Metadata-Version: 2.4
Name: panos-response-pages
Version: 0.1.0
Summary: Self-contained PAN-OS URL Filtering and Anti-Phishing response pages, generated from templates
Project-URL: Homepage, https://github.com/kaisero/panos-response-pages
Project-URL: Documentation, https://kaisero.github.io/panos-response-pages/
Project-URL: Changelog, https://github.com/kaisero/panos-response-pages/blob/main/CHANGELOG.md
Author-email: Oliver Kaiser <oliver.kaiser@outlook.com>
License-Expression: MIT
License-File: LICENSE
Keywords: anti-phishing,palo-alto,pan-os,response-pages,url-filtering
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: System Administrators
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Security
Classifier: Topic :: System :: Networking :: Firewalls
Requires-Python: >=3.11
Requires-Dist: pyyaml>=6
Requires-Dist: rich>=13
Requires-Dist: typer>=0.12
Description-Content-Type: text/markdown

# panos-response-pages

[![CI](https://github.com/kaisero/panos-response-pages/actions/workflows/ci.yml/badge.svg)](https://github.com/kaisero/panos-response-pages/actions/workflows/ci.yml)
[![Python](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org)
[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)

Modern, responsive response pages for PAN-OS. Generate response pages to delight users while protecting them from threats.

**[Full documentation →](https://kaisero.github.io/panos-response-pages/)**

## Preview

`panos-response-pages` generates responsive response pages for Desktop and Mobile which
support both dark and light mode by default. For a full preview of all available themes
and options take a look at the dedicated [Preview](https://kaisero.github.io/panos-response-pages/preview/) pages.

[![A blocked-application page rendered in the Beacon Field style](docs/assets/preview-beacon.png)](https://kaisero.github.io/panos-response-pages/preview/)


## Install

```bash
pip install panos-response-pages
```

## Install (From Source)

```bash
uv tool install panos-response-pages
uvx panos-response-pages build          # or run it without installing
```

## Use

```bash
panos-response-pages build              # every style, into ./out
panos-response-pages themes             # what styles exist
panos-response-pages init               # copy the templates out to customise them
```

`out/deploy/<style>/` is what you import. `out/preview/index.html` is a
clickthrough gallery for review — style, page, viewport and colour scheme — built
with sample data standing in for the PAN-OS tokens.

Six styles ship, all supporting three brand palettes and both colour schemes:
`assist`, `record`, `banner`, `glass`, `beacon`, `mesh`. See [Styles].

## Development

```bash
uv sync --all-groups
uv run pre-commit install
uv run nox                            # lint, type-check, tests, docs
```

`nox -s tests` runs the suite with coverage; the gate is 93%. Commit `uv.lock`.

## License

MIT. See [LICENSE](LICENSE).
