Difference between revisions of "Wescamp.py Instructions"

From The Battle for Wesnoth Wiki
(Invocation)
(Checkouts)
Line 8: Line 8:
  
 
== Checkouts ==
 
== Checkouts ==
Like the svn invocation, with git, a directory per "version branch" is required. Unlike the svn version, you can't simply check out a single directory to do this. I haven't yet tested if the -D switch will do this properly, but if not, the required tool/switch will be simple to create.
+
Like the svn invocation, with git, a directory per "version branch" is required. Unlike the svn version, you can't simply check out a single directory to do this.
 +
The -U switch can make the requisite checkouts as a side-effect.
  
 
== Invocation ==
 
== Invocation ==

Revision as of 20:35, 4 December 2011

Documented here is how wescamp.py works when -g (--git) is passed, so that it communicates with wescamp at github.com instead of wescamp-i18n at berlios.de.

Requirements

  • Git
  • Python (2.5 or above should work)
  • Ssh keys so that git push doesn't require a password prompt
  • Administrator rights on github.com/wescamp (for creating new repositories)

Checkouts

Like the svn invocation, with git, a directory per "version branch" is required. Unlike the svn version, you can't simply check out a single directory to do this. The -U switch can make the requisite checkouts as a side-effect.

Invocation

Invocation (for -u and -U) is the same as with svn, with the following differences:

  • The -g/--git switch is required
  • The -G/--github-login (with argument in the form of USER:PASSWORD) is required an upload would create a new repository on github. This is because a json API is used to create the new repository.

Examples

./data/tools/wesnoth/wescamp.py -scampaigns.wesnoth.org -p15002 -w/tmp/wescamp-upload/1.10/ -u Invasion_from_the_Unknown -g

In this case a checkout of the Invasion_from_the_Unknown-1.10 repository already exists in /tmp/wescamp-upload/1.10/Invasion_from_the_Unknown/

./data/tools/wesnoth/wescamp.py -scampaigns.wesnoth.org -p15002 -w/tmp/wescamp-upload/1.10/ -u Era_of_Myths -g -G USER:PASSWORD

In this case the directory /tmp/wescamp-upload/1.10/ exists, but there is no Era_of_Myths directory in it and neither is there an Era_of_Myths-1.10 repository on github.

Notes

If there's anything missing, please contact me. (AI0867)