這個教程緊接（7）,我們將我們的網頁問卷調查變成一個單獨的python包，你可以在新專案中重用它，也可以和其他人分享。

如果你沒有完成教程1-7，我們鼓勵你來複習這些所以你的例子專案符合下面的描述。

1. 可重用性很重要

設計，建立，測試和維護一個web應用有很多工作要做。許多Python和Django專案都有同樣的問題。如果我們可以省下這些重複的工作量難道不是很美好麼？

可重用性就像是Python中的生命一種方式。<Python包索引（PyPI）>有一個廣闊的包的範圍，你可以在你的專案中使用這些。查閱<Django 包>瞭解你可以在你專案中繼承的現存的可重用應用。Django本身就是一個Python包。這意味著你能將現存的Python包或者Django應用作為你自己網頁專案的組成部分。你只需要編寫是你專案獨一無二的部分。

假設你正在開始一個新的專案，它需要一個像我們之前工作的polls應用一樣的應用。你如何將這個應用重用？幸運的是，你已經在路上了。在教程(3)中，我們瞭解了我們可以使用include將polls從專案級的URLconf中解耦。在這個教程中，我們做更深入的幾步來讓應用更容易使用在新專案中，並且準備好釋出給其他人安裝和使用。

包？應用？

一個Python包提供了為了更容易重用的相關Python程式碼的組成的一種方式。一個包包含一個或者多個Python程式碼檔案(同樣也成為模組).

一個包能被使用import foo.bar或者from foo import bar匯入。用於組成一個包的路徑（像Polls），它必須包含一個特殊的檔案__init__.py，即使這個檔案是空的。

一個Django應用只是一個Python包，這個包專門用於Django的專案。一個應用可能使用通用的Django約束，例如，模組，測試，urls和views子模組。

稍後我們將使用術語”打包“來描述一個容易為其他人安裝的Python包的製作過程。它可能會有一點迷惑，我們知道。

2. 你的專案和你的可重用應用

經過先前的教程之後，我們的專案應該是這個樣子：

mysite/
    manage.py
    mysite/
        __init__.py
        settings.py
        urls.py
        wsgi.py
    polls/
        __init__.py
        admin.py
        migrations/
            __init__.py
            0001_initial.py
        models.py
        static/
            polls/
                images/
                    background.gif
                style.css
        templates/
            polls/
                detail.html
                index.html
                results.html
        tests.py
        urls.py
        views.py
    templates/
        admin/
            base_site.html
 

在教程(7)中你建立了mysite/templates，教程（3）中建立了polls/templates.也許現在很清晰為什麼我們為專案和應用選擇分開模板路徑：所有東西都是在polls中的polls應用的一部分。它讓應用自包含並且更容易變成一個新的專案。

polls目錄現在可以備份成一個新的Django專案並且可以立即使用。儘管它還沒有準備好釋出。要完成那個，我們需要打包應用好讓其他人更容易安裝。

3. 安裝一些先決條件

當前pyhon打包的狀態是有著各種工具的一團糟。對於這個教程，我們將使用setuptools來建立我們的包。他是推薦的打包工具（與分發合併）。我們同樣使用pip來安裝和解除安裝。你應該安裝這2個包。如果你需要幫助，你可以參考<如何使用pip安裝Django>。你可以以同樣的方式安裝setuptools。

4. 打包你的應用

Python打包指的是以一種特殊的格式準備你的應用，以讓它更容易安裝和使用。Django本身就是一個這樣的包。對於想polls這樣的小型應用來說，這個過程不會太難。

1. 首先，為polls建立愛你一個父路徑，在你的Django專案的外面。將這個路徑起名為django-polls                        為你的應用選擇一個名字                                                                                                                                                               當為你的包選擇名字時，檢查類似PyPI的源來避免和現有的包名稱衝突。當建立一個釋出的包時預先將django-加到你的名稱中將會很有幫助。這將幫助其他尋找Django應用的人將你的應用作為指定的Django識別。                                                          應用標籤（那是，應用包的點路徑的最後一部分）必須在INSTALLED_APPS中是獨一無二的。避免使用和Django的任何contrib包相同的標籤，例如auth,admin或者messages.
2. 將polls路徑移動到django-polls路徑
3. 建立一個檔案django-polls/README.rst使用下列程式碼：

   django-polls/README.rst
   =====
   Polls
   =====
   
   Polls is a simple Django app to conduct Web-based polls. For each
   question, visitors can choose between a fixed number of answers.
   
   Detailed documentation is in the "docs" directory.
   
   Quick start
   -----------
   
   1. Add "polls" to your INSTALLED_APPS setting like this::
   
       INSTALLED_APPS = [
           ...
           'polls',
       ]
   
   2. Include the polls URLconf in your project urls.py like this::
   
       url(r'^polls/', include('polls.urls')),
   
   3. Run `python manage.py migrate` to create the polls models.
   
   4. Start the development server and visit http://127.0.0.1:8000/admin/
      to create a poll (you'll need the Admin app enabled).
   
   5. Visit http://127.0.0.1:8000/polls/ to participate in the poll.

   
   
4. 建立一個django-polls/LICENSE檔案。選擇一個許可證對於這個教程來說超出了範圍，但足以說明沒有許可證的公開程式碼釋出是沒有用的。Django和許多Django相容應用是在BSD許可證下發布的；然而，你可以自由選擇你的許可證。請注意，你的許可證的選擇將會影響到使用你程式碼的人。
5. 下一步我們將建立一個setup.py檔案，它提供了關於如何去建立和安裝應用的明細。這個文件的完整解釋超出了這個教程的範圍，但是<安裝工具文件>有一個好的解釋。建立一個檔案django-polls/setup.py，並寫入以下程式碼：

   django-polls/setup.py
   import os
   from setuptools import find_packages, setup
   
   with open(os.path.join(os.path.dirname(__file__), 'README.rst')) as readme:
       README = readme.read()
   
   # allow setup.py to be run from any path
   os.chdir(os.path.normpath(os.path.join(os.path.abspath(__file__), os.pardir)))
   
   setup(
       name='django-polls',
       version='0.1',
       packages=find_packages(),
       include_package_data=True,
       license='BSD License',  # example license
       description='A simple Django app to conduct Web-based polls.',
       long_description=README,
       url='https://www.example.com/',
       author='Your Name',
       author_email='[email protected]',
       classifiers=[
           'Environment :: Web Environment',
           'Framework :: Django',
           'Framework :: Django :: X.Y',  # replace "X.Y" as appropriate
           'Intended Audience :: Developers',
           'License :: OSI Approved :: BSD License',  # example license
           'Operating System :: OS Independent',
           'Programming Language :: Python',
           # Replace these appropriately if you are stuck on Python 2.
           'Programming Language :: Python :: 3',
           'Programming Language :: Python :: 3.4',
           'Programming Language :: Python :: 3.5',
           'Topic :: Internet :: WWW/HTTP',
           'Topic :: Internet :: WWW/HTTP :: Dynamic Content',
       ],
   )

   
   
6. 只有Python模組和包預設是包含在包裡的。為了包含額外的檔案，我們需要建立一個MANIFEST.in檔案。<安裝工具文件>有更多這個檔案的細節。為了包含模板，README.rst和我們的LICENSE檔案，建立一個有以下內容的檔案django-polls/MANIFEST.in：

   django-polls/MANIFEST.in
   include LICENSE
   include README.rst
   recursive-include polls/static *
   recursive-include polls/templates *

   
   
7. 它是可選的，但是是推薦的，在你的應用中包含詳細的文件。建立一個空的路徑django-polls/docs，留給未來的文件。在django-polls/MANIFEST.in裡新增額外的一行：

   recursive-include docs *

   注意，docs路徑將不會包含在你的包裡除非你在它裡面添加了一些檔案。許多Django應用同樣提供他們的線上文件通過站點readthedocs.org.
8. 嘗試使用python setup.py sdist(在django-polls內部執行)來建立你的包。這建立一個路徑成為dist並且建立了你的新包，django-polls-0.1.tar.gz.

瞭解打包的更多詳情，請閱讀Python的<打包和釋出專案教程>

5. 使用你自己的包

因為我們將polls路徑移出了專案，它不再起作用。我們現在通過安裝我們新的django-polls包來修復這個問題。

作為使用者庫安裝

下列步驟將django-polls作為一個使用者庫來安裝。基於使用者的安裝比在系統範圍安裝包有很大的優勢，例如在一個你沒有管理員許可權的系統上使用，防止包影響系統服務和其他使用者的機器。

注意，基於使用者的安裝仍然能影響作為那個使用者執行的統工具的行為，所以virtualenv是更優秀的解決方案（看下面）

1. 為了安裝包，使用pip（你已經安裝過了，對嗎？）：

   pip install --user django-polls/dist/django-polls-0.1.tar.gz

   
   
2. 幸運的話，你的Django專案想在應該能再次正確運行了。執行服務來確認這一點
3. 解除安裝包，使用pip：

   pip uninstall django-polls

   
   

6. 釋出你的應用

• 將包郵件給你的朋友
• 上傳包到你的網站
• 釋出到公用倉庫，例如 Python包索引(PyPI).packaging.python.org有一個做這個的好的教程。

7. 使用virtualenv安裝Python包

• 修改使用者庫將會影響你係統上的其他Python軟體
• 你不能執行這個包的多個版本(或者其他有相同名字的東西)。