Hal-hal dapat digunakan kembali¶

Adalah pekerjaan banyak untuk merancang, membangun, mencoba dan merawat aplikasi jaringan. Banyak proyek Phyton dan Django berbagi masalah umum. Bukankah bagus jika kami dapat menyimpan beberapa pekerjaan berulang ini?

Dapat digunakan kembali adalah cara hidup dalam Python. The Python Package Index (PyPI) memiliki jangkauan luas dari paket-paket anda dapat gunakan dalam program Python anda. Periksa Django Packages untuk aplikasi-aplikasi yang dapat digunakan kembali yang anda anda dapat bekerjasama dalam proyek anda. Django itu sendiri merupakan paket biasa Python. Ini berarti bahwa anda dapat mengambil paket Python yang ada atau aplikasi Django dan menyusun mereka kedalam proyek jaringan anda sendiri. Anda hanya butuh menulis bagian yang membuat proyek anda unik.

Mari kita katakan anda sedang memulai proyek baru yang butuh aplikasi jejak pendapat seperti satu yang kite telah kerjakan. Bagaimana anda ingin membuat aplikasi ini dapat digunakan kembali? Untungnya, anda sudah sedang dalam perjalanan. Dalam Tutorial 1, kai lihat bagaimana kami dapat memisahkan jejak pendapat dari URLconf tingkat-proyek menggunakan include. Dalam tutorial ini, kami akan mengambil langkah lebih jauh untuk membuat aplikasi lebih mudah digunakan dalam proyek baru dan siap untuk diterbitkan untuk lainnya untuk dipasang dan digunakan.

Proyek anda dan aplikasi digunakan kembali anda¶

After the previous tutorials, our project should look like this:

mysite/
    manage.py
    mysite/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py
    polls/
        __init__.py
        admin.py
        apps.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

Anda membuat mysite/template di doc:Tutorial 7 </intro/tutorial07>`, dan “polls/templates` di :doc: Tutorial 3 </intro/tutorial03>`. Sekarang tampak lebih jelas mengapa kita memilih direktori templat yang berbeda untuk project dan aplikasi: semua yang merupakan bagian aplikasi polls di dalam “polls`. Hal ini membuat aplikasi berdiri-sendiri dan lebih mudah untuk membuat projek baru.

Direktori polls sekarang dapat disalin kedalam proyek Django baru dan segera digunakan kembali. Dia tidak siap untuk diterbitkan. Untuk itu, kami butuh untuk memaketkan aplikasi agar membuatnya mudah untuk lainnya dipasang.

Memasang beberapa prasyarat¶

The current state of Python packaging is a bit muddled with various tools. For this tutorial, we’re going to use setuptools to build our package. It’s the recommended packaging tool (merged with the distribute fork). We’ll also be using pip to install and uninstall it. You should install these two packages now. If you need help, you can refer to how to install Django with pip. You can install setuptools the same way.

Memaketkan aplikasi anda¶

Pemaketan Phyton mengacu pada menyiapkan aplikasi anda di bentuk khusus yang dapat mudah dipasang dan digunakan. Django itu sendiri dipaketkan seperti ini. Untuk aplikasi jecil seperti jejak pendapat, pengolahan ini tidak terlalu sulit.

1. Pertama, buat direktori induk untuk polls, diluar dari proyek Django anda. Panggil direktori ini django-polls.

   Memilih nama dari aplikasi anda

   Ketika memilih nama untuk paket anda, periksa sumber daya seperti PyPI untuk menghindari penamaan bertentangan dengan paket yang anda. Ini sering berguna untuk menambahkan django- ke nama modul ketika membuat paket untuk dibagikan. Ini membantu lainnya mencari aplikasi Django mencirikan aplikasi anda sebagai khas Django.

   Label aplikasi (yaitu, bagian akhir dari jalur bertitik ke paket aplikasi) harus unik di INSTALLED_APPS. Hindari menggunakan label sama seperti Django contrib packages, sebagai contoh auth, admin, or messages.

2. Pindahkan direktori poll kedalam direktori django-polls.

3. Buat berkas django-polls/README.rst dengan isi berikut:

   django-polls/README.rst¶

   =====
   Polls
   =====
   
   Polls is a 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::
   
       path("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. Buat berkas django-polls/LICENSE. Memilih lisensi diluar lingkup dari tutorial ini, tetapi mencukupinya untuk dikatakan bahwa kode diterbitkan umum tanpa lisensi adalah tidak berguna. Django dan banyak aplikasi Sesuai-Django disebarkan dibawah lisensi BSD; bagaimanapun, anda bebas mengambil lisensi anda sendiri. Hanya waspada bahwa pilihan lisensi anda akan mempengaruhi siapa yang dapat menggunakan kode anda.

5. Selanjutnya kami akan membuat berkas pyproject.toml, setup.cfg, dan setup.py yang merinci bagaimana membangun dan memasang aplikasi. Penjelasan penuh dari berkas ini diluar cakupan tutorial, tetapi setuptools documentation mempunyai penjelasan yang bagus. Buat berkas django-polls/pyproject.toml, django-polls/setup.cfg, dan django-polls/setup.py dengan isi berikut:

   django-polls/pyproject.toml¶

   [build-system]
   requires = ['setuptools>=40.8.0']
   build-backend = 'setuptools.build_meta'
   

   django-polls/setup.cfg¶

   [metadata]
   name = django-polls
   version = 0.1
   description = A Django app to conduct web-based polls.
   long_description = file: README.rst
   url = https://www.example.com/
   author = Your Name
   author_email = yourname@example.com
   license = BSD-3-Clause  # Example license
   classifiers =
       Environment :: Web Environment
       Framework :: Django
       Framework :: Django :: X.Y  # Replace "X.Y" as appropriate
       Intended Audience :: Developers
       License :: OSI Approved :: BSD License
       Operating System :: OS Independent
       Programming Language :: Python
       Programming Language :: Python :: 3
       Programming Language :: Python :: 3 :: Only
       Programming Language :: Python :: 3.8
       Programming Language :: Python :: 3.9
       Programming Language :: Python :: 3.10
       Programming Language :: Python :: 3.11
       Programming Language :: Python :: 3.12
       Topic :: Internet :: WWW/HTTP
       Topic :: Internet :: WWW/HTTP :: Dynamic Content
   
   [options]
   include_package_data = true
   packages = find:
   python_requires = >=3.8
   install_requires =
       Django >= X.Y  # Replace "X.Y" as appropriate
   

   django-polls/setup.py¶

   from setuptools import setup
   
   setup()
   

6. Only Python modules and packages are included in the package by default. To include additional files, we’ll need to create a MANIFEST.in file. The setuptools docs referred to in the previous step discuss this file in more detail. To include the templates, the README.rst and our LICENSE file, create a file django-polls/MANIFEST.in with the following contents:

   django-polls/MANIFEST.in¶

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

7. It’s optional, but recommended, to include detailed documentation with your app. Create an empty directory django-polls/docs for future documentation. Add an additional line to django-polls/MANIFEST.in:

   recursive-include docs *
   

   Catat bahwa direktori docs tidak akan disertakan dalam paket anda meskipun anda menambahkan beberapa berkas ke dalamnya. Banyak aplikasi Django juga menyediakan dokumentasi darin mereka melalui situs seperti readthedocs.org.

8. Coba membangun paket anda dengan python setup.py sdist (jalankan dari dalam django-polls). Ini membuat direktori dipanggil dist dan bangun paket baru anda, django-polls-0.1.tar.gz.

Untuk informasi lebih pada pemaketan, lihat Tutorial on Packaging and Distributing Projects Python.

Menggunakan paket anda sendiri¶

Sejak kami memindahkan direktori polls diluar proyek, dia tidak lagi bekerja. Kami akan sekarang memperbaiki ini dengan memasang paket django-polls baru.

1. To install the package, use pip (you already installed it, right?):

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

2. Dengan keberuntungan, proyek Django anda seharusnya sekarang bekerja dengan benar kembali. Jalankan peladen kembali untuk menegaskan ini.

3. To uninstall the package, use pip:

   python -m pip uninstall django-polls
   

Keluarkan aplikasi anda¶

Sekarang bahwa kita telah memaketkan dan mengujikan django-polls, dia sudah siap dibagi dengan dunia! Jika ini bukan contoh, anda dapat melakukannya sekarang:

• Surel paket ke teman.
• Unggah paket di situs jaringan anda.
• Tempatkan paket pada gudang umum, seperti the Python Package Index (PyPI). packaging.python.org mempunyai a good tutorial untuk melakukan ini.

Menginstal paket Python dengan lingkungan virtual¶

Sebelumnya, kami memasalang aplikasi poling sebagai pustaka pengguna. Ini mempunyai beberapa kerugian:

• Merubah pustaka pengguna dapat berakibat perangkat lunak Phyton lain di sistem anda.
• Anda tidak dapat menjalankan versi banyak dari paket ini (atau lainnya dengan nama sama disini).

Khususnya, keadaan ini dapat hanya muncul ketika anda sedang merawat beberapa proyek Django. Ketika mereka melakukannya, pemecahan terbaik adalah menggunakan venv. Alat ini mengizinkan anda merawat banyak lingkungan Python terpencil, masing-masing dengan salinannya sendiri dari pustaka dan paket namespace.