This advanced tutorial begins where Tutorial 8\nleft off. We’ll be turning our web-poll into a standalone Python package\nyou can reuse in new projects and share with other people.
\nSe non hai completato di recente i Tutorial 1–7, ti invitiamo a rivederli in modo che il tuo progetto di esempio corrisponda a quello descritto di seguito.
\nCi vuole molto lavoro per progettare, costruire, testare e manutenere una applicazione web. Alcuni progetti in Python e Django condividono problemi comuni.\nNon sarebbe fantastico se potessimo risparmiare parte di questo lavoro ripetuto?
\nLa riusabilità è uno stile di vita in Python. Il Python Package Index (PyPI) <https://pypi.org/> offre una vasta gamma di package che puoi usare nei tuoi programmi Python. Dai un’occhiata agli Django Packages per trovare app riutilizzabili da incorporare nei tuoi progetti. Django stesso è un normale package. Questo significa che puoi prendere package Django esistenti o app Django e comporli nel tuo progetto web. Devi solo scrivere le parti che rendono il tuo progetto unico.
\nDiciamo che tu stia iniziando un nuovo progetto che necessita di una applicazione di questionari come quella su cui abbiamo lavorato. Come rendi quest’app riutilizzabile? Fortunatamente, sei già un passo avanti. Nel Tutorial 1, abbiamo detto come disaccoppiare polls dalla configurazione delle URL a livello di progetto usando include. In questo tutorial, faremo altri passi per rendere l’app facilmente utilizzabile in progetti nuovi e pronta da pubblicare affinchè altri possano installarla ed usarla.
After the previous tutorials, our project should look like this:
\nmysite/\n manage.py\n mysite/\n __init__.py\n settings.py\n urls.py\n asgi.py\n wsgi.py\n polls/\n __init__.py\n admin.py\n apps.py\n migrations/\n __init__.py\n 0001_initial.py\n models.py\n static/\n polls/\n images/\n background.gif\n style.css\n templates/\n polls/\n detail.html\n index.html\n results.html\n tests.py\n urls.py\n views.py\n templates/\n admin/\n base_site.html\nHai creato mysite/templates in Tutorial 7 </intro/tutorial07> e `polls/templates` in :doc:`Tutorial 3 </intro/tutorial03>. Ora forse è più chiaro perchè abbiamo scelto di separare le directories con i template tra progetto e applicazione: tutto ciò che fa parte dell’applicazione «polls» è dentro «polls». Questo rende l’applicazione più facile da rilasciare in un nuovo progetto poichè contiene tutte le informazioni dentro di se.
\nLa directory polls può essere copiata in un nuovo progetto Django e immediatamente riutilizzata. Non è completamente pronta per essere pubblicata. Per questo, dobbiamo creare un pacchetto dall’app per semplificare l’installazione da parte di altri.
The current state of Python packaging is a bit muddled with various tools. For\nthis tutorial, we’re going to use setuptools to build our package. It’s\nthe recommended packaging tool (merged with the distribute fork). We’ll\nalso be using pip to install and uninstall it. You should install these\ntwo packages now. If you need help, you can refer to how to install\nDjango with pip. You can install setuptools\nthe same way.
Il packaging Python si riferisce al preparare la tua app in un formato specifico che può essere facilmente installato e riutilizzato. Django stesso è «impacchettato» così. Per piccole app come polls, è un processo non molto difficile.
\nPrimo, crea una directory principale per polls, all’esterno del tuo progetto Django. Nomina questa cartella django-polls.
Sposta la cartella polls nella cartella django-polls.
Crea un file django-polls/README.rst con il seguente contenuto:
django-polls/README.rst=====\nPolls\n=====\n\nPolls is a Django app to conduct web-based polls. For each question,\nvisitors can choose between a fixed number of answers.\n\nDetailed documentation is in the "docs" directory.\n\nQuick start\n-----------\n\n1. Add "polls" to your INSTALLED_APPS setting like this::\n\n INSTALLED_APPS = [\n ...,\n "polls",\n ]\n\n2. Include the polls URLconf in your project urls.py like this::\n\n path("polls/", include("polls.urls")),\n\n3. Run ``python manage.py migrate`` to create the polls models.\n\n4. Start the development server and visit http://127.0.0.1:8000/admin/\n to create a poll (you'll need the Admin app enabled).\n\n5. Visit http://127.0.0.1:8000/polls/ to participate in the poll.\nCrea un file ``django-polls/LICENSE`. Scegliere una licenza è oltre lo scopo di questo tutorial, ma è sufficiente dire che il codice rilasciato pubblicamente senza licenza è inutile. Django e molte app Django-compatibili sono distribuite sotto la licenza BSD; comunque, sei libero di scegliere la licenza che preferisci. Sii solo consapevole che la licenza che scegli influenzerà anche quelli che usano il tuo codice.
Next we’ll create the pyproject.toml file which details how to build and\ninstall the app. A full explanation of this file is beyond the scope of this\ntutorial, but the Python Packaging User Guide has a good\nexplanation. Create the django-polls/pyproject.toml file with the\nfollowing contents:
django-polls/pyproject.toml[build-system]\nrequires = ["setuptools>=69.3"]\nbuild-backend = "setuptools.build_meta"\n\n[project]\nname = "django-polls"\nversion = "0.1"\ndependencies = [\n "django>=X.Y", # Replace "X.Y" as appropriate\n]\ndescription = "A Django app to conduct web-based polls."\nreadme = "README.rst"\nrequires-python = ">= 3.8"\nauthors = [\n {name = "Your Name", email = "yourname@example.com"},\n]\nclassifiers = [\n "Environment :: Web Environment",\n "Framework :: Django",\n "Framework :: Django :: X.Y", # Replace "X.Y" as appropriate\n "Intended Audience :: Developers",\n "License :: OSI Approved :: BSD License",\n "Operating System :: OS Independent",\n "Programming Language :: Python",\n "Programming Language :: Python :: 3",\n "Programming Language :: Python :: 3 :: Only",\n "Programming Language :: Python :: 3.8",\n "Programming Language :: Python :: 3.9",\n "Programming Language :: Python :: 3.10",\n "Programming Language :: Python :: 3.11",\n "Programming Language :: Python :: 3.12",\n "Topic :: Internet :: WWW/HTTP",\n "Topic :: Internet :: WWW/HTTP :: Dynamic Content",\n]\n\n[project.urls]\nHomepage = "https://www.example.com/"\nMany common files and Python modules and packages are included in the\npackage by default. To include additional files, we’ll need to create a\nMANIFEST.in file. To include the templates and static files, create a\nfile django-polls/MANIFEST.in with the following contents:
django-polls/MANIFEST.inrecursive-include polls/static *\nrecursive-include polls/templates *\nIt’s optional, but recommended, to include detailed documentation with your\napp. Create an empty directory django-polls/docs for future\ndocumentation.
Nota che la directory docs non verrà inclusa nel tuo package finchè non ci aggiungi dei file. Molte Django app offrono la loro documentazione online anche attraverso siti come readthedocs.org.
Check that the build package is installed (python -m pip install\nbuild) and try building your package by running python -m build inside\ndjango-polls. This creates a directory called dist and builds your\nnew package into source and binary formats, django_polls-0.1.tar.gz and\ndjango_polls-0.1-py3-none-any.whl.
Per ulteriori informazioni sul packaging, vedi il tutorial di Python Tutorial sul Packaging e la Distribuzione di Progetti.
\nDato che abbiamo spostato la cartella polls fuori dal nostro progetto, non funziona più. Possiamo sistemare questo problema, installando il nuovo nostro package django-polls.
To install the package, use pip (you already installed it, right?):
\npython -m pip install --user django-polls/dist/django_polls-0.1.tar.gz\nCon un pizzico di fortuna, il tuo progetto Django ora dovrebbe nuovamente funzionare correttamente. Esegui il server di nuovo per confermare.
To uninstall the package, use pip:
\npython -m pip uninstall django-polls\nOra che abbiamo creato e testato il package django-polls, è pronto per essere condiviso con il mondo! Se questo non era solo un esempio, potresti fare ora:
Manda via mail il package ad un amico.
Uploada il pacchetto sul tuo sito web
Metti il package su un repository pubblico come il Python Package Index (PyPI). packaging.python.org <https://packaging.python.org>`_ offre un bel tutorial <https://packaging.python.org/tutorials/packaging-projects/#uploading-the-distribution-archives>`_ per farlo.
Prima, abbiamo installato la app polls come una libreria utente. Questo però ha dei svantaggi:
\nModificare le librerie delle utenze può danneggiare altri software Python installati nel tuo sistema.
Non sarai in grado di eseguire multiple versioni di questo pacchetto ( o altri con lo stesso nome ).
Tipicamente, queste situazioni accadono quando manutieni svariati progetti Django. In questo caso, la miglior soluzione è usare venv. Questo tool ti permette di mantenere più ambienti Python isolati, ognuno con la propria copia delle librerie ed un namespace proprio.
\n