gateway-defender 0.1.0

Reusable Django app gateway-defender

gateway-defender

gateway-defender is a small, reusable Django app that provides authentication helpers (login/logout views), a protected portal view, session timeout handling, and packaged templates/static assets. The PyPI distribution name is gateway-defender; the importable Python package is gateway_defender.

---

Install

Install from PyPI with pip:

pip install gateway-defender

For local development, install editable from the repository root:

pip install -e /path/to/django-accounts

---

Quick start

1. Add to INSTALLED_APPS in your Django settings:

INSTALLED_APPS = [
    # ...
    "gateway_defender",
]

2. Include the URLs in your project urls.py:

from django.urls import include, path

urlpatterns = [
    path("", include("gateway_defender.urls")),
]

3. Run migrations:

python manage.py migrate

4. Routes provided by the app:

• GET / — login page (uses gateway_defender/gateway.html)
• GET /portal/ — protected portal page
• GET /logout/ — logout and redirect to index

---

API / Files included

Key modules included in the package:

• gateway_defender.models — AuthToggle, PassPhrase
• gateway_defender.views — Gateway (login view) and EndSession (logout view)
• gateway_defender.urls — URL patterns included above
• gateway_defender.custom_decorator — protected_redirect decorator
• gateway_defender/templates/ — packaged templates (gateway_defender/gateway.html, gateway_defender/logged_out.html)
• gateway_defender/static/ — CSS and images

Refer to module docstrings and the source for details.

---

Compatibility

• Python: 3.10 — 3.13
• Django: >= 4.2 (tested with Django 5.2)

---

Development

Run tests and linters in your development environment. For local development:

pip install -r requirements-dev.txt  # if you create one
pytest

When preparing a release:

1. Update pyproject.toml version and metadata.
2. Build with python -m build.
3. Upload with twine upload dist/*.

---

Contributing

Contributions are welcome. Please open issues or PRs and include tests for new behavior. Keep public APIs stable where possible.

---

License

MIT — see the LICENSE file included in the repository.

---

Project & PyPI

PyPI package name: gateway-defender
Python package (import): gateway_defender

Update the repository or PyPI URLs here if you host the project on GitHub or another platform.