Metadata-Version: 2.4
Name: sphinx-systemverilog
Version: 0.2.0
Summary: Sphinx autodoc extension for SystemVerilog, powered by the pyslang parser
Author-email: Matthew Ballance <matt.ballance@gmail.com>
License: Apache-2.0
Project-URL: Homepage, https://dvkit.org/fvutils/sphinx-systemverilog/
Project-URL: Documentation, https://dvkit.org/fvutils/sphinx-systemverilog/
Project-URL: Source, https://git.dvkit.org/fvutils/sphinx-systemverilog.git
Keywords: sphinx,systemverilog,autodoc,documentation,pyslang,uvm
Classifier: Framework :: Sphinx :: Extension
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Documentation :: Sphinx
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: sphinx>=7.0
Requires-Dist: pyslang>=7.0
Provides-Extra: test
Requires-Dist: pytest>=8.0; extra == "test"
Requires-Dist: beautifulsoup4; extra == "test"
Provides-Extra: docs
Requires-Dist: myst-parser; extra == "docs"
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: beautifulsoup4; extra == "dev"
Requires-Dist: myst-parser; extra == "dev"
Dynamic: license-file

<div align="center">

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="assets/icons/png/logo-horizontal-dark.png">
  <source media="(prefers-color-scheme: light)" srcset="assets/icons/png/logo-horizontal.png">
  <img src="assets/icons/png/logo-horizontal.png" alt="sphinx-systemverilog" width="440">
</picture>

**A Sphinx autodoc extension for SystemVerilog, powered by [`pyslang`](https://github.com/MikePopoloski/slang).**

[![Docs](https://img.shields.io/badge/docs-dvkit.org-38BDF8)](https://dvkit.org/fvutils/sphinx-systemverilog/)
[![Source](https://img.shields.io/badge/source-git.dvkit.org-6366F1)](https://git.dvkit.org/fvutils/sphinx-systemverilog)
[![PyPI](https://img.shields.io/pypi/v/sphinx-systemverilog?color=0EA5A4)](https://pypi.org/project/sphinx-systemverilog/)
[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://pyslang.readthedocs.io/)
[![License](https://img.shields.io/badge/license-Apache--2.0-FBBF24)](LICENSE)

</div>

A [Sphinx](https://www.sphinx-doc.org) autodoc extension for **SystemVerilog**, powered by
the [`pyslang`](https://github.com/MikePopoloski/slang) parser.

It documents SystemVerilog source the way `sphinx.ext.autodoc` documents Python: declarations
and their doc comments are pulled directly from source, supporting multiple comment dialects
(a Python-docstring-like *native* style, NaturalDocs, and Doxygen).

📖 **Documentation:** <https://dvkit.org/fvutils/sphinx-systemverilog/>

> **Status:** early development. See `docs/design/` for the design and implementation plan.

## Installation

```bash
pip install sphinx-systemverilog
```

## Quick start

```python
# docs/conf.py
extensions = ["sphinx_systemverilog"]
sv_source_dirs = ["../rtl"]
sv_doc_style = "native"
```

```rst
.. autosvclass:: my_pkg::my_transaction
   :members:
```

## Development

```bash
source packages/python/bin/activate
pip install -e .
pytest -m "unit or sphinx"
sphinx-build -W docs docs/_build/html
```

## License

Apache-2.0.
