# martypy
Python library to communicate with Marty the Robot V1 and V2 by Robotical
[See the API Documentation](https://userguides.robotical.io/martyv2/documentation/python_function_reference)
To regenerate documentation:
- pip install -r dev-requirements.txt
- pydoc-markdown --server --open
OR, automatically:
- run docgen.bat (or docgen.sh on Mac/Linux) from Python environment (will put the contents of the formatted docs into clipboard)
## How to run example scripts
If you cloned the repository or downloaded the source code to try the [example scripts](examples),
you will need to make sure you have MartyPy installed before you can run the examples.
The easiest way to install MartyPy is with the `pip install martypy` script as explained in
[step 2 here](https://userguides.robotical.io/martyv2/userguides/python/setting_up_python_on_your_computer).
Once martypy is installed you can run each example using python.
The following (for the dance example) assumes you have connected your marty using the USB cable to a Windows computer
python example_dance.py USB
To run the sound example over WiFi when your Marty is connected on IP address 192.168.86.10, use:
python example_sound.py WiFi 192.168.0.10
If you would like to make modifications to the martypy library itself, it will be better to install
it from source using the command `pip install --editable /path/to/martypy/repo` (replacing
`/path/to/martypy/repo` as appropriate of course).
If you do not want to "`pip install`" the MartyPy library, you can add the following 4 lines at the
top (before any other code) of each script you want to run:
```python
import sys
import pathlib
cur_path = pathlib.Path(__file__).parent.resolve()
sys.path.append(str(cur_path.parent.resolve()))
```
Raw data
{
"_id": null,
"home_page": "http://github.com/robotical/martypy",
"name": "martypy",
"maintainer": "Robotical",
"docs_url": null,
"requires_python": "",
"maintainer_email": "hello@robotical.io",
"keywords": "ros,robot,marty,marty the robot,robotical",
"author": "Robotical",
"author_email": "hello@robotical.io",
"download_url": "https://files.pythonhosted.org/packages/10/61/624e4b8c5f3f7b53a1b659be07f2ece37f5ef34dddb44d1fb65d5b100f1f/martypy-3.6.6.tar.gz",
"platform": null,
"description": "# martypy\n\nPython library to communicate with Marty the Robot V1 and V2 by Robotical\n\n[See the API Documentation](https://userguides.robotical.io/martyv2/documentation/python_function_reference)\n\nTo regenerate documentation:\n- pip install -r dev-requirements.txt\n- pydoc-markdown --server --open\nOR, automatically:\n- run docgen.bat (or docgen.sh on Mac/Linux) from Python environment (will put the contents of the formatted docs into clipboard)\n\n## How to run example scripts\n\nIf you cloned the repository or downloaded the source code to try the [example scripts](examples),\nyou will need to make sure you have MartyPy installed before you can run the examples.\n\nThe easiest way to install MartyPy is with the `pip install martypy` script as explained in\n[step 2 here](https://userguides.robotical.io/martyv2/userguides/python/setting_up_python_on_your_computer).\n\nOnce martypy is installed you can run each example using python.\nThe following (for the dance example) assumes you have connected your marty using the USB cable to a Windows computer\n\npython example_dance.py USB\n\nTo run the sound example over WiFi when your Marty is connected on IP address 192.168.86.10, use:\n\npython example_sound.py WiFi 192.168.0.10\n\nIf you would like to make modifications to the martypy library itself, it will be better to install\nit from source using the command `pip install --editable /path/to/martypy/repo` (replacing\n`/path/to/martypy/repo` as appropriate of course).\n\nIf you do not want to \"`pip install`\" the MartyPy library, you can add the following 4 lines at the\ntop (before any other code) of each script you want to run:\n\n```python\nimport sys\nimport pathlib\ncur_path = pathlib.Path(__file__).parent.resolve()\nsys.path.append(str(cur_path.parent.resolve()))\n```\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "Python library for Marty the Robot V1 and V2",
"version": "3.6.6",
"project_urls": {
"Homepage": "http://github.com/robotical/martypy"
},
"split_keywords": [
"ros",
"robot",
"marty",
"marty the robot",
"robotical"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ce56b3c850a2032ded8ec74a894bdf1b91911e3fcf5a38d883ce5354303f26e6",
"md5": "72f3b96be11784057e3ed17f301c92a1",
"sha256": "eb42a27deb41f5fc5e59c08f5f26b01a3ccf30db4c7c064920c7692eba71fb2d"
},
"downloads": -1,
"filename": "martypy-3.6.6-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "72f3b96be11784057e3ed17f301c92a1",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 80557,
"upload_time": "2024-01-12T09:50:08",
"upload_time_iso_8601": "2024-01-12T09:50:08.760782Z",
"url": "https://files.pythonhosted.org/packages/ce/56/b3c850a2032ded8ec74a894bdf1b91911e3fcf5a38d883ce5354303f26e6/martypy-3.6.6-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1061624e4b8c5f3f7b53a1b659be07f2ece37f5ef34dddb44d1fb65d5b100f1f",
"md5": "d30c46fbd651f967e5542dc5e0f98c10",
"sha256": "ec9a7ecf3b373e60c0b4868e3231b6f3208a58eb73cb63c561590a9d0732ad39"
},
"downloads": -1,
"filename": "martypy-3.6.6.tar.gz",
"has_sig": false,
"md5_digest": "d30c46fbd651f967e5542dc5e0f98c10",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 71664,
"upload_time": "2024-01-12T09:50:10",
"upload_time_iso_8601": "2024-01-12T09:50:10.707564Z",
"url": "https://files.pythonhosted.org/packages/10/61/624e4b8c5f3f7b53a1b659be07f2ece37f5ef34dddb44d1fb65d5b100f1f/martypy-3.6.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-12 09:50:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "robotical",
"github_project": "martypy",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "martypy"
}
JSON
