<commit_before>

How to install TurboGears 2
=============================

Installing TurboGears 2 currently requires some developer skills. You are willing to checkout both the Pylons and TurboGears 2 code from their respective version control systems.  TurboGears 2 is working well, and there is at least one large project built upon it already, but it's not yet documented and ready for users who aren't ready to deal with the current rate of change in the project.

We do expect to have a technology preview release sometime soon, and that should provide a clear picture of the TurboGears 2 stack, and a slightly more stable API.   However, if you want API stability and good documentation, you may want to consider building your application on TurboGears 1 and porting it to TG2 after it is officially released.

Prerequisites:
-----------------------
* gcc
* python
* appropriate python development package (python*-devel python*-dev)

Installing Pylons:
-----------------------

You could easy_install pylons with command::

 $ easy_install -f http://pylonshq.com/download/0.9.7 -U Pylons

Installing Pylons from Source:
--------------------------------

.. note:: If you've installed pylons in previous section, you could skip to next section.

Pylons uses the Mercurial Version control system, so if you want to install from repository,  you probably need to install Mercurial before you can pull down the latest development source for Pylons. Mercurial `packages are available <http://www.selenic.com/mercurial/wiki/index.cgi/BinaryPackages>`_ for Windows, Mac OSX, and other OS's.

First you need to install:

1. Python (see http://www.python.org)

2. setuptools (run http://peak.telecommunity.com/dist/ez_setup.py from any directory)

Now you can check out the latest code::

 $ hg clone http://pylonshq.com/hg/pylons-dev Pylons


To tell setuptools to use the version you are editing in the Pylons directory::

  $ cd Pylons
  $ python setup.py develop


**Mac OSX Leopard** comes with Python 2.5 but does not include **setuptools**. Install it using the instructions above.

**Cygwin** does not include the necessary binary file **sqlite3.dll**; if you want to run cygwin you'll need to install a different database. If you have cygwin installed and you want to use the default setup described here, you must perform all operations, including setup operations, within DOS command windows, not cygwin command windows.

Now you can make changes to the files in the Pylons directory and the code will run exactly as if you had installed a version of the egg with the changes you have made.

Installing TurboGears 2 from Source:
--------------------------------------

TurboGears 2 are constructed by a bunch of packages.

Check out the latest code from subversion::<commit_msg>Added Paver installation to DownloadInstall doc.<commit_after>

How to install TurboGears 2
=============================

Installing TurboGears 2 currently requires some developer skills. You are willing to checkout both the Pylons and TurboGears 2 code from their respective version control systems.  TurboGears 2 is working well, and there is at least one large project built upon it already, but it's not yet documented and ready for users who aren't ready to deal with the current rate of change in the project.

We do expect to have a technology preview release sometime soon, and that should provide a clear picture of the TurboGears 2 stack, and a slightly more stable API.   However, if you want API stability and good documentation, you may want to consider building your application on TurboGears 1 and porting it to TG2 after it is officially released.

Prerequisites:
-----------------------
* gcc
* python
* appropriate python development package (python*-devel python*-dev)

Installing Pylons:
-----------------------

You could easy_install pylons with command::

 $ easy_install -f http://pylonshq.com/download/0.9.7 -U Pylons

Installing Pylons from Source:
--------------------------------

.. note:: If you've installed pylons in previous section, you could skip to next section.

Pylons uses the Mercurial Version control system, so if you want to install from repository,  you probably need to install Mercurial before you can pull down the latest development source for Pylons. Mercurial `packages are available <http://www.selenic.com/mercurial/wiki/index.cgi/BinaryPackages>`_ for Windows, Mac OSX, and other OS's.

First you need to install:

1. Python (see http://www.python.org)

2. setuptools (run http://peak.telecommunity.com/dist/ez_setup.py from any directory)

Now you can check out the latest code::

 $ hg clone http://pylonshq.com/hg/pylons-dev Pylons


To tell setuptools to use the version you are editing in the Pylons directory::

  $ cd Pylons
  $ python setup.py develop


**Mac OSX Leopard** comes with Python 2.5 but does not include **setuptools**. Install it using the instructions above.

**Cygwin** does not include the necessary binary file **sqlite3.dll**; if you want to run cygwin you'll need to install a different database. If you have cygwin installed and you want to use the default setup described here, you must perform all operations, including setup operations, within DOS command windows, not cygwin command windows.

Now you can make changes to the files in the Pylons directory and the code will run exactly as if you had installed a version of the egg with the changes you have made.

Installing Paver:
-----------------------

To install paver::

 $ easy_install paver


Installing TurboGears 2 from Source:
--------------------------------------

TurboGears 2 are constructed by a bunch of packages.

Check out the latest code from subversion::
{'fraction_non_alphanumeric': 0.10385964912280701, 'fraction_numerical': 0.0059649122807017545, 'mean_word_length': 3.51743264659271, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 5, 'https://': 0, 'lorem ipsum': 0, 'www.': 4, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 3, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2617468', 'n_tokens_mistral': 1500, 'n_tokens_neox': 1432, 'n_words': 787}