Metadata-Version: 2.1
Name: django-accounts-api
Version: 0.2.0a1
Summary: 
Author: PeteCoward
Author-email: peter@catalpa.io
Requires-Python: >=3.7,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: django (>=3.2) ; python_version < "3.8"
Requires-Dist: django (>=3.2,<4.2) ; python_version >= "3.8"
Description-Content-Type: text/markdown

# Django Accounts API

Scenario to support is a compiled javascript capable frontend needing to provide authentication features over api

Caveat enptor, very early days, still being tested in it's first project

# Requirements
- Python 3.7 - 3.11
- Django 3.2 - 4

# Usage

- `pip install ...` or equivalent
- add `'django_accounts_api',` to INSTALLED_APPS
- add `path('/accounts_api/', include('django_accounts_api.urls'))` to your urls
- implement your frontend to use the urls

## Features

See docs...


## Development
1. Install Poetry https://python-poetry.org/docs/#installation

2. Use a virtual environment https://python-poetry.org/docs/basic-usage/#using-your-virtual-environment

3. `poetry install --with dev --no-root` installs dependencies for development

4. `poetry run pre-commit install` installs the pre-commit hooks

5. `pytest` runs tests

### Tox

To run tox you will need to make sure that the range of python versions required are available for tox to use.

Recommendation: use pyenv
- `pyenv install 3.7 3.8 3.9 3.10 3.11`
- `pyenv local  3.7 3.8 3.9 3.10 3.11`
- `tox`

### Documentation

- `cd docs`
- `make html`

TODO: add to tox

### Linting & formatting

TODO: add to tox

