--- 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