Metadata-Version: 2.1
Name: mebo
Version: 0.1.0b1
Summary: Simple python interface to control the mebo toy robot
Home-page: https://github.com/crlane/python-mebo
Author: Cameron Lane
Author-email: crlane@adamanteus.com
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Education
Classifier: Topic :: Scientific/Engineering :: Human Machine Interfaces
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Dist: requests (==2.21.0)
Requires-Dist: zeroconf (==0.21.3)
Provides-Extra: development
Requires-Dist: ipython ; extra == 'development'
Requires-Dist: ipdb ; extra == 'development'
Provides-Extra: testing
Requires-Dist: coverage (==4.0.3) ; extra == 'testing'
Requires-Dist: pytest (==4.0.2) ; extra == 'testing'
Requires-Dist: pytest-cov (==2.5.1) ; extra == 'testing'
Requires-Dist: Sphinx (==1.8.3) ; extra == 'testing'
Requires-Dist: python-coveralls (==2.9.1) ; extra == 'testing'

mebo
----

Mebo is a python package to control the `Mebo Robot <https://meborobot.com>`_ with Python. It is currently in active development, so there might be breaking changes. Some basic usage is defined below, but more extensive `documentation is available at ReadTheDocs <https://python-mebo.readthedocs.io/en/latest/>`_.

.. note::
    This project is not associated with the official Mebo project or its owners, Skyrocket LLC.

.. note::

    This package and the associated modules have been tested on Mebo version 1 *only*.


Installation
---------------

.. code:: 

   pip install mebo




Quickstart
----------

Some basic usage is below. The API will change and limited documentation exists, but it works for getting started.

.. code:: python

    from mebo import Mebo
    m = Mebo(auto_connect=True) # discover and connect automatically!
    m.move('n', speed=255, dur=1000)  # move forward at max speed for 1 second
    m.arm.up(dur=1000) # move the arm up for one second
    m.claw.open(dur=1000) # open the claw for one second


Development
-----------

Requirements:
~~~~~~~~~~~~~
* python >= 3.6

To get started with the project:

.. code:: 

    git clone https://github.com/crlane/python-mebo.git
    python -m venv mebo-venv
    . mebo-venv/bin/actvate
    pip install -r requirements.txt
    pip install -e .

To run the tests:

.. code::

    pip install -r test_requirements.txt
    py.test

Todo
~~~~

* [ ] Cleaner API (better subclasses, kwargs for component methods, no metaprogramming)
* [ ] Clean up kwargs inconsistency
* [ ] Better documentation
* [ ] Better tests
* [ ] Media stream (multithreading or asyncio, http with <video> tag)




