Add updated PyPi and example install instructions

Author: malcolm-sparkfun

README.md

@@ -50,43 +50,24 @@ The first step to using this package is installing it on your system. The instal
 
 ### Python 
 
-The package is primarily installed using the `pip` command, downloading the package from the Python Index - "PyPi". Note - the below instructions outline installation an Linux-based (Raspberry Pi) system.
-
 #### PyPi Installation
+The package is primarily installed using the `pip3` command, downloading the package from the Python Index - "PyPi". 
 
-The SparkFun Qwiic Keypad Python package is part of the overall SparkFun Qwiic Python package which is hosted on PyPi. On systems that support PyPi installation via pip, this library is installed using the following commands
+Note - the below instructions outline installation an Linux-based (Raspberry Pi) system.
 
-For all users (note: the user must have sudo privileges):
+First, setup a virtual environment from a specific directory using venv:
 ```sh
-sudo pip install sparkfun-qwiic
+python3 -m venv path/to/venv
 ```
-For the current user:
+You can pass any path as path/to/venv, just make sure you use the same one for all future steps. For more information on venv [click here](https://docs.python.org/3/library/venv.html).
 
+Next, install the qwiic package with:
 ```sh
-pip install sparkfun-qwiic
-```
----
----
-> [!CAUTION]
-> **TODO** Put together how this works with the new virtual environments used with the latest Python install
----
----
-#### Local Installation
-To install, make sure the setuptools package is installed on the system.
-
-Direct installation at the command line:
-```sh
-python setup.py install
+path/to/venv/bin/pip3 install sparkfun-qwiic-keypad
 ```
-
-To build a package for use with pip:
-```sh
-python setup.py sdist
- ```
-A package file is built and placed in a subdirectory called dist. This package file can be installed using pip.
+Now you should be able to run any example or custom python scripts that have `import qwiic_keypad` by running e.g.:
 ```sh
-cd dist
-pip install sparkfun_qwiic_keypad-<version>.tar.gz
+path/to/venv/bin/python3 example_script.py
 ```
 
 ### MicroPython Installation
@@ -97,6 +78,11 @@ Connect a device with MicroPython installed to your computer and then install th
 mpremote mip install github:sparkfun/qwiic_keypad_py
 ```
 
+If you would also like to install the examples for this repository, issue the following mip command as well:
+```sh
+mprmeote mip install github:sparkfun/qwiic_keypad_py@examples
+```
+
 ### CircuitPython Installation
 If not already installed, follow the [instructions here](https://docs.circuitpython.org/projects/circup/en/latest/#installation) to install CircUp on your computer.
 
@@ -110,6 +96,13 @@ Finally, connect a device with CircuitPython installed to your computer and then
 circup install --py qwiic_keypad
 ```
 
+If you would like to install any of the examples from this repository, issue the corresponding circup command from below. (NOTE: The below syntax assumes you are using CircUp on Windows. Linux and Mac will have different path seperators (i.e. "/" vs. "\"). See the [CircUp "example" command documentation](https://learn.adafruit.com/keep-your-circuitpython-libraries-on-devices-up-to-date-with-circup/example-command) for more information)
+```sh
+circup example qwiic_keypad\qwiic_keypad_ex1.py
+circup example qwiic_keypad\qwiic_keypad_ex2.py
+circup example qwiic_keypad\qwiic_keypad_ex3.py
+```
+
 Example Use
  ---------------
 Below is a quickstart program to print which button was pressed or a space if '*' is pressed and a newline if '#' is pressed.