Difference between revisions of "Developer Info"
| Line 33: | Line 33: | ||
java -cp target/test-classes com.bitplan.mediawiki.japi.user.WikiUser mediawiki_org | java -cp target/test-classes com.bitplan.mediawiki.japi.user.WikiUser mediawiki_org | ||
</source> | </source> | ||
| − | + | The first parameter is the wikiid "mediawiki_org" which identifies the wiki the credentials are going to be used for. | |
| + | |||
| + | When running WikiUser you'll be asked for: | ||
* username (please enter it with a capital first letter or fix the .ini file later) | * username (please enter it with a capital first letter or fix the .ini file later) | ||
* password (will be encrypted) | * password (will be encrypted) | ||
| Line 39: | Line 41: | ||
like this: | like this: | ||
<pre> | <pre> | ||
| − | java -cp target/test-classes com.bitplan.mediawiki.japi.user.WikiUser | + | java -cp target/test-classes com.bitplan.mediawiki.japi.user.WikiUser mediawiki_org |
Please Enter username: Scott | Please Enter username: Scott | ||
Please Enter password: tiger | Please Enter password: tiger | ||
Please Enter email: scott@tiger.com | Please Enter email: scott@tiger.com | ||
| − | Please Enter shall i store Scott's credentials encrypted in | + | Please Enter shall i store Scott's credentials encrypted in wf_mediawiki_org.ini y/n?: y |
</pre> | </pre> | ||
Revision as of 05:56, 5 January 2015
Development Environment
Maven
Maven 3 is is used in a pretty standard way - just look at pom.xml for details
Eclipse
The project can be imported to eclipse - using the m2eclipse plugin is recommended
Testenvironment
There is a JUnit 4 Testsuite for the Mediawiki-Japi library that accesses some ExampleWikis for the tests.
A login attempt is part of most of the tests - you'll need credentials at http://www.mediawiki.org to run these tests successfully. You might want to create an account at https://www.mediawiki.org/w/index.php?title=Special:UserLogin&type=signup
Credentials for the test example Mediawikis
The credentials for the test example Mediawikis are fetched from ini files in the .mediawiki-api subdirectory of your home directory. E.g. if your username is bob and the id of the Mediawiki is "mediawiki_org" then you'll find the ini file at $HOME/.mediawiki-api/bob_mediawiki_org.ini.
If the credentials ini files do not exist yet you are warned during the test run e.g.
Jan 04, 2015 6:27:51 PM com.bitplan.mediawiki.japi.user.WikiUser getUser
Schwerwiegend: Need to be able to read Credentials for
http://www.mediawiki.org
from /home/rene/.mediawiki-japi/rene_mediawiki_org.ini
Please run
java -cp target/test-classes com.bitplan.mediawiki.japi.user.WikiUser mediawiki_org
to create it. Then restart your tests.
In this case you might want to run
java -cp target/test-classes com.bitplan.mediawiki.japi.user.WikiUser mediawiki_org
The first parameter is the wikiid "mediawiki_org" which identifies the wiki the credentials are going to be used for.
When running WikiUser you'll be asked for:
- username (please enter it with a capital first letter or fix the .ini file later)
- password (will be encrypted)
like this:
java -cp target/test-classes com.bitplan.mediawiki.japi.user.WikiUser mediawiki_org Please Enter username: Scott Please Enter password: tiger Please Enter email: scott@tiger.com Please Enter shall i store Scott's credentials encrypted in wf_mediawiki_org.ini y/n?: y
Example for a credential ini file
.mediawiki-japi/scott_wiki1.ini
#Mediawiki-api
#Fri Jan 02 19:58:49 CET 2015
secret=5hKnFOyU1uE\=
user=Scott
email=scott@tiger.org
salt=w75pcoUN
cypher=YYmhAs86ygNnLbs@b9dNq36afytEzkCm