Update description and readme
This commit is contained in:
parent
b2e665fcbd
commit
6dfbf9da6e
|
@ -0,0 +1,16 @@
|
|||
This is a testing tool for one proprietary enterprise app which in turn handles aviation lights on top of the wind turbines for aviation safety.
|
||||
While working on that app it is not always possible to use real devices (so called light controllers).
|
||||
|
||||
Thus the purpose of this tool to help with development via simulating those devices.
|
||||
Communication with controllers is built upon **MODBUS** protocol via TCP/IP.
|
||||
|
||||
The name ``abibas`` is more like a joke implying that it is not real devices but the simulated ones.
|
||||
The tool consists of two parts - simulator (implemented using **pyModbusTCP**) and UI interface to it for configuration and monitoring (implemented using **Flask**)
|
||||
|
||||
Type ``abibas`` in terminal to run the tool after installation
|
||||
Type Ctrl+C to cancel (or stop) the tool
|
||||
After stopping it a table will be printed out with some stats info
|
||||
|
||||
Requires **python3.10** and above
|
||||
|
||||
Licensed under **GPLv3** license
|
|
@ -0,0 +1,42 @@
|
|||
Purpose
|
||||
=======
|
||||
This is a testing tool for one proprietary enterprise app which in turn handles aviation lights on top of the wind turbines for aviation safety.
|
||||
While working on that app it is not always possible to use real devices (so called light controllers).
|
||||
|
||||
Thus the purpose of this tool to help with development via simulating those devices.
|
||||
Communication with controllers is built upon **MODBUS** protocol via TCP/IP.
|
||||
|
||||
The name ``abibas`` is more like a joke implying that it is not real devices but the simulated ones.
|
||||
The tool consists of two parts - simulator (implemented using **pyModbusTCP**) and UI interface to it for configuration and monitoring (implemented using **Flask**)
|
||||
|
||||
Type ``abibas`` in terminal to run the tool after installation
|
||||
Type Ctrl+C to cancel (or stop) the tool
|
||||
After stopping it a table will be printed out with some stats info
|
||||
|
||||
Requires **python3.10** and above
|
||||
|
||||
Licensed under **GPLv3** license
|
||||
|
||||
|
||||
Setup & debug
|
||||
=============
|
||||
+ clone the repo and cd to the cloned dir
|
||||
+ ``python3.11 -m venv .venv``
|
||||
+ ``source .venv/bin/activate``
|
||||
+ ``pip install build``
|
||||
+ ``python -m build``
|
||||
+ ``pip install -e .``
|
||||
+ ``pip list`` (pip show abibas, pip uninstall abibas, etc)
|
||||
|
||||
At this stage the package is installed in editable mode, to run it in debug mode:
|
||||
|
||||
+ ``abibas-debug``
|
||||
|
||||
or in normal mode:
|
||||
|
||||
+ ``abibas``
|
||||
|
||||
If in debug mode changes made to the Flask app will be applied automatically at runtime,
|
||||
for the changes in simulator though the tool has to be restarted.
|
||||
|
||||
**main** module can be manipulated for debugging purposes as well
|
34
README.rst
34
README.rst
|
@ -1,34 +0,0 @@
|
|||
Purpose
|
||||
=======
|
||||
This is a simple helper tool designed specifically for one enterprise app,
|
||||
which in turn controls flashing lights on the wind turbines for aviation safety.
|
||||
|
||||
This tool simulates interaction with the light controllers via MODBUS protocol over TCP/IP and additionally provides a simple UI for configuration and monitoring.
|
||||
UI is built using **Flask**, simulator - using the **pyModbusTCP** package
|
||||
|
||||
Requires **python3.10** and above
|
||||
|
||||
Licensed under **GPLv3** license
|
||||
|
||||
Setup & debug
|
||||
=============
|
||||
+ clone the repo and cd to the cloned dir
|
||||
+ ``python3.11 -m venv .venv``
|
||||
+ ``source .venv/bin/activate``
|
||||
+ ``pip install build``
|
||||
+ ``python -m build``
|
||||
+ ``pip install -e .``
|
||||
+ ``pip list`` (pip show abibas, pip uninstall abibas, etc)
|
||||
|
||||
At this stage the package is installed in editable mode, to run it in debug mode:
|
||||
|
||||
+ ``abibas-debug``
|
||||
|
||||
or in normal mode:
|
||||
|
||||
+ ``abibas``
|
||||
|
||||
If in debug mode changes made to the Flask app will be applied automatically at runtime,
|
||||
for the changes in simulator though the tool has to be restarted.
|
||||
|
||||
**main** module can be manipulated for debugging purposes as well
|
|
@ -8,13 +8,18 @@ authors = [
|
|||
{name = "Taryel Hlontsi", email = "xhaaix@gmail.com"},
|
||||
]
|
||||
description = "Aviation lights simulator for Environmental Control (EC)"
|
||||
readme = "README.rst"
|
||||
readme = "DESCRIPTION.rst"
|
||||
requires-python = ">=3.10"
|
||||
keywords = ["simulator", "MODBUS", "EC"]
|
||||
license = {file = "LICENSE"}
|
||||
classifiers = [
|
||||
"Framework :: Flusk",
|
||||
"Development Status :: 3 - Alpha",
|
||||
"License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",
|
||||
"Intended Audience :: Developers",
|
||||
"Framework :: Flask",
|
||||
"Programming Language :: Python :: 3",
|
||||
"Programming Language :: Python :: 3.10",
|
||||
"Topic :: Software Development :: Libraries :: Python Modules",
|
||||
]
|
||||
dependencies = [
|
||||
"Flask",
|
||||
|
|
Loading…
Reference in New Issue