Metadata-Version: 2.4
Name: sphinx-codelinks
Version: 0.1.2
Summary: Fast Source Code Traceability for Sphinx-Needs
Author-email: team useblocks <info@useblocks.com>
Maintainer-email: Marco Heinemann <marco.heinemann@useblocks.com>, Jui-Wen Chen <jui-wen.chen@useblocks.com>
Requires-Python: >= 3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: comment-parser>=1.2.4
Requires-Dist: gitignore-parser>=0.1.11
Requires-Dist: typer>=0.16.0
Requires-Dist: jsonschema
Requires-Dist: sphinx>=7.4,<9
Requires-Dist: sphinx-needs>=4.2.0
Requires-Dist: jinja2
Requires-Dist: pygments
Requires-Dist: docutils

# Sphinx CodeLinks

A Sphinx extension for discovering, linking, and documenting source code across projects.

## Features

- **Source Discovery**: Automatically discover source files in your project
- **Virtual Documentation**: Generate documentation from code without modifying source files
- **Code Linking**: Create intelligent links between code elements
- **Sphinx Integration**: Seamless integration with existing Sphinx documentation

## Quick Start

```bash
pip install sphinx-codelinks
```

Add to your `conf.py`:

```python
extensions = ['sphinx_needs', 'sphinx_codelinks']
```

## Documentation

Full documentation: https://codelinks.useblocks.com

## Components

- **Source Discovery** ([`src/sphinx_codelinks/source_discovery`](src/sphinx_codelinks/source_discovery)): Code analysis and discovery
- **Virtual Docs** ([`src/sphinx_codelinks/virtual_docs`](src/sphinx_codelinks/virtual_docs)): Documentation generation
- **Sphinx Extension** ([`src/sphinx_codelinks/sphinx_extension`](src/sphinx_codelinks/sphinx_extension)): Sphinx integration
- **Command Line** ([`src/sphinx_codelinks/cmd.py`](src/sphinx_codelinks/cmd.py)): CLI interface

## Development

See [Development Guide](docs/source/development/) for contributing guidelines.

