1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
|
Metadata-Version: 2.1
Name: nxt-python
Version: 3.5.1
Summary: LEGO Mindstorms NXT Control Package
Home-page: https://sr.ht/~ni/nxt-python/
License: GPL-3.0-or-later
Author: Nicolas Schodet
Author-email: nico@ni.fr.eu.org
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Provides-Extra: bluetooth
Provides-Extra: screenshot
Requires-Dist: pillow (>=9.4.0,<10.0.0) ; extra == "screenshot"
Requires-Dist: pybluez (>=0.23,<0.24) ; extra == "bluetooth"
Requires-Dist: pyusb (>=1.2.1,<2.0.0)
Project-URL: Documentation, https://ni.srht.site/nxt-python/latest/
Project-URL: Repository, https://git.sr.ht/~ni/nxt-python
Description-Content-Type: text/markdown
# 
NXT-Python is a package for controlling a LEGO NXT robot using the Python
programming language. It can communicate using either USB or Bluetooth.
NXT-Python for Python 2 is no longer supported.
NXT-Python repository is on [sourcehut][] with a mirror on [Github][].
[sourcehut]: https://sr.ht/~ni/nxt-python/ "NXT-Python repository on sourcehut"
[Github]: https://github.com/schodet/nxt-python "NXT-Python repository on Github"
## Requirements
- [Python 3.x](https://www.python.org)
- USB communication:
- [PyUSB](https://github.com/pyusb/pyusb)
- Bluetooth communication:
- [PyBluez](https://github.com/pybluez/pybluez)
## Installation
Install NXT-Python with pip:
python3 -m pip install --upgrade nxt-python
See [installation][] instructions in the documentation for more informations.
[installation]: https://ni.srht.site/nxt-python/latest/installation.html
## Next steps
You can read the [documentation][], or start directly with the [tutorial][].
[documentation]: https://ni.srht.site/nxt-python/latest/
[tutorial]: https://ni.srht.site/nxt-python/latest/handbook/tutorial.html
## Upgrading your code
If you used previous version of NXT-Python with Python 2, the documentation
includes an [migration guide][].
[migration guide]: https://ni.srht.site/nxt-python/latest/migration.html
## Contact
There is a [mailing list][] for questions.
NXT-Python repository maintainer is Nicolas Schodet, since 2021-11-06. You can
contact him on the mailing list.
You can use the [Github issues page][] to report problems, but please use the
mailing list for questions.
[mailing list]: https://lists.sr.ht/~ni/nxt-python
[Github issues page]: https://github.com/schodet/nxt-python/issues
## Thanks
- Doug Lau for writing NXT\_Python, our starting point.
- rhn for creating what would become v2, making lots of smaller changes, and
reviewing tons of code.
- Marcus Wanner for maintaining NXT-Python up to v2.2.2, his work has been
amazing!
- Elvin Luff for taking over the project after Marcus, making a lot of work
for the port to Python 3.
- mindsensors.com (esp. Ryan Kneip) for helping out with the code for a lot of
their sensors, expanding the sensors covered by the type checking database,
and providing hardware for testing.
- HiTechnic for providing identification information for their sensors. I note
that they have now included this information in their website. ;)
- Linus Atorf, Samuel Leeman-Munk, melducky, Simon Levy, Steve Castellotti,
Paulo Vieira, zonedabone, migpics, TC Wan, jerradgenson, henryacev, Paul
Hollensen, and anyone else I forgot for various fixes and additions.
- Goldsloth for making some useful changes and keeping the tickets moving
after the migration to Github.
- All our users for their interest and support!
## License
NXT-Python 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.
This program 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
this program. If not, see <https://www.gnu.org/licenses/>.
|
