- name: PyLint
run: |
pylint $( find . -path './*io.py' )
- ([[ ! -d "examples" ]] || pylint --disable=missing-docstring,invalid-name,bad-whitespace $( find . -path "./examples/*.py" ))
- name: Build docs
working-directory: docs
run: sphinx-build -E -W -b html . _build/html
Introduction
============
-.. image:: https://readthedocs.org/projects/adafruit-blinka-circuitpython-displayio/badge/?version=latest
+.. image:: https://readthedocs.org/projects/adafruit-blinka-blinka-displayio/badge/?version=latest
:target: https://circuitpython.readthedocs.io/projects/displayio/en/latest/
:alt: Documentation Status
=============
This driver depends on:
-* `Adafruit CircuitPython <https://github.com/adafruit/circuitpython>`_
-
-Please ensure all dependencies are available on the CircuitPython filesystem.
-This is easily achieved by downloading
-`the Adafruit library and driver bundle <https://circuitpython.org/libraries>`_.
+* `Adafruit Blinka <https://github.com/adafruit/Adafruit_Blinka>`_
Installing from PyPI
=====================
-.. note:: This library is not available on PyPI yet. Install documentation is included
- as a standard element. Stay tuned for PyPI availability!
-
-.. todo:: Remove the above note if PyPI version is/will be available at time of release.
- If the library is not planned for PyPI, remove the entire 'Installing from PyPI' section.
On supported GNU/Linux systems like the Raspberry Pi, you can install the driver locally `from
-PyPI <https://pypi.org/project/adafruit-circuitpython-displayio/>`_. To install for current user:
+PyPI <https://pypi.org/project/adafruit-blinka-displayio/>`_. To install for current user:
.. code-block:: shell
- pip3 install adafruit-circuitpython-displayio
+ pip3 install adafruit-blinka-displayio
To install system-wide (this may be required in some cases):
.. code-block:: shell
- sudo pip3 install adafruit-circuitpython-displayio
+ sudo pip3 install adafruit-blinka-displayio
To install in a virtual environment in your current project:
mkdir project-name && cd project-name
python3 -m venv .env
source .env/bin/activate
- pip3 install adafruit-circuitpython-displayio
-
-Usage Example
-=============
-
-.. todo:: Add a quick, simple example. It and other examples should live in the examples folder and be included in docs/examples.rst.
+ pip3 install adafruit-blinka-displayio
Contributing
============
Documentation
=============
-For information on building library documentation, please check out `this guide <https://learn.adafruit.com/creating-and-sharing-a-circuitpython-library/sharing-our-docs-on-readthedocs#sphinx-5-1>`_.
+For information on building library documentation, please check out `this guide <https://learn.adafruit.com/creating-and-sharing-a-blinka-library/sharing-our-docs-on-readthedocs#sphinx-5-1>`_.
.. If your library file(s) are nested in a directory (e.g. /adafruit_foo/foo.py)
.. use this format as the module name: "adafruit_foo.foo"
-.. automodule:: adafruit_blinka_displayio
+.. automodule:: displayio
+ :members:
+
+.. automodule:: fontio
+ :members:
+
+.. automodule:: terminalio
:members:
+++ /dev/null
-Simple test
-------------
-
-Ensure your device works with this simple test.
-
-.. literalinclude:: ../examples/displayio_simpletest.py
- :caption: examples/displayio_simpletest.py
- :linenos:
self
-.. toctree::
- :caption: Examples
-
- examples
-
.. toctree::
:caption: API Reference
:maxdepth: 3
.. toctree::
:caption: Tutorials
-.. todo:: Add any Learn guide links here. If there are none, then simply delete this todo and leave
- the toctree above for use later.
-
.. toctree::
:caption: Related Products
-.. todo:: Add any product links here. If there are none, then simply delete this todo and leave
- the toctree above for use later.
-
.. toctree::
:caption: Other Links
long_description = f.read()
setup(
- name="adafruit-circuitpython-displayio",
+ name="adafruit-blinka-displayio",
use_scm_version=True,
setup_requires=["setuptools_scm"],
description="displayio for Blinka",
long_description=long_description,
long_description_content_type="text/x-rst",
# The project's main homepage.
- url="https://github.com/adafruit/Adafruit_CircuitPython_displayio",
+ url="https://github.com/adafruit/Adafruit_Blinka_Displayio",
# Author details
author="Adafruit Industries",
author_email="circuitpython@adafruit.com",
keywords="adafruit blinka circuitpython micropython displayio lcd tft display pitft",
# You can just specify the packages manually here if your project is
# simple. Or you can use find_packages().
- # TODO: IF LIBRARY FILES ARE A PACKAGE FOLDER,
- # CHANGE `py_modules=['...']` TO `packages=['...']`
- py_modules=["adafruit_blinka_displayio"],
+ py_modules=["displayio", "fontio", "terminalio"],
)