# django-popolo
Welcome to the documentation for django-popolo!
**django-popolo** is a django-based implementation of the
[Popolo's open government data specifications](http://popoloproject.com/).
It is developed as a Django reusable app to be deployed directly within Django projects.
It will allow web developers using it to manage and store data according to Popolo's specifications.
The standard sql-oriented Django ORM will be used.
From release 1.2.0, django-popolo includes classes that extend the model, although compatibility
with the standard is kept.
Release 2.0.0 introduces a change in how Sources and Links are referred to,
that breaks compatibility with the popit importer.
Release 3.0.0 main focuses have been to keep up with latest Django
versions and to "modernize" the code base, adopting latest Python features (like type hinting),
and doing some serious housekeeping. Python 2 is no longer supported.
This release also implements a lot of new models which are not part of the Popolo specification (mildly out of scope),
but we needed them in some projects which make use this package. Those new models can be safely ignored, and they could
also be removed in the future, as we are considering the option of entirely decoupling them from `django-popolo`.
See the [CHANGELOG.md](./CHANGELOG.md) file for more details.
## Installation
To install `django-popolo` as a third party app within a django project,
you need to add it to the django project's requirements.txt.
You can do this from GitHub in the usual way, or using the
`django-popolo` package on PyPI.
## Notes on mysociety's fork
[mysociety/django-popolo](https://github.com/mysociety/django-popolo) is a fork of this project where integer IDs are used
instead of slugs.
Our packages, since version 1.1 also uses numerical ids as primary keys for all entities.
Slugs are available as non-primary fields, for the 4 main classes (`Person`, `Organization`, `Post`, `Membership`).
Slugs are used through the `Permalinkable` behavior, that adds the `slug` field to the class, populating it according to rules defined in each class.
Raw data
{
"_id": null,
"home_page": "http://github.com/openpolis/django-popolo",
"name": "django-popolo",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Guglielmo Celata",
"author_email": "guglielmo@openpolis.it",
"download_url": "https://files.pythonhosted.org/packages/86/2f/6d719819deae3b687f5c744ee4b5360bd85ff4c751731b114d7512088f24/django-popolo-3.0.10.tar.gz",
"platform": null,
"description": "# django-popolo\n\nWelcome to the documentation for django-popolo!\n\n**django-popolo** is a django-based implementation of the\n[Popolo's open government data specifications](http://popoloproject.com/).\n\nIt is developed as a Django reusable app to be deployed directly within Django projects.\n\nIt will allow web developers using it to manage and store data according to Popolo's specifications.\n\nThe standard sql-oriented Django ORM will be used.\n\nFrom release 1.2.0, django-popolo includes classes that extend the model, although compatibility\nwith the standard is kept.\n\nRelease 2.0.0 introduces a change in how Sources and Links are referred to,\nthat breaks compatibility with the popit importer.\n\nRelease 3.0.0 main focuses have been to keep up with latest Django\nversions and to \"modernize\" the code base, adopting latest Python features (like type hinting), \nand doing some serious housekeeping. Python 2 is no longer supported. \nThis release also implements a lot of new models which are not part of the Popolo specification (mildly out of scope), \nbut we needed them in some projects which make use this package. Those new models can be safely ignored, and they could \nalso be removed in the future, as we are considering the option of entirely decoupling them from `django-popolo`. \n\n\nSee the [CHANGELOG.md](./CHANGELOG.md) file for more details.\n\n## Installation\n\nTo install `django-popolo` as a third party app within a django project,\nyou need to add it to the django project's requirements.txt.\nYou can do this from GitHub in the usual way, or using the\n`django-popolo` package on PyPI.\n\n## Notes on mysociety's fork\n\n[mysociety/django-popolo](https://github.com/mysociety/django-popolo) is a fork of this project where integer IDs are used\ninstead of slugs.\n\nOur packages, since version 1.1 also uses numerical ids as primary keys for all entities.\nSlugs are available as non-primary fields, for the 4 main classes (`Person`, `Organization`, `Post`, `Membership`).\nSlugs are used through the `Permalinkable` behavior, that adds the `slug` field to the class, populating it according to rules defined in each class.\n\n\n\n\n",
"bugtrack_url": null,
"license": "AGPL-3.0",
"summary": "A Django-based implementation of the OpenGovernment context, compliant with the Popolo data specifications.",
"version": "3.0.10",
"project_urls": {
"Homepage": "http://github.com/openpolis/django-popolo"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6996ac84c7669e35dc1ca1ec29e5f0b930d92105fd21de9c33e8d82ab8dc63df",
"md5": "e27d5c6038b5341fac8d17a82bec8375",
"sha256": "073071f6bf355e2d6d24de59f2471a67050f4732936d494fe788c0ce2a29f5e6"
},
"downloads": -1,
"filename": "django_popolo-3.0.10-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e27d5c6038b5341fac8d17a82bec8375",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 38102,
"upload_time": "2025-01-08T15:00:20",
"upload_time_iso_8601": "2025-01-08T15:00:20.818296Z",
"url": "https://files.pythonhosted.org/packages/69/96/ac84c7669e35dc1ca1ec29e5f0b930d92105fd21de9c33e8d82ab8dc63df/django_popolo-3.0.10-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "862f6d719819deae3b687f5c744ee4b5360bd85ff4c751731b114d7512088f24",
"md5": "92946250eebc627818f6b95ac6269a5c",
"sha256": "b6a9c3f45e89da7097e2cbaa01f06e41e83247010b8abfa8560c85cd339ad45f"
},
"downloads": -1,
"filename": "django-popolo-3.0.10.tar.gz",
"has_sig": false,
"md5_digest": "92946250eebc627818f6b95ac6269a5c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 34232,
"upload_time": "2025-01-08T15:00:23",
"upload_time_iso_8601": "2025-01-08T15:00:23.427221Z",
"url": "https://files.pythonhosted.org/packages/86/2f/6d719819deae3b687f5c744ee4b5360bd85ff4c751731b114d7512088f24/django-popolo-3.0.10.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-08 15:00:23",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "openpolis",
"github_project": "django-popolo",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"tox": true,
"lcname": "django-popolo"
}
JSON
