circup 0.1.0

Installation

Circup requires Python 3.5 or higher.

In a virtualenv, pip install circup should do the trick. This is the simplest way to make it work.

If you have no idea what a virtualenv is, try the following command, pip3 install --user circup.

What?

Each CircuitPython library on the device (.py, NOT .mpy at this time) usually has a version number as metadata within the module.

This utility looks at all the libraries on the device and checks if they are the most recent (compared to the versions found in the most recent version of the Adafruit CircuitPython Bundle). If the libraries are out of date, the utility helps you update them.

The Adafruit CircuitPython Bundle can be found here:

https://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases/latest

Full details of these libraries, what they’re for and how to get them, can be found here:

https://circuitpython.org/libraries

Usage

First, plug in a device running CircuiPython. This should appear as a mounted storage device called CIRCUITPYTHON.

To get help, just type the command:

$ circup
Usage: circup [OPTIONS] COMMAND [ARGS]...

  A tool to manage and update libraries on a CircuitPython device.

Options:
  --verbose         Comprehensive logging is sent to stdout.
  --version         Show the version and exit.
  --help            Show this message and exit.
  -r --requirement  Supports requirements.txt tracking of library
                    requirements with freeze and install commands.

Commands:
  freeze     Output details of all the modules found on the connected...
  install    Install a named module onto the device.
  list       Lists all out of date modules found on the connected...
  show       Show a list of available modules in the bundle.
  uninstall  Uninstall a named module(s) from the connected device.
  update     Update modules on the device. Use --all to automatically update
             all modules.

To show version information for all the modules currently on a connected CIRCUITPYTHON device:

$ circup freeze
adafruit_binascii==v1.0
adafruit_bme280==2.3.1
adafruit_ble==1.0.2

With $ circup freeze -r, Circup will save, in the current working directory, a requirements.txt file with a list of all modules currently installed on the connected device.

To list all the modules that require an update:

$ circup list
The following modules are out of date or probably need an update.

Module             Version  Latest
------------------ -------- --------
adafruit_binascii  v1.0     1.0.1
adafruit_ble       1.0.2    4.0

To interactively update the out-of-date modules:

$ circup update
Found 3 module[s] needing update.
Please indicate which modules you wish to update:

Update 'adafruit_binascii'? [y/N]: Y
OK
Update 'adafruit_ble'? [y/N]: Y
OK

Install a module onto the connected device with:

$ circup install adafruit_thermal_printer
Installed 'adafruit_thermal_printer'.

You can also install a list of modules from a requirements.txt file in the current working directory with:

$ circup install -r requirements.txt
Installed 'adafruit_bmp280'.
Installed 'adafruit_lis3mdl'.
Installed 'adafruit_lsm6ds'.
Installed 'adafruit_sht31d'.
Installed 'neopixel'.

Uninstall a module like this:

$ circup uninstall adafruit_thermal_printer
Uninstalled 'adafruit_thermal_printer'.

Use the --verbose flag to see the logs as the command is working:

$ circup --verbose freeze
Logging to /home/ntoll/.cache/circup/log/circup.log

INFO: Started 2019-09-05 13:13:41.031822
INFO: Freeze
INFO: Found device: /media/ntoll/CIRCUITPY
... etc ...

Finally, the --version flag will tell you the current version of the circup command itself:

$ circup --version
CircUp, A CircuitPython module updater. Version 0.0.1

That’s it!

Developer Setup

Clone the repository then make a virtualenv. From the root of the project, install the requirements:

pip install -e ".[dev]"

Run the test suite:

make check

There is a Makefile that helps with most of the common workflows associated with development. Typing “make” on its own will list the options thus:

$ make

There is no default Makefile target right now. Try:

make clean - reset the project and remove auto-generated assets.
make pyflakes - run the PyFlakes code checker.
make pycodestyle - run the PEP8 style checker.
make test - run the test suite.
make coverage - view a report on test coverage.
make tidy - tidy code with the 'black' formatter.
make check - run all the checkers and tests.
make dist - make a dist/wheel for the project.
make publish-test - publish the project to PyPI test instance.
make publish-live - publish the project to PyPI production.
make docs - run sphinx to create project documentation.

make check

make tidy

0.0.8

• Added requirements.txt support to both freeze and install commands. Many thanks to Steven Abadie for this really useful feature.

0.0.7

Two new features contributed from the community:

• Run circup via python -m circup. Thank you to Joe DeVivo for this contribution.

• Add an uninstall command. Thank you to Steven Abadie for this new feature.

0.0.6

This release includes a security fix

0.0.5

Fixed error message when Bundle Unavailable

• Error message when bundle unavailable is better

• Fixed a couple types

0.0.4

Added install and show commands

• Circup now has an install command to install a CircuitPython library onto your device.

• It also has a show command to show you what is available.

0.0.3

Automated Release Deployment Bug Fix

• Fix missing PyPI egg dependency

0.0.2

Initial PyPI Release Automation w/ TravisCI

• Add Continuous Integration with TravisCI

• Deploy circup releases to PyPI automatically with TravisCI

0.0.1

Initial release.

• Core project scaffolding.

• circup freeze - lists version details for all modules found on the connected CIRCUITPYTHON device.

• circup list - lists all modules requiring an update found on the the connected CIRCUITPYTHON device.

• circup update - interactively update out-of-date modules found on the connected CIRCUITPYTHON device.

• 100% test coverage.

• Documentation.