Denna avancerade handledning börjar där Handledning 8 slutade. Vi kommer att förvandla vår webbenkät till ett fristående Python-paket som du kan återanvända i nya projekt och dela med andra människor.
\nOm du inte nyligen har slutfört Tutorials 1-8, uppmanar vi dig att gå igenom dessa så att ditt exempelprojekt överensstämmer med det som beskrivs nedan.
\nDet är mycket arbete att designa, bygga, testa och underhålla en webbapplikation. Många Python- och Django-projekt delar gemensamma problem. Skulle det inte vara bra om vi kunde spara en del av detta upprepade arbete?
\nÅteranvändbarhet är livsstilen i Python. Python Package Index (PyPI) har ett stort utbud av paket som du kan använda i dina egna Python-program. Kolla in Django Packages för befintliga återanvändbara appar som du kan införliva i ditt projekt. Django i sig är också ett normalt Python-paket. Det innebär att du kan ta befintliga Python-paket eller Django-appar och komponera dem till ditt eget webbprojekt. Du behöver bara skriva de delar som gör ditt projekt unikt.
\nLåt oss säga att du startar ett nytt projekt som behöver en app för opinionsundersökningar, som den vi har arbetat med. Hur gör du den här appen återanvändbar? Lyckligtvis, du är på god väg redan. I Tutorial 1 såg vi hur vi kunde frikoppla polls från URLconf på projektnivå med hjälp av en include. I den här handledningen tar vi ytterligare steg för att göra appen enkel att använda i nya projekt och redo att publicera så att andra kan installera och använda den.
Efter de tidigare handledningarna bör vårt projekt se ut så här:
\ndjangotutorial/\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.png\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\nDu skapade djangotutorial/templates i Tutorial 7, och polls/templates i Tutorial 3. Nu kanske det är tydligare varför vi valde att ha separata mallkataloger för projektet och applikationen: allt som är en del av pollsapplikationen finns i polls. Det gör applikationen fristående och lättare att släppa in i ett nytt projekt.
Katalogen polls kan nu kopieras till ett nytt Django-projekt och omedelbart återanvändas. Den är dock inte riktigt redo att publiceras. För det måste vi paketera appen för att göra det enkelt för andra att installera den.
Det nuvarande läget för Python-paketering är lite förvirrat med olika verktyg. För denna handledning kommer vi att använda setuptools för att bygga vårt paket. Det är det rekommenderade förpackningsverktyget (sammanslaget med distribute-gaffeln). Vi kommer också att använda pip för att installera och avinstallera det. Du bör installera dessa två paket nu. Om du behöver hjälp kan du läsa så här installerar du Django med pip. Du kan installera setuptools på samma sätt.
Python packaging hänvisar till att förbereda din app i ett specifikt format som enkelt kan installeras och användas. Django själv är förpackat mycket på detta sätt. För en liten app som polls är denna process inte alltför svår.
\nFörst skapar du en överordnad katalog för paketet, utanför ditt Django-projekt. Kalla den här katalogen django-polls.
Flytta katalogen polls till katalogen django-polls och döp om den till django_polls.
Redigera django_polls/apps.py så att name refererar till det nya modulnamnet, lägg till label för att ge appen ett kort namn och ange default_auto_field för att säkerställa att dina migreringar inte påverkas av ändringar av DEFAULT_AUTO_FIELD som görs av användare av din återanvändbara app:
django-polls/django_polls/apps.pyfrom django.apps import AppConfig\n\n\nclass PollsConfig(AppConfig):\n default_auto_field = "django.db.models.BigAutoField"\n name = "django_polls"\n label = "polls"\nSkapa en fil django-polls/README.rst med följande innehåll:
django-polls/README.rst============\ndjango-polls\n============\n\ndjango-polls is a Django app to conduct web-based polls. For each\nquestion, visitors 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 "django_polls",\n ]\n\n2. Include the polls URLconf in your project urls.py like this::\n\n path("polls/", include("django_polls.urls")),\n\n3. Run ``python manage.py migrate`` to create the models.\n\n4. Start the development server and visit the admin to create a poll.\n\n5. Visit the ``/polls/`` URL to participate in the poll.\nSkapa en fil med namnet django-polls/LICENSE. Att välja en licens ligger utanför ramen för denna handledning, men det räcker med att säga att kod som släpps offentligt utan licens är användbar. Django och många Django-kompatibla appar distribueras under BSD-licensen; du är dock fri att välja din egen licens. Var bara medveten om att ditt licensval kommer att påverka vem som kan använda din kod.
Därefter skapar vi filen pyproject.toml som beskriver hur appen ska byggas och installeras. En fullständig förklaring av den här filen ligger utanför ramen för denna handledning, men Python Packaging User Guide har en bra förklaring. Skapa filen django-polls/pyproject.toml med följande innehåll:
django-polls/pyproject.toml[build-system]\nrequires = ["setuptools>83"]\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"\nlicense = "BSD-3-Clause"\nrequires-python = ">= 3.12"\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 "Operating System :: OS Independent",\n "Programming Language :: Python",\n "Programming Language :: Python :: 3",\n "Programming Language :: Python :: 3 :: Only",\n "Programming Language :: Python :: 3.12",\n "Programming Language :: Python :: 3.13",\n "Programming Language :: Python :: 3.14",\n "Topic :: Internet :: WWW/HTTP",\n "Topic :: Internet :: WWW/HTTP :: Dynamic Content",\n]\n\n[project.urls]\nHomepage = "https://www.example.com/"\nMånga vanliga filer och Python-moduler och -paket ingår i paketet som standard. För att inkludera ytterligare filer måste vi skapa en fil MANIFEST.in. För att inkludera mallarna och de statiska filerna skapar du en fil django-polls/MANIFEST.in med följande innehåll:
django-polls/MANIFEST.inrecursive-include django_polls/static *\nrecursive-include django_polls/templates *\nDet är valfritt, men rekommenderas, att inkludera detaljerad dokumentation med din app. Skapa en tom katalog django-polls/docs för framtida dokumentation.
Observera att katalogen docs inte kommer att ingå i ditt paket om du inte lägger till några filer i den. Många Django-appar tillhandahåller också sin dokumentation online via webbplatser som readthedocs.org.
Många Python-projekt, inklusive Django och Python självt, använder Sphinx för att bygga sin dokumentation. Om du väljer att använda Sphinx kan du länka tillbaka till Djangos dokumentation genom att konfigurera Intersphinx och inkludera ett värde för Django i ditt projekts intersphinx_mapping värde:
intersphinx_mapping = {\n # ...\n "django": (\n "https://docs.djangoproject.com/en/stable/",\n None,\n ),\n}\nMed det på plats kan du sedan korslänka till specifika poster, på samma sätt som i Django-dokumenten, till exempel ”:attr:`django.test.TransactionTestCase.databases”.
Kontrollera att paketet build är installerat (python -m pip install build) och försök bygga ditt paket genom att köra python -m build inuti django-polls. Detta skapar en katalog som heter dist och bygger ditt nya paket till källkods- och binärformat, django_polls-0.1.tar.gz och django_polls-0.1-py3-none-any.whl.
Mer information om paketering finns i Pythons Tutorial on Packaging and Distributing Projects.
\nEftersom vi flyttade katalogen polls ut ur projektet fungerar den inte längre. Vi ska nu åtgärda detta genom att installera vårt nya paket django-polls.
För att installera paketet använder du pip (du har redan installerat det, eller hur?):
\npython -m pip install --user django-polls/dist/django_polls-0.1.tar.gz\nUppdatera mysite/settings.py för att peka på det nya modulnamnet:
INSTALLED_APPS = [\n "django_polls.apps.PollsConfig",\n ...,\n]\nUppdatera mysite/urls.py för att peka på det nya modulnamnet:
urlpatterns = [\n path("polls/", include("django_polls.urls")),\n ...,\n]\nKör utvecklingsservern för att bekräfta att projektet fortsätter att fungera.
Nu när vi har paketerat och testat django-polls, är det redo att dela med sig till världen! Om detta inte bara var ett exempel, kan du nu:
Skicka paketet till en vän via e-post.
Ladda upp paketet på din webbplats.
Publicera paketet på ett offentligt arkiv, som the Python Package Index (PyPI). Det finns en bra handledning för hur du gör detta.
Tidigare installerade vi django-polls som ett användarbibliotek. Detta har några nackdelar:
Om du ändrar användarbiblioteken kan det påverka andra Python-program på ditt system.
Du kommer inte att kunna köra flera versioner av det här paketet (eller andra med samma namn).
Vanligtvis uppstår dessa situationer först när du underhåller flera Django-projekt. När de gör det är den bästa lösningen att använda venv. Med det här verktyget kan du underhålla flera isolerade Python-miljöer, var och en med sin egen kopia av biblioteken och paketnamnrymden.
\n