| 1 | = TracLegos - building blocks for creating Trac projects = |
| 2 | |
| 3 | == Description == |
| 4 | |
| 5 | TracLegos is software designed to assist with trac project creation. |
| 6 | Its goal is to make project creation easy and flexible, allowing |
| 7 | flexibility with regards to creation methodology as well as |
| 8 | extensibility as a project factory for environments with advanced |
| 9 | needs. TracLegos is not [at least by design, yet] meant for project |
| 10 | upgrading or maintainence, but only to setup a project with sensible |
| 11 | defaults. |
| 12 | |
| 13 | TracLegos can be invoked in a number of ways: |
| 14 | |
| 15 | * through a command-line interface (legos.py) |
| 16 | |
| 17 | * through a WSGI wrapper around trac (web.py) |
| 18 | |
| 19 | * via `paster create` |
| 20 | |
| 21 | * programmatically |
| 22 | |
| 23 | |
| 24 | == Bugs/Feature Requests == |
| 25 | |
| 26 | Existing bugs and feature requests for TracLegosScript are |
| 27 | [report:9?COMPONENT=TracLegosScript here]. |
| 28 | |
| 29 | If you have any issues, create a |
| 30 | [http://trac-hacks.org/newticket?component=TracLegosScript&owner=k0s new ticket]. |
| 31 | |
| 32 | == Download == |
| 33 | |
| 34 | Download the zipped source from [download:traclegosscript here]. |
| 35 | |
| 36 | == Source == |
| 37 | |
| 38 | You can check out TracLegosScript from [http://trac-hacks.org/svn/traclegosscript here] using Subversion, or [source:traclegosscript browse the source] with Trac. |
| 39 | |
| 40 | == Example == |
| 41 | |
| 42 | Example of command line usage: |
| 43 | |
| 44 | {{{ |
| 45 | > create-trac-project |
| 46 | Usage: create-trac-project [options] project <project2> <...> var1=1 var2=2 ... |
| 47 | |
| 48 | assemble a trac project from components |
| 49 | |
| 50 | Options: |
| 51 | -h, --help show this help message and exit |
| 52 | -c CONF, --conf=CONF site configuration files |
| 53 | -d DIRECTORY, --directory=DIRECTORY |
| 54 | trac projects directory |
| 55 | -i INHERIT, --inherit=INHERIT |
| 56 | .ini file to inherit from |
| 57 | -r REQUIREMENTS, --requires=REQUIREMENTS |
| 58 | requirements files for plugins |
| 59 | -s REPOSITORY, --repository=REPOSITORY |
| 60 | repository type to use |
| 61 | -t TEMPLATES trac.ini templates to be applied in order |
| 62 | --list-templates list available TracProject PasteScript templates |
| 63 | --list-repositories list repositories available for setup by TracLegos |
| 64 | > create-trac-project --list-templates |
| 65 | Available projects: |
| 66 | topp_trac_project: The Open Planning Project Trac Template |
| 67 | )> create-trac-project --list-repositories |
| 68 | Available repositories: |
| 69 | ExistingSVN: Use an existing repository |
| 70 | NewSVN: Create a new SVN repository |
| 71 | > create-trac-project -t topp-trac-project mynewproject # create a new project |
| 72 | }}} |
| 73 | |
| 74 | == Recent Changes == |
| 75 | |
| 76 | [[ChangeLog(traclegosscript, 3)]] |
| 77 | |
| 78 | == Author/Contributors == |
| 79 | |
| 80 | '''Author:''' [wiki:k0s] [[BR]] |
| 81 | '''Contributors:''' |