Commit Graph

345 Commits

Author SHA1 Message Date
609ecfb715 fix(deb): Use default sphinx theme
The `sphinx_rtd_theme` ist not available in debian packages.
2026-02-18 15:57:47 +01:00
1a17ce0605 Merge tag '2.8.1' into pkg/debian
Release version 2.8.1
2026-02-18 15:43:17 +01:00
8a19959582 build: Add docs/_build to make clean target in Makefile
Signed-off-by: Sven Sager <akira@narux.de>
2.8.1
2026-02-18 15:40:20 +01:00
2544dcf38b chore: Add sphinx-rtd-theme to requirements.txt for documentation
Signed-off-by: Sven Sager <akira@narux.de>
2026-02-18 15:32:04 +01:00
ef07b6ce4f chore: Bump version to 2.8.1
Signed-off-by: Sven Sager <akira@narux.de>
2026-02-18 10:07:56 +01:00
5e0463b09b chore: Update setup.py and README with project URLs
Added `Documentation` and `Source` links to `setup.py` under
`project_urls`. Updated README with a link to the official
documentation.

Signed-off-by: Sven Sager <akira@narux.de>
2026-02-18 10:04:09 +01:00
3294c5e980 docs: Update documentation for improved clarity and consistency
Revised various sections across multiple documentation files to reflect
updated methods (`run_plc` replacing manual setup with `cycleloop`) and
adjust for new default parameters (e.g., `autorefresh`). Enhanced
descriptions for timers, Cycletools usage, and new method explanations.
Removed outdated or redundant examples and updated system requirements.

Signed-off-by: Sven Sager <akira@narux.de>
2026-02-17 12:05:58 +01:00
Nicolai Buchwitz
bae85e1b09 docs: add docs extra dependencies and missing _static directory
The Read the Docs build fails because the "docs" extra is referenced in
.readthedocs.yaml but not defined in setup.py, so sphinx_rtd_theme is
never installed.

Signed-off-by: Nicolai Buchwitz <n.buchwitz@kunbus.com>
2026-02-12 15:05:23 +01:00
cd64dbcd1b style: Remove redundant whitespaces from docstrings and comments
Cleaned up excessive indentation and unnecessary spacing in docstrings
and comments across multiple files to improve code readability and
maintain consistency.

Signed-off-by: Sven Sager <akira@narux.de>
2026-02-12 14:00:23 +01:00
Nicolai Buchwitz
c338069833 docs: enforce 100 character line width in docstrings
Reformatted docstrings across device.py, helper.py, and io.py to honor
the 100 character line width limit, improving readability and
consistency with project formatting standards.
2026-02-12 14:00:23 +01:00
Nicolai Buchwitz
e8af56ff70 ci: add Read the Docs configuration 2026-02-12 14:00:23 +01:00
Nicolai Buchwitz
7136a2b23a docs: use inline attribute docstrings for Sphinx compatibility
Added inline docstring documentation for Device class attributes:
- bmk, catalognr, comment, extend, guid, id, inpvariant, outvariant, type

Added inline docstrings for LED and IO attributes in device classes:
- Core: a1green, a1red, a2green, a2red, wd
- Connect: a3green, a3red, x2in, x2out
- ModularBaseConnect_4_5: a1-a5 red/green/blue
- Connect4: x2in, x2out
- Compact: a1green, a1red, a2green, a2red, wd
- Flat: a1-a5 green/red, switch, relais, wd

Translated remaining German text:
- 'Statusbit for piControl-Treiber laeuft' -> 'Status bit indicating piControl driver is running'
- 'Treiber laeuft' -> 'driver is running'
- 'Inputs to Bus schreiben' -> 'Write inputs to bus'
2026-02-12 14:00:23 +01:00
Nicolai Buchwitz
d4817adff1 docs: enable inherited members display by default
Added :inherited-members: to autodoc_default_options in conf.py
so all classes automatically show inherited methods and attributes
from their base classes. This makes Connect5 show members from
GatewayMixin and ModularBaseConnect_4_5, for example.
2026-02-12 14:00:23 +01:00
Nicolai Buchwitz
4892adaeff docs: improve watchdog toggle terminology and formatting
Changed 'Autowatchdog' to 'automatic watchdog toggle' for clarity.
Fixed inconsistent indentation in _set_wdtoggle docstring.
2026-02-12 14:00:23 +01:00
Nicolai Buchwitz
e7d5bd9fdf docs: fix last German text in io.py docstring
Changed 'wenn Vorzeichenbehaftet' to 'if signed'
2026-02-12 14:00:23 +01:00
Nicolai Buchwitz
3c56eed978 docs: translate German text in docstrings to English
Replaced German terms with English equivalents:
- Zustand → state
- vom → of the
- Ausgang → output
- Sekunden → seconds
- toggeln → toggle
- from → off
- gruen → green
- rot/root → red
- blau → blue
2026-02-12 14:00:23 +01:00
Nicolai Buchwitz
bf631ea176 docs: add missing docstrings to classes and methods
Added docstrings to:
- Error classes (RevPiModIOError, DeviceNotFoundError)
- ProductType constants class
- GatewayMixin class for piGate module detection
- IO __call__ methods (IOBase, IntIO, StructIO)
- MemIO.get_variantvalue method
- RevPiModIO context manager methods (__enter__, __exit__)
2026-02-12 14:00:23 +01:00
Nicolai Buchwitz
2eac69b7bd docs: add comprehensive documentation structure and API reference
Created topic-based documentation:
- basics.rst: core concepts and fundamental usage
- cyclic_programming.rst: PLC-style programming with Cycletools
- event_programming.rst: event-driven patterns and callbacks
- advanced.rst: gateway IOs, replace_io_file, watchdog management
- installation.rst and quickstart.rst: getting started guides

Added complete API reference in docs/api/:
- All device classes including ModularBaseConnect_4_5 and GatewayMixin
- I/O, helper, and main class documentation

Enhanced Sphinx configuration with RTD theme and improved autodoc settings.
Removed auto-generated modules.rst and revpimodio2.rst.
2026-02-12 14:00:23 +01:00
Nicolai Buchwitz
b35edac694 fix: correct typos and complete German translations
- Fix remaining untranslated German text in param descriptions
- Fix typo: 'ist' -> 'is' in error messages
- Fix typo: 'fist' -> 'first' in comment
- Fix typo: 'configuraiton' -> 'configuration'
- Fix typo: 'thrading' -> 'threading' in docstring
- Translate remaining German TODO comment

Signed-off-by: Nicolai Buchwitz <n.buchwitz@kunbus.com>
2026-02-12 14:00:23 +01:00
Nicolai Buchwitz
c26841cf94 docs: translate German comments and docstrings to English
Translate all inline comments, docstrings, and documentation from German to English across the codebase to improve accessibility for international developers.

Fixes #27

Signed-off-by: Nicolai Buchwitz <n.buchwitz@kunbus.com>
2026-02-12 14:00:23 +01:00
4a2ea2d527 Update changelog for 2.8.0-1 release debian/2.8.0-1 2024-11-13 14:16:00 +01:00
5518d8ce1c Merge tag '2.8.0' into pkg/debian
Release version 2.8.0
2024-11-13 14:13:40 +01:00
21d8c523ae chore: Release 2.8.0 2.8.0 2024-11-13 14:11:55 +01:00
f50a7744cd chore: Increase to RC2 of upcoming Release 2.8.0 unstable/2.8.0_rc2 2024-11-12 10:53:47 +01:00
a9ec71e970 test: Update runtime warning for exceeded cycle time in mainloop 2024-11-12 10:53:47 +01:00
19bbdb03e8 test: Fix test for default location of config.rsc
The tests for the default path of the config.rsc are now performed
optionally. If write permission exists for the standard paths, the
tests are performed with the config.rsc.
2024-11-12 10:18:52 +01:00
41720ee042 chore: Increase to RC1 of upcoming Release 2.8.0 unstable/2.8.0_rc1 2024-11-12 09:48:44 +01:00
e5510f5726 Merge branch 'main' into rc 2024-11-12 09:47:49 +01:00
24744a5a9c test: Add tests for RevPi Connect 5 2024-11-08 09:40:09 +01:00
94ac5c9b92 feat: Add support for RevPi Connect 5 2024-11-08 09:40:09 +01:00
f3f81f3633 refactor: Show deprecation warning on root context manager
This context manager can delete the entire instance of ModIO when using
`with rpi:` after creating an instance of ModIO by
`rpi = revpimodio.RevPiModIO(...)`.
2024-11-08 09:37:40 +01:00
579617d223 feat: Add more colors in constants for a RGB status LED
On the Connect 4, the status LEDs are RGB. By switching several LEDs,
further colors can be generated as red, green, blue.
2024-11-08 09:21:05 +01:00
276ea8dd72 test: Cleanup tests and use relative imports 2024-11-08 08:31:39 +01:00
dc5906288c test: Cycle loop functions 2024-10-29 14:15:16 +01:00
1de230c1e2 test: Events and signals 2024-10-29 14:15:16 +01:00
32d113540c test: Test mainloop functions 2024-10-29 14:15:16 +01:00
d7a185451a test: IO values and counter 2024-10-29 14:13:06 +01:00
601d018eba test: Old core rap file without error limits 2024-10-29 14:13:06 +01:00
43d2b12413 test: Connect devices 2024-10-29 14:13:06 +01:00
e876c97c30 test: Core devices 2024-10-29 14:13:06 +01:00
f95b2d6c49 test: Basic IO functions 2024-10-29 14:13:06 +01:00
4c64387649 test: Replace io function 2024-10-29 14:13:06 +01:00
c10f0a2d05 test: Common device functions 2024-10-29 14:13:06 +01:00
960f21539e test: ModIO class basics 2024-10-29 14:13:05 +01:00
125f8bb4fe test: Init ModIO classes 2024-10-29 14:13:05 +01:00
442071c212 test: Configuration errors in config.rsc 2024-10-29 14:13:05 +01:00
1e331feb2f fix: Resolve constants of internal module 2024-10-28 13:33:44 +01:00
629a517ab8 test: Connect 4 integrated input and output 2024-10-28 12:48:50 +01:00
30dfb48fe5 Update changelog for 2.7.2-1 release debian/2.7.2-1 2024-09-23 12:24:36 +02:00
4b7f55701b Merge tag '2.7.2' into pkg/debian
Release version 2.7.2
2024-09-23 12:21:33 +02:00