Modifications

Sauter à la navigation Sauter à la recherche
aucun résumé de modification
Ligne 2 : Ligne 2 :     
{{traduction}}
 
{{traduction}}
 +
 +
== Installer Ampy ==
 +
To install the A[https://github.com/adafruit/ampy dafruit MicroPython tool] (ampy) you'll first need to make sure you have [http://www.python.org/ Python] installed on your computer.  The tool will work with either Python 2.7.x or 3.x so you can use whichever version you prefer.
 +
 +
'''For Linux and Mac OSX''' you probably already have a version of python installed--trying running the python or pip command to see that it's available.  If you don't see python installed consult your package manager or a tool like [http://brew.sh/ Homebrew] to easily install it.
 +
 +
'''For Windows''' you'll need to install Python and be sure to check the box during installation to add python to your system path.
 +
 +
Once Python is avaialble on your system you can easily install ampy from the Python package index.  If you're using '''Python 2.7.x''' open a terminal and run this command:
 +
 +
<nowiki>pip install adafruit-ampy</nowiki>
 +
 +
Note on some Linux and Mac OSX systems you might need to install as root with sudo:
 +
 +
<nowiki>sudo pip3 install adafruit-ampy</nowiki>
 +
 +
Or if you'd like to use Python 3.x run the pip3 command instead (using sudo if necessary):
 +
 +
<nowiki>pip3 install adafruit-ampy</nowiki>
 +
 +
{{ADFImage|FEATHER-CHARGER-FICHIER-MICROPYTHON-AMPY-00.png}}
 +
 +
Finally in some rare cases like Mac OSX with Homebrew and multiple Python versions installed you might need to use the pip2 command to explicitly install in Python 2.7.x:
 +
 +
<nowiki>pip2 install adafruit-ampy</nowiki>
 +
 +
Make sure the pip command finishes without an error.  If you see an error then go back and check you have python installed and are running it as root with sudo if necessary.
 +
 +
To check that ampy installed successfully run the following command to print its usage:
 +
 +
<nowiki>ampy --help</nowiki>
 +
 +
{{ADFImage|FEATHER-CHARGER-FICHIER-MICROPYTHON-AMPY-01.png}}
 +
 +
You should see usage information for the tool printed, like what commands it has and options for using them.  If you see an error instead go back and carefully check the pip install command above succeeded, and that python is in your system path.
 +
 +
== Installer depuis les sources ==
 +
 +
If you'd like to install ampy from its [https://github.com/adafruit/ampy source on GitHub] you can do so easily with a few commands.  If you followed the above steps to install from the Python package index this isn't necessary, but if you'd like the current code or are perhaps modifying it then you'll want to install from source.
 +
 +
First [https://github.com/adafruit/ampy/archive/master.zip download the source] or use the git tool to clone it from GitHub:
 +
 +
<nowiki>git clone https://github.com/adafruit/ampy.git</nowiki>
 +
 +
Then in a terminal navigate to the directory with the cloned or extracted source and run the following command to install with ''''Python 2.7.x''':
 +
 +
<nowiki>python setup.py install</nowiki>
 +
 +
Note on some Linux and Mac OSX machines you might need to run as root with sudo:
 +
 +
<nowiki>sudo python setup.py install</nowiki>
 +
 +
Or to install for Python 3.x use the python3 command (using sudo when necessary too):
 +
 +
<nowiki>python3 setup.py install</nowiki>
 +
 +
{{ADFImage|FEATHER-CHARGER-FICHIER-MICROPYTHON-AMPY-02.png}}
 +
 +
Carefully inspect the output of the command to make sure it finished without an error or exception.  You should see something like 'Finished processing dependencies for adafruit-ampy...' as the last line.  Once installed in this way the ampy tool should be available in your path just like if installed from the Python package index.
 +
 +
One final way to install ampy from source is in '''develop''' mode, this way the cloned / downloaded code will actually be the code Python runs instead of copying and installing it into an internal Python module cache.  This is handy if you're working on the code and want to see your changes immediately updated.  To install in develop mode just run the setup.py command above but change '''install''' to '''develop'''.
 +
 +
Also note on Python 2.7.x if you plan to run the unit tests in the source code you will need the mock module installed:
 +
 +
<nowiki>pip install mock</nowiki>
    
{{FEATHER-CHARGER-FICHIER-MICROPYTHON-TRAILER}}
 
{{FEATHER-CHARGER-FICHIER-MICROPYTHON-TRAILER}}
29 917

modifications

Menu de navigation