diff -r 26d427cd976a -r e2b79f699cf2 docs/source/install.rst --- a/docs/source/install.rst Thu Jun 01 15:23:21 2017 +0200 +++ b/docs/source/install.rst Wed Jun 07 10:46:30 2017 +0200 @@ -32,66 +32,26 @@ PyAMS provides a new Pyramid scaffold, called *pyams*, provided by the *pyams_base* package. -A simple option to install PyAMS is to create a buildout environment including *Pyramid* and *PyAMS_base* packages: +A simple option to install PyAMS is to create a buildout environment including *Pyramid* and all *PyAMS* packages: .. code-block:: bash - # mkdir /var/local/env/ + # mkdir /var/local/ # pip3 install virtualenv - # virtualenv --python=python3.5 pyams - # cd pyams + # virtualenv --python=python3.5 env + # cd env # . bin/activate - (pyams) # pip3.5 install zc.buildout - (pyams) # buildout init - -Then update your Buildout configuration file *buildout.cfg* as follow: - -.. code-block:: ini + (pyams) # pip3.5 install cookiecutter + (pyams) # cookiecutter hg+http://hg.ztfy.org/pyams/scaffolds/pyams - [buildout] - find-links = http://download.ztfy.org/eggs - extends = http://download.ztfy.org/pyams/pyams-0.1.0.cfg - socket-timeout = 3 - show-picked-versions = true - newest = false - allow-hosts = - *.python.org - *.sourceforge.net - github.com - bitbucket.org - versions = versions - eggs-directory = eggs - parts = pyramid - - [pyramid] - recipe = zc.recipe.egg - dependent-scripts = true - eggs = - pyramid - pyams_base - interpreter = py3.4 - -Then launch the buildout initialization: - -.. code-block:: bash - - (pyams) # ./bin/buildout - (pyams) # ./bin/pcreate -l - Available scaffolds: - alchemy: Pyramid project using SQLAlchemy, SQLite, URL dispatch, and - pyams: Pyramid project using all PyAMS packages - pyams_asyncio: Pyramid AsyncIO project using websockets for PyAMS notifications - starter: Pyramid starter project using URL dispatch and Chameleon - zodb: Pyramid project using ZODB, traversal, and Chameleon - (pyams) # ./bin/pcreate -t pyams myapp - (pyams) # cd myapp +CookieCutter will ask for for a small set of input variables that you can change or not. You can then check, and eventually update, the proposed Buildout configuration file *buildout.cfg*, to add or remove packages or update settings to your needs. Then finalize Bootstrap initialization: .. code-block:: bash - (pyams) # ../bin/buildout bootstrap + (pyams) # python3.5 bootstrap.py (pyams) # ./bin/buildout This last operation can be quite long, as many packages have to downloaded, compiled and installed in the virtual