Commit Graph

326 Commits

Author SHA1 Message Date
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
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
8702c3c8c1 chore: Release 2.7.2 2.7.2 2024-09-23 12:20:26 +02:00
9bb1cee4a1 test: Update wd_toggle test for connect 4
This function will now raise a NotImplementedError.
2024-09-20 16:37:50 +02:00
0ba8772d1b fix: Raise error on connect 4 when using wd_toggle function
On the Connect 4, the hardware watchdog was removed from the process
image by KUNBUS. To use the hardware watchdog, other functions must now
be used that are not implemented by RevPiModIO.
2024-09-18 10:57:17 +02:00
5d9f513f71 chore: Increase to RC1 of upcoming Release 2.7.2 unstable/2.7.2_rc1 2024-09-18 10:00:04 +02:00
88d5fc4e98 build: Add test target as dependency of all target in Makefile 2024-09-18 10:00:04 +02:00
e8d7860dd2 fix: Colors of constants GREEN and RED match LEDs of RevPi Connect 4
The LED colors for the A1-A5 objects of the .core class of the connect 4
did not match the values of the constants for GREEN and RED, as on all
other RevPi Devices. In addition, the color BLUE was added.
2024-09-18 09:20:21 +02:00
c6ae318a15 test: Add RevPi Compact tests 2024-09-18 09:09:25 +02:00
6adfe95201 test: Add RevPi Flat tests 2024-09-18 09:09:25 +02:00
379899f54c test: Add connect 4 tests 2024-09-18 09:09:25 +02:00