Skip to main content

Generate graphical pinout references for electronic hardware.

Project description

pinout

GitHub GitHub last commit Read the Docs

SVG diagram creation from Python code - pinout provides an easy method of creating pin-out diagrams for electronic hardware.

Example diagram created from pinout: micropython pin-out on Adafruit Huzzah32 ESP32 Feather Board.

Please visit pinout.readthedocs.io for the latest 'getting started' guide and detailed documentation on all options provided by the pinout package.

Quick start

pinout provides some sample files for a quick start and demonstration of key features.

Install

Using a virtual environment is recommended; Start by installing the pinout package. Either clone this repo and pip install it or install from PyPi:

pip install pinout

# Or upgrade to the latest version
pip install --upgrade pinout

Duplicate sample files

A normal pinout diagram will ultimately include an SVG file, an image of hardware to be documented, and a stylesheet that provides unique styles to the diagram. Duplicate the sample files from the pinout package by launch Python at the location you intend to work and enter the following:

from pinout import resources
resources.duplicate('get started')

# expected output:
# >>> get_started_pinout.py duplicated.
# >>> get_started_board.png duplicated.
# >>> get_started_styles.css duplicated.

Once you have these file a finished diagram can be generated by running the python script from a command line py get_started_pinout.py. An SVG file is created and can be conveniently view in a browser.

SVG diagram

For a detailed walk through sample_diagram.py and more information on pinout please visit pinout.readthedocs.io.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pinout-0.0.8.tar.gz (29.1 kB view hashes)

Uploaded Source

Built Distribution

pinout-0.0.8-py3-none-any.whl (33.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page