Skip to main content

Gravity Controller Operator

Модуль для унифицированной работы с промышленными контроллерами (реле, дискретные входы и т.д.). Позволяет взаимодействовать с различными устройствами через единый интерфейс.


🚀 Поддерживаемые контроллеры

  • EmulatorController — заглушка для тестов
  • ARMK210Controller — Modbus TCP
  • WBMR6LV — Modbus RTU
  • NetPing2Controller — HTTP API
  • Sigur — доступ через TCP (СКУД)
  • MoxaE1214 — REST API (vdn.dac.v1)

🧩 Архитектура

🧠 Интерфейсы:

  • DIInterface: чтение дискретных входов
  • RelayInterface: чтение/управление релейными выходами
  • ControllerInterface: объединяет оба

Все интерфейсы наследуют SoftStateMixin, в котором реализовано хранение состояния точек (state, changed, addr).

🛠 Контроллер

Каждый контроллер реализует:

self.interface = ControllerInterface(di_interface=..., relay_interface=...)

🧪 Обёртки:

  • ControllerOperator — отвечает за автоматическое обновление, mutex-безопасность и удобный API
  • ControllerCreator — фабрика создания контроллеров по имени модели (см. controller_factory.py)

🧪 Как использовать

from gravity_controller_operator.controllers.moxa import MoxaE1214
from gravity_controller_operator.controller_operator import ControllerOperator

moxa = MoxaE1214("192.168.60.103")
operator = ControllerOperator(moxa)

print(operator.get_points())
operator.change_relay_state(0, 1)  # включить реле 0

🔬 Тестирование

Установка:

pip install pytest

Запуск:

pytest gravity_controller_operator/tests/

📦 Добавление нового контроллера

  1. Реализуй YourControllerDI и YourControllerRelay, наследуя DIInterface, RelayInterface
  2. Создай YourController, в котором:
self.interface = ControllerInterface(di_interface=..., relay_interface=...)
  1. Добавь контроллер в AVAILABLE_CONTROLLERS в controller_factory.py

📁 Структура

controllers_super.py          # Базовые интерфейсы
controllers/                  # Реализации контроллеров
controller_operator.py        # Обёртка ControllerOperator ✅
controller_factory.py         # AVAILABLE_CONTROLLERS + фабрика ✅
exceptions.py                 # Кастомные исключения ✅
tests/                        # Тесты
README.md

🤝 Контакты

Проект поддерживается Артуром (PunchyArchy, Qodex)

Metadata

Release files for gravity-controller-operator 2.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gravity-controller-operator 2.4.0
File Size Uploaded Provenance Actions
gravity_controller_operator-2.4.0.tar.gz 17.5 kB Without provenance Details for gravity_controller_operator-2.4.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for gravity-controller-operator 2.4.0
File Interpreter ABI Platform Actions
gravity_controller_operator-2.4.0-py3-none-any.whl Python 3 none any Details for gravity_controller_operator-2.4.0-py3-none-any.whl

Total release size: 40.4 kB

Release files / gravity_controller_operator-2.4.0.tar.gz

Download URL gravity_controller_operator-2.4.0.tar.gz
Size 17.5 kB
Tags Source
SHA-256 checksum
How to use checksums
2aa934e5085595e19f86ed12d47b1bb699b15afb69cc749636cd5ab559f5913a
BLAKE2b-256 checksum
How to use checksums
676cfb672b820d8e8167688bb74aae07b6b2557959c8d2622ba2298e735fea10
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.0

Release files / gravity_controller_operator-2.4.0-py3-none-any.whl

Download URL gravity_controller_operator-2.4.0-py3-none-any.whl
Size 22.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
74f6b9d0a8ab7aa8d92ffa09fb2a61d6d9e9ab7ad12222cdfa85ab8722ad325d
BLAKE2b-256 checksum
How to use checksums
69c4cad209cf3c0efc3f0c4c3c24070eedc576d5286e33b86f01218cc56d9df7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.0

Security for gravity-controller-operator 2.4.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.4.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page