automate 0.10.19

Description:

automate 0.10.19

Automate

Github URL: http://github.com/tuomas2/automate
Read full documentation at http://python-automate.readthedocs.org/

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.

Highlights:

Supported hardware:

Raspberry Pi GPIO input/output ports
Arduino support
for analog and digital input/output ports and VirtualWire wireless networking
with AutomateFirmata.
Easy to write extensions to support other hardware


System state saving and restoring via serialization
Intelligent design:

Comprehensively tested via py.test unit/integration tests
Takes advantage of Traits library, especially its
notification system.
IPython console to monitor, modify and control system on-the-fly
Versatile function/callable library to write state program logic


RPC and Websocket interfaces to connect between other applications or other Automate systems.
Comprehensive and customizable
Web User Interface
UML graphs can be drawn automaticlaly of the system (as can be seen in the examples
of this documentation)



Example
Let’s take a look at a small Automate program as an example:
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.


Installing Automate
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


Optionally, you can specify some of the extras, i.e. web, rpc, raspberrypi, arduino:
pip install automate[web,rpc,raspberrypi,arduino]
or if you want them all:
pip install automate[all]


License
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/.