Metadata-Version: 2.1
Name: openregister
Version: 0.8.9
Summary: Publishing tools for GOV.UK style registers
Home-page: https://github.com/psd/openregister
Author: Paul Downey
Author-email: paul.downey@whatfettle.com
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Database
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown
Requires-Dist: click (==7.0)
Requires-Dist: click-default-group (==1.2)
Requires-Dist: PyYAML (==3.13)
Requires-Dist: requests (==2.22.0)
Requires-Dist: Sanic (==0.7.0)
Requires-Dist: tempdir (==0.7.1)
Provides-Extra: test
Requires-Dist: coverage (>=4.5.3) ; extra == 'test'
Requires-Dist: flake8 (>=3.7.7) ; extra == 'test'
Requires-Dist: pytest (>=4.0.2) ; extra == 'test'
Requires-Dist: python-coveralls (>=2.9.1) ; extra == 'test'
Requires-Dist: twine (>=1.13.0) ; extra == 'test'
Requires-Dist: black ; extra == 'test'

# OpenRegister

[![Package](https://img.shields.io/pypi/v/openregister.svg)](https://pypi.python.org/pypi/openregister/)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/openregister.svg)](https://pypi.python.org/pypi/openregister/)
[![Build](https://travis-ci.org/psd/openregister.svg?branch=master)](https://travis-ci.org/psd/openregister)
[![Coverage](https://coveralls.io/repos/github/psd/openregister/badge.svg?branch=master)](https://coveralls.io/github/psd/openregister?branch=master)
[![License](https://img.shields.io/github/license/mashape/apistatus.svg)](https://github.com/psd/openregister/blob/master/LICENSE)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://black.readthedocs.io/en/stable/)


*Publishing tools for GOV.UK style registers.*

A self-contained and easily installed [GOV.UK register product](https://www.gov.uk/government/publications/registers/registers) intended for use by devolved authorities and administrations.

## Installation

    pip3 install openregister

## Basic usage

    openregister serve /path/to/register.json

Runs a web server serving an index of registers on http://localhost:8088/

## Command options

    $ openregister --help

    Usage: openregister [OPTIONS] COMMAND [ARGS]...

      OpenRegister:  publishing tools for GOV.UK style registers.

    Options:
      --version  Show the version and exit.
      --help     Show this message and exit.

    Commands:
      serve*

## Server options

    $ openregister serve --help

    Usage: openregister serve [OPTIONS]

    Options:
      -h, --host TEXT      host for server, defaults to 127.0.0.1
      -r, --register TEXT  Serve a single register, otherwise serve all know
                           registers as a catalog
      -p, --port INTEGER   port for server, defaults to 8088
      -d, --debug          More verbose logging and automatically reload on
                           changes
      --help               Show this message and exit.

## Development

Development requires Python 3.5 or later, we recommend using a [virtual environment](https://docs.python.org/3/library/venv.html):

    make init
    make
    python -m openregister --help


