# 安装
Werkzeug 要求 Python 2.6 以上版本。如果你需要支持 Pyhthon <2.6 版本可以下载老版本的 Werkzeug (强烈推荐 Pyhton 2.6 以上版本)。Werkzeug目前已经支持 Python 3。更多信息请看 [*Python 3 Notes*](#).
### 安装一个发行版
### 安装一个egg包 (通过 easy_install 或 pip)
你可以安装最新的 Werkzeug 版本通过 [easy_install](http://peak.telecommunity.com/DevCenter/EasyInstall) :
~~~
easy_install Werkzeug
~~~
另外你也可以使用pip:
~~~
pip install Werkzeug
~~~
我们强烈推荐结合 [*virtualenv*](#) 使用这些工具。
这将会在 site-packages 目录安装一个 Werkzeug egg 包。
### 从压缩包安装
1. 从 [download page](https://pypi.python.org/pypi/Werkzeug) 下载最新的压缩包。
1. 解压压缩包。
1. 执行 pythonsetup.pyinstall 命令。
注意如果你没有安装 [setuptools](http://peak.telecommunity.com/DevCenter/setuptools) 执行最后一条命令将会自动下载和安装。这需要联网。
以上命令会将 Werkzeug 安装到 site-packages 文件夹。
### 安装开发版
1. 安装 [Git](http://git-scm.org/)
1. gitclonegit://github.com/mitsuhiko/werkzeug.git
1. cdwerkzeug
1. pipinstall--editable
### virtualenv
Virtualenv 大概会是你想在开发环境下使用的软件。如果你有shell权限访问生产环境,你可能也会喜欢他。
virtualenv 解决了什么问题?如果你像我一样喜欢Python,你很可能会在基于 Werkzeug的 Web 应用之外使用Python。但是随着项目越来越多,你使用不同版本python的可能性越大,至少你有可能会用到支持不同Pytohn版本的库。我们不得不面对一种很常见的情况就是库是不向后兼容的,或者很少有应用没有依赖包。所以当然有两个甚至更多项目的时候你打算怎么解决依赖冲突?
Virtualenv 正是为此而生!它允许你安装多个Python版本, 每个项目对应自己的Python。他其实并没有安装一个Python副本,而是通过很奇妙的方法来保持环境独立。
下面让我门看看 virtualenv 是怎么工作的!
如果你使用 Mac OS X 或 Linux, 这里有两种安装方法供你选择:
~~~
$ sudo easy_install virtualenv
~~~
或者更好的方法:
~~~
$ sudo pip install virtualenv
~~~
你可以通过上述命令在你的系统安装 virtualenv 。你甚至可以使用包管理器安装,如果你使用Ubuntu,可以尝试:
~~~
$ sudo apt-get install python-virtualenv
~~~
如果你是用Windows,没有 easy_install 命令,你必须首先安装它。一旦安装成功,执行相同的命令,但是不需要带 sudo 前缀。
一旦成功安装 virtualenv,打开 shell 创建你自己的环境。我经常会创建一个 myproject 文件夹,并在其中创建 env 文件夹:
~~~
$ mkdir myproject
$ cd myproject
$ virtualenv env
New python executable in env/bin/python
Installing setuptools............done.
~~~
现在,无论何时只要你想在某个项目上工作,只需激活相应环境。在 OS X 和 Linux,按如下操作:
~~~
$ . env/bin/activate
~~~
(注意 . 和脚本名称之间的空格。 . 意味着这个脚本在当前shell下运行。如果这个命令在你的命令行无效, 尝试用 source 代替 .)
如果你是个 Windows 用户,可以使用以下命令:
~~~
$ env\scripts\activate
~~~
无论哪种方式,现在你已经可以使用 virtualenv 了(观察shell中切换到的Virtualenv提示)。
> 安装Werkzeug
~~~
$ pip install Werkzeug
~~~
几秒钟后你就可以使用werkzeug了。
- 开始
- Werkzeug 文档概览
- 安装
- 过渡到 Werkzeug 1.0
- Werkzeug 教程
- API 标准
- 快速开始
- Python 3 Notes
- 服务和测试
- Debugging Applications
- 在服务器运行 WSGI 应用
- 单元测试
- 参考
- Request / Response Objects
- URL Routing
- WSGI Helpers
- HTTP Utilities
- Data Structures
- Utilities
- Context Locals
- Middlewares
- HTTP Exceptions
- 部署
- CGI
- mod_wsgi (Apache)
- FastCGI
- HTTP Proxying
- 贡献模块
- Atom Syndication
- Sessions
- Secure Cookie
- Cache
- Extra Wrappers
- Iter IO
- Fixers
- WSGI Application Profiler
- Lint Validation Middleware
- 额外说明
- Werkzeug Changelog
- Important Terms
- Unicode
- Dealing with Request Data