Skip to content

Commit 0a7f238

Browse files
authored
Merge pull request #379 from davclark/library_development_doc
Some small pointers on library development
2 parents ffa34ce + 41cb85e commit 0a7f238

File tree

3 files changed

+24
-0
lines changed

3 files changed

+24
-0
lines changed

LIBRARY_DEVELOPMENT.rst

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
Developing Libraries in the Bundle
2+
==================================
3+
4+
Adafruit CircuitPython libraries are generally installable on a CPython interpreter with `pip` (or other package
5+
managers). The "Blinka" libraries are compatibility layers to fill in missing pieces that are expected from
6+
CircuitPython. Unfortunately, some of these compatibility layers may not work in all environments.
7+
8+
Unless you are working with all of the libaries at the same time, the easiest workflow for development is to fork an
9+
individual library and make your changes there before submitting a PR back to the adafruit repository. If, however, you
10+
want to programmatically modify all libraries in this bundle, it may be more efficient to do development within this
11+
repository.
12+
13+
Code Hygiene
14+
------------
15+
16+
Adafruit libraries are not currently fully typed. If you would like to improve the typing coverage, we suggest
17+
`installing mypy`_. You can then run mypy from the command line or from within your editor / IDE.
18+
19+
.. _installing mypy: https://mypy.readthedocs.io/en/stable/getting_started.html#installing-and-running-mypy

LIBRARY_DEVELOPMENT.rst.license

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# SPDX-FileCopyrightText: 2022 Dav Clark (@davclark)
2+
#
3+
# SPDX-License-Identifier: Unlicense

README.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,8 @@ Development
4545
After you clone this repository you must run ``git submodule init``
4646
and then ``git submodule update``.
4747

48+
For developing individual libraries, please see LIBRARY_DEVELOPMENT.rst.
49+
4850
Updating libraries
4951
-------------------
5052
To update the libraries run ``update-submodules.sh``. The script will fetch the

0 commit comments

Comments
 (0)