Skip to main content

Name Authority App for Django.

Project description

# Django Name [![Build Status](]( [![Docs Status](]( [![PyPI Version](](
Python Implementation of NACO Normalization Rules

The Name App is a tool originally developed for documenting names used by the UNT Libraries in its various digital library systems and collections. The app provides a consistent way of communicating the authorized version of a name and information about the name that is useful for reuse. The Name App generates a unique URL for each name that can be used to unambiguously refer to a person, organization, event, building or piece of software. In addition to an HTML page for each name there are a number of other formats available for each record including a MADS XML version and a simple JSON representation. A key feature of the UNT Name App is the ability to link to other vocabularies such as the Virtual International Authority File (VIAF), the Library of Congress Name Authority File, or Wikipedia.


## Installation

For installation instructions, see the [Installation]( page in the docs.

## License


## Acknowledgements

django-name was developed at the UNT Libraries.


- [Joey Liechty](
- [Damon Kelley](
- [Lauren Ko](
- [Mark Phillips](
- [Gio Gottardi](

## Developing

To take advantage of the dev environment that is already configured, you need to have Docker(>= 1.3) and Docker Compose installed.

Install [Docker](

Install Docker Compose
$ pip install docker-compose

Clone the repository.
$ git clone
$ cd django-name

Warm up the MySQL database. This only needs to be done when the database container doesn't exist yet. This will take about a minute once the image has been pulled.
$ docker-compose up -d mysql

Start the app and run the migrations.
# start the app
$ docker-compose up -d

# run the migrations
$ docker-compose run --rm web ./ migrate

# optional: add a superuser in order to login to the admin interface
$ docker-compose run --rm web ./ createsuperuser

The code is in a volume that is shared between your workstation and the web container, which means any edits you make on your workstation will also be reflected in the Docker container. No need to rebuild the container to pick up changes in the code.

However, if the requirements files change, it is important that you rebuild the web container for those packages to be installed. This is something that could happen when switching between feature branches, or when pulling updates from the remote.

# stop the app
$ docker-compose stop

# remove the web container
$ docker-compose rm web

# rebuild the web container
$ docker-compose build web

# start the app
$ docker-compose up -d

#### Running the Tests
To run the tests via Tox, use this command.
$ docker-compose run --rm web tox
The Tox configuration will test this app with Django 1.10 - 1.11.

To run the tests only with the development environment (i.e. with Django 1.11)
$ docker-compose run --rm web ./
Note: This is the same command that Tox issues inside each test environment it has defined.

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

django-name-2.0.0.tar.gz (43.0 kB view hashes)

Uploaded Source

Built Distribution

django_name-2.0.0-py3-none-any.whl (53.1 kB view hashes)

Uploaded Python 3

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