Metadata-Version: 2.4
Name: beemo
Version: 0.6.1
Summary: A Python-based static site generator. Bring your own content and templates and it'll quickly generate you a deployable HTML website/blog.
License-Expression: BSD-3-Clause
License-File: LICENSE.txt
Author: Ben Nuttall
Author-email: ben@bennuttall.com
Requires-Python: >=3.10,<4.0.0
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Intended Audience :: Developers
Classifier: Topic :: Utilities
Classifier: Topic :: Internet
Provides-Extra: logs
Requires-Dist: beautifulsoup4 (>=4.13.4,<5.0.0)
Requires-Dist: chameleon (>=4.6.0,<5.0.0)
Requires-Dist: docutils (>=0.21,<0.23)
Requires-Dist: lars ; extra == "logs"
Requires-Dist: markdown (>=3.8.2,<4.0.0)
Requires-Dist: pydantic (>=2.11.7,<3.0.0)
Requires-Dist: pydantic-settings (>=2.10.1,<3.0.0)
Requires-Dist: pyyaml (>=6.0.2)
Requires-Dist: structlog (>=25.4.0)
Requires-Dist: typer (>=0.15.0)
Requires-Dist: user-agents (>=2.2) ; extra == "logs"
Project-URL: Documentation, https://beemo.readthedocs.io/
Project-URL: Issues, https://github.com/bennuttall/beemo/issues
Project-URL: Repository, https://github.com/bennuttall/beemo
Description-Content-Type: text/markdown

# beemo

A Python-based static site generator. Bring your own content and templates and it'll quickly
generate you a deployable HTML website/blog. Also includes support for building a simple analytics
site based on the known site structure by processing Apache logs.

![](https://raw.githubusercontent.com/bennuttall/beemo/refs/heads/main/beemo.png)

## Features

- Content as HTML, markdown or reStructuredText
- Pages
- Blog:
  - Posts
  - Tags
  - Archives (index, years and months)
  - Atom feed
- Three modes:
  - Posts only
  - Pages only
  - Pages + posts
- XML sitemap
- Custom Chameleon templates
- Custom CSS, JS and other static files
- Apache log analytics (optional, via ``beemo[logs]``)

## Install

Install the latest release with:

```
pip install beemo
```

For Apache log analytics, install the `logs` extra:

```
pip install beemo[logs]
```

## Documentation

Documentation is available at [beemo.readthedocs.io](https://beemo.readthedocs.io/)

## Examples

Sites built with Beemo:

- [bennuttall.com](https://bennuttall.com) ([repo](https://github.com/bennuttall/web-content))
- [blog.piwheels.org](https://blog.piwheels.org) ([repo](https://github.com/piwheels/blog))
- [pynw.org](https://pynw.org/) ([repo](https://github.com/pythonnorthwestengland/pynw.org))
- [pyjok.es](https://pyjok.es/) ([repo](https://github.com/pyjokes/website))

If you wish to use this project for your own website, these examples will be a useful reference.

## Links

- [PyPI](https://pypi.org/project/beemo/)
- [GitHub](https://github.com/bennuttall/beemo)
- [ReadTheDocs](https://beemo.readthedocs.io/)

## Licence

- [BSD-3-Clause](LICENSE.txt)

