Download Install Tutorial Docs FAQ Tools WikiLicense Team IRC Planet Involvement Shop Book

Subversion Repository

CherryPy's source code is managed using Subversion, a source code control system.

Direct access

You can access our Subversion repository using your favorite Subversion client through this URL:

http://svn.cherrypy.org

For Windows users we recommend the wonderful Subversion client TortoiseSVN. Users of other operating systems are advised to use multi-platform, Qt-based eSVN or the command line tools provided by the core Subversion distribution.

Note: In some cases http access fails with the error 'Cannot checkout' even though the web interface works fine. This is usually because of a proxy between you and the server which doesn't support all the access methods that SVN needs. Many ISPs insert a transparent proxy on all http traffic, causing this problem. The solution is to switch to https access so the proxy cannot interfere.

Web interface

This site provides a nice web interface to the repository, allowing you to browse specific revisions, inspect change sets, and even follow changes to specific trees/files using RSS feeds. This web interface is located at:

http://www.cherrypy.org/browser/

Usage notes

  • The repository is open for anonymous read-only access. CherryPy developers have write permissions. To obtain write permission, please contact fumanchu via email or IRC.
  • The repository follows the standard trunk/branches/tags structure that is recommended in the Subversion documentation.
    • trunk contains the official development code. Please do not checkin any code on trunk that is untested, or that breaks the test suite.
    • branches contain experimental branches. Patches for complex tickets may also be developed and tested on a branch, to allow for easier collaboration during test of inherently unstable features.
    • tags contain frozen, known quality releases.

Configuring the Subversion client

Popular Subversion clients, including TortoiseSVN and the standard command line tools, are configurable by editing a standard config file. The file is stored at:

  • Linux: ~/.subversion/config
  • Windows XP, 2000, NT: %APPDATA%\Subversion\config
  • Windows 98 (and possibly ME also): \Windows\Application Data\Subversion\config

Configuration is necessary because line endings do matter for Subversion, and different code editors and IDEs use different conventions. This problem can be solved by telling Subversion to automatically map the line endings of the code in the repository to the conventions of you local install. The configuration file should contain the following entries:

[miscellany]
global-ignores = *.o *.lo *.la #*# .*.rej *.rej .*~ *~ .#* .DS_Store *.pyc
enable-auto-props = yes

[auto-props]
*.py = svn:eol-style=native
README.* = svn:eol-style=CRLF
*.TXT = svn:eol-style=CRLF

The miscellany section contains two important settings: first, it tells Subversion to ignore pyc files (in addition to the standard files it already ignores); and also, it enables the auto-props section, which in turn provides the standard line-ending convention.

Hosted by WebFaction

Log in as guest/cpguest to create tickets