Add updated PyPi and example install instructions

Author: malcolm-sparkfun

README.md

@@ -50,43 +50,25 @@ 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 SparkFun Qwiic Soil Moisture Sensor 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
+The package is primarily installed using the `pip3` command, downloading the package from the Python Index - "PyPi". 
 
-For all users (note: the user must have sudo privileges):
-```sh
-sudo pip install sparkfun-qwiic
-```
-For the current user:
+Note - the below instructions outline installation an Linux-based (Raspberry Pi) system.
 
+First, setup a virtual environment from a specific directory using venv:
 ```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
+python3 -m venv path/to/venv
 ```
+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).
 
-To build a package for use with pip:
+Next, install the qwiic package with:
 ```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.
+path/to/venv/bin/pip3 install sparkfun-qwiic-soil-moisture-sensor
+```
+Now you should be able to run any example or custom python scripts that have `import qwiic_soil_moisture_sensor` by running e.g.:
 ```sh
-cd dist
-pip install sparkfun_qwiic_soil_moisture_sensor-<version>.tar.gz
+path/to/venv/bin/python3 example_script.py
 ```
 
 ### MicroPython Installation
@@ -97,6 +79,11 @@ Connect a device with MicroPython installed to your computer and then install th
 mpremote mip install github:sparkfun/qwiic_soil_moisture_sensor_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_soil_moisture_sensor_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 +97,12 @@ Finally, connect a device with CircuitPython installed to your computer and then
 circup install --py qwiic_soil_moisture_sensor
 ```
 
+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_soil_moisture_sensor\Example1_GetReadings
+circup example qwiic_soil_moisture_sensor\Example2_Change_I2C_Address
+```
+
 Example Use
  ---------------
 Below is a quickstart program to print moisture level and toggle the LED on the Soil Moisture Sensor.