1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
|
.. _qtut_requirements:
============
Requirements
============
Let's get our tutorial environment set up. Most of the set up work is in
standard Python development practices (install Python and make an isolated
environment.)
.. note::
Pyramid encourages standard Python development practices with
packaging tools, virtual environments, logging, and so on. There
are many variations, implementations, and opinions across the Python
community. For consistency, ease of documentation maintenance,
and to minimize confusion, the Pyramid *documentation* has adopted
specific conventions.
This *Quick Tutorial* is based on:
* **Python 3.5**. Pyramid fully supports Python 3.3+ and Python 2.6+. This
tutorial uses **Python 3.5** but runs fine under Python 2.7.
* **venv**. We believe in virtual environments. For this tutorial, we use
Python 3.5's built-in solution ``venv``. For Python 2.7, you can install
``virtualenv``.
* **pip**. We use ``pip`` for package management.
* **Workspaces, projects, and packages.** Our home directory
will contain a *tutorial workspace* with our Python virtual
environment(s) and *Python projects* (a directory with packaging
information and *Python packages* of working code.)
* **Unix commands**. Commands in this tutorial use UNIX syntax and
paths. Windows users should adjust commands accordingly.
.. note::
Pyramid was one of the first web frameworks to fully support Python 3 in
October 2011.
Steps
=====
#. :ref:`install-python-3`
#. :ref:`create-a-project-directory-structure`
#. :ref:`set-an-environment-variable`
#. :ref:`create-a-virtual-environment`
#. :ref:`install-pyramid`
.. _install-python-3:
Install Python 3
----------------
Windows and Mac OS X users can download and run an installer.
Download the latest standard Python 3 release (not development release) from
`python.org <https://www.python.org/downloads/>`_.
Windows users should also install the `Python for Windows extensions
<http://sourceforge.net/projects/pywin32/files/pywin32/>`_. Carefully read the
``README.txt`` file at the end of the list of builds, and follow its
directions. Make sure you get the proper 32- or 64-bit build and Python
version.
Linux users can either use their package manager to install Python 3
or may `build Python 3 from source
<http://pyramid.readthedocs.org/en/master/narr/install.html#package-manager-
method>`_.
.. seealso:: See also :ref:`For Mac OS X Users <for-mac-os-x-users>`, :ref:`If
You Don't Yet Have a Python Interpreter (UNIX)
<if-you-don-t-yet-have-a-python-interpreter-unix>`, and :ref:`If You Don't
Yet Have a Python Interpreter (Windows)
<if-you-don-t-yet-have-a-python-interpreter-windows>`.
.. _create-a-project-directory-structure:
Create a project directory structure
------------------------------------
We will arrive at a directory structure of
``workspace->project->package``, with our workspace named
``quick_tutorial``. The following tree diagram shows how this will be
structured and where our virtual environment will reside as we proceed through
the tutorial:
.. code-block:: text
└── ~
└── projects
└── quick_tutorial
├── env
└── step_one
├── intro
│ ├── __init__.py
│ └── app.py
└── setup.py
For Linux, the commands to do so are as follows:
.. code-block:: bash
# Mac and Linux
$ cd ~
$ mkdir -p projects/quick_tutorial
$ cd projects/quick_tutorial
For Windows:
.. code-block:: ps1con
# Windows
c:\> cd \
c:\> mkdir projects\quick_tutorial
c:\> cd projects\quick_tutorial
In the above figure, your user home directory is represented by ``~``. In
your home directory, all of your projects are in the ``projects`` directory.
This is a general convention not specific to Pyramid that many developers use.
Windows users will do well to use ``c:\`` as the location for ``projects`` in
order to avoid spaces in any of the path names.
Next within ``projects`` is your workspace directory, here named
``quick_tutorial``. A workspace is a common term used by integrated
development environments (IDE) like PyCharm and PyDev that stores
isolated Python environments (virtualenvs) and specific project files
and repositories.
.. _set-an-environment-variable:
Set an Environment Variable
---------------------------
This tutorial will refer frequently to the location of the virtual
environment. We set an environment variable to save typing later.
.. code-block:: bash
# Mac and Linux
$ export VENV=~/projects/quick_tutorial/env
.. code-block:: ps1con
# Windows
# TODO: This command does not work
c:\> set VENV=c:\projects\quick_tutorial\env
.. _create-a-virtual-environment:
Create a Virtual Environment
----------------------------
``venv`` is a tool to create isolated Python 3 environments, each with its own
Python binary and independent set of installed Python packages in its site
directories. Let's create one, using the location we just specified in the
environment variable.
.. code-block:: bash
# Mac and Linux
$ python3 -m venv $VENV
.. code-block:: ps1con
# Windows
c:\> c:\Python35\python3 -m venv %VENV%
.. seealso:: See also Python 3's :mod:`venv module <python:venv>` and Python
2's `virtualenv <http://www.virtualenv.org/en/latest/>`_ package.
.. _install-pyramid:
Install Pyramid
---------------
We have our Python standard prerequisites out of the way. The Pyramid
part is pretty easy:
.. parsed-literal::
# Mac and Linux
$ $VENV/bin/pip install "pyramid==\ |release|\ "
# Windows
c:\\> %VENV%\\Scripts\\pip install "pyramid==\ |release|\ "
Our Python virtual environment now has the Pyramid software available.
You can optionally install some of the extra Python packages used
during this tutorial:
.. code-block:: bash
# Mac and Linux
$ $VENV/bin/pip install nose webtest deform sqlalchemy \
pyramid_chameleon pyramid_debugtoolbar waitress \
pyramid_tm zope.sqlalchemy
.. code-block:: ps1con
# Windows
c:\> %VENV%\Scripts\pip install nose webtest deform sqlalchemy pyramid_chameleon pyramid_debugtoolbar waitress pyramid_tm zope.sqlalchemy
|
