Skip to main content

A django app to create and manage handle-pids

Project description


.. image::

A django app to create and manage handle-pids_.


Install acdh-django-handle::

pip install acdh-django-handle

Add it to your `INSTALLED_APPS`:

.. code-block:: python


Provide a handle-config dict:

.. code-block:: python

'resolver': "",
'user': "your handle-provider user",
'pw': "your handle-provider password",
'url': "base url to your handle-provider api",
'app_base_url': "the base url of your application"


.. code-block:: python

'resolver': "",
'user': "user11.1234567-01",
'pw': "password1234",
'url': "",
'app_base_url': ""

The value of `app_base_url` will be concaneted with the value of the `get_absolute_url` method of the model instance you want to register a handle for.

And run

python migrate handle

Create/register handle-pids

The package provides a management command to bulk create/register handle-pids. For this you'll have to
* add a `GenericRelation` property to the model class you would like register handles for
* and make sure you have a `get_absolute_url` method defined

.. code-block:: python

from django.contrib.contenttypes.fields import GenericRelation
from handle.models import Pid


class Example(models.Model):
name = models.CharField(
max_length=255, blank=True,
pid = GenericRelation(Pid, blank=True, null=True, related_query_name="get_pid")
def get_absolute_url(self):
return reverse('example_detail', kwargs={'pk':})

To register/create handle-pids run:

python crate_handles example

In case your GenericRelation property is named something else than `pid` you need to pass in the name as second argument, e.g:

python crate_handles example --pid=<name>

Handle-Pids will only be crated for objects which do not have a handle-pid yet.


* Provides a `Pid` class which stores
* a handle-pid
* creation and modification date
* a generic relation to any other class of your django project.
* an overidden save-method which will register/create a handle-pid on save in case you didn't provide a handle-pid

* Provides a `handle.utils.create_handle` function to register/create a new handle-pid

* Register/Create handle-pid for any objects in your project via admin-interface.

* Provides a management command to bulk create/register handle-pids for all instances of a model-class in your project.

Build and publish

.. code-block:: console

python sdist bdist_wheel
twine upload dist/*


Tools used in rendering this package:

* Cookiecutter_
* `cookiecutter-djangopackage`_

.. _Cookiecutter:
.. _`cookiecutter-djangopackage`:
.. _handle-pids:


0.1.0 (2018-06-28)

* First release on PyPI.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

acdh-django-handle-0.1.1.tar.gz (9.9 kB view hashes)

Uploaded source

Built Distribution

acdh_django_handle-0.1.1-py2.py3-none-any.whl (10.4 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page