
_Photo by [David Clode](https://unsplash.com/@davidclode) on
[unsplash.com](https://unsplash.com/photos/a-close-up-of-a-snake-on-a-rock-J_5xvghAvmc)_

This project takes the Official Django Polls App a step further, turning it into
a standalone Python package that can be installed into any Django project with
pip. It follows Django's advanced tutorial on writing reusable apps, working
through the packaging process end to end rather than just building the app
itself.

That process meant pulling the polls app out of its original project,
restructuring it as an independent package, and adding the files Python
packaging expects: a README, a BSD 3-Clause LICENSE, a pyproject.toml describing
the build, and a MANIFEST.in to include templates and static files in the
distribution. From there the package builds into both source and wheel formats
with Python's build tool, and installs cleanly into a virtual environment the
same way any third-party Django app would.

The result is a self-contained, pip-installable polls app, ready to drop into a
new Django project without copying files by hand.

## Related Resources

- [Django official advanced tutorial on writing reusable apps](/blog/django-official-advanced-tutorial-on-writing-reusable-apps):
  the companion post walking through this package's build process
- [Official Django Polls App](/projects/official-django-polls-app): the original
  project this package is built from


The Official Django Polls App repackaged as a standalone, installable Python package, following the Django project's advanced tutorial on writing reusable apps, complete with a pyproject.toml build config, MANIFEST.in, and BSD-licensed distribution.

Django Polls Package


_Photo by [David Clode](https://unsplash.com/@davidclode) on
[unsplash.com](https://unsplash.com/photos/a-close-up-of-a-snake-on-a-rock-J_5xvghAvmc)_

This project is a Django Polls application built by following Django's official
tutorial from the ground up, after refactoring an earlier version of the same
app that had been sitting untouched for seven years. It's structured as a set of
reusable apps rather than a single monolithic project.

Along the way it covers setting up a virtual environment and starting a Django
project, defining and activating the polls models, working the interactive
Django shell, registering the app in the admin interface, writing views and
namespaced URLconfs, building out templates, adding a voting form, and
introducing automated tests. The project also wires up static files for local
development and the Django Debug Toolbar for inspecting requests in the browser.
Code quality is enforced with flake8, Black, and djLint, run automatically
through pre-commit hooks.

## Related Resources

- [Creating the official Django Polls app table of contents](/blog/creating-the-official-django-polls-app-table-of-contents):
  the eight-part series documenting this build
- [Django Polls Package](/projects/django-polls-package): this app repackaged as
  a standalone, installable Python package


A Django project following the official Django Polls tutorial from scratch, covering models, the admin interface, views and templates, forms, automated testing, static files, and the Django Debug Toolbar.

projects tag: reusable-apps

Django Polls Package

Official Django Polls App