Metadata-Version: 2.4
Name: mkdocstrings-twincat
Version: 0.3.4
Summary: A Twincat handler for mkdocstrings.
Author-Email: drehstromer <privat@samuelruckli.ch>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
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: Topic :: Documentation
Classifier: Topic :: Software Development
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Project-URL: Homepage, https://drehstromer.github.io/mkdocstrings-twincat
Project-URL: Documentation, https://drehstromer.github.io/mkdocstrings-twincat
Project-URL: Changelog, https://drehstromer.github.io/mkdocstrings-twincat/changelog
Project-URL: Repository, https://github.com/drehstromer/mkdocstrings-twincat
Project-URL: Issues, https://github.com/drehstromer/mkdocstrings-twincat/issues
Project-URL: Discussions, https://github.com/drehstromer/mkdocstrings-twincat/discussions
Project-URL: Gitter, https://gitter.im/mkdocstrings-twincat/community
Project-URL: Funding, https://github.com/sponsors/drehstromer
Requires-Python: >=3.11
Requires-Dist: mkdocstrings>=0.18
Requires-Dist: pytwincatparser>=0.5.4
Description-Content-Type: text/markdown

# mkdocstrings-twincat

[![documentation](https://img.shields.io/badge/docs-mkdocs-708FCC.svg?style=flat)](https://drehstromer.github.io/mkdocstrings-twincat/)
[![pypi version](https://img.shields.io/pypi/v/mkdocstrings-twincat.svg)](https://pypi.org/project/mkdocstrings-twincat/)

A Twincat handler for mkdocstrings.

## Installation

```bash
pip install mkdocstrings-twincat
```

This handler is using pytwincatparser to parse Twincatfiles. Currently supported are:

- .plcproj
- .tcio
- .tcpou
- .tcgvl
- .tcdut

The handler can load recursivly all objects. You just have to add the .plcproj file, and it generates the documentation for all Function Blocks etc.


## Demo
At the project page you can find a demo of this handler. It parses the source code of the famous [TcUnit](https://github.com/tcunit/TcUnit) TwinCAT unit testing framework and displays it. The documentation is not optimal, but this is because the tags are not used by tcunit.


## Used packages
- mkdocstrings
- mkdocstrings-python (heavily as inspiration. really great code!)
- pytwincatparser


## Be aware
I am a plc programmer. I usually dont code in python. if you find bugs, flaws, mistakes or if you have an idea how to improve or make a new feature, do not hesitate to contact me!
