General purpose Python automatization library
Automate is a general purpose automatization library for Python. Its objective is to offer convenient and robust object-oriented programming framework for complex state machine systems. Automate can be used to design complex automation systems, yet it is easy to learn and fun to use. It was originally developed with home robotics/automatization projects in mind, but is quite general in nature and one could find applications from various fields that could take advantage of Automate. Automate can be embedded in other Python software as a component, which runs its operations in its own threads.
Let’s take a look at a small Automate program as an example, which uses also automate-rpio extension.
from automate import * class MySystem(System): # HW swtich connected Raspberry Pi GPIO port 1 hardware_switch = RpioSensor(port=1) # Switch that is controllable, for example, from WEB interface web_switch = UserBoolSensor() # Lamp relay that switches lamp on/off, connected to GPIO port 2 lamp = RpioActuator(port=2) # Program that controls the system behaviour program = Program( active_condition=Or('web_switch', 'hardware_switch'), on_activate=SetStatus('lamp', True) ) my_system = MySystem()
This simple example has two sensors hardware_switch, web_switch, actuator (lamp) and a program that contains logic what to do and when. Here, lamp is switched on if either web_switch or hardware_switch has status True.
Automate can be installed like ordinary python package. I recommend installation in within virtual environment (see virtualenv).
(optional): Create and start using virtualenv:
mkvirtualenv automate workon automate
Install from pypi:
pip install automate
If you want to install some extensions too, you may also run:
pip install automate-webui pip install automate-rpc pip install automate-arduino pip install automate-rpio
Optionally, you could install also by cloning GIT repository and installing manually:
git clone https://github.com/tuomas2/automate.git cd automate ./setup.py install
Automate is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
Automate is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with Automate. If not, see http://www.gnu.org/licenses/.