.gitignore: ignore generated files

Signed-off-by: Erik Bernoth <erik.bernoth@gmail.com>
Acked-by: Eik Binschek <eik.binschek@dresearch-fe.de>
Acked-by: Peter Winkler <peter.winkler@dresearch-fe.de>
conn.py: Implementing connection layer

The connection layer is the lowest abstraction layer of the MONK framework.
Its task is to interact directly with different types of connections. Some
logic is implemented via the State design pattern, and a cmd() method is
implmented as general interface for all connections. This cmd() method sends
a shell command to the target device and returns its standard output and some
additional information, e.g. the prompt or the return code of the shell
command.

See GitHub Issue #72

Signed-off-by: Erik Bernoth <erik.bernoth@gmail.com>
Acked-by: Eik Binschek <eik.binschek@dresearch-fe.de>
Acked-by: Peter Winkler <peter.winkler@dresearch-fe.de>
dev.py: Implementation of the device layer

The device layer is the central layer of the MONK framework. Its task is to
abstract a target device in an object, offering the same cmd() interface as the
connection layer, while handling more errors and many different connections for
the user. By using this layer it should be possible to focus on the interaction
with the target device without worrying how the object and the device actually
communicate with each other.

See GitHub Issue #72

Signed-off-by: Erik Bernoth <erik.bernoth@gmail.com>
Acked-by: Eik Binschek <eik.binschek@dresearch-fe.de>
Acked-by: Peter Winkler <peter.winkler@dresearch-fe.de>
conn.py/dev.py: PWR's feedback implemented

 * protected "constants" in AState
 * module doc in dev.py
 * single character names replaced by longer names

See GitHub Issue #72 for more information.

Signed-off-by: Erik Bernoth <erik.bernoth@gmail.com>
Acked-by: Eik Binschek <eik.binschek@dresearch-fe.de>
Acked-by: Peter Winkler <peter.winkler@dresearch-fe.de>
conn.py/dev.py: update documentation

To decrease the burdon of the first steps when reading the code base each file
now contains an overview of the classes and sections in the code files and each
section has a section header with a short intro sentence.

See GitHub Issue #72 for more details.

Signed-off-by: Erik Bernoth <erik.bernoth@gmail.com>
Acked-by: Eik Binschek <eik.binschek@dresearch-fe.de>
Acked-by: Peter Winkler <peter.winkler@dresearch-fe.de>
conn.py: debug; forgot a return

These returns are done for this case that a connection wants to return
something from their protected methods to the caller. In most cases they are
not used, but when you need it, then you are happy it is there.

See GitHub Issue #72.

Signed-off-by: Erik Bernoth <erik.bernoth@gmail.com>
Acked-by: Eik Binschek <eik.binschek@dresearch-fe.de>
Acked-by: Peter Winkler <peter.winkler@dresearch-fe.de>
conn.py: without login credentials return False

See GitHub Issue #72.

Signed-off-by: Erik Bernoth <erik.bernoth@gmail.com>
Acked-by: Eik Binschek <eik.binschek@dresearch-fe.de>
Acked-by: Peter Winkler <peter.winkler@dresearch-fe.de>
conn.py/dev.py: detail documentation

Both reviewers considered it too incomplete, therefore degree of detail was
increased for all documentation.

See GitHub Issue #72.

Signed-off-by: Erik Bernoth <erik.bernoth@gmail.com>
Acked-by: Eik Binschek <eik.binschek@dresearch-fe.de>
Acked-by: Peter Winkler <peter.winkler@dresearch-fe.de>
test_conn.py: test_fsm with second state check

See GitHub Issue #72.

Signed-off-by: Erik Bernoth <erik.bernoth@gmail.com>
Acked-by: Eik Binschek <eik.binschek@dresearch-fe.de>
Acked-by: Peter Winkler <peter.winkler@dresearch-fe.de>
test_conn.py: add error test case

See GitHub Issue #72.

Signed-off-by: Erik Bernoth <erik.bernoth@gmail.com>
Acked-by: Eik Binschek <eik.binschek@dresearch-fe.de>
Acked-by: Peter Winkler <peter.winkler@dresearch-fe.de>
conn.py: more debug logging output

See GitHub Issue #72.

Signed-off-by: Erik Bernoth <erik.bernoth@gmail.com>
Acked-by: Eik Binschek <eik.binschek@dresearch-fe.de>
Acked-by: Peter Winkler <peter.winkler@dresearch-fe.de>
Merge branch 'f-conn-dev' into dev

Closes GitHub Issue #72