Repackage and focus on Python only code.

Author: Gadgetoid

library/CHANGELOG.txt renamed to CHANGELOG.md

@@ -0,0 +1,60 @@
+LIBRARY_NAME := $(shell hatch project metadata name 2> /dev/null)
+LIBRARY_VERSION := $(shell hatch version 2> /dev/null)
+
+.PHONY: usage install uninstall check pytest qa build-deps check tag wheel sdist clean dist testdeploy deploy
+usage:
+ifdef LIBRARY_NAME
+	@echo "Library: ${LIBRARY_NAME}"
+	@echo "Version: ${LIBRARY_VERSION}\n"
+else
+	@echo "WARNING: You should 'make dev-deps'\n"
+endif
+	@echo "Usage: make <target>, where target is one of:\n"
+	@echo "install:      install the library locally from source"
+	@echo "uninstall:    uninstall the local library"
+	@echo "dev-deps:     install Python dev dependencies"
+	@echo "check:        perform basic integrity checks on the codebase"
+	@echo "qa:           run linting and package QA"
+	@echo "pytest:       run Python test fixtures"
+	@echo "clean:        clean Python build and dist directories"
+	@echo "build:        build Python distribution files"
+	@echo "testdeploy:   build and upload to test PyPi"
+	@echo "deploy:       build and upload to PyPi"
+	@echo "tag:          tag the repository with the current version\n"
+
+install:
+	./install.sh --unstable
+
+uninstall:
+	./uninstall.sh
+
+dev-deps:
+	python3 -m pip install -r requirements-dev.txt
+	sudo apt install dos2unix
+
+check:
+	@bash check.sh
+
+qa:
+	tox -e qa
+
+pytest:
+	tox -e py
+
+nopost:
+	@bash check.sh --nopost
+
+tag:
+	git tag -a "v${LIBRARY_VERSION}" -m "Version ${LIBRARY_VERSION}"
+
+build: check
+	@hatch build
+
+clean:
+	-rm -r dist
+
+testdeploy: build
+	twine upload --repository testpypi dist/*
+
+deploy: nopost build
+	twine upload dist/*

Dockerfile

@@ -1,89 +1,65 @@
-![Blinkt!](blinkt-logo.png)
-
-[![Build Status](https://travis-ci.com/pimoroni/blinkt.svg?branch=master)](https://travis-ci.com/pimoroni/blinkt)
-[![Coverage Status](https://coveralls.io/repos/github/pimoroni/blinkt/badge.svg?branch=master)](https://coveralls.io/github/pimoroni/blinkt?branch=master)
-[![PyPi Package](https://img.shields.io/pypi/v/blinkt.svg)](https://pypi.python.org/pypi/blinkt)
-[![Python Versions](https://img.shields.io/pypi/pyversions/blinkt.svg)](https://pypi.python.org/pypi/blinkt)
-
-https://shop.pimoroni.com/products/blinkt
-
-Eight super-bright RGB LED indicators, ideal for adding visual notifications to your Raspberry Pi on their own or on a pHAT stacking header.
-
-## Installing
-
-### Full install (recommended):
-
-We've created an easy installation script that will install all pre-requisites and get your Blinkt!
-up and running with minimal efforts. To run it, fire up Terminal which you'll find in Menu -> Accessories -> Terminal
-on your Raspberry Pi desktop, as illustrated below:
-
-![Finding the terminal](http://get.pimoroni.com/resources/github-repo-terminal.png)
-
-In the new terminal window type the command exactly as it appears below (check for typos) and follow the on-screen instructions:
-
-```bash
-curl https://get.pimoroni.com/blinkt | bash
-```
-
-Alternatively, on Raspbian, you can download the `pimoroni-dashboard` and install your product by browsing to the relevant entry:
-
-```bash
-sudo apt-get install pimoroni
-```
-(you will find the Dashboard under 'Accessories' too, in the Pi menu - or just run `pimoroni-dashboard` at the command line)
-
-If you choose to download examples you'll find them in `/home/pi/Pimoroni/blinkt/`.
-
-### Manual install:
-
-#### Library install for Python 3:
-
-on Raspbian:
-
-```bash
-sudo apt-get install python3-blinkt
-```
-
-other environments: 
-
-```bash
-sudo pip3 install blinkt
-```
-
-#### Library install for Python 2:
-
-on Raspbian:
-
-```bash
-sudo apt-get install python-blinkt
-```
-
-other environments: 
-
-```bash
-sudo pip2 install blinkt
-```
-
-### Development:
-
-If you want to contribute, or like living on the edge of your seat by having the latest code, you should clone this repository, `cd` to the library directory, and run:
-
-```bash
-sudo python3 setup.py install
-```
-(or `sudo python setup.py install` whichever your primary Python environment may be)
-
-## Documentation & Support
-
-* Guides and tutorials - https://learn.pimoroni.com/blinkt
-* Function reference - http://docs.pimoroni.com/blinkt/
-* GPIO Pinout - https://pinout.xyz/pinout/blinkt
-* Get help - http://forums.pimoroni.com/c/support
-
-## Unofficial / Third-party libraries
-
-* Golang library & examples by [Alex Ellis](https://www.alexellis.io) - https://github.com/alexellis/blinkt_go, https://github.com/alexellis/blinkt_go_examples
-* Java library by Jim Darby - https://github.com/hackerjimbo/PiJava
-* Java library by @HoldYourWaffle - https://github.com/HoldYourWaffle/blinkt4j
-* Node.js library by @irrelon - https://github.com/irrelon/node-blinkt
-* Rust library by @golemparts - https://github.com/golemparts/blinkt
+![Blinkt!](blinkt-logo.png)
+
+[![Build Status](https://travis-ci.com/pimoroni/blinkt.svg?branch=master)](https://travis-ci.com/pimoroni/blinkt)
+[![Coverage Status](https://coveralls.io/repos/github/pimoroni/blinkt/badge.svg?branch=master)](https://coveralls.io/github/pimoroni/blinkt?branch=master)
+[![PyPi Package](https://img.shields.io/pypi/v/blinkt.svg)](https://pypi.python.org/pypi/blinkt)
+[![Python Versions](https://img.shields.io/pypi/pyversions/blinkt.svg)](https://pypi.python.org/pypi/blinkt)
+
+https://shop.pimoroni.com/products/blinkt
+
+Eight super-bright RGB LED indicators, ideal for adding visual notifications to your Raspberry Pi on their own or on a pHAT stacking header.
+
+## Installing
+
+### Full install (recommended):
+
+We've created an easy installation script that will install all pre-requisites and get your Blinkt!
+up and running with minimal efforts. To run it, fire up Terminal which you'll find in Menu -> Accessories -> Terminal
+on your Raspberry Pi desktop, as illustrated below:
+
+![Finding the terminal](http://get.pimoroni.com/resources/github-repo-terminal.png)
+
+In the new terminal window type the command exactly as it appears below (check for typos) and follow the on-screen instructions:
+
+```bash
+git clone https://github.com/pimoroni/blinkt
+cd blinkt
+./install.sh
+```
+
+### Manual install:
+
+```bash
+python3 -m pip install blinkt
+```
+### Development:
+
+If you want to contribute, or like living on the edge of your seat by having the latest code, you should clone this repository, `cd` to the library directory, and run:
+
+```bash
+make dev-deps
+make build
+```
+
+To run QA and tests, use:
+
+```bash
+make check
+make qa
+make pytest
+```
+
+## Documentation & Support
+
+* Guides and tutorials - https://learn.pimoroni.com/blinkt
+* Function reference - http://docs.pimoroni.com/blinkt/
+* GPIO Pinout - https://pinout.xyz/pinout/blinkt
+* Get help - http://forums.pimoroni.com/c/support
+
+## Unofficial / Third-party libraries
+
+* Golang library & examples by [Alex Ellis](https://www.alexellis.io) - https://github.com/alexellis/blinkt_go, https://github.com/alexellis/blinkt_go_examples
+* Java library by Jim Darby - https://github.com/hackerjimbo/PiJava
+* Java library by @HoldYourWaffle - https://github.com/HoldYourWaffle/blinkt4j
+* Node.js library by @irrelon - https://github.com/irrelon/node-blinkt
+* Rust library by @golemparts - https://github.com/golemparts/blinkt

Makefile

@@ -2,7 +2,9 @@
 import atexit
 import time
 
-import RPi.GPIO as GPIO
+import gpiod
+
+from gpiod.line import Direction, Value
 
 
 __version__ = '0.1.2'
@@ -11,20 +13,13 @@
 CLK = 24
 NUM_PIXELS = 8
 BRIGHTNESS = 7
+GPIOCHIP = "/dev/gpiochip4"
 
 pixels = [[0, 0, 0, BRIGHTNESS]] * NUM_PIXELS
 
 sleep_time = 0
 
-_gpio_setup = False
-_clear_on_exit = True
-
-
-def _exit():
-    if _clear_on_exit:
-        clear()
-        show()
-    GPIO.cleanup()
+gpio_lines = None
 
 
 def set_brightness(brightness):
@@ -48,45 +43,47 @@ def clear():
 
 def _write_byte(byte):
     for x in range(8):
-        GPIO.output(DAT, byte & 0b10000000)
-        GPIO.output(CLK, 1)
+        gpio_lines.set_value(DAT, Value.ACTIVE if (byte & 0b10000000) else Value.INACTIVE)
+        gpio_lines.set_value(CLK, Value.ACTIVE)
         time.sleep(sleep_time)
         byte <<= 1
-        GPIO.output(CLK, 0)
+        gpio_lines.set_value(CLK, Value.INACTIVE)
         time.sleep(sleep_time)
 
 
 # Emit exactly enough clock pulses to latch the small dark die APA102s which are weird
 # for some reason it takes 36 clocks, the other IC takes just 4 (number of pixels/2)
 def _eof():
-    GPIO.output(DAT, 0)
+    gpio_lines.set_value(DAT, Value.INACTIVE)
     for x in range(36):
-        GPIO.output(CLK, 1)
+        gpio_lines.set_value(CLK, Value.ACTIVE)
         time.sleep(sleep_time)
-        GPIO.output(CLK, 0)
+        gpio_lines.set_value(CLK, Value.INACTIVE)
         time.sleep(sleep_time)
 
 
 def _sof():
-    GPIO.output(DAT, 0)
+    gpio_lines.set_value(DAT, Value.INACTIVE)
     for x in range(32):
-        GPIO.output(CLK, 1)
+        gpio_lines.set_value(CLK, Value.ACTIVE)
         time.sleep(sleep_time)
-        GPIO.output(CLK, 0)
+        gpio_lines.set_value(CLK, Value.INACTIVE)
         time.sleep(sleep_time)
 
 
 def show():
     """Output the buffer to Blinkt!."""
-    global _gpio_setup
-
-    if not _gpio_setup:
-        GPIO.setmode(GPIO.BCM)
-        GPIO.setwarnings(False)
-        GPIO.setup(DAT, GPIO.OUT)
-        GPIO.setup(CLK, GPIO.OUT)
-        atexit.register(_exit)
-        _gpio_setup = True
+    global gpio_lines
+
+    if not gpio_lines:
+        gpio_lines = gpiod.request_lines(
+            GPIOCHIP,
+            consumer="blinkt",
+            config={
+                DAT: gpiod.LineSettings(direction=Direction.OUTPUT, output_value=Value.INACTIVE),
+                CLK: gpiod.LineSettings(direction=Direction.OUTPUT, output_value=Value.INACTIVE)
+            }
+        )
 
     _sof()