笨鸟编程-零基础入门Pyhton教程 › 首页 ›Flask中文手册 › 查看内容

Flask 扩展开发

Flask，一个微框架，通常需要一些重复的步骤来让第三方库工作。因为在很多时候，这些步骤可以被分离出，来支持多个项目，就有了 Flask Extension Registry 。

如果你想要为还没有的功能创建你自己的 Flask 扩展，这份扩展开发指南会帮助你在很短的时间内让你的应用跑起来并且感到像用户一样期待你的扩展运转。

剖析扩展

所有的扩展都位于一个叫做 flask_something 的包，其中“ something ”是你想要连接的库的名字。那么，例如当你计划要为 Flask 添加一个叫做 simplexml 的库的支持时，你应该把你扩展的包命名为 flask_simplexml 。

实际的扩展名（人类可读的名称）无论如何会是“Flask-SimpleXML”之类的东西。确保在名字中包含“Flask”并注意大小写。这是用户可以在他们的 setup.py 文件中注册你的扩展为依赖的方式。

Flask 设立了一个叫做 flask.ext 的重定向包，用户应该从这个包导入扩展。例如，如果你有一个叫做 flask_something 的包，用户应该用 flask.ext.something 的方式导入。这样做是为了从老命名空间的包过度。详情见扩展导入的过渡。

但是扩展如何看起来像扩展？一个扩展必须保证它可以同时在多个 Flask 应用中工作。这是必要条件，因为许多人会使用类似应用程序的工厂函数的模式来创建应用来进行单元测试或是支持多套配置。因此，你的应用支持这种行为非常重要。

最重要的是，扩展必须与一个 setup.py 文件一起装配，并且在 PyPI 上注册。同样，开发 checkout 链接也应该能工作，这样才可以在 virtualenv 中容易地安装开发版本，而不是手动下载库。

Flask 扩展必须以 BSD 或 MIT 或更自由的许可证来许可，这样才能被列入到 Flask Extension Registry 。记住 Flask Extension Registry 是一个人工维护的地方，并且会视这些库的行为来决定是否进行必要的提前审查。

“Hello Flaskext!”

那么让我们开始创建这样一个 Flask 扩展。我们这里想要创建的扩展会提供 SQLite3 最基础的支持。

首先我们创建下面的目录结构:

flask-sqlite3/
    flask_sqlite3.py
    LICENSE
    README

这里是最重要的文件的内容:

setup.py

下一个绝对需要的文件是 setup.py ，用于安装你的 Flask 扩展。你可以使用下面的内容:

"""
Flask-SQLite3
-------------

This is the description for that library
"""
from setuptools import setup


setup(
    name='Flask-SQLite3',
    version='1.0',
    url='http://example.com/flask-sqlite3/',
    license='BSD',
    author='Your Name',
    author_email='your-email@example.com',
    description='Very short description',
    long_description=__doc__,
    py_modules=['flask_sqlite3'],
    # if you would be using a package instead use packages instead
    # of py_modules:
    # packages=['flask_sqlite3'],
    zip_safe=False,
    include_package_data=True,
    platforms='any',
    install_requires=[
        'Flask'
    ],
    classifiers=[
        'Environment :: Web Environment',
        'Intended Audience :: Developers',
        'License :: OSI Approved :: BSD License',
        'Operating System :: OS Independent',
        'Programming Language :: Python',
        'Topic :: Internet :: WWW/HTTP :: Dynamic Content',
        'Topic :: Software Development :: Libraries :: Python Modules'
    ]
)

这有相当多的代码，但是你实际上可以从现有的扩展中直接复制/粘贴，并修改相应的内容。

12 3 4 / 4 页下一页

上一篇：Flask 中的 Unicode下一篇：Pocoo 风格指引

		自动登录	找回密码
密码			立即注册