Metadata-Version: 2.4
Name: docsmint
Version: 1.0.3
Summary: Python interface for the DocsMint Node.js CLI.
Author: Raphael Avocegamou
License: MIT
Project-URL: Homepage, https://usedocsmint.pages.dev/
Project-URL: Repository, https://github.com/Raphjacksun7/docsmint
Project-URL: Issues, https://github.com/Raphjacksun7/docsmint/issues
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: PyYAML>=6.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"

# docsmint (Python)

Python interface for the DocsMint Node.js CLI.

Minimal markdown docs and writing. Rendering uses Astro (Node ≥22.12); this package runs that CLI reliably.

## Install

```sh
pip install docsmint
npm install -g docsmint   # or use from a repo with node_modules
```

## Usage

Same commands as the Node CLI:

```sh
docsmint init
docsmint dev
docsmint build
```



## Python command routing and YAML bridge

`convert` and `extract-docs` are routed to Python-native implementations.

- `convert` performs a minimal `.ipynb` -> `.mdx` flow (frontmatter, markdown/code cells, text output, PNG image outputs).
- `extract-docs` extracts basic API docs from Python/TypeScript/Go source comments.

The wrapper supports reading `docsmint.yaml` / `docsmint.yml` and bridging command-scoped args from:

```yaml
python:
  convert:
    input_path: analysis.ipynb
    watch: true
```

You can also pass `--config /path/to/docsmint.yaml` for explicit config selection.
