{"title":"Zaawansowany tutorial: Jak pisać aplikacje wielokrotnego użytku","version":"4.0","locale":"pl","docname":"intro/reusable-apps","url":"/pl/4.0/intro/reusable-apps/","canonical":"https://djangodocs.dev/pl/4.0/intro/reusable-apps/","summary":"Ten tutorial dla zaawansowanych zaczyna się, gdzie Tutorial 7 się skończył. Będziemy przerabiać naszą web-ankietę na samodzielny pakiet Pythona, który…","html":"

Zaawansowany tutorial: Jak pisać aplikacje wielokrotnego użytkuLink to this heading#

\n

Ten tutorial dla zaawansowanych zaczyna się, gdzie Tutorial 7 się skończył. Będziemy przerabiać naszą web-ankietę na samodzielny pakiet Pythona, który będziesz mógł wykorzystać w nowym projekcie i którym będziesz mógł podzielić się z innymi.

\n

Jeśli nie ukończyłeś niedawno Tutoriali 1–7, zachęcamy cię do powtórzenia ich, aby twój przykładowy projekt pasował do tego opisanego poniżej.

\n
\n

Możliwość ponownego użycia ma znaczenieLink to this heading#

\n

Zaprojektować, zbudować, przetestować i utrzymywać aplikację webową to bardzo dużo pracy. Wiele projektów w Pythonie i Django napotyka wspólne problemy. Czy nie byłoby super, jeśli moglibyśmy oszczędzić części tej powtarzanej pracy?

\n

Ponowne wykorzystanie to sposób na życie w Pythonie. Python Package Index (PyPI) zawiera obszerny zakres pakietów, które możesz wykorzystać w swoich własnych pythonowych programach. Sprawdź w Django Packages istniejące aplikacje gotowe do wykorzystania, które mógłbyś wcielić w swój projekt. Samo Django także jest normalnym pythonowym pakietem. To znaczy, że możesz wziąć istniejące pakiety Pythona lub aplikacje Django i złożyć z nich swój własny projekt webowy. Musisz jedynie napisać części, które uczynią twój projekt unikalnym.

\n

Powiedzmy, że zaczynałeś nowy projekt, który potrzebował aplikacji z ankietą, takiej jak ta, nad którą pracowaliśmy. Jak uczynić tą aplikację gotową do wykorzystania przez innych? Na szczęście, jesteśmy już na dobrej drodze. W Tutorialu 1 widzieliśmy jak możemy wydzielić ankiety z URLconfa na poziomie projektu przez użycie include. W tym tutorialu poczynimy dalsze kroki, aby uczynić aplikację łatwą do użycia w nowych projektach i gotową do publikacji, aby inni mogli ją zainstalować i używać.

\n\n
\n
\n

Twój projekt i twoja aplikacja do ponownego wykorzystaniaLink to this heading#

\n

Po poprzednich tutorialach, nasz projekt powinien wyglądać tak:

\n
Code
mysite/\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\n
\n

Stworzyłeś mysite/templates w Tutorialu 7 i polls/templates w Tutorialu 3. Teraz prawdopodobnie jest jaśniejsze dlaczego postanowiliśmy mieć osobne katalogi szablonów dla projektu i aplikacji: wszystko, co jest częścią aplikacji ankietowej jest w polls. To powoduje, że aplikacja jest w jednym kawałku i prościej ją wrzucić w nowy projekt.

\n

Katalog polls mógłby być teraz skopiowany do nowego projektu Django i od razu użyty. Ale nie jest zupełnie gotowy do bycia opublikowanym. Na tę potrzebę, musimy spakować naszą aplikację, aby ułatwić innym jej instalację.

\n
\n
\n

Instalowanie narzędziLink to this heading#

\n

Bieżący stan pakietowania w Pythonie jest nieco zagmatwany przez wiele narzędzi. Na potrzeby tego tutorialu, użyjemy setuptools, aby zbudować nasz pakiet. Są one zalecanym narzędziem pakietowania (zmergowane z forkiem distribute). Będziemy też używać pipa, aby go zainstalować i odinstalować. Powinieneś teraz zainstalować te dwa pakiety. Jeśli potrzebujesz pomocy, możesz zajrzeć do jak zainstalować Django używając pipa. W ten sam sposób możesz zainstalować setuptools.

\n
\n
\n

Pakowanie twojej aplikacjiLink to this heading#

\n

Pythonowe pakietowanie oznacza przygotowane twojej aplikacji w określonym formacie, który będzie mógł być prosto zainstalowany i użyty. Samo Django jest zapakowane właśnie w ten sposób. Dla małej aplikacji jak ankiety, ten proces nie jest zbyt skomplikowany.

\n
    \n

  1. Najpierw stwórz katalog nadrzędny dla polls, poza swoim projektem Django. Nazwij ten katalog django-polls.

    \n\n
    2. \n

  2. Przenieś katalog polls do katalogu django-polls.

    3. \n

  3. Stwórz plik django-polls/README.rst o następującej treści:

    \n
    django-polls/README.rst
    \n
    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.\n
    \n
    4. \n

  4. Stwórz plik django-polls/LICENSE. Wybór licencji jest poza zakresem tego tutorialu, ale wystarczy powiedzieć, że kod wydany publicznie bez licencji jest bezużyteczny. Django i wiele kompatybilnych z Django aplikacji są rozpowszechniane na licencji BSD, aczkolwiek ty możesz wybrać swoją własną licencję. Bądź tylko świadom, że wybór licencji będzie miał wpływ na to, kto może używać twój kod.

    5. \n

  5. Następnie stworzymy pliki pyproject.toml, setup.cfg i setup.py, które uszczegóławiają jak zbudować i zainstalować aplikację. Pełne wytłumaczenie tych plików nie należy do tego tutorialu, ale dokumentacja setuptools ma dobre wytłumaczenie. Stwórz pliki django-polls/pyproject.toml, django-polls/setup.cfg i django-polls/setup.py z następującą treścią:

    \n
    django-polls/pyproject.toml
    \n
    Toml
    [build-system]\nrequires = ['setuptools>=40.8.0', 'wheel']\nbuild-backend = 'setuptools.build_meta:__legacy__'\n
    \n
    django-polls/setup.cfg
    \n
    Ini
    [metadata]\nname = django-polls\nversion = 0.1\ndescription = A Django app to conduct web-based polls.\nlong_description = file: README.rst\nurl = https://www.example.com/\nauthor = Your Name\nauthor_email = yourname@example.com\nlicense = BSD-3-Clause  # Example license\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    Topic :: Internet :: WWW/HTTP\n    Topic :: Internet :: WWW/HTTP :: Dynamic Content\n\n[options]\ninclude_package_data = true\npackages = find:\npython_requires = >=3.8\ninstall_requires =\n    Django >= X.Y  # Replace "X.Y" as appropriate\n
    \n
    django-polls/setup.py
    \n
    Python
    from setuptools import setup\n\nsetup()\n
    \n
    6. \n

  6. Domyślnie tylko pythonowe moduły i pakiety zawierają się w pakiecie. Aby zawrzeć dodatkowe pliki, musimy stworzyć plik MANIFEST.in. Dokumentacja setuptools, do której odsyłaliśmy w poprzednim punkcie, opisuje ten plik szczegółowo. Aby zawrzeć szablony, pliki README.rst i LICENSE, stwórz plik django-polls/MANIFEST.in o następującej treści:

    \n
    django-polls/MANIFEST.in
    \n
    Text
    include LICENSE\ninclude README.rst\nrecursive-include polls/static *\nrecursive-include polls/templates *\n
    \n
    7. \n

  7. Opcjonalne, ale zalecane, jest zawarcie szczegółowej dokumentacji w twojej aplikacji. Stwórz pusty katalog django-polls/docs na przyszłą dokumentację. Dodaj nową linię w django-polls/MANIFEST.in:

    \n
    Code
    recursive-include docs *\n
    \n

    Zwróć uwagę, że katalog docs nie zostanie zawarty w twoim pakiecie dopóki nie dodasz do niego jakichś plików. Wiele aplikacji Django dostarcza swoją dokumentację online przez strony takie jak readthedocs.org.

    \n
    8. \n

  8. Spróbuj zbudować swój pakiet używając python setup.py sdist (uruchom z wnętrza django-polls). Stworzy to katalog o nazwie dist i zbuduje twój nowy pakiet, django-polls-0.1.tar.gz.

    9. \n
\n

Aby dowiedzieć się więcej na temat pakowania, zobacz tutorial Packaging Python Projects.

\n
\n
\n

Używanie twojego własnego pakietuLink to this heading#

\n

Odkąd przenieśliśmy katalog polls poza projekt, nie działa. Naprawimy to teraz instalując nasz nowy pakiet django-polls.

\n\n
    \n

  1. Aby zainstalować pakiet, użyj pipa (już go zainstalowałeś, prawda?):

    \n
    Code
    python -m pip install --user django-polls/dist/django-polls-0.1.tar.gz\n
    \n
    2. \n

  2. Z odrobiną szczęścia, twój projekt Django powinien teraz działać znów poprawnie. Uruchom serwer ponownie, aby to potwierdzić.

    3. \n

  3. Aby odinstalować pakiet, użyj pipa:

    \n
    Code
    python -m pip uninstall django-polls\n
    \n
    4. \n
\n
\n
\n

Publikowanie twojej aplikacjiLink to this heading#

\n

Teraz, kiedy już spakowaliśmy i przetestowaliśmy django-polls, są gotowe do podzielenia się ze światem! Gdyby to nie był tylko przykład, mógłbyś teraz:

\n\n
\n
\n

Instalowanie pakietów Pythona z wirtualnym środowiskiemLink to this heading#

\n

Wcześniej zainstalowaliśmy aplikację ankietową jako bibliotekę użytkownika. Ma to pewne wady:

\n\n

Zazwyczaj takie sytuacje zdarzają się tylko kiedy utrzymujesz kilka projektów Django. W takiej sytuacji najlepszym rozwiązaniem jest venv <python:tutorial/venv>. To narzędzie pozwala utrzymywać wiele izolowanych środowisk Pythona, każdy ze swoimi własnymi kopiami bibliotek i przestrzeniami nazw dla pakietów.

\n
","rootId":"advanced-tutorial-how-to-write-reusable-apps","toc":[{"title":"Możliwość ponownego użycia ma znaczenie","anchor":"reusability-matters","children":[]},{"title":"Twój projekt i twoja aplikacja do ponownego wykorzystania","anchor":"your-project-and-your-reusable-app","children":[]},{"title":"Instalowanie narzędzi","anchor":"installing-some-prerequisites","children":[]},{"title":"Pakowanie twojej aplikacji","anchor":"packaging-your-app","children":[]},{"title":"Używanie twojego własnego pakietu","anchor":"using-your-own-package","children":[]},{"title":"Publikowanie twojej aplikacji","anchor":"publishing-your-app","children":[]},{"title":"Instalowanie pakietów Pythona z wirtualnym środowiskiem","anchor":"installing-python-packages-with-a-virtual-environment","children":[]}],"breadcrumbs":[{"docname":"intro/index","title":"Pierwsze kroki","url":"/pl/4.0/intro/"}],"prev":{"docname":"intro/tutorial07","title":"Pisanie pierwszej aplikacji Django, część 7.","url":"/pl/4.0/intro/tutorial07/"},"next":{"docname":"intro/whatsnext","title":"Co czytać dalej","url":"/pl/4.0/intro/whatsnext/"},"formats":{"html":"/pl/4.0/intro/reusable-apps/","markdown":"/pl/4.0/intro/reusable-apps.md","json":"/pl/4.0/intro/reusable-apps.json"},"source":"https://github.com/django/django/blob/stable/4.0.x/docs/intro/reusable-apps.txt","official":"https://docs.djangoproject.com/pl/4.0/intro/reusable-apps/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}