{"title":"Ardteagasc: Conas aipeanna in-athúsáidte a scríobh","version":"5.2","locale":"ga","docname":"intro/reusable-apps","url":"/ga/5.2/intro/reusable-apps/","canonical":"https://djangodocs.dev/ga/5.2/intro/reusable-apps/","summary":"Tosaíonn an rang teagaisc chun cinn seo nuair a d'fhág :d oc: Tutorial 8 < / intro/tutorial08> as. Beimid ag casadh ár vótaíocht gréasáin i bpacáiste Python…","html":"

Ardteagasc: Conas aipeanna in-athúsáidte a scríobhLink to this heading#

\n

Tosaíonn an rang teagaisc chun cinn seo nuair a d'fhág :d oc: Tutorial 8 < / intro/tutorial08> as. Beimid ag casadh ár vótaíocht gréasáin i bpacáiste Python neamhspleách is féidir leat a athúsáid i dtionscadail nua agus a roinnt le daoine eile.

\n

Mura bhfuil Ranganna Teagaisc 1–8 críochnaithe agat le déanaí, molaimid duit iad seo a athbhreithniú ionas go mbeidh do thionscadal samplach ag teacht leis an gceann a gcuirtear síos air thíos.

\n
\n

Baineann cúrsaí ath-inúsáidteLink to this heading#

\n

Tá sé a lán oibre a dhearadh, a thógáil, a thástáil agus a chothabháil iarratas gréasáin. Tá fadhbanna coitianta ag go leor tionscadal Python agus Django. Nach mbeadh sé go hiontach dá bhféadfaimis cuid den obair seo a shábháil arís agus arís eile?

\n

Is é reusability an bealach maireachtála i Python. The Python Package Index (PyPI) tá réimse leathan pacáistí ann ar féidir leat a úsáid i do chláir Python féin. Amharc ar Django Packages le haghaidh feidhmchláir in-athúsáidte atá ann cheana a d'fhéadfá a ionchorprú i do thionscadal. Is gnáthphacáiste Python é Django féin freisin. Ciallaíonn sé seo gur féidir leat pacáistí Python nó feidhmchláir Django atá ann cheana féin a ghlacadh agus iad a chumadh i do thionscadal gréasáin féin. Ní gá duit ach na codanna a dhéanann do thionscadal uathúil a scríobh.

\n

Deirimid go raibh tú ag cur tús le tionscadal nua a raibh aip pobalbhreithe ag teastáil uaidh cosúil leis an gceann a raibh muid ag obair air. Conas a dhéantar an aip seo a athúsáid? Ar ámharaí an tsaoil, tá tú go maith ar an mbealach cheana féin. In :d oc:Tutorial 1 </intro/tutorial01>, chonaiceamar conas a d'fhéadfaimis pobalbhreitheanna a dhíchúpláil ón URLconf ar leibhéal an tionscadail ag baint úsáide as include. Sa rang teagaisc seo, glacfaimid céimeanna breise chun an aip a dhéanamh éasca le húsáid i dtionscadail nua agus réidh le foilsiú do dhaoine eile le suiteáil agus le húsáid.

\n\n
\n
\n

Do thionscadal agus d'aip ath-inúsáidteLink to this heading#

\n

Tar éis na ranganna teagaisc roimhe seo, ba chóir go mbeadh cuma mar seo ar ár dtionscadal:

\n
Text
djangotutorial/\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\n
\n

Chruthaigh tú djangotutorial/templates in :d oc:'Tutorial 7 </intro/tutorial07>', agus polls/templates in :d oc:'Tutorial 3 </intro/tutorial03>'. Anois, b'fhéidir go bhfuil sé níos soiléire cén fáth ar roghnaigh muid eolairí teimpléid ar leith a bheith againn don tionscadal agus don chur i bhfeidhm: tá gach rud atá mar chuid d'iarratas na bpobalbhreitheanna i polls. Déanann sé an t-iarratas féinchuimsitheach agus níos éasca le titim isteach i dtionscadal nua.

\n

The polls directory could now be copied into a new Django project and\nimmediately reused. It's not quite ready to be published though. For that, we\nneed to package the app to make it easy for others to install.

\n
\n
\n

Roinnt réamhriachtanais a shuiteáilLink to this heading#

\n

Tá staid reatha pacáistiú Python beagán measctha le huirlisí éagsúla. Don rang teagaisc seo, úsáidfimid setuptools chun ár bpacáiste a thógáil. Is é an uirlis pacáistithe molta é (cumasc leis an bhforc distribute). Beidh pip á úsáid againn freisin chun é a shuiteáil agus a dhíshuiteáil. Ba cheart duit an dá phacáiste seo a shuiteáil anois. Má tá cabhair uait, is féidir leat tagairt a dhéanamh do conas Django a shuiteáil le pip. Is féidir leat `` setuptools`` a shuiteáil ar an mbealach céanna.

\n
\n
\n

Pacáistiú d'aipLink to this heading#

\n

Is éard atá i gceist le Python phacáistiú ná d’aip a ullmhú i bhformáid ar leith ar féidir é a shuiteáil agus a úsáid go héasca. Tá Django féin pacáistithe go mór mar seo. I gcás aip bheag cosúil le pobalbhreith, níl an próiseas seo ró-dheacair.

\n
    \n

  1. Ar dtús, cruthaigh máthairchomhadlann don phacáiste, lasmuigh de do thionscadal Django. Glaoigh ar an eolaire seo django-polls.

    \n\n
    2. \n

  2. Bog an t-eolaire polls` isteach san eolaire``django-polls , agus athainmnigh é go``django_polls``.

    3. \n

  3. Cuir django_polls/apps.py in eagar ionas go mbeidh :attr:'~. Tagraíonn AppConfig.name' d'ainm an mhodúil nua agus cuir :attr:'~. AppConfig.label' chun ainm gearr a thabhairt ar an bhfeidhmchlár:

    \n
    django-polls/django_polls/apps.py
    \n
    Python
    from django.apps import AppConfig\n\n\nclass PollsConfig(AppConfig):\n    default_auto_field = "django.db.models.BigAutoField"\n    name = "django_polls"\n    label = "polls"\n
    \n
    4. \n

  4. Cruthaigh comhad django-polls/README.rst leis an ábhar seo a leanas:

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

  5. Cruthaigh comhad django-polls/LICENSE. Tá roghnú ceadúnais thar raon feidhme an teagaisc seo, ach is leor a rá go bhfuil an cód a scaoiltear go poiblí gan cheadúnas *useless *. Django agus go leor apps Django-comhoiriúnach a dháileadh faoin gceadúnas BSD; mar sin féin, tá tú saor in aisce do cheadúnas féin a roghnú. Just a bheith ar an eolas go mbeidh tionchar ag do rogha ceadúnaithe ar cé atá in ann do chód a úsáid.

    6. \n

  6. Ansin cruthóimid an comhad `` pyproject.toml`` ina sonraítear conas an aip a thógáil agus a shuiteáil. Tá míniú iomlán ar an gcomhad seo lasmuigh de scóip an teagaisc seo, ach tá míniú maith ar an Python Packaging User Guide. Cruthaigh an comhad django-polls/pyproject.toml leis an ábhar seo a leanas:

    \n
    django-polls/pyproject.toml
    \n
    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.10"\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.10",\n    "Programming Language :: Python :: 3.11",\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/"\n
    \n
    7. \n

  7. Tá go leor comhad coitianta agus modúil agus pacáistí Python san áireamh sa phacáiste de réir réamhshocraithe. Chun comhaid bhreise a chur san áireamh, beidh orainn comhad MANIFEST.in a chruthú. Chun na teimpléid agus na comhaid statacha a chur san áireamh, cruthaigh comhad django-polls/MANIFEST.in leis an ábhar seo a leanas:

    \n
    django-polls/MANIFEST.in
    \n
    Text
    recursive-include django_polls/static *\nrecursive-include django_polls/templates *\n
    \n
    8. \n

  8. Tá sé roghnach, ach moltar é, doiciméid mhionsonraithe a chur san áireamh le d'aip. Cruthaigh eolaire folamh django-polls/docs le haghaidh doiciméadú amach anseo.

    \n

    Tabhair faoi deara nach mbeidh an t-eolaire docs san áireamh i do phacáiste mura gcuireann tú roinnt comhad leis. Soláthraíonn go leor aipeanna Django a ndoiciméadú ar líne freisin trí shuíomhanna mar readthedocs.org.

    \n

    Many Python projects, including Django and Python itself, use Sphinx to build\ntheir documentation. If you choose to use Sphinx you can link back to the\nDjango documentation by configuring Intersphinx\nand including a value for Django in your project's intersphinx_mapping\nvalue:

    \n
    Code
    intersphinx_mapping = {\n    # ...\n    "django": (\n        "https://docs.djangoproject.com/en/stable/",\n        None,\n    ),\n}\n
    \n

    With that in place, you can then cross-link to specific entries, in the\nsame way as in the Django docs, such as\n":attr:`django.test.TransactionTestCase.databases`".

    \n
    9. \n

  9. 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.

    10. \n
\n

Le haghaidh tuilleadh eolais ar phacáistiú, féach Tutorial on Packaging and Distributing Projects <https://packaging.python.org/tutorials/packaging-projects/> le Python_.

\n
\n
\n

Do phacáiste féin a úsáidLink to this heading#

\n

Ó bhogamar an t-eolaire polls amach as an tionscadal, níl sé ag obair a thuilleadh. Déanfaimid é seo a shocrú anois trínár bpacáiste nua django-polls a shuiteáil.

\n\n
    \n

  1. Chun an pacáiste a shuiteáil, bain úsáid as pip (tá tú cheana féin: ref: 'suiteáilte sé <installing-reusable-apps-prerequisites>', ceart?):

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

  2. Nuashonraigh mysite/settings.py chun ainm an mhodúil nua a chur in iúl:

    \n
    Code
    INSTALLED_APPS = [\n    "django_polls.apps.PollsConfig",\n    ...,\n]\n
    \n
    3. \n

  3. Nuashonraigh mysite/urls.py chun ainm an mhodúil nua a chur in iúl:

    \n
    Code
    urlpatterns = [\n    path("polls/", include("django_polls.urls")),\n    ...,\n]\n
    \n
    4. \n

  4. Rith an freastalaí forbartha chun a dheimhniú go leanann an tionscadal ag obair.

    5. \n
\n
\n
\n

D'aip a fhoilsiúLink to this heading#

\n

Anois agus django-polls pacáistithe agus tástáilte againn, tá sé réidh le roinnt leis an domhan mór! Mura raibh anseo ach sampla, d'fhéadfá anois:

\n\n
\n
\n

Pacáistí Python a shuiteáil le timpeallacht fhíorúilLink to this heading#

\n

Níos luaithe, shuiteáil muid django-polls mar leabharlann úsáideora. Tá roinnt míbhuntáistí ag baint leis seo:

\n\n

Go hiondúil, ní thagann na cásanna seo chun cinn ach amháin nuair a bhíonn roinnt tionscadal Django á gcothabháil agat. Nuair a dhéanann siad, is é an réiteach is fearr ná venv a úsáid. Ligeann an uirlis seo duit timpeallachtaí iomadúla iargúlta Python a chothabháil, gach ceann acu lena chóip féin de na leabharlanna agus ainmspás an phacáiste.

\n
","rootId":"advanced-tutorial-how-to-write-reusable-apps","toc":[{"title":"Baineann cúrsaí ath-inúsáidte","anchor":"reusability-matters","children":[]},{"title":"Do thionscadal agus d'aip ath-inúsáidte","anchor":"your-project-and-your-reusable-app","children":[]},{"title":"Roinnt réamhriachtanais a shuiteáil","anchor":"installing-some-prerequisites","children":[]},{"title":"Pacáistiú d'aip","anchor":"packaging-your-app","children":[]},{"title":"Do phacáiste féin a úsáid","anchor":"using-your-own-package","children":[]},{"title":"D'aip a fhoilsiú","anchor":"publishing-your-app","children":[]},{"title":"Pacáistí Python a shuiteáil le timpeallacht fhíorúil","anchor":"installing-python-packages-with-a-virtual-environment","children":[]}],"breadcrumbs":[{"docname":"intro/index","title":"Ag tosnú","url":"/ga/5.2/intro/"}],"prev":{"docname":"intro/tutorial08","title":"Do chéad aip Django a scríobh, cuid 8","url":"/ga/5.2/intro/tutorial08/"},"next":{"docname":"intro/whatsnext","title":"Cad atá le léamh ina dhiaidh sin","url":"/ga/5.2/intro/whatsnext/"},"formats":{"html":"/ga/5.2/intro/reusable-apps/","markdown":"/ga/5.2/intro/reusable-apps.md","json":"/ga/5.2/intro/reusable-apps.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/intro/reusable-apps.txt","official":"https://docs.djangoproject.com/ga/5.2/intro/reusable-apps/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}