Metadata-Version: 2.4
Name: afterpython
Version: 0.1.0.dev5
Summary: CLI tool for AfterPython
Keywords: package-maintenance,project-website,static-site-generator,developer-tools,documentation,cli-tool,ci/cd,mystmd,semantic-release,python-packaging
Author: Stephen Yau
Author-email: Stephen Yau <softwareentrepreneer+afterpython@gmail.com>
License-Expression: Apache-2.0
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Documentation
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: click>=8.3.1
Requires-Dist: trogon>=0.6.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: tomlkit>=0.13.3
Requires-Dist: ruamel-yaml>=0.18.16
Requires-Dist: gitpython>=3.1.45
Requires-Dist: pygithub>=2.8.1
Requires-Dist: python-dotenv>=1.2.1
Requires-Dist: pyproject-metadata>=0.9.1
Requires-Dist: mystmd>=1.6.6
Requires-Dist: pdoc>=16.0.0
Requires-Dist: ruff>=0.14.5
Requires-Dist: pre-commit>=4.4.0
Requires-Dist: commitizen>=4.10.0
Requires-Python: >=3.11
Project-URL: documentation, https://ap.afterpython.org/doc
Project-URL: homepage, https://afterpython.org
Project-URL: repository, https://github.com/AfterPythonOrg/afterpython
Description-Content-Type: text/markdown

# AfterPython: Python Package Maintenance Toolkit and Project Website Generator

[![afterpython](https://afterpython.org/shield.svg)](https://afterpython.org)
[![Pixi Badge](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/prefix-dev/pixi/main/assets/badge/v0.json)](https://pixi.sh)
![PyPI downloads](https://img.shields.io/pypi/dm/afterpython)
[![PyPI](https://img.shields.io/pypi/v/afterpython.svg)](https://pypi.org/project/afterpython)
![PyPI - Support Python Versions](https://img.shields.io/pypi/pyversions/afterpython)
[![Discussions](https://img.shields.io/badge/Discussions-Let's%20Chat-green)](https://github.com/AfterPythonOrg/afterpython/discussions)
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/AfterPythonOrg/afterpython)


[MyST]: https://mystmd.org
[MyST Markdown]: https://mystmd.org/spec/
[Jupyter Notebook]: https://jupyter.org
[pre-commit]: https://pre-commit.com
[pagefind]: https://pagefind.app
[SemVer]: https://semver.org
[pdoc]: https://pdoc.dev/
[GitHub Actions]: https://github.com/features/actions
[PyTorch]: https://pytorch.org
[Scikit-Learn]: https://scikit-learn.org
[WebLLM]: https://webllm.mlc.ai/
[project-website-template]: https://github.com/AfterPythonOrg/project-website-template
[uv]: https://docs.astral.sh/uv/
[ruff]: https://docs.astral.sh/ruff/


## Problem
Going from **writing Python code to publishing and maintaining a package** is **time-consuming**.
First-time maintainers must learn multiple tools and concepts, e.g. [MyST], [SemVer], CI/CD ([pre-commit] hooks, GitHub workflows), and they often spending hours just to deploy a documentation site whereas well-resourced projects like [PyTorch] and [Scikit-Learn] have **dedicated websites** that serve as their project hubs.


## Solution
`afterpython` **automates** the tedious parts of Python package maintenance and generates a **project website** for **building community** and **hosting content** such as documentation, **blog posts**, tutorials, examples and more — empowering more developers to write packages with ease.

---
`afterpython` is a CLI tool that **abstracts away the complexity** of **content writing, website deployment, and package release/maintenance** by providing an opinionated set of modern tools — so you don’t have to spend time selecting or learning anything beyond the basics.


## Core Features
- [x] Write content directly in [MyST Markdown] or [Jupyter Notebook]
- [x] Go from writing to website deployment in minutes — no need to learn any of the underlying tools
- [x] Centralize all your content in a modern, unified project website — from documentation to blog posts
- [ ] Export content as PDF — for example, combine all blog posts into a single PDF file
- [ ] **⚡ Full-text search** across **ALL** your content in your website — docs, blogs, tutorials, everything
- [ ] **🤖 Embedded AI Chatbot** that answers questions directly using an in-browser LLM — at no cost


## Installation
```bash
# install afterpython as a dev dependency
uv add --dev afterpython
# initialize afterpython
ap init
```


## Tech Stack
- [MyST]
- [project-website-template]
- [pre-commit]
- [GitHub Actions]
- [pdoc]
- [uv]
- [ruff]
- [pagefind]
- [WebLLM]
<!-- - ty -->
<!-- - [pixi] -->
