Package: gp.vcsdevelop
ContentsWhat is gp.vcsdevelop ?Available optionsUsageBasic usageNon-python packagesGit submodulespip requirements fileBugsChanges2.2 (12-07-2011)2.1 (22-05-2011)2.0 (20-05-2011)1.9.4 (04-05-2011)1.9.2 (04-01-2011)1.9.1 (22-08-2010)1.9 (22-08-2010)1.8 (06-08-2010)1.7 (06-08-2010)1.6 (13-05-2010)1.5 (17-02-2010)1.4 (24-01-2010)1.3 (13-09-2009)1.2 (24-08-2009)1.1 (29-06-2009)0.4 (04-05-2009)0.2 (27-01-2009)0.1 (23-01-2009)DownloadWhat is gp.vcsdevelop ?This package allow you to checkout some package and use them as developed
eggs withzc.buildout.Available optionsdevelop-dir: a directory to checkout packages invcs-extend-develop: A list of vcs url. Seepip’s editable parameter.
Available schemes are ssh, svn, git, hg, bzr, sftp.vcs-update:Iftrueon every run buildout try updating
egg. As example for hg+https run hg pull -uIfalwaysthen remove existing code from filesystem and get a fresh checkoutrequirements:A path to a pip requirement file.UsageBasic usageUse this package as azc.buildoutextension and provide
some vcs urls in thevcs-extend-developoption:>>> write('buildout.cfg','''
... [buildout]
... extensions=gp.vcsdevelop
... vcs-extend-develop=hg+https://gawel@bitbucket.org/ianb/pip/@tip#egg=pip
... parts=
... ''')Then if you runbuildout, the package will be checkout from the
repository:>>> print 'Start', system(buildout)
Start...
Cloning hg https://gawel@bitbucket.org/ianb/pip/ (to revision tip) to ./pip
Found command 'hg' at '...'
Develop: '/...buildout/pip'
...Packages can be found in thedevelop-dir(default to .). You can override this:>>> write('buildout.cfg','''
... [buildout]
... extensions=gp.vcsdevelop
... develop-dir=./src
... vcs-extend-develop=git+https://github.com/pypa/pip.git/@1.1#egg=pip
... parts=
... ''')

>>> print 'Start', system(buildout)
Start...
Cloning https://github.com/pypa/pip.git/ (to 1.1) to ./src/pip
Found command 'git' at '...'
...
Develop: '/...buildout/./src/pip'
...Non-python packagesYou can also checkout non-python packages but you’ll get a warning:>>> write('buildout.cfg','''
... [buildout]
... extensions=gp.vcsdevelop
... develop-dir=./src
... vcs-extend-develop=git+git://github.com/benoitc/couchbeam.git#egg=couchbeam
... parts=
... ''')

>>> print 'Start', system(buildout).strip()
Start...
Cloning git://github.com/benoitc/couchbeam.git to ./src/couchbeam
Found command 'git' at '...'
Warning: ./src/couchbeam is not a python packageGit submodulesgp.vcsdevelopis aware of Git’s submodules at the first level:>>> write('buildout.cfg','''
... [buildout]
... extensions=gp.vcsdevelop
... develop-dir=./src
... vcs-extend-develop=git+git://github.com/bearstech/PloneTerminal.git#egg=PloneTerminal
... parts=
... ''')

>>> print 'Start', system(buildout).strip()
Start...
Cloning git://github.com/bearstech/PloneTerminal.git to ./src/PloneTerminal
Found command 'git' at '...'
Submodule 'jquery.terminal' (git://github.com/jcubic/jquery.terminal.git) registered for path 'ploneterminal/statics/jquery.terminal'
<BLANKLINE>
Cloning into ploneterminal/statics/jquery.terminal...
Submodule path 'ploneterminal/statics/jquery.terminal': checked out '...'
<BLANKLINE>
Develop: '/...buildout/./src/PloneTerminal'
...

>>> ls('src', 'PloneTerminal', 'ploneterminal', 'statics', 'jquery.terminal')
d  .git
-  CHANGELOG
-  README
d  css
d  examples
d  js
d  trypythonpip requirements filegp.vcsdevelopcan take care of your requirements file. All packages names
contained by the requirements file can be found in a var named${buildout:requirements-eggs}:>>> write('buildout.cfg','''
... [buildout]
... extensions=gp.vcsdevelop
... develop-dir=./requirements
... requirements = requirements.txt
... parts= eggs
...
... [eggs]
... recipe = zc.recipe.egg
... eggs = ${buildout:requirements-eggs}
... interpreter = python
... ''')

>>> write('requirements.txt', '''
... ConfigObject>=1.0
... -e git+git://github.com/bearstech/PloneTerminal.git#egg=PloneTerminal
... ''')

>>> print 'Start', system(buildout).strip()
Start...
Cloning git://github.com/bearstech/PloneTerminal.git to ./requirements/PloneTerminal
Found command 'git' at '...'
...
Develop: '/...buildout/./requirements/PloneTerminal'
...
Generated interpreter '/...buildout/bin/python'.

>>> print 'File', cat('bin', 'python')
File...
sys.path[0:0] = [
    '.../ConfigObject-....egg',
    '/...buildout/requirements/PloneTerminal',
...BugsUse thebitbuckettracker.Changes2.2 (12-07-2011)use more pip apiaddrequirementsoption2.1 (22-05-2011)Take care of any.gitmodulesfound at package root2.0 (20-05-2011)No longer depends on pip. Useget-pip.py1.9.4 (04-05-2011)python3 ready1.9.2 (04-01-2011)require pip>=0.81.9.1 (22-08-2010)add mercurial in require1.9 (22-08-2010)support latest pip1.8 (06-08-2010)always add svn scheme1.7 (06-08-2010)fix pip 0.8 compat1.6 (13-05-2010)require pip>=0.7.11.5 (17-02-2010)rename vcsdevelop-update to vcs-update. can be set toalways1.4 (24-01-2010)pip 0.6.3 compat by Boris Kocherov1.3 (13-09-2009)add vcsdevelop-update by Boris Kocherov1.2 (24-08-2009)allow to fetch non-python package1.1 (29-06-2009)add svn to vcs.schemes0.4 (04-05-2009)allow to have existing develop directories0.2 (27-01-2009)only take care of urls starting with a valid available scheme.0.1 (23-01-2009)nothing changeDownload