Merge branch 'master' of https://github.com/adafruit/Adafruit_CircuitPython_FeatherWing

Author: makermelissa

.github/workflows/build.yml

@@ -40,7 +40,7 @@ jobs:
         source actions-ci/install.sh
     - name: Pip install pylint, black, & Sphinx
       run: |
-        pip install --force-reinstall pylint==1.9.2 black==19.10b0 Sphinx sphinx-rtd-theme
+        pip install --force-reinstall pylint black==19.10b0 Sphinx sphinx-rtd-theme
     - name: Library version
       run: git describe --dirty --always --tags
     - name: PyLint

CODE_OF_CONDUCT.md

@@ -1,74 +1,129 @@
-# Contributor Covenant Code of Conduct
+# Adafruit Community Code of Conduct
 
 ## Our Pledge
 
 In the interest of fostering an open and welcoming environment, we as
-contributors and maintainers pledge to making participation in our project and
+contributors and leaders pledge to making participation in our project and
 our community a harassment-free experience for everyone, regardless of age, body
-size, disability, ethnicity, gender identity and expression, level of experience,
-nationality, personal appearance, race, religion, or sexual identity and
-orientation.
+size, disability, ethnicity, gender identity and expression, level or type of
+experience, education, socio-economic status, nationality, personal appearance,
+race, religion, or sexual identity and orientation.
 
 ## Our Standards
 
+We are committed to providing a friendly, safe and welcoming environment for
+all.
+
 Examples of behavior that contributes to creating a positive environment
 include:
 
+* Be kind and courteous to others
 * Using welcoming and inclusive language
 * Being respectful of differing viewpoints and experiences
+* Collaborating with other community members
 * Gracefully accepting constructive criticism
 * Focusing on what is best for the community
 * Showing empathy towards other community members
 
 Examples of unacceptable behavior by participants include:
 
-* The use of sexualized language or imagery and unwelcome sexual attention or
-advances
+* The use of sexualized language or imagery and sexual attention or advances
+* The use of inappropriate images, including in a community member's avatar
+* The use of inappropriate language, including in a community member's nickname
+* Any spamming, flaming, baiting or other attention-stealing behavior
+* Excessive or unwelcome helping; answering outside the scope of the question
+  asked
 * Trolling, insulting/derogatory comments, and personal or political attacks
+* Promoting or spreading disinformation, lies, or conspiracy theories against
+  a person, group, organisation, project, or community
 * Public or private harassment
 * Publishing others' private information, such as a physical or electronic
   address, without explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
-  professional setting
+* Other conduct which could reasonably be considered inappropriate
+
+The goal of the standards and moderation guidelines outlined here is to build
+and maintain a respectful community. We ask that you don’t just aim to be
+"technically unimpeachable", but rather try to be your best self. 
+
+We value many things beyond technical expertise, including collaboration and
+supporting others within our community. Providing a positive experience for
+other community members can have a much more significant impact than simply
+providing the correct answer.
 
 ## Our Responsibilities
 
-Project maintainers are responsible for clarifying the standards of acceptable
+Project leaders are responsible for clarifying the standards of acceptable
 behavior and are expected to take appropriate and fair corrective action in
 response to any instances of unacceptable behavior.
 
-Project maintainers have the right and responsibility to remove, edit, or
-reject comments, commits, code, wiki edits, issues, and other contributions
+Project leaders have the right and responsibility to remove, edit, or
+reject messages, comments, commits, code, issues, and other contributions
 that are not aligned to this Code of Conduct, or to ban temporarily or
-permanently any contributor for other behaviors that they deem inappropriate,
-threatening, offensive, or harmful.
+permanently any community member for other behaviors that they deem
+inappropriate, threatening, offensive, or harmful.
 
-## Scope
+## Moderation
 
-This Code of Conduct applies both within project spaces and in public spaces
-when an individual is representing the project or its community. Examples of
-representing a project or community include using an official project e-mail
-address, posting via an official social media account, or acting as an appointed
-representative at an online or offline event. Representation of a project may be
-further defined and clarified by project maintainers.
+Instances of behaviors that violate the Adafruit Community Code of Conduct
+may be reported by any member of the community. Community members are
+encouraged to report these situations, including situations they witness
+involving other community members.
+
+You may report in the following ways:
+
+In any situation, you may send an email to <[email protected]>.
 
-## Enforcement
+On the Adafruit Discord, you may send an open message from any channel
+to all Community Moderators by tagging @community moderators. You may 
+also send an open message from any channel, or a direct message to 
+@kattni#1507, @tannewt#4653, @Dan Halbert#1614, @cater#2442, 
+@sommersoft#0222, @Mr. Certainly#0472 or @Andon#8175.
 
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at [email protected]. All
-complaints will be reviewed and investigated and will result in a response that
-is deemed necessary and appropriate to the circumstances. The project team is
-obligated to maintain confidentiality with regard to the reporter of an incident.
-Further details of specific enforcement policies may be posted separately.
+Email and direct message reports will be kept confidential.
 
-Project maintainers who do not follow or enforce the Code of Conduct in good
-faith may face temporary or permanent repercussions as determined by other
-members of the project's leadership.
+In situations on Discord where the issue is particularly egregious, possibly
+illegal, requires immediate action, or violates the Discord terms of service,
+you should also report the message directly to Discord.
+
+These are the steps for upholding our community’s standards of conduct.
+
+1. Any member of the community may report any situation that violates the
+Adafruit Community Code of Conduct. All reports will be reviewed and
+investigated.
+2. If the behavior is an egregious violation, the community member who
+committed the violation may be banned immediately, without warning.
+3. Otherwise, moderators will first respond to such behavior with a warning.
+4. Moderators follow a soft "three strikes" policy - the community member may
+be given another chance, if they are receptive to the warning and change their
+behavior.
+5. If the community member is unreceptive or unreasonable when warned by a
+moderator, or the warning goes unheeded, they may be banned for a first or
+second offense. Repeated offenses will result in the community member being
+banned.
+
+## Scope
+
+This Code of Conduct and the enforcement policies listed above apply to all
+Adafruit Community venues. This includes but is not limited to any community
+spaces (both public and private), the entire Adafruit Discord server, and
+Adafruit GitHub repositories. Examples of Adafruit Community spaces include
+but are not limited to meet-ups, audio chats on the Adafruit Discord, or
+interaction at a conference.
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. As a community
+member, you are representing our community, and are expected to behave
+accordingly.
 
 ## Attribution
 
-This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
-available at [http://contributor-covenant.org/version/1/4][version]
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 1.4, available at
+<https://www.contributor-covenant.org/version/1/4/code-of-conduct.html>,
+and the [Rust Code of Conduct](https://www.rust-lang.org/en-US/conduct.html).
 
-[homepage]: http://contributor-covenant.org
-[version]: http://contributor-covenant.org/version/1/4/
+For other projects adopting the Adafruit Community Code of
+Conduct, please contact the maintainers of those projects for enforcement.
+If you wish to use this code of conduct for your own project, consider
+explicitly mentioning your moderation policy or making a copy with your
+own moderation policy so as to avoid confusion.

adafruit_featherwing/alphanum_featherwing.py

@@ -35,11 +35,13 @@
 import adafruit_ht16k33.segments as segments
 from adafruit_featherwing.led_segments import Segments
 
+
 class AlphaNumFeatherWing(Segments):
     """Class representing an `Adafruit 14-segment AlphaNumeric FeatherWing
        <https://www.adafruit.com/product/3139>`_.
 
        Automatically uses the feather's I2C bus."""
+
     def __init__(self, address=0x70, i2c=None):
         super().__init__()
         if i2c is None:

adafruit_featherwing/dotstar_featherwing.py

@@ -35,11 +35,13 @@
 import adafruit_dotstar as dotstar
 from adafruit_featherwing.pixelmatrix import PixelMatrix
 
+
 class DotStarFeatherWing(PixelMatrix):
     """Class representing a `DotStar FeatherWing
        <https://www.adafruit.com/product/3449>`_.
 
        The feather uses pins D13 and D11"""
+
     def __init__(self, clock=board.D13, data=board.D11, brightness=0.2):
         """
             :param pin clock: The clock pin for the featherwing
@@ -49,5 +51,10 @@ def __init__(self, clock=board.D13, data=board.D11, brightness=0.2):
         super().__init__()
         self.rows = 6
         self.columns = 12
-        self._matrix = dotstar.DotStar(clock, data, self.rows * self.columns,
-                                       brightness=brightness, auto_write=False)
+        self._matrix = dotstar.DotStar(
+            clock,
+            data,
+            self.rows * self.columns,
+            brightness=brightness,
+            auto_write=False,
+        )

adafruit_featherwing/gps_featherwing.py

@@ -35,11 +35,13 @@
 import busio
 import adafruit_gps
 
+
 class GPSFeatherWing:
     """Class representing an `Ultimate GPS FeatherWing
        <https://www.adafruit.com/product/3133>`_.
 
        Automatically uses the feather's UART bus."""
+
     def __init__(self, update_period=1000, baudrate=9600):
         """
         :param int update_period: (Optional) The amount of time in milliseconds between
@@ -57,8 +59,10 @@ def __init__(self, update_period=1000, baudrate=9600):
         self._uart = busio.UART(board.TX, board.RX, baudrate=baudrate, timeout=timeout)
         self._gps = adafruit_gps.GPS(self._uart, debug=False)
         # Turn on the basic GGA and RMC info
-        self._gps.send_command(bytes('PMTK314,0,1,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0', 'utf-8'))
-        self._gps.send_command(bytes('PMTK220,{}'.format(update_period), 'utf-8'))
+        self._gps.send_command(
+            bytes("PMTK314,0,1,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0", "utf-8")
+        )
+        self._gps.send_command(bytes("PMTK220,{}".format(update_period), "utf-8"))
 
     def update(self):
         """

adafruit_featherwing/ina219_featherwing.py

@@ -34,11 +34,13 @@
 import board
 import adafruit_ina219
 
+
 class INA219FeatherWing:
     """Class representing an `Adafruit INA219 FeatherWing
        <https://www.adafruit.com/product/3650>`_.
 
        Automatically uses the feather's I2C bus."""
+
     def __init__(self, i2c=None):
         if i2c is None:
             i2c = board.I2C()

adafruit_featherwing/joy_featherwing.py

@@ -46,12 +46,15 @@ class JoyFeatherWing:
     """Class representing an `Adafruit Joy FeatherWing <https://www.adafruit.com/product/3632>`_.
 
        Automatically uses the feather's I2C bus."""
+
     def __init__(self, i2c=None):
         if i2c is None:
             i2c = board.I2C()
         self._seesaw = adafruit_seesaw.seesaw.Seesaw(i2c)
-        self._seesaw.pin_mode_bulk(BUTTON_A | BUTTON_B | BUTTON_Y | BUTTON_X | BUTTON_SELECT,
-                                   self._seesaw.INPUT_PULLUP)
+        self._seesaw.pin_mode_bulk(
+            BUTTON_A | BUTTON_B | BUTTON_Y | BUTTON_X | BUTTON_SELECT,
+            self._seesaw.INPUT_PULLUP,
+        )
 
         # Initialise joystick_offset
         self._joystick_offset = (0, 0)

adafruit_featherwing/led_segments.py

@@ -31,13 +31,15 @@
 __version__ = "0.0.0-auto.0"
 __repo__ = "https://github.com/adafruit/Adafruit_CircuitPython_FeatherWing.git"
 
-#pylint: disable-msg=unsubscriptable-object, unsupported-assignment-operation
+# pylint: disable-msg=unsubscriptable-object, unsupported-assignment-operation
+
 
 class Segments:
     """Class representing an `Adafruit 14-segment AlphaNumeric FeatherWing
        <https://www.adafruit.com/product/3139>`_.
 
        Automatically uses the feather's I2C bus."""
+
     def __init__(self):
         self._segments = None
 
@@ -78,7 +80,7 @@ def fill(self, fill):
             self._segments.fill(1 if fill else 0)
             self._segments.show()
         else:
-            raise ValueError('Must set to either True or False.')
+            raise ValueError("Must set to either True or False.")
 
     @property
     def blink_rate(self):

adafruit_featherwing/matrix_featherwing.py

@@ -35,11 +35,13 @@
 import board
 import adafruit_ht16k33.matrix as matrix
 
+
 class MatrixFeatherWing:
     """Class representing an `Adafruit 8x16 LED Matrix FeatherWing
        <https://www.adafruit.com/product/3155>`_.
 
        Automatically uses the feather's I2C bus."""
+
     def __init__(self, address=0x70, i2c=None):
         if i2c is None:
             i2c = board.I2C()
@@ -102,7 +104,7 @@ def fill(self, fill):
             self._matrix.fill(1 if fill else 0)
             self._update()
         else:
-            raise ValueError('Must set to either True or False.')
+            raise ValueError("Must set to either True or False.")
 
     def shift_right(self, rotate=False):
         """