diff --git a/library/.coveragerc b/.coveragerc
similarity index 100%
rename from library/.coveragerc
rename to .coveragerc
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
new file mode 100644
index 0000000..5365571
--- /dev/null
+++ b/.github/workflows/build.yml
@@ -0,0 +1,42 @@
+name: Build
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  test:
+    name: Build (Python ${{ matrix.python }})
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python: ['3.9', '3.10', '3.11']
+
+    env:
+      TERM: xterm-256color
+      RELEASE_FILE: ${{ github.event.repository.name }}-${{ github.event.release.tag_name || github.sha }}-py${{ matrix.python }}
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+
+      - name: Install Dependencies
+        run: |
+          make dev-deps
+
+      - name: Build Packages
+        run: |
+          make build
+
+      - name: Upload Packages
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ env.RELEASE_FILE }}
+          path: dist/
diff --git a/.github/workflows/install.yml b/.github/workflows/install.yml
new file mode 100644
index 0000000..f3c1a2d
--- /dev/null
+++ b/.github/workflows/install.yml
@@ -0,0 +1,40 @@
+name: Install Test
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  test:
+    name: Install (Python ${{ matrix.python }})
+    runs-on: ubuntu-latest
+    env:
+      TERM: xterm-256color
+    strategy:
+      matrix:
+        python: ['3.9', '3.10', '3.11']
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+
+      - name: Stub files & Patch install.sh
+        run: |
+          mkdir -p boot/firmware
+          touch boot/firmware/config.txt
+          sed -i "s|/boot/firmware|`pwd`/boot/firmware|g" install.sh
+          sed -i "s|sudo raspi-config|raspi-config|g" pyproject.toml
+          touch raspi-config
+          chmod +x raspi-config
+          echo `pwd` >> $GITHUB_PATH
+
+      - name: Run install.sh
+        run: |
+          ./install.sh --unstable --force
diff --git a/.github/workflows/qa.yml b/.github/workflows/qa.yml
new file mode 100644
index 0000000..2e166c0
--- /dev/null
+++ b/.github/workflows/qa.yml
@@ -0,0 +1,39 @@
+name: QA
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  test:
+    name: Linting & Spelling
+    runs-on: ubuntu-latest
+    env:
+      TERM: xterm-256color
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Set up Python '3,11'
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install Dependencies
+        run: |
+          make dev-deps
+
+      - name: Run Quality Assurance
+        run: |
+          make qa
+
+      - name: Run Code Checks
+        run: |
+          make check
+
+      - name: Run Bash Code Checks
+        run: |
+          make shellcheck
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 06a675b..9e29cb9 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -1,37 +1,43 @@
-name: Python Tests
+name: Tests
 
 on:
   pull_request:
   push:
     branches:
-      - master
+      - main
 
 jobs:
   test:
+    name: Test (Python ${{ matrix.python }})
     runs-on: ubuntu-latest
+    env:
+      TERM: xterm-256color
     strategy:
       matrix:
-        python: [2.7, 3.6, 3.7, 3.9]
+        python: ['3.9', '3.10', '3.11']
 
     steps:
-      - uses: actions/checkout@v2
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
       - name: Set up Python ${{ matrix.python }}
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python }}
+
       - name: Install Dependencies
         run: |
-          python -m pip install --upgrade setuptools tox
+          make dev-deps
+
       - name: Run Tests
-        working-directory: library
         run: |
-          tox -e py
+          make pytest
+
       - name: Coverage
+        if: ${{ matrix.python == '3.9' }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        working-directory: library
         run: |
           python -m pip install coveralls
           coveralls --service=github
-        if: ${{ matrix.python == '3.9' }}
 
diff --git a/library/CHANGELOG.txt b/CHANGELOG.md
similarity index 100%
rename from library/CHANGELOG.txt
rename to CHANGELOG.md
diff --git a/Makefile b/Makefile
index 0813324..56cf0df 100644
--- a/Makefile
+++ b/Makefile
@@ -1,70 +1,66 @@
-LIBRARY_VERSION=$(shell grep version library/setup.cfg | awk -F" = " '{print $$2}')
-LIBRARY_NAME=$(shell grep name library/setup.cfg | awk -F" = " '{print $$2}')
+LIBRARY_NAME := $(shell hatch project metadata name 2> /dev/null)
+LIBRARY_VERSION := $(shell hatch version 2> /dev/null)
 
-.PHONY: usage install uninstall
+.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 "check:         peform basic integrity checks on the codebase"
-	@echo "python-readme: generate library/README.md from README.md + library/CHANGELOG.txt"
-	@echo "python-wheels: build python .whl files for distribution"
-	@echo "python-sdist:  build python source distribution"
-	@echo "python-clean:  clean python build and dist directories"
-	@echo "python-dist:   build all python distribution files"
-	@echo "python-testdeploy: build all and deploy to test PyPi"
-	@echo "tag:           tag the repository with the current version"
+	@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"
+
+version:
+	@hatch version
 
 install:
-	./install.sh
+	./install.sh --unstable
 
 uninstall:
 	./uninstall.sh
 
-check:
-	@echo "Checking for trailing whitespace"
-	@! grep -IUrn --color "[[:blank:]]$$" --exclude-dir=sphinx --exclude-dir=.tox --exclude-dir=.git --exclude=PKG-INFO
-	@echo "Checking for DOS line-endings"
-	@! grep -lIUrn --color "
" --exclude-dir=sphinx --exclude-dir=.tox --exclude-dir=.git --exclude=Makefile
-	@echo "Checking library/CHANGELOG.txt"
-	@cat library/CHANGELOG.txt | grep ^${LIBRARY_VERSION}
-	@echo "Checking library/${LIBRARY_NAME}/__init__.py"
-	@cat library/${LIBRARY_NAME}/__init__.py | grep "^__version__ = '${LIBRARY_VERSION}'"
-
-tag:
-	git tag -a "v${LIBRARY_VERSION}" -m "Version ${LIBRARY_VERSION}"
+dev-deps:
+	python3 -m pip install -r requirements-dev.txt
+	sudo apt install dos2unix shellcheck
 
-python-readme: library/README.md
+check:
+	@bash check.sh
 
-python-license: library/LICENSE.txt
+shellcheck:
+	shellcheck *.sh
 
-library/README.md: README.md library/CHANGELOG.txt
-	cp README.md library/README.md
-	printf "\n# Changelog\n" >> library/README.md
-	cat library/CHANGELOG.txt >> library/README.md
+qa:
+	tox -e qa
 
-library/LICENSE.txt: LICENSE
-	cp LICENSE library/LICENSE.txt
+pytest:
+	tox -e py
 
-python-wheels: python-readme python-license
-	cd library; python3 setup.py bdist_wheel
-	cd library; python setup.py bdist_wheel
+nopost:
+	@bash check.sh --nopost
 
-python-sdist: python-readme python-license
-	cd library; python setup.py sdist
+tag: version
+	git tag -a "v${LIBRARY_VERSION}" -m "Version ${LIBRARY_VERSION}"
 
-python-clean:
-	-rm -r library/dist
-	-rm -r library/build
-	-rm -r library/*.egg-info
+build: check
+	@hatch build
 
-python-dist: python-clean python-wheels python-sdist
-	ls library/dist
+clean:
+	-rm -r dist
 
-python-testdeploy: python-dist
-	twine upload --repository-url https://test.pypi.org/legacy/ library/dist/*
+testdeploy: build
+	twine upload --repository testpypi dist/*
 
-python-deploy: check python-dist
-	twine upload library/dist/*
+deploy: nopost build
+	twine upload dist/*
diff --git a/README.md b/README.md
index 3bc5b5b..2687142 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,9 @@
 # LED SHIM
 
-[![Build Status](https://travis-ci.com/pimoroni/led-shim.svg?branch=master)](https://travis-ci.com/pimoroni/led-shim)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/pimoroni/led-shim/test.yml?branch=main)](https://github.com/pimoroni/led-shim/actions/workflows/test.yml)
 [![Coverage Status](https://coveralls.io/repos/github/pimoroni/led-shim/badge.svg?branch=master)](https://coveralls.io/github/pimoroni/led-shim?branch=master)
 [![PyPi Package](https://img.shields.io/pypi/v/ledshim.svg)](https://pypi.python.org/pypi/ledshim)
-[![Python Versions](https://img.shields.io/pypi/pyversions/ledshim.svg)](https://pypi.python.org/pypi/ledshim)
+[![Python Versions](https://img.shields.io/pypi/pyversions/ledshim.svg)](https://pypi.python.org/pypi/led-shim)
 
 https://shop.pimoroni.com/products/led-shim
 
@@ -14,21 +14,16 @@ https://shop.pimoroni.com/products/led-shim
 ### Full install (recommended):
 
 We've created an easy installation script that will install all pre-requisites and get your LED SHIM
-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:
+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/ledshim | bash
-```
-
-### Manual install:
-
-```bash
-python3 -m pip install ledshim
+git clone https://github.com/pimoroni/led-shim
+cd led-shim
+./install
 ```
 
 ### Development:
@@ -36,10 +31,14 @@ python3 -m pip install ledshim
 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
-python3 setup.py install
+./install --unstable
 ```
 
-In all cases you will have to enable the i2c bus.
+In all cases you will have to enable the i2c bus:
+
+```
+sudo raspi-config nonint do_i2c 0
+```
 
 ## Documentation & Support
 
diff --git a/check.sh b/check.sh
new file mode 100755
index 0000000..38dfc3a
--- /dev/null
+++ b/check.sh
@@ -0,0 +1,84 @@
+#!/bin/bash
+
+# This script handles some basic QA checks on the source
+
+NOPOST=$1
+LIBRARY_NAME=$(hatch project metadata name)
+LIBRARY_VERSION=$(hatch version | awk -F "." '{print $1"."$2"."$3}')
+POST_VERSION=$(hatch version | awk -F "." '{print substr($4,0,length($4))}')
+TERM=${TERM:="xterm-256color"}
+
+success() {
+	echo -e "$(tput setaf 2)$1$(tput sgr0)"
+}
+
+inform() {
+	echo -e "$(tput setaf 6)$1$(tput sgr0)"
+}
+
+warning() {
+	echo -e "$(tput setaf 1)$1$(tput sgr0)"
+}
+
+while [[ $# -gt 0 ]]; do
+	K="$1"
+	case $K in
+	-p|--nopost)
+		NOPOST=true
+		shift
+		;;
+	*)
+		if [[ $1 == -* ]]; then
+			printf "Unrecognised option: %s\n" "$1";
+			exit 1
+		fi
+		POSITIONAL_ARGS+=("$1")
+		shift
+	esac
+done
+
+inform "Checking $LIBRARY_NAME $LIBRARY_VERSION\n"
+
+inform "Checking for trailing whitespace..."
+if grep -IUrn --color "[[:blank:]]$" --exclude-dir=dist --exclude-dir=.tox --exclude-dir=.git --exclude=PKG-INFO; then
+    warning "Trailing whitespace found!"
+    exit 1
+else
+    success "No trailing whitespace found."
+fi
+printf "\n"
+
+inform "Checking for DOS line-endings..."
+if grep -lIUrn --color $'\r' --exclude-dir=dist --exclude-dir=.tox --exclude-dir=.git --exclude=Makefile; then
+    warning "DOS line-endings found!"
+    exit 1
+else
+    success "No DOS line-endings found."
+fi
+printf "\n"
+
+inform "Checking CHANGELOG.md..."
+if ! grep "^${LIBRARY_VERSION}" CHANGELOG.md > /dev/null 2>&1; then
+    warning "Changes missing for version ${LIBRARY_VERSION}! Please update CHANGELOG.md."
+    exit 1
+else
+    success "Changes found for version ${LIBRARY_VERSION}."
+fi
+printf "\n"
+
+inform "Checking for git tag ${LIBRARY_VERSION}..."
+if ! git tag -l | grep -E "${LIBRARY_VERSION}$"; then
+    warning "Missing git tag for version ${LIBRARY_VERSION}"
+fi
+printf "\n"
+
+if [[ $NOPOST ]]; then
+    inform "Checking for .postN on library version..."
+    if [[ "$POST_VERSION" != "" ]]; then
+        warning "Found .$POST_VERSION on library version."
+        inform "Please only use these for testpypi releases."
+        exit 1
+    else
+        success "OK"
+    fi
+fi
diff --git a/examples/blinkt_thermo.py b/examples/blinkt_thermo.py
index bb2f1fb..c36a601 100755
--- a/examples/blinkt_thermo.py
+++ b/examples/blinkt_thermo.py
@@ -3,8 +3,8 @@
 # Data from OpenWeatherMap
 # show_graph function adapted from cpu_temp.py
 
-from time import sleep
 from sys import exit
+from time import sleep
 
 try:
     import requests
@@ -13,7 +13,6 @@
 
 import ledshim
 
-
 # Grab your API key here: http://openweathermap.org
 # List of city ID city.list.json.gz can be downloaded here http://bulk.openweathermap.org/sample/
 API_KEY = ''
diff --git a/examples/candle.py b/examples/candle.py
index 5f262ce..0de2dc9 100755
--- a/examples/candle.py
+++ b/examples/candle.py
@@ -11,7 +11,6 @@
 
 import ledshim
 
-
 ledshim.clear()
 start = 0
 end = 60
diff --git a/examples/extra_examples/drum_hits.py b/examples/extra_examples/drum_hits.py
index 7384a3d..dad43e5 100755
--- a/examples/extra_examples/drum_hits.py
+++ b/examples/extra_examples/drum_hits.py
@@ -17,7 +17,6 @@
 
 import blinkt
 
-
 DRUM_FOLDER = 'drums2'
 
 BANK = os.path.join(os.path.dirname(__file__), DRUM_FOLDER)
diff --git a/examples/extra_examples/spirit_level.py b/examples/extra_examples/spirit_level.py
index 9669682..c48dfc8 100755
--- a/examples/extra_examples/spirit_level.py
+++ b/examples/extra_examples/spirit_level.py
@@ -10,7 +10,6 @@
 
 import blinkt
 
-
 x_avg = []
 
 while True:
diff --git a/examples/graph.py b/examples/graph.py
index 5cc858b..25ef850 100755
--- a/examples/graph.py
+++ b/examples/graph.py
@@ -5,7 +5,6 @@
 
 import ledshim
 
-
 ledshim.set_clear_on_exit()
 
 
diff --git a/examples/larson_hue.py b/examples/larson_hue.py
index 911a46d..19fc7ac 100755
--- a/examples/larson_hue.py
+++ b/examples/larson_hue.py
@@ -1,8 +1,8 @@
 #!/usr/bin/env python
 
+import colorsys
 import math
 import time
-import colorsys
 
 import ledshim
 
diff --git a/examples/mqtt.py b/examples/mqtt.py
index 6a99f91..6bf6601 100755
--- a/examples/mqtt.py
+++ b/examples/mqtt.py
@@ -9,7 +9,6 @@
 
 import ledshim
 
-
 MQTT_SERVER = 'iot.eclipse.org'
 MQTT_PORT = 1883
 MQTT_TOPIC = 'pimoroni/ledshim'
diff --git a/examples/set_multiple.py b/examples/set_multiple.py
index 4f45d87..e6fa56e 100755
--- a/examples/set_multiple.py
+++ b/examples/set_multiple.py
@@ -1,8 +1,9 @@
 #!/usr/bin/env python
 
-import ledshim
 import time
 
+import ledshim
+
 # Just green
 print('Green')
 ledshim.set_multiple_pixels(range(0, 28), (0, 255, 0))
diff --git a/examples/solid_colours.py b/examples/solid_colours.py
index b8033ea..c8be854 100755
--- a/examples/solid_colours.py
+++ b/examples/solid_colours.py
@@ -4,7 +4,6 @@
 
 import ledshim
 
-
 ledshim.set_clear_on_exit()
 
 step = 0
diff --git a/examples/test.py b/examples/test.py
index 130d515..78d2dd5 100755
--- a/examples/test.py
+++ b/examples/test.py
@@ -1,5 +1,6 @@
 #!/usr/bin/env python
 import time
+
 import ledshim
 
 for col in ((255, 0, 0), (0, 255, 0), (0, 0, 255)):
diff --git a/examples/twitter_monitor.py b/examples/twitter_monitor.py
index b7e9995..147f2d8 100755
--- a/examples/twitter_monitor.py
+++ b/examples/twitter_monitor.py
@@ -4,14 +4,13 @@
 from sys import exit
 
 try:
-    from tweepy import Stream, OAuthHandler
+    from tweepy import OAuthHandler, Stream
     from tweepy.streaming import StreamListener
 except ImportError:
     exit('This script requires the tweepy module\nInstall with: sudo pip install tweepy')
 
 import ledshim
 
-
 ckey = ''     # Consumer key
 csecret = ''  # Consumer secret
 atoken = ''   # Access token
diff --git a/install.sh b/install.sh
new file mode 100755
index 0000000..61f1a4a
--- /dev/null
+++ b/install.sh
@@ -0,0 +1,385 @@
+#!/bin/bash
+LIBRARY_NAME=$(grep -m 1 name pyproject.toml | awk -F" = " '{print substr($2,2,length($2)-2)}')
+CONFIG_FILE=config.txt
+CONFIG_DIR="/boot/firmware"
+DATESTAMP=$(date "+%Y-%m-%d-%H-%M-%S")
+CONFIG_BACKUP=false
+APT_HAS_UPDATED=false
+RESOURCES_TOP_DIR="$HOME/Pimoroni"
+VENV_BASH_SNIPPET="$RESOURCES_TOP_DIR/auto_venv.sh"
+VENV_DIR="$HOME/.virtualenvs/pimoroni"
+USAGE="./install.sh (--unstable)"
+POSITIONAL_ARGS=()
+FORCE=false
+UNSTABLE=false
+PYTHON="python"
+CMD_ERRORS=false
+
+
+user_check() {
+	if [ "$(id -u)" -eq 0 ]; then
+		fatal "Script should not be run as root. Try './install.sh'\n"
+	fi
+}
+
+confirm() {
+	if $FORCE; then
+		true
+	else
+		read -r -p "$1 [y/N] " response < /dev/tty
+		if [[ $response =~ ^(yes|y|Y)$ ]]; then
+			true
+		else
+			false
+		fi
+	fi
+}
+
+success() {
+	echo -e "$(tput setaf 2)$1$(tput sgr0)"
+}
+
+inform() {
+	echo -e "$(tput setaf 6)$1$(tput sgr0)"
+}
+
+warning() {
+	echo -e "$(tput setaf 1)⚠ WARNING:$(tput sgr0) $1"
+}
+
+fatal() {
+	echo -e "$(tput setaf 1)⚠ FATAL:$(tput sgr0) $1"
+	exit 1
+}
+
+find_config() {
+	if [ ! -f "$CONFIG_DIR/$CONFIG_FILE" ]; then
+		CONFIG_DIR="/boot"
+		if [ ! -f "$CONFIG_DIR/$CONFIG_FILE" ]; then
+			fatal "Could not find $CONFIG_FILE!"
+		fi
+	fi
+	inform "Using $CONFIG_FILE in $CONFIG_DIR"
+}
+
+venv_bash_snippet() {
+	inform "Checking for $VENV_BASH_SNIPPET\n"
+	if [ ! -f "$VENV_BASH_SNIPPET" ]; then
+		inform "Creating $VENV_BASH_SNIPPET\n"
+		mkdir -p "$RESOURCES_TOP_DIR"
+		cat << EOF > "$VENV_BASH_SNIPPET"
+# Add "source $VENV_BASH_SNIPPET" to your ~/.bashrc to activate
+# the Pimoroni virtual environment automagically!
+VENV_DIR="$VENV_DIR"
+if [ ! -f \$VENV_DIR/bin/activate ]; then
+  printf "Creating user Python environment in \$VENV_DIR, please wait...\n"
+  mkdir -p \$VENV_DIR
+  python3 -m venv --system-site-packages \$VENV_DIR
+fi
+printf " ↓ ↓ ↓ ↓   Hello, we've activated a Python venv for you. To exit, type \"deactivate\".\n"
+source \$VENV_DIR/bin/activate
+EOF
+	fi
+}
+
+venv_check() {
+	PYTHON_BIN=$(which "$PYTHON")
+	if [[ $VIRTUAL_ENV == "" ]] || [[ $PYTHON_BIN != $VIRTUAL_ENV* ]]; then
+		printf "This script should be run in a virtual Python environment.\n"
+		if confirm "Would you like us to create and/or use a default one?"; then
+			printf "\n"
+			if [ ! -f "$VENV_DIR/bin/activate" ]; then
+				inform "Creating a new virtual Python environment in $VENV_DIR, please wait...\n"
+				mkdir -p "$VENV_DIR"
+				/usr/bin/python3 -m venv "$VENV_DIR" --system-site-packages
+				venv_bash_snippet
+				# shellcheck disable=SC1091
+				source "$VENV_DIR/bin/activate"
+			else
+				inform "Activating existing virtual Python environment in $VENV_DIR\n"
+				printf "source \"%s/bin/activate\"\n" "$VENV_DIR"
+				# shellcheck disable=SC1091
+				source "$VENV_DIR/bin/activate"
+			fi
+		else
+			printf "\n"
+			fatal "Please create and/or activate a virtual Python environment and try again!\n"
+		fi
+	fi
+	printf "\n"
+}
+
+check_for_error() {
+	if [ $? -ne 0 ]; then
+		CMD_ERRORS=true
+		warning "^^^ 😬 previous command did not exit cleanly!"
+	fi
+}
+
+function do_config_backup {
+	if [ ! $CONFIG_BACKUP == true ]; then
+		CONFIG_BACKUP=true
+		FILENAME="config.preinstall-$LIBRARY_NAME-$DATESTAMP.txt"
+		inform "Backing up $CONFIG_DIR/$CONFIG_FILE to $CONFIG_DIR/$FILENAME\n"
+		sudo cp "$CONFIG_DIR/$CONFIG_FILE" "$CONFIG_DIR/$FILENAME"
+		mkdir -p "$RESOURCES_TOP_DIR/config-backups/"
+		cp $CONFIG_DIR/$CONFIG_FILE "$RESOURCES_TOP_DIR/config-backups/$FILENAME"
+		if [ -f "$UNINSTALLER" ]; then
+			echo "cp $RESOURCES_TOP_DIR/config-backups/$FILENAME $CONFIG_DIR/$CONFIG_FILE" >> "$UNINSTALLER"
+		fi
+	fi
+}
+
+function apt_pkg_install {
+	PACKAGES_NEEDED=()
+	PACKAGES_IN=("$@")
+	# Check the list of packages and only run update/install if we need to
+	for ((i = 0; i < ${#PACKAGES_IN[@]}; i++)); do
+		PACKAGE="${PACKAGES_IN[$i]}"
+		if [ "$PACKAGE" == "" ]; then continue; fi
+		printf "Checking for %s\n" "$PACKAGE"
+		dpkg -L "$PACKAGE" > /dev/null 2>&1
+		if [ "$?" == "1" ]; then
+			PACKAGES_NEEDED+=("$PACKAGE")
+		fi
+	done
+	PACKAGES="${PACKAGES_NEEDED[*]}"
+	if ! [ "$PACKAGES" == "" ]; then
+		printf "\n"
+		inform "Installing missing packages: $PACKAGES"
+		if [ ! $APT_HAS_UPDATED ]; then
+			sudo apt update
+			APT_HAS_UPDATED=true
+		fi
+		# shellcheck disable=SC2086
+		sudo apt install -y $PACKAGES
+		check_for_error
+		if [ -f "$UNINSTALLER" ]; then
+			echo "apt uninstall -y $PACKAGES" >> "$UNINSTALLER"
+		fi
+	fi
+}
+
+function pip_pkg_install {
+	# A null Keyring prevents pip stalling in the background
+	PYTHON_KEYRING_BACKEND=keyring.backends.null.Keyring $PYTHON -m pip install --upgrade "$@"
+	check_for_error
+}
+
+function pip_requirements_install {
+	# A null Keyring prevents pip stalling in the background
+	PYTHON_KEYRING_BACKEND=keyring.backends.null.Keyring $PYTHON -m pip install -r "$@"
+	check_for_error
+}
+
+while [[ $# -gt 0 ]]; do
+	K="$1"
+	case $K in
+	-u|--unstable)
+		UNSTABLE=true
+		shift
+		;;
+	-f|--force)
+		FORCE=true
+		shift
+		;;
+	-p|--python)
+		PYTHON=$2
+		shift
+		shift
+		;;
+	*)
+		if [[ $1 == -* ]]; then
+			printf "Unrecognised option: %s\n" "$1";
+			printf "Usage: %s\n" "$USAGE";
+			exit 1
+		fi
+		POSITIONAL_ARGS+=("$1")
+		shift
+	esac
+done
+
+printf "Installing %s...\n\n" "$LIBRARY_NAME"
+
+user_check
+venv_check
+
+if [ ! -f "$(which "$PYTHON")" ]; then
+	fatal "Python path %s not found!\n" "$PYTHON"
+fi
+
+PYTHON_VER=$($PYTHON --version)
+
+inform "Checking Dependencies. Please wait..."
+
+# Install toml and try to read pyproject.toml into bash variables
+
+pip_pkg_install toml
+
+CONFIG_VARS=$(
+	$PYTHON - <<EOF
+import toml
+config = toml.load("pyproject.toml")
+github_url = config['project']['urls']['GitHub']
+p = dict(config['tool']['pimoroni'])
+# Convert list config entries into bash arrays
+for k, v in p.items():
+    v = "'\n\t'".join(v)
+    p[k] = f"('{v}')"
+print(f'GITHUB_URL="{github_url}"')
+print("""
+APT_PACKAGES={apt_packages}
+SETUP_CMDS={commands}
+CONFIG_TXT={configtxt}
+""".format(**p))
+EOF
+)
+
+# shellcheck disable=SC2181 # Inlining the above command would be messy
+if [ $? -ne 0 ]; then
+	# This is bad, this should not happen in production!
+	fatal "Error parsing configuration...\n"
+fi
+
+eval "$CONFIG_VARS"
+
+RESOURCES_DIR=$RESOURCES_TOP_DIR/$LIBRARY_NAME
+UNINSTALLER=$RESOURCES_DIR/uninstall.sh
+
+RES_DIR_OWNER=$(stat -c "%U" "$RESOURCES_TOP_DIR")
+
+# Previous install.sh scripts were run as root with sudo, which caused
+# the ~/Pimoroni dir to be created with root ownership. Try and fix it.
+if [[ "$RES_DIR_OWNER" == "root" ]]; then
+	warning "\n\nFixing $RESOURCES_TOP_DIR permissions!\n\n"
+	sudo chown -R "$USER:$USER" "$RESOURCES_TOP_DIR"
+fi
+
+mkdir -p "$RESOURCES_DIR"
+
+# Create a stub uninstaller file, we'll try to add the inverse of every
+# install command run to here, though it's not complete.
+cat << EOF > "$UNINSTALLER"
+printf "It's recommended you run these steps manually.\n"
+printf "If you want to run the full script, open it in\n"
+printf "an editor and remove 'exit 1' from below.\n"
+exit 1
+source $VIRTUAL_ENV/bin/activate
+EOF
+
+printf "\n"
+
+inform "Installing for $PYTHON_VER...\n"
+
+# Install apt packages from pyproject.toml / tool.pimoroni.apt_packages
+apt_pkg_install "${APT_PACKAGES[@]}"
+
+printf "\n"
+
+if $UNSTABLE; then
+	warning "Installing unstable library from source.\n"
+	pip_pkg_install .
+else
+	inform "Installing stable library from pypi.\n"
+	pip_pkg_install "$LIBRARY_NAME"
+fi
+
+# shellcheck disable=SC2181 # One of two commands run, depending on --unstable flag
+if [ $? -eq 0 ]; then
+	success "Done!\n"
+	echo "$PYTHON -m pip uninstall $LIBRARY_NAME" >> "$UNINSTALLER"
+fi
+
+find_config
+
+printf "\n"
+
+# Run the setup commands from pyproject.toml / tool.pimoroni.commands
+
+inform "Running setup commands...\n"
+for ((i = 0; i < ${#SETUP_CMDS[@]}; i++)); do
+	CMD="${SETUP_CMDS[$i]}"
+	# Attempt to catch anything that touches config.txt and trigger a backup
+	if [[ "$CMD" == *"raspi-config"* ]] || [[ "$CMD" == *"$CONFIG_DIR/$CONFIG_FILE"* ]] || [[ "$CMD" == *"\$CONFIG_DIR/\$CONFIG_FILE"* ]]; then
+		do_config_backup
+	fi
+	if [[ ! "$CMD" == printf* ]]; then
+		printf "Running: \"%s\"\n" "$CMD"
+	fi
+	eval "$CMD"
+	check_for_error
+done
+
+printf "\n"
+
+# Add the config.txt entries from pyproject.toml / tool.pimoroni.configtxt
+
+for ((i = 0; i < ${#CONFIG_TXT[@]}; i++)); do
+	CONFIG_LINE="${CONFIG_TXT[$i]}"
+	if ! [ "$CONFIG_LINE" == "" ]; then
+		do_config_backup
+		inform "Adding $CONFIG_LINE to $CONFIG_DIR/$CONFIG_FILE"
+		sudo sed -i "s/^#$CONFIG_LINE/$CONFIG_LINE/" $CONFIG_DIR/$CONFIG_FILE
+		if ! grep -q "^$CONFIG_LINE" $CONFIG_DIR/$CONFIG_FILE; then
+			printf "%s \n" "$CONFIG_LINE" | sudo tee --append $CONFIG_DIR/$CONFIG_FILE
+		fi
+	fi
+done
+
+printf "\n"
+
+# Just a straight copy of the examples/ dir into ~/Pimoroni/board/examples
+
+if [ -d "examples" ]; then
+	if confirm "Would you like to copy examples to $RESOURCES_DIR?"; then
+		inform "Copying examples to $RESOURCES_DIR"
+		cp -r examples/ "$RESOURCES_DIR"
+		echo "rm -r $RESOURCES_DIR" >> "$UNINSTALLER"
+		success "Done!"
+	fi
+fi
+
+printf "\n"
+
+if [ -f "requirements-examples.txt" ]; then
+	if confirm "Would you like to install example dependencies?"; then
+		inform "Installing dependencies from requirements-examples.txt..."
+		pip_requirements_install requirements-examples.txt
+	fi
+fi
+
+printf "\n"
+
+# Use pdoc to generate basic documentation from the installed module
+
+if confirm "Would you like to generate documentation?"; then
+	inform "Installing pdoc. Please wait..."
+	pip_pkg_install pdoc
+	inform "Generating documentation.\n"
+	if $PYTHON -m pdoc "$LIBRARY_NAME" -o "$RESOURCES_DIR/docs" > /dev/null; then
+		inform "Documentation saved to $RESOURCES_DIR/docs"
+		success "Done!"
+	else
+		warning "Error: Failed to generate documentation."
+	fi
+fi
+
+printf "\n"
+
+if [ "$CMD_ERRORS" = true ]; then
+	warning "One or more setup commands appear to have failed."
+	printf "This might prevent things from working properly.\n"
+	printf "Make sure your OS is up to date and try re-running this installer.\n"
+	printf "If things still don't work, report this or find help at %s.\n\n" "$GITHUB_URL"
+else
+	success "\nAll done!"
+fi
+
+printf "If this is your first time installing you should reboot for hardware changes to take effect.\n"
+printf "Find uninstall steps in %s\n\n" "$UNINSTALLER"
+
+if [ "$CMD_ERRORS" = true ]; then
+	exit 1
+else
+	exit 0
+fi
diff --git a/library/ledshim/__init__.py b/ledshim/__init__.py
similarity index 98%
rename from library/ledshim/__init__.py
rename to ledshim/__init__.py
index f31301b..381ba39 100644
--- a/library/ledshim/__init__.py
+++ b/ledshim/__init__.py
@@ -1,7 +1,7 @@
 """LED SHIM 28-pixel RGB LED display."""
 from . import is31fl3731
 
-__version__ = '0.0.2'
+__version__ = "0.0.2"
 
 display = is31fl3731.LEDSHIM(None, address=0x75, gamma_table=is31fl3731.LED_GAMMA)
 
diff --git a/library/ledshim/is31fl3731.py b/ledshim/is31fl3731.py
similarity index 87%
rename from library/ledshim/is31fl3731.py
rename to ledshim/is31fl3731.py
index 125a835..4204ee4 100644
--- a/library/ledshim/is31fl3731.py
+++ b/ledshim/is31fl3731.py
@@ -1,16 +1,9 @@
 """Driver for the IS31FL3731."""
-import time
-import atexit
-from sys import version_info
 
-try:
-    import smbus
-except ImportError:
-    if version_info[0] < 3:
-        raise ImportError('This library requires python-smbus\nInstall with: sudo apt-get install python-smbus')
-    elif version_info[0] == 3:
-        raise ImportError('This library requires python3-smbus\nInstall with: sudo apt-get install python3-smbus')
+import atexit
+import time
 
+import smbus2
 
 _MODE_REGISTER = 0x00
 _FRAME_REGISTER = 0x01
@@ -20,12 +13,12 @@
 _AUDIOSYNC_REGISTER = 0x06
 _BREATH1_REGISTER = 0x08
 _BREATH2_REGISTER = 0x09
-_SHUTDOWN_REGISTER = 0x0a
-_GAIN_REGISTER = 0x0b
-_ADC_REGISTER = 0x0c
+_SHUTDOWN_REGISTER = 0x0A
+_GAIN_REGISTER = 0x0B
+_ADC_REGISTER = 0x0C
 
-_CONFIG_BANK = 0x0b
-_BANK_ADDRESS = 0xfd
+_CONFIG_BANK = 0x0B
+_BANK_ADDRESS = 0xFD
 
 _PICTURE_MODE = 0x00
 _AUTOPLAY_MODE = 0x08
@@ -91,17 +84,17 @@ def setup(self):
 
         if self.i2c is None:
             try:
-                self.i2c = smbus.SMBus(1)
+                self.i2c = smbus2.SMBus(1)
             except IOError as e:
-                if hasattr(e, 'errno') and e.errno == 2:
-                    e.strerror += '\n\nMake sure you\'ve enabled i2c in your Raspberry Pi configuration.\n'
+                if hasattr(e, "errno") and e.errno == 2:
+                    e.strerror += "\n\nMake sure you've enabled i2c in your Raspberry Pi configuration.\n"
                 raise e
 
         try:
             self._reset()
         except IOError as e:
-            if hasattr(e, 'errno') and e.errno == 5:
-                e.strerror += '\n\nMake sure your LED SHIM is attached, and double-check your soldering.\n'
+            if hasattr(e, "errno") and e.errno == 5:
+                e.strerror += "\n\nMake sure your LED SHIM is attached, and double-check your soldering.\n"
             raise e
 
         self.show()
@@ -182,7 +175,7 @@ def set_gamma(self, gamma_table):
 
         """
         if len(gamma_table) != 256:
-            raise ValueError('Gamma table must be a list with 256 values.')
+            raise ValueError("Gamma table must be a list with 256 values.")
 
         self._gamma_table = gamma_table
 
@@ -229,13 +222,13 @@ def set_pixel(self, x, r, g, b, brightness=1.0):
 
         for c in (r, g, b):
             if c > 255 or c < 0:
-                raise ValueError('Value {} out of range. RGB values should be between 0 and 255'.format(c))
+                raise ValueError(f"Value {c} out of range. RGB values should be between 0 and 255")
 
         try:
             self.buf[x] = r, g, b, brightness
 
         except IndexError:
-            raise ValueError('x position ({}) is out of range!'.format(x))
+            raise ValueError(f"x position ({x}) is out of range!")
 
     def get_shape(self):
         """Get the size/shape of the display.
@@ -286,7 +279,7 @@ def _frame(self, frame=None, show=True):
             return self._current_frame
 
         if not 0 <= frame <= 8:
-            raise ValueError('Frame out of range: 0-8')
+            raise ValueError("Frame out of range: 0-8")
 
         self._current_frame = frame
 
@@ -309,9 +302,9 @@ def _register(self, bank, register, value=None):
 
         self.i2c.write_i2c_block_data(self.address, register, [value])
 
-    def _chunk(self, l, n):
-        for i in range(0, len(l) + 1, n):
-            yield l[i:i + n]
+    def _chunk(self, data, length):
+        for i in range(0, len(data) + 1, length):
+            yield data[i : i + length]
 
     def _pixel_addr(self, x, y):
         return x + y * 16
diff --git a/library/LICENSE.txt b/library/LICENSE.txt
deleted file mode 100644
index c95a7d4..0000000
--- a/library/LICENSE.txt
+++ /dev/null
@@ -1,21 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) 2017 Pimoroni Ltd
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
diff --git a/library/MANIFEST.in b/library/MANIFEST.in
deleted file mode 100644
index e922bdf..0000000
--- a/library/MANIFEST.in
+++ /dev/null
@@ -1,5 +0,0 @@
-include CHANGELOG.txt
-include LICENSE.txt
-include README.md
-include setup.py
-recursive-include ledshim *.py
diff --git a/library/README.md b/library/README.md
deleted file mode 100644
index e964310..0000000
--- a/library/README.md
+++ /dev/null
@@ -1,63 +0,0 @@
-# LED SHIM
-
-[![Build Status](https://travis-ci.com/pimoroni/led-shim.svg?branch=master)](https://travis-ci.com/pimoroni/led-shim)
-[![Coverage Status](https://coveralls.io/repos/github/pimoroni/led-shim/badge.svg?branch=master)](https://coveralls.io/github/pimoroni/led-shim?branch=master)
-[![PyPi Package](https://img.shields.io/pypi/v/ledshim.svg)](https://pypi.python.org/pypi/ledshim)
-[![Python Versions](https://img.shields.io/pypi/pyversions/ledshim.svg)](https://pypi.python.org/pypi/ledshim)
-
-https://shop.pimoroni.com/products/led-shim
-
-28 tiny RGB LED pixels in a single row that just slip right onto your Pi's pins, no soldering required! LED SHIM is ideal for status updates, notifications, a VU meter, or as a bar graph for sensor readings.
-
-## Installing
-
-### Full install (recommended):
-
-We've created an easy installation script that will install all pre-requisites and get your LED SHIM
-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/ledshim | bash
-```
-
-### Manual install:
-
-```bash
-python3 -m pip install ledshim
-```
-
-### 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
-python3 setup.py install
-```
-
-In all cases you will have to enable the i2c bus.
-
-## Documentation & Support
-
-* Guides and tutorials - https://learn.pimoroni.com/led-shim
-* Function reference - http://docs.pimoroni.com/ledshim/
-* GPIO Pinout - https://pinout.xyz/pinout/led_shim
-* Get help - http://forums.pimoroni.com/c/support
-
-# Changelog
-0.0.2
------
-
-* Add `set_multiple_pixels`
-* Updated packaging
-* Linting & minor improvements to docstrings
-
-0.0.1
------
-
-* Initial release
-
diff --git a/library/setup.cfg b/library/setup.cfg
deleted file mode 100644
index 8921a89..0000000
--- a/library/setup.cfg
+++ /dev/null
@@ -1,49 +0,0 @@
-# -*- coding: utf-8 -*-
-[metadata]
-name = ledshim
-version = 0.0.2
-author = Philip Howard
-author_email = phil@pimoroni.com
-description = LED SHIM Driver
-long_description = file: README.md
-long_description_content_type = text/markdown
-keywords = Raspberry Pi LED
-url = https://www.pimoroni.com
-project_urls =
-	GitHub=https://www.github.com/pimoroni/led-shim
-license = MIT
-# This includes the license file(s) in the wheel.
-# https://wheel.readthedocs.io/en/stable/user_guide.html#including-license-files-in-the-generated-wheel-file
-license_files = LICENSE.txt
-classifiers =
-	Development Status :: 5 - Production/Stable
-	Operating System :: POSIX :: Linux
-	License :: OSI Approved :: MIT License
-	Intended Audience :: Developers
-	Programming Language :: Python :: 2.7
-	Programming Language :: Python :: 3
-	Topic :: Software Development
-	Topic :: Software Development :: Libraries
-	Topic :: System :: Hardware
-
-[options]
-python_requires = >= 2.7
-packages = ledshim
-install_requires =
-
-[flake8]
-exclude =
-	.tox,
-	.eggs,
-	.git,
-	__pycache__,
-	build,
-	dist
-ignore =
-	E501
-
-[pimoroni]
-py2deps =
-py3deps =
-configtxt =
-commands =
diff --git a/library/setup.py b/library/setup.py
deleted file mode 100755
index afb1ee1..0000000
--- a/library/setup.py
+++ /dev/null
@@ -1,33 +0,0 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
-"""
-Copyright (c) 2016 Pimoroni
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of
-this software and associated documentation files (the "Software"), to deal in
-the Software without restriction, including without limitation the rights to
-use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
-of the Software, and to permit persons to whom the Software is furnished to do
-so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-"""
-
-from setuptools import setup, __version__
-from pkg_resources import parse_version
-
-minimum_version = parse_version('30.4.0')
-
-if parse_version(__version__) < minimum_version:
-    raise RuntimeError("Package setuptools must be at least version {}".format(minimum_version))
-
-setup()
diff --git a/library/tox.ini b/library/tox.ini
deleted file mode 100644
index a8f3249..0000000
--- a/library/tox.ini
+++ /dev/null
@@ -1,24 +0,0 @@
-[tox]
-envlist = py{27,35,37,39},qa
-skip_missing_interpreters = True
-
-[testenv]
-commands =
-	python setup.py install
-	coverage run -m py.test -v -r wsx
-	coverage report
-deps =
-	mock
-	pytest>=3.1
-	pytest-cov
-
-[testenv:qa]
-commands =
-	check-manifest --ignore tox.ini,tests/*,.coveragerc
-	python setup.py sdist bdist_wheel
-	twine check dist/*
-	flake8 --ignore E501
-deps =
-	check-manifest
-	flake8
-	twine
diff --git a/packaging/CHANGELOG b/packaging/CHANGELOG
deleted file mode 100644
index e9a1028..0000000
--- a/packaging/CHANGELOG
+++ /dev/null
@@ -1,5 +0,0 @@
-ledshim (0.0.1) stable; urgency=low
-
-  * Initial release
-
- -- Phil Howard <phil@pimoroni.com>  Wed, 29 Nov 2017 00:00:00 +0000
diff --git a/packaging/debian/README b/packaging/debian/README
deleted file mode 100644
index 279fca5..0000000
--- a/packaging/debian/README
+++ /dev/null
@@ -1,10 +0,0 @@
-README
-
-Learn more: https://shop.pimoroni.com/products/ledshim
-For examples run: `curl -sS get.pimoroni.com/ledshim | bash`
-
-IMPORTANT
-
-LED SHIM requires i2c.
-To enable run `curl get.pimoroni.com/i2c | bash`
-or use raspi-config and reboot your Raspberry Pi.
diff --git a/packaging/debian/changelog b/packaging/debian/changelog
deleted file mode 100644
index e9a1028..0000000
--- a/packaging/debian/changelog
+++ /dev/null
@@ -1,5 +0,0 @@
-ledshim (0.0.1) stable; urgency=low
-
-  * Initial release
-
- -- Phil Howard <phil@pimoroni.com>  Wed, 29 Nov 2017 00:00:00 +0000
diff --git a/packaging/debian/clean b/packaging/debian/clean
deleted file mode 100644
index 45149aa..0000000
--- a/packaging/debian/clean
+++ /dev/null
@@ -1 +0,0 @@
-*.egg-info/*
diff --git a/packaging/debian/compat b/packaging/debian/compat
deleted file mode 100644
index ec63514..0000000
--- a/packaging/debian/compat
+++ /dev/null
@@ -1 +0,0 @@
-9
diff --git a/packaging/debian/control b/packaging/debian/control
deleted file mode 100644
index 2255c24..0000000
--- a/packaging/debian/control
+++ /dev/null
@@ -1,31 +0,0 @@
-Source: ledshim
-Maintainer: Phil Howard <phil@pimoroni.com>
-Homepage: https://github.com/pimoroni/led-shim
-Section: python
-Priority: extra
-Build-Depends: debhelper (>= 9.0.0), dh-python, python-all (>= 2.7), python-setuptools, python3-all (>= 3.4), python3-setuptools
-Standards-Version: 3.9.6
-X-Python-Version: >= 2.7
-X-Python3-Version: >= 3.4
-
-Package: python-ledshim
-Architecture: all
-Section: python
-Depends: ${misc:Depends}, ${python:Depends}, python-smbus
-Suggests: i2c-tools, python-psutil
-Description: Python library for the Pimoroni LED SHIM.
- LED SHIM tucks 28 RGB LEDs underneath a HAT or pHAT,
- it's ideal for showing notifications, patterns, or anything else!
- .
- This is the Python 2 version of the package.
-
-Package: python3-ledshim
-Architecture: all
-Section: python
-Depends: ${misc:Depends}, ${python3:Depends}, python3-smbus
-Suggests: i2c-tools, python3-psutil
-Description: Python library for the Pimoroni LED SHIM.
- LED SHIM tucks 28 RGB LEDs underneath a HAT or pHAT,
- it's ideal for showing notifications, patterns, or anything else!
- .
- This is the Python 3 version of the package.
diff --git a/packaging/debian/copyright b/packaging/debian/copyright
deleted file mode 100644
index 78e5920..0000000
--- a/packaging/debian/copyright
+++ /dev/null
@@ -1,26 +0,0 @@
-Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
-Upstream-Name: ledshim
-Source: https://github.com/pimoroni/led-shim
-
-Files: *
-Copyright: 2017 Pimoroni Ltd <phil@pimoroni.com>
-License: MIT
-
-License: MIT
- Permission is hereby granted, free of charge, to any person obtaining a copy
- of this software and associated documentation files (the "Software"), to deal
- in the Software without restriction, including without limitation the rights
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- copies of the Software, and to permit persons to whom the Software is
- furnished to do so, subject to the following conditions:
- .
- The above copyright notice and this permission notice shall be included in
- all copies or substantial portions of the Software.
- .
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- THE SOFTWARE.
diff --git a/packaging/debian/docs b/packaging/debian/docs
deleted file mode 100644
index e69de29..0000000
diff --git a/packaging/debian/rules b/packaging/debian/rules
deleted file mode 100755
index 846360b..0000000
--- a/packaging/debian/rules
+++ /dev/null
@@ -1,12 +0,0 @@
-#!/usr/bin/make -f
-# -*- makefile -*-
-
-#export DH_VERBOSE=1
-export DH_OPTIONS
-
-%:
-	dh $@ --with python2,python3 --buildsystem=python_distutils
-
-override_dh_auto_install:
-	python setup.py install --root debian/python-ledshim --install-layout=deb
-	python3 setup.py install --root debian/python3-ledshim --install-layout=deb
diff --git a/packaging/debian/source/format b/packaging/debian/source/format
deleted file mode 100644
index 89ae9db..0000000
--- a/packaging/debian/source/format
+++ /dev/null
@@ -1 +0,0 @@
-3.0 (native)
diff --git a/packaging/debian/source/options b/packaging/debian/source/options
deleted file mode 100644
index 8f82c91..0000000
--- a/packaging/debian/source/options
+++ /dev/null
@@ -1 +0,0 @@
-extend-diff-ignore = "^[^/]+\.egg-info/"
diff --git a/packaging/makeall.sh b/packaging/makeall.sh
deleted file mode 100755
index abca395..0000000
--- a/packaging/makeall.sh
+++ /dev/null
@@ -1,165 +0,0 @@
-#!/bin/bash
-
-# script control variables
-
-reponame="" # leave this blank for auto-detection
-libname="" # leave this blank for auto-detection
-packagename="" # leave this blank for auto-selection
-
-debianlog="debian/changelog"
-debcontrol="debian/control"
-debcopyright="debian/copyright"
-debrules="debian/rules"
-debreadme="debian/README"
-
-debdir="$(pwd)"
-rootdir="$(dirname $debdir)"
-libdir="$rootdir/library"
-
-FLAG=false
-
-# function define
-
-success() {
-    echo "$(tput setaf 2)$1$(tput sgr0)"
-}
-
-inform() {
-    echo "$(tput setaf 6)$1$(tput sgr0)"
-}
-
-warning() {
-    echo "$(tput setaf 1)$1$(tput sgr0)"
-}
-
-newline() {
-    echo ""
-}
-
-# assessing repo and library variables
-
-if [ -z "$reponame" ] || [ -z "$libname" ]; then
-    inform "detecting reponame and libname..."
-else
-    inform "using reponame and libname overrides"
-fi
-
-if [ -z "$reponame" ]; then
-    if [[ $rootdir == *"python"* ]]; then
-        repodir="$(dirname $rootdir)"
-        reponame="$(basename $repodir)"
-    else
-        repodir="$rootdir"
-        reponame="$(basename $repodir)"
-    fi
-    reponame=$(echo "$reponame" | tr "[A-Z]" "[a-z]")
-fi
-
-if [ -z "$libname" ]; then
-    cd "$libdir"
-    libname=$(grep "name" setup.py | tr -d "[:space:]" | cut -c 7- | rev | cut -c 3- | rev)
-    libname=$(echo "$libname" | tr "[A-Z]" "[a-z]") && cd "$debdir"
-fi
-
-if [ -z "$packagename" ]; then
-    packagename="$libname"
-fi
-
-echo "reponame is $reponame and libname is $libname"
-echo "output packages will be python-$packagename and python3-$packagename"
-
-# checking generating changelog file
-
-./makelog.sh
-version=$(head -n 1 "$libdir/CHANGELOG.txt")
-echo "building $libname version $version"
-
-# checking debian/changelog file
-
-inform "checking debian/changelog file..."
-
-if ! head -n 1 $debianlog | grep "$libname" &> /dev/null; then
-    warning "library not mentioned in header!" && FLAG=true
-elif head -n 1 $debianlog | grep "UNRELEASED"; then
-    warning "this changelog is not going to generate a release!"
-    warning "change distribution to 'stable'" && FLAG=true
-fi
-
-# checking debian/copyright file
-
-inform "checking debian/copyright file..."
-
-if ! grep "^Source" $debcopyright | grep "$reponame" &> /dev/null; then
-    warning "$(grep "^Source" $debcopyright)" && FLAG=true
-fi
-
-if ! grep "^Upstream-Name" $debcopyright | grep "$libname" &> /dev/null; then
-    warning "$(grep "^Upstream-Name" $debcopyright)" && FLAG=true
-fi
-
-# checking debian/control file
-
-inform "checking debian/control file..."
-
-if ! grep "^Source" $debcontrol | grep "$libname" &> /dev/null; then
-    warning "$(grep "^Source" $debcontrol)" && FLAG=true
-fi
-
-if ! grep "^Homepage" $debcontrol | grep "$reponame" &> /dev/null; then
-    warning "$(grep "^Homepage" $debcontrol)" && FLAG=true
-fi
-
-if ! grep "^Package: python-$packagename" $debcontrol &> /dev/null; then
-    warning "$(grep "^Package: python-" $debcontrol)" && FLAG=true
-fi
-
-if ! grep "^Package: python3-$packagename" $debcontrol &> /dev/null; then
-    warning "$(grep "^Package: python3-" $debcontrol)" && FLAG=true
-fi
-
-if ! grep "^Priority: extra" $debcontrol &> /dev/null; then
-    warning "$(grep "^Priority" $debcontrol)" && FLAG=true
-fi
-
-
-# checking debian/rules file
-
-inform "checking debian/rules file..."
-
-if ! grep "debian/python-$packagename" $debrules &> /dev/null; then
-    warning "$(grep "debian/python-" $debrules)" && FLAG=true
-fi
-
-if ! grep "debian/python3-$packagename" $debrules &> /dev/null; then
-    warning "$(grep "debian/python3-" $debrules)" && FLAG=true
-fi
-
-# checking debian/README file
-
-inform "checking debian/readme file..."
-
-if ! grep -e "$libname" -e "$reponame" $debreadme &> /dev/null; then
-    warning "README does not seem to mention product, repo or lib!" && FLAG=true
-fi
-
-# summary of checks pre build
-
-if $FLAG; then
-    warning "Check all of the above and correct!" && exit 1
-else
-    inform "we're good to go... bulding!"
-fi
-
-# building deb and final checks
-
-./makedeb.sh
-
-inform "running lintian..."
-lintian -v $(find -name "python*$version*.deb")
-lintian -v $(find -name "python3*$version*.deb")
-
-inform "checking signatures..."
-gpg --verify $(find -name "*$version*changes")
-gpg --verify $(find -name "*$version*dsc")
-
-exit 0
diff --git a/packaging/makedeb.sh b/packaging/makedeb.sh
deleted file mode 100755
index 03ebac7..0000000
--- a/packaging/makedeb.sh
+++ /dev/null
@@ -1,38 +0,0 @@
-#!/bin/bash
-
-gettools="no" # if set to yes downloads the tools required
-setup="yes" # if set to yes populates library folder
-buildeb="yes" # if set to yes builds the deb files
-cleanup="yes" # if set to yes cleans up build files
-pkgfiles=( "build" "changes" "deb" "dsc" "tar.xz" )
-
-if [ $gettools == "yes" ]; then
-    sudo apt-get update && sudo apt-get install build-essential debhelper devscripts dh-make dh-python dput gnupg
-    sudo apt-get install python-all python-setuptools python3-all python3-setuptools
-    sudo apt-get install python-mock python-sphinx python-sphinx-rtd-theme
-    sudo pip install Sphinx --upgrade && sudo pip install sphinx_rtd_theme --upgrade
-fi
-
-if [ $setup == "yes" ]; then
-    rm -R ../library/build ../library/debian &> /dev/null
-    cp -R ./debian ../library/ && cp -R ../sphinx ../library/doc
-fi
-
-cd ../library
-
-if [ $buildeb == "yes" ]; then
-    debuild -aarmhf
-    for file in ${pkgfiles[@]}; do
-        rm ../packaging/*.$file &> /dev/null
-        mv ../*.$file ../packaging
-    done
-    rm -R ../documentation/html &> /dev/null
-    cp -R ./build/sphinx/html ../documentation
-fi
-
-if [ $cleanup == "yes" ]; then
-    debuild clean
-    rm -R ./build ./debian ./doc &> /dev/null
-fi
-
-exit 0
diff --git a/packaging/makedoc.sh b/packaging/makedoc.sh
deleted file mode 100755
index 244e992..0000000
--- a/packaging/makedoc.sh
+++ /dev/null
@@ -1,37 +0,0 @@
-#!/bin/bash
-
-gettools="no" # if set to yes downloads the tools required
-setup="yes" # if set to yes populates library folder
-buildoc="yes" # if set to yes builds the deb files
-cleanup="yes" # if set to yes cleans up build files
-pkgfiles=( "build" "changes" "deb" "dsc" "tar.xz" )
-
-if [ $gettools == "yes" ]; then
-    sudo apt-get update && sudo apt-get install build-essential debhelper devscripts dh-make dh-python
-    sudo apt-get install python-all python-setuptools python3-all python3-setuptools
-    sudo apt-get install python-mock python-sphinx python-sphinx-rtd-theme
-    sudo pip install Sphinx --upgrade && sudo pip install sphinx_rtd_theme --upgrade
-fi
-
-if [ $setup == "yes" ]; then
-    rm -R ../library/build ../library/debian &> /dev/null
-    cp -R ./debian ../library/ && cp -R ../sphinx ../library/doc
-fi
-
-cd ../library
-
-if [ $buildoc == "yes" ]; then
-    debuild
-    for file in ${pkgfiles[@]}; do
-        rm ../*.$file &> /dev/null
-    done
-    rm -R ../documentation/html &> /dev/null
-    cp -R ./build/sphinx/html ../documentation
-fi
-
-if [ $cleanup == "yes" ]; then
-    debuild clean
-    rm -R ./build ./debian ./doc &> /dev/null
-fi
-
-exit 0
diff --git a/packaging/makelog.sh b/packaging/makelog.sh
deleted file mode 100755
index 1055987..0000000
--- a/packaging/makelog.sh
+++ /dev/null
@@ -1,82 +0,0 @@
-#!/bin/bash
-
-# script control variables
-
-libname="" # leave this blank for auto-detection
-sibname=() # name of sibling in packages list
-versionwarn="yes" # set to anything but 'yes' to turn off warning
-
-debdir="$(pwd)"
-rootdir="$(dirname $debdir)"
-libdir="$rootdir/library"
-
-mainlog="CHANGELOG"
-debianlog="debian/changelog"
-pypilog="$libdir/CHANGELOG.txt"
-
-# function define
-
-success() {
-    echo "$(tput setaf 2)$1$(tput sgr0)"
-}
-
-inform() {
-    echo "$(tput setaf 6)$1$(tput sgr0)"
-}
-
-warning() {
-    echo "$(tput setaf 1)$1$(tput sgr0)"
-}
-
-newline() {
-    echo ""
-}
-
-# generate debian changelog
-
-cat $mainlog > $debianlog
-inform "seeded debian changelog"
-
-# generate pypi changelog
-
-sed -e "/--/d" -e "s/  \*/\*/" \
-    -e "s/.*\([0-9].[0-9].[0-9]\).*/\1/" \
-    -e '/[0-9].[0-9].[0-9]/ a\
------' $mainlog | cat -s > $pypilog
-
-version=$(head -n 1 $pypilog)
-inform "pypi changelog generated"
-
-# touch up version in setup.py file
-
-if [ -n $(grep version "$libdir/setup.py" &> /dev/null) ]; then
-    inform "touched up version in setup.py"
-    sed -i "s/'[0-9].[0-9].[0-9]'/'$version'/" "$libdir/setup.py"
-else
-    warning "couldn't touch up version in setup, no match found"
-fi
-
-# touch up version in lib or package siblings
-
-if [ -z "$libname" ]; then
-    cd "$libdir"
-    libname=$(grep "name" setup.py | tr -d "[:space:]" | cut -c 7- | rev | cut -c 3- | rev)
-    libname=$(echo "$libname" | tr "[A-Z]" "[a-z]") && cd "$debdir"
-    sibname+=( "$libname" )
-elif [ "$libname" != "package" ]; then
-    sibname+=( "$libname" )
-fi
-
-for sibling in ${sibname[@]}; do
-    if grep -e "__version__" "$libdir/$sibling.py" &> /dev/null; then
-        sed -i "s/__version__ = '[0-9].[0-9].[0-9]'/__version__ = '$version'/" "$libdir/$sibling.py"
-        inform "touched up version in $sibling.py"
-    elif grep -e "__version__" "$libdir/$sibling/__init__.py" &> /dev/null; then
-        sed -i "s/__version__ = '[0-9].[0-9].[0-9]'/__version__ = '$version'/" "$libdir/$sibling/__init__.py"
-        inform "touched up version in $sibling/__init__.py"
-    elif [ "$versionwarn" == "yes" ]; then
-        warning "couldn't touch up __version__ in $sibling, no match found"
-    fi
-done
-
-exit 0
diff --git a/pyproject.toml b/pyproject.toml
new file mode 100644
index 0000000..75d6e69
--- /dev/null
+++ b/pyproject.toml
@@ -0,0 +1,115 @@
+[build-system]
+requires = ["hatchling", "hatch-fancy-pypi-readme"]
+build-backend = "hatchling.build"
+
+[project]
+name = "ledshim"
+dynamic = ["version", "readme"]
+description = "LED SHIM Driver"
+license = {file = "LICENSE"}
+requires-python = ">= 3.7"
+authors = [
+    { name = "Philip Howard", email = "phil@pimoroni.com" },
+]
+maintainers = [
+    { name = "Philip Howard", email = "phil@pimoroni.com" },
+]
+keywords = [
+    "Pi",
+    "Raspberry",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Software Development",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: System :: Hardware",
+]
+dependencies = [
+    "smbus2"
+]
+
+[project.urls]
+GitHub = "https://www.github.com/pimoroni/led-shim"
+Homepage = "https://www.pimoroni.com"
+
+[tool.hatch.version]
+path = "ledshim/__init__.py"
+
+[tool.hatch.build]
+include = [
+    "ledshim",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "*"
+]
+exclude = [
+    ".*",
+    "dist"
+]
+
+[tool.hatch.metadata.hooks.fancy-pypi-readme]
+content-type = "text/markdown"
+fragments = [
+  { path = "README.md" },
+  { text = "\n" },
+  { path = "CHANGELOG.md" }
+]
+
+[tool.ruff]
+exclude = [
+    '.tox',
+    '.egg',
+    '.git',
+    '__pycache__',
+    'build',
+    'dist'
+]
+line-length = 200
+
+[tool.codespell]
+skip = """
+./.tox,\
+./.egg,\
+./.git,\
+./__pycache__,\
+./build,\
+./dist.\
+"""
+
+[tool.isort]
+line_length = 200
+
+[tool.check-manifest]
+ignore = [
+    '.stickler.yml',
+    'boilerplate.md',
+    'check.sh',
+    'install.sh',
+    'uninstall.sh',
+    'Makefile',
+    'tox.ini',
+    'tests/*',
+    'examples/*',
+    '.coveragerc',
+    'requirements-dev.txt'
+]
+
+[tool.pimoroni]
+apt_packages = []
+configtxt = []
+commands = []
\ No newline at end of file
diff --git a/requirements-dev.txt b/requirements-dev.txt
new file mode 100644
index 0000000..525b042
--- /dev/null
+++ b/requirements-dev.txt
@@ -0,0 +1,9 @@
+check-manifest
+ruff
+codespell
+isort
+twine
+hatch
+hatch-fancy-pypi-readme
+tox
+pdoc
diff --git a/sphinx/_static/custom.css b/sphinx/_static/custom.css
deleted file mode 100644
index 141c20c..0000000
--- a/sphinx/_static/custom.css
+++ /dev/null
@@ -1,53 +0,0 @@
-.rst-content a, .rst-content a:focus {
-    color:#13c0d7;
-}
-.rst-content a:visited, .rst-content a:active {
-    color:#87319a;
-}
-.rst-content .highlighted {
-    background:url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAJElEQVQIW2P8//9/PSMjYyMDEmAEsdElwILoEnBBZAkUQZgEABMWE4Kzp1KUAAAAAElFTkSuQmCC),rgba(246,167,4,0.2);
-    margin:0 -6px;
-}
-.wy-side-nav-search {
-    background:#333333;
-}
-.wy-nav-side {
-    background:#444444;
-}
-.wy-menu-vertical a {
-    color:#cccccc
-}
-.wy-menu-vertical p.caption {
-    background: #333333;
-    color: #6d6d6d;
-}
-.rst-content dl:not(.docutils) dt {
-    background:#e7fafd;
-    border-top:solid 3px #13c0d7;
-    color:rgba(0,0,0,0.5);
-}
-.rst-content .viewcode-link, .rst-content .viewcode-back {
-    color:#00b09b;
-}
-code.literal {
-    color:#e63c2e;
-}
-
-
-.rst-content #at-a-glance {
-    margin-bottom:24px;
-}
-.rst-content #at-a-glance blockquote {
-    margin-left:0;
-}
-.rst-content #at-a-glance dl:not(.docutils) dt {
-    border:none;
-    background:#f0f0f0;
-}
-.rst-content #at-a-glance dl:not(.docutils) dd, 
-.rst-content #at-a-glance dl:not(.docutils) dd dl:not(.docutils) dd {
-    display:none;
-}
-.rst-content #at-a-glance dl:not(.docutils) {
-    margin-bottom:0;
-}
diff --git a/sphinx/_templates/breadcrumbs.html b/sphinx/_templates/breadcrumbs.html
deleted file mode 100644
index e69de29..0000000
diff --git a/sphinx/_templates/layout.html b/sphinx/_templates/layout.html
deleted file mode 100644
index a2bd1c5..0000000
--- a/sphinx/_templates/layout.html
+++ /dev/null
@@ -1,43 +0,0 @@
-{% extends "!layout.html" %}
-{% block extrahead %}
-	<link rel="stylesheet" href="{{ pathto("_static/custom.css", True) }}" type="text/css">
-{% endblock %}
-{% block footer %}
-<script type="text/javascript">
-	var menuItems = $('.wy-menu-vertical').find('a');
-
-	var scrollItems = menuItems.map(function(){
-		var item = $($(this).attr('href'));
-		if (item.length) { return item; }
-	});
-
-	$(window).on('scroll',function(){
-		var fromTop = $(this).scrollTop()
-
-		var cur = scrollItems.map(function(){
-			if ($(this).offset().top < fromTop+30) return this;
-		});
-
-		cur = cur[cur.length-1];
-		var id = cur && cur.length ? cur[0].id : "";
-
-		var target = $('#'+id);
-		target.attr('id','');
-		window.location.hash = '#'+id;
-		target.attr('id',id);
-
-		menuItems
-			.parent().removeClass("current")
-			.end().filter("[href='#"+id+"']").parent().addClass("current");
-	});
-
-	$(window).on('hashchange',function(){
-
-		var hash = window.location.hash.replace('#','');
-
-		menuItems
-			.parent().removeClass("current")
-			.end().filter("[href='#"+hash+"']").parent().addClass("current");
-	})
-</script>
-{% endblock %}
\ No newline at end of file
diff --git a/sphinx/conf.py b/sphinx/conf.py
deleted file mode 100644
index 29e9324..0000000
--- a/sphinx/conf.py
+++ /dev/null
@@ -1,415 +0,0 @@
-#-*- coding: utf-8 -*-
-
-import sys
-import site
-
-import mock
-PACKAGE_NAME = u"LED SHIM"
-PACKAGE_HANDLE = "LEDSHIM"
-PACKAGE_MODULE = "ledshim"
-
-# Prompte /usr/local/lib to the front of sys.path
-#sys.path.insert(0,site.getsitepackages()[0])
-
-import sphinx_rtd_theme
-
-MOCK_MODULES = ['smbus','numpy']
-for module_name in MOCK_MODULES:
-    sys.modules[module_name] = mock.MagicMock()
-
-sys.path.insert(0, '../library/')
-
-
-import ledshim
-
-from sphinx.ext import autodoc
-
-class OutlineClassDocumenter(autodoc.ClassDocumenter):
-    objtype = 'class'
-
-    def add_content(self, more_content, no_docstring=False):
-        return
-
-class OutlineMethodDocumenter(autodoc.MethodDocumenter):
-    objtype = 'method'
-
-    def add_content(self, more_content, no_docstring=False):
-        return
-
-    def add_directive_header(self, sig):
-        if self.objpath[0] == u"Matrix":
-            self.objpath[0] = u'ledshim'
-        autodoc.MethodDocumenter.add_directive_header(self, sig)
-
-class OutlineFunctionDocumenter(autodoc.FunctionDocumenter):
-    objtype = 'function'
-
-    def add_content(self, more_content, no_docstring=False):
-        return
-
-    def add_directive_header(self, sig):
-        if self.objpath[0] == u"Matrix":
-            self.objpath[0] = u'ledshim'
-        autodoc.FunctionDocumenter.add_directive_header(self, sig)
-
-class MethodDocumenter(autodoc.MethodDocumenter):
-    objtype = 'method'
-
-    def add_directive_header(self, sig):
-        if self.objpath[0] == u"Matrix":
-            self.objpath[0] = u'ledshim'
-        autodoc.MethodDocumenter.add_directive_header(self, sig)
-
-class ClassOutlineDocumenter(autodoc.ClassDocumenter):
-    objtype = 'classoutline'
-
-    def add_directive_header(self, sig):
-        pass # Squash directive header for At A Glance view
-
-    def __init__(self, directive, name, indent=u''):
-        # Monkey patch the Method and Function documenters
-        sphinx_app.add_autodocumenter(OutlineMethodDocumenter)
-        #sphinx_app.add_autodocumenter(OutlineClassDocumenter)
-        sphinx_app.add_autodocumenter(OutlineFunctionDocumenter)
-        autodoc.ClassDocumenter.__init__(self, directive, name, indent)
-
-    def __del__(self):
-        # Return the Method and Function documenters to normal
-        #sphinx_app.add_autodocumenter(autodoc.ClassDocumenter)
-        sphinx_app.add_autodocumenter(MethodDocumenter)
-        sphinx_app.add_autodocumenter(autodoc.FunctionDocumenter)
-
-
-def setup(app):
-    global sphinx_app
-    sphinx_app = app
-    app.add_autodocumenter(ClassOutlineDocumenter)
-    app.add_autodocumenter(MethodDocumenter)
-    ClassOutlineDocumenter.objtype = 'class'
-
-# -- General configuration ------------------------------------------------
-
-# If your documentation needs a minimal Sphinx version, state it here.
-#
-# needs_sphinx = '1.0'
-
-# Add any Sphinx extension module names here, as strings. They can be
-# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
-# ones.
-extensions = [
-    'sphinx.ext.autodoc',
-    'sphinx.ext.viewcode',
-]
-
-# Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
-
-# The suffix(es) of source filenames.
-# You can specify multiple suffix as a list of string:
-#
-# source_suffix = ['.rst', '.md']
-source_suffix = '.rst'
-
-# The encoding of source files.
-#
-# source_encoding = 'utf-8-sig'
-
-# The master toctree document.
-master_doc = 'index'
-
-# General information about the project.
-project = PACKAGE_NAME
-copyright = u'2017, Pimoroni Ltd'
-author = u'Phil Howard'
-
-# The version info for the project you're documenting, acts as replacement for
-# |version| and |release|, also used in various other places throughout the
-# built documents.
-#
-# The short X.Y version.
-version = u'{}'.format(ledshim.__version__)
-# The full version, including alpha/beta/rc tags.
-release = u'{}'.format(ledshim.__version__)
-
-# The language for content autogenerated by Sphinx. Refer to documentation
-# for a list of supported languages.
-#
-# This is also used if you do content translation via gettext catalogs.
-# Usually you set "language" from the command line for these cases.
-language = None
-
-# There are two options for replacing |today|: either, you set today to some
-# non-false value, then it is used:
-#
-# today = ''
-#
-# Else, today_fmt is used as the format for a strftime call.
-#
-# today_fmt = '%B %d, %Y'
-
-# List of patterns, relative to source directory, that match files and
-# directories to ignore when looking for source files.
-# This patterns also effect to html_static_path and html_extra_path
-exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
-
-# The reST default role (used for this markup: `text`) to use for all
-# documents.
-#
-# default_role = None
-
-# If true, '()' will be appended to :func: etc. cross-reference text.
-#
-# add_function_parentheses = True
-
-# If true, the current module name will be prepended to all description
-# unit titles (such as .. function::).
-#
-# add_module_names = True
-
-# If true, sectionauthor and moduleauthor directives will be shown in the
-# output. They are ignored by default.
-#
-# show_authors = False
-
-# The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'sphinx'
-
-# A list of ignored prefixes for module index sorting.
-# modindex_common_prefix = []
-
-# If true, keep warnings as "system message" paragraphs in the built documents.
-# keep_warnings = False
-
-# If true, `todo` and `todoList` produce output, else they produce nothing.
-todo_include_todos = False
-
-
-# -- Options for HTML output ----------------------------------------------
-
-# The theme to use for HTML and HTML Help pages.  See the documentation for
-# a list of builtin themes.
-#
-html_theme = 'sphinx_rtd_theme'
-#html_theme = 'alabaster'
-
-# Theme options are theme-specific and customize the look and feel of a theme
-# further.  For a list of options available for each theme, see the
-# documentation.
-#
-html_theme_options = {
-    'collapse_navigation': False,
-    'display_version': True
-}
-
-# Add any paths that contain custom themes here, relative to this directory.
-html_theme_path = [
-    '_themes',
-    sphinx_rtd_theme.get_html_theme_path()
-]
-
-# The name for this set of Sphinx documents.
-# "<project> v<release> documentation" by default.
-#
-# html_title = PACKAGE_NAME + u' v0.1.2'
-
-# A shorter title for the navigation bar.  Default is the same as html_title.
-#
-# html_short_title = None
-
-# The name of an image file (relative to this directory) to place at the top
-# of the sidebar.
-#
-html_logo = 'shop-logo.png'
-
-# The name of an image file (relative to this directory) to use as a favicon of
-# the docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
-# pixels large.
-#
-html_favicon = 'favicon.png'
-
-# Add any paths that contain custom static files (such as style sheets) here,
-# relative to this directory. They are copied after the builtin static files,
-# so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
-
-# Add any extra paths that contain custom files (such as robots.txt or
-# .htaccess) here, relative to this directory. These files are copied
-# directly to the root of the documentation.
-#
-# html_extra_path = []
-
-# If not None, a 'Last updated on:' timestamp is inserted at every page
-# bottom, using the given strftime format.
-# The empty string is equivalent to '%b %d, %Y'.
-#
-# html_last_updated_fmt = None
-
-# If true, SmartyPants will be used to convert quotes and dashes to
-# typographically correct entities.
-#
-# html_use_smartypants = True
-
-# Custom sidebar templates, maps document names to template names.
-#
-# html_sidebars = {}
-
-# Additional templates that should be rendered to pages, maps page names to
-# template names.
-#
-# html_additional_pages = {}
-
-# If false, no module index is generated.
-#
-# html_domain_indices = True
-
-# If false, no index is generated.
-#
-html_use_index = False
-
-# If true, the index is split into individual pages for each letter.
-#
-# html_split_index = False
-
-# If true, links to the reST sources are added to the pages.
-#
-html_show_sourcelink = False
-
-# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
-#
-html_show_sphinx = False
-
-# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
-#
-# html_show_copyright = True
-
-# If true, an OpenSearch description file will be output, and all pages will
-# contain a <link> tag referring to it.  The value of this option must be the
-# base URL from which the finished HTML is served.
-#
-# html_use_opensearch = ''
-
-# This is the file name suffix for HTML files (e.g. ".xhtml").
-# html_file_suffix = None
-
-# Language to be used for generating the HTML full-text search index.
-# Sphinx supports the following languages:
-#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
-#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr', 'zh'
-#
-# html_search_language = 'en'
-
-# A dictionary with options for the search language support, empty by default.
-# 'ja' uses this config value.
-# 'zh' user can custom change `jieba` dictionary path.
-#
-# html_search_options = {'type': 'default'}
-
-# The name of a javascript file (relative to the configuration directory) that
-# implements a search results scorer. If empty, the default will be used.
-#
-# html_search_scorer = 'scorer.js'
-
-# Output file base name for HTML help builder.
-htmlhelp_basename = PACKAGE_HANDLE + 'doc'
-
-# -- Options for LaTeX output ---------------------------------------------
-
-latex_elements = {
-     # The paper size ('letterpaper' or 'a4paper').
-     #
-     # 'papersize': 'letterpaper',
-
-     # The font size ('10pt', '11pt' or '12pt').
-     #
-     # 'pointsize': '10pt',
-
-     # Additional stuff for the LaTeX preamble.
-     #
-     # 'preamble': '',
-
-     # Latex figure (float) alignment
-     #
-     # 'figure_align': 'htbp',
-}
-
-# Grouping the document tree into LaTeX files. List of tuples
-# (source start file, target name, title,
-#  author, documentclass [howto, manual, or own class]).
-latex_documents = [
-    (master_doc, PACKAGE_HANDLE + '.tex', PACKAGE_NAME + u' Documentation',
-     u'Phil Howard', 'manual'),
-]
-
-# The name of an image file (relative to this directory) to place at the top of
-# the title page.
-#
-# latex_logo = None
-
-# For "manual" documents, if this is true, then toplevel headings are parts,
-# not chapters.
-#
-# latex_use_parts = False
-
-# If true, show page references after internal links.
-#
-# latex_show_pagerefs = False
-
-# If true, show URL addresses after external links.
-#
-# latex_show_urls = False
-
-# Documents to append as an appendix to all manuals.
-#
-# latex_appendices = []
-
-# It false, will not define \strong, \code, 	itleref, \crossref ... but only
-# \sphinxstrong, ..., \sphinxtitleref, ... To help avoid clash with user added
-# packages.
-#
-# latex_keep_old_macro_names = True
-
-# If false, no module index is generated.
-#
-# latex_domain_indices = True
-
-
-# -- Options for manual page output ---------------------------------------
-
-# One entry per manual page. List of tuples
-# (source start file, name, description, authors, manual section).
-man_pages = [
-    (master_doc,  PACKAGE_MODULE, PACKAGE_NAME + u' Documentation',
-     [author], 1)
-]
-
-# If true, show URL addresses after external links.
-#
-# man_show_urls = False
-
-
-# -- Options for Texinfo output -------------------------------------------
-
-# Grouping the document tree into Texinfo files. List of tuples
-# (source start file, target name, title, author,
-#  dir menu entry, description, category)
-texinfo_documents = [
-    (master_doc, PACKAGE_HANDLE, PACKAGE_NAME + u' Documentation',
-     author, PACKAGE_HANDLE, 'One line description of project.',
-     'Miscellaneous'),
-]
-
-# Documents to append as an appendix to all manuals.
-#
-# texinfo_appendices = []
-
-# If false, no module index is generated.
-#
-# texinfo_domain_indices = True
-
-# How to display URL addresses: 'footnote', 'no', or 'inline'.
-#
-# texinfo_show_urls = 'footnote'
-
-# If true, do not generate a @detailmenu in the "Top" node's menu.
-#
-# texinfo_no_detailmenu = False
diff --git a/sphinx/favicon.png b/sphinx/favicon.png
deleted file mode 100644
index 5ed0316..0000000
Binary files a/sphinx/favicon.png and /dev/null differ
diff --git a/sphinx/index.rst b/sphinx/index.rst
deleted file mode 100644
index 2c35de6..0000000
--- a/sphinx/index.rst
+++ /dev/null
@@ -1,60 +0,0 @@
-.. role:: python(code)
-   :language: python
-
-Welcome
--------
-
-This documentation will guide you through the methods available in the LED SHIM Python library.
-
-LED SHIM provides a row of 24 tiny RGB LEDs which you can light up with any colour you like!
-
-* More information - https://shop.pimoroni.com/products/led-shim
-* Get the code - https://github.com/pimoroni/led-shim
-* GPIO pinout - https://pinout.xyz/pinout/led_shim
-* Get help - http://forums.pimoroni.com/c/support
-
-.. currentmodule:: ledshim.is31fl3731.Matrix
-
-At A Glance
------------
-
-.. autoclassoutline:: ledshim.is31fl3731.Matrix
-   :members:
-
-.. toctree::
-   :titlesonly:
-   :maxdepth: 0
-
-Set A Single Pixel In Buffer
-----------------------------
-
-When you set a pixel it will not immediately display on LED SHIM, you must call :python:`ledshim.show()`.
-
-.. automethod:: ledshim.is31fl3731.Matrix.set_pixel
-   :noindex:
-
-Display Buffer
---------------
-
-All of your changes to LED SHIM are stored in a Python buffer. To display them
-on LED SHIM you must call :python:`ledshim.show()`.
-
-.. automethod:: ledshim.is31fl3731.Matrix.show
-   :noindex:
-
-Clear Buffer
-------------
-
-.. automethod:: ledshim.is31fl3731.Matrix.clear
-   :noindex:
-
-Get The Display Size
---------------------
-
-.. automethod:: ledshim.is31fl3731.Matrix.get_shape
-   :noindex:
-
-Set Multiple Pixels
--------------------
-
-.. autofunction:: ledshim.set_multiple_pixels
diff --git a/sphinx/requirements.txt b/sphinx/requirements.txt
deleted file mode 100644
index be4d985..0000000
--- a/sphinx/requirements.txt
+++ /dev/null
@@ -1,18 +0,0 @@
-alabaster==0.7.9
-appdirs==1.4.2
-Babel==2.3.4
-docutils==0.13.1
-imagesize==0.7.1
-Jinja2==2.9.5
-MarkupSafe==0.23
-mock==2.0.0
-packaging==16.8
-pbr==1.10.0
-Pygments==2.2.0
-pyparsing==2.1.10
-pytz==2016.10
-requests==2.13.0
-six==1.10.0
-snowballstemmer==1.2.1
-Sphinx==1.5.3
-sphinx-rtd-theme==0.1.9
diff --git a/sphinx/shop-logo.png b/sphinx/shop-logo.png
deleted file mode 100644
index 8fd0cda..0000000
Binary files a/sphinx/shop-logo.png and /dev/null differ
diff --git a/library/test.py b/test.py
similarity index 99%
rename from library/test.py
rename to test.py
index 5995f91..dec385c 100644
--- a/library/test.py
+++ b/test.py
@@ -2,7 +2,6 @@
 
 import ledshim
 
-
 for x in range(ledshim.width):
     ledshim.set_pixel(x,255,0,0)
     ledshim.show()
diff --git a/library/tests/setup.cfg b/tests/setup.cfg
similarity index 100%
rename from library/tests/setup.cfg
rename to tests/setup.cfg
diff --git a/library/tests/test_setup.py b/tests/test_setup.py
similarity index 65%
rename from library/tests/test_setup.py
rename to tests/test_setup.py
index 967cd87..07188d9 100644
--- a/library/tests/test_setup.py
+++ b/tests/test_setup.py
@@ -1,8 +1,10 @@
-import mock
 import sys
 
+import mock
+
 
 def test_setup():
-    sys.modules['smbus'] = mock.Mock()
+    sys.modules["smbus2"] = mock.Mock()
+
     import ledshim
     ledshim.show()
diff --git a/tox.ini b/tox.ini
new file mode 100644
index 0000000..2b6d87b
--- /dev/null
+++ b/tox.ini
@@ -0,0 +1,27 @@
+[tox]
+envlist = py,qa
+skip_missing_interpreters = True
+isolated_build = true
+minversion = 4.0.0
+
+[testenv]
+commands =
+	coverage run -m pytest -v -r wsx
+	coverage report
+deps =
+	mock
+	pytest>=3.1
+	pytest-cov
+	build
+
+[testenv:qa]
+commands =
+	check-manifest
+	python -m build --no-isolation
+	python -m twine check dist/*
+	isort --check .
+	ruff check .
+	codespell .
+deps =
+	-r{toxinidir}/requirements-dev.txt
+
diff --git a/uninstall.sh b/uninstall.sh
new file mode 100755
index 0000000..3314b7f
--- /dev/null
+++ b/uninstall.sh
@@ -0,0 +1,72 @@
+#!/bin/bash
+
+FORCE=false
+LIBRARY_NAME=$(grep -m 1 name pyproject.toml | awk -F" = " '{print substr($2,2,length($2)-2)}')
+RESOURCES_DIR=$HOME/Pimoroni/$LIBRARY_NAME
+PYTHON="python"
+
+
+venv_check() {
+	PYTHON_BIN=$(which $PYTHON)
+	if [[ $VIRTUAL_ENV == "" ]] || [[ $PYTHON_BIN != $VIRTUAL_ENV* ]]; then
+		printf "This script should be run in a virtual Python environment.\n"
+		exit 1
+	fi
+}
+
+user_check() {
+	if [ "$(id -u)" -eq 0 ]; then
+		printf "Script should not be run as root. Try './uninstall.sh'\n"
+		exit 1
+	fi
+}
+
+confirm() {
+	if $FORCE; then
+		true
+	else
+		read -r -p "$1 [y/N] " response < /dev/tty
+		if [[ $response =~ ^(yes|y|Y)$ ]]; then
+			true
+		else
+			false
+		fi
+	fi
+}
+
+prompt() {
+	read -r -p "$1 [y/N] " response < /dev/tty
+	if [[ $response =~ ^(yes|y|Y)$ ]]; then
+		true
+	else
+		false
+	fi
+}
+
+success() {
+	echo -e "$(tput setaf 2)$1$(tput sgr0)"
+}
+
+inform() {
+	echo -e "$(tput setaf 6)$1$(tput sgr0)"
+}
+
+warning() {
+	echo -e "$(tput setaf 1)$1$(tput sgr0)"
+}
+
+printf "%s Python Library: Uninstaller\n\n" "$LIBRARY_NAME"
+
+user_check
+venv_check
+
+printf "Uninstalling for Python 3...\n"
+$PYTHON -m pip uninstall "$LIBRARY_NAME"
+
+if [ -d "$RESOURCES_DIR" ]; then
+	if confirm "Would you like to delete $RESOURCES_DIR?"; then
+		rm -r "$RESOURCES_DIR"
+	fi
+fi
+
+printf "Done!\n"