Source: python-uflash
Section: python
Priority: optional
Maintainer: Debian Python Team <team+python@tracker.debian.org>
Uploaders: Nick Morrott <nickm@debian.org>
Build-Depends:
 debhelper-compat (= 13),
 dh-python,
 pandoc,
 python3-all,
 python3-coverage,
 python3-mock,
 python3-nudatus,
 python3-pycodestyle,
 python3-pyflakes,
 python3-pytest,
 python3-pytest-cov,
 python3-setuptools,
 python3-sphinx,
Standards-Version: 4.5.1
Homepage: https://github.com/ntoll/uflash
Vcs-Browser: https://salsa.debian.org/python-team/packages/python-uflash
Vcs-Git: https://salsa.debian.org/python-team/packages/python-uflash.git
Rules-Requires-Root: no

Package: python3-uflash
Architecture: all
Depends:
 python3 (>= 3.5),
 ${misc:Depends},
 ${python3:Depends},
Recommends:
 firmware-microbit-micropython,
 python3-nudatus,
Suggests:
 firmware-microbit-micropython-dl,
 python-uflash-doc,
Description: module and utility for flashing the BBC micro:bit
 uflash is a utility for flashing the BBC micro:bit with Python scripts
 and the MicroPython runtime.
 .
 It provides two services:
 .
  * a library of functions to programmatically create a hex file and flash
    it onto a BBC micro:bit.
  * a command line utility (uflash) that will flash Python scripts onto
    a BBC micro:bit
 .
 Several essential operations are implemented:
 .
  * encode Python into the hex format
  * embed the resulting hexified Python into the MicroPython runtime hex
  * extract an encoded Python script from a MicroPython hex file
  * discover the connected micro:bit
  * copy the resulting hex onto the micro:bit, thus flashing the device
  * specify the MicroPython runtime hex in which to embed your Python code
 .
 By default, python3-uflash will use the MicroPython runtime for micro:bit
 provided by the firmware-microbit-micropython{,-dl} packages and which is
 located in /usr/share/firmware-microbit-micropython/firmware.hex. Please
 ensure one of these packages is installed so that a default runtime is
 always available.
 .
 This package provides the Python 3 module.

Package: python-uflash-doc
Section: doc
Architecture: all
Multi-Arch: foreign
Depends:
 ${misc:Depends},
 ${sphinxdoc:Depends},
Suggests:
 www-browser,
Enhances: python3-uflash
Breaks: python3-uflash-doc
Replaces: python3-uflash-doc
Description: module and utility for flashing the BBC micro:bit (documentation)
 uflash is a utility for flashing the BBC micro:bit with Python scripts
 and the MicroPython runtime.
 .
 It provides two services:
 .
  * a library of functions to programmatically create a hex file and flash
    it onto a BBC micro:bit.
  * a command line utility (uflash) that will flash Python scripts onto
    a BBC micro:bit
 .
 Several essential operations are implemented:
 .
  * encode Python into the hex format
  * embed the resulting hexified Python into the MicroPython runtime hex
  * extract an encoded Python script from a MicroPython hex file
  * discover the connected micro:bit
  * copy the resulting hex onto the micro:bit, thus flashing the device
  * specify the MicroPython runtime hex in which to embed your Python code
 .
 By default, python3-uflash will use the MicroPython runtime for micro:bit
 provided by the firmware-microbit-micropython{,-dl} packages and which is
 located in /usr/share/firmware-microbit-micropython/firmware.hex. Please
 ensure one of these packages is installed so that a default runtime is
 always available.
 .
 This package provides the uflash documentation.

Package: firmware-microbit-micropython-dl
Section: contrib/python
Architecture: all
Depends:
 ca-certificates,
 wget,
 ${misc:Depends},
 ${shlibs:Depends},
Recommends:
 python3-uflash,
Conflicts:
 firmware-microbit-micropython,
Enhances: python3-uflash
Description: micro:bit MicroPython runtime downloader
 This empty package will, at the time of installation, download the
 current MicroPython runtime for the micro:bit as bundled with uflash
 upstream.
 .
 The firmware image will be downloaded from https://github.com/ntoll/uflash
 and saved to /usr/share/firmware-microbit-micropython/firmware.hex
 .
 Note that this package will not flash MicroPython onto the micro:bit; that can
 be done with the uflash utility (package: python3-uflash).