add pypi instructions to README.rst

Author: brennen

README.rst

@@ -1,4 +1,3 @@
-
 Introduction
 ============
 
@@ -16,48 +15,67 @@ Introduction
 
 I2C and SPI driver for the Bosch BME280 Temperature, Humidity, and Barometric Pressure sensor
 
-Dependencies
-=============
+Installation and Dependencies
+=============================
+
 This driver depends on:
 
 * `Adafruit CircuitPython <https://github.com/adafruit/circuitpython>`_
 * `Bus Device <https://github.com/adafruit/Adafruit_CircuitPython_BusDevice>`_
 
-Please ensure all dependencies are available on the CircuitPython filesystem.
-This is easily achieved by downloading
-`the Adafruit library and driver bundle <https://github.com/adafruit/Adafruit_CircuitPython_Bundle>`_.
+Please ensure that the driver and all dependencies are available on the
+CircuitPython filesystem.  This can be most easily achieved by downloading and
+installing the latest
+`Adafruit library and driver bundle <https://github.com/adafruit/Adafruit_CircuitPython_Bundle>`_
+on your device.
+
+Installing from PyPI
+--------------------
+
+On the Raspberry Pi, you can install the driver locally
+`from PyPI <https://pypi.org/project/adafruit-circuitpython-bme280/>`_.  To
+install system-wide, use:
+
+..code-block:: shell
+    pip3 install adafruit-circuitpython-bme280
+
+To install in a virtual environment in your current project:
+
+..code-block:: shell
+    mkdir project-name && cd project-name
+    python3 -m venv .env
+    source .env/bin/activate
+    pip3 install adafruit-circuitpython-bme280
 
 Usage Example
 =============
 
 .. code-block:: python
 
-	import board
-	import digitalio
-	import busio
-	import time
-	import adafruit_bme280
-
-	# Create library object using our Bus I2C port
-	i2c = busio.I2C(board.SCL, board.SDA)
-	bme280 = adafruit_bme280.Adafruit_BME280_I2C(i2c)
-
-	# OR create library object using our Bus SPI port
-	#spi = busio.SPI(board.SCK, board.MOSI, board.MISO)
-	#bme_cs = digitalio.DigitalInOut(board.D10)
-	#bme280 = adafruit_bme280.Adafruit_BME280_SPI(spi, bme_cs)
+    import board
+    import digitalio
+    import busio
+    import time
+    import adafruit_bme280
 
-	# change this to match the location's pressure (hPa) at sea level
-	bme280.sea_level_pressure = 1013.25
+    # Create library object using our Bus I2C port
+    i2c = busio.I2C(board.SCL, board.SDA)
+    bme280 = adafruit_bme280.Adafruit_BME280_I2C(i2c)
 
-	while True:
-	    print("\nTemperature: %0.1f C" % bme280.temperature)
-	    print("Humidity: %0.1f %%" % bme280.humidity)
-	    print("Pressure: %0.1f hPa" % bme280.pressure)
-	    print("Altitude = %0.2f meters" % bme280.altitude)
-	    time.sleep(2)
+    # OR create library object using our Bus SPI port
+    #spi = busio.SPI(board.SCK, board.MOSI, board.MISO)
+    #bme_cs = digitalio.DigitalInOut(board.D10)
+    #bme280 = adafruit_bme280.Adafruit_BME280_SPI(spi, bme_cs)
 
+    # change this to match the location's pressure (hPa) at sea level
+    bme280.sea_level_pressure = 1013.25
 
+    while True:
+        print("\nTemperature: %0.1f C" % bme280.temperature)
+        print("Humidity: %0.1f %%" % bme280.humidity)
+        print("Pressure: %0.1f hPa" % bme280.pressure)
+        print("Altitude = %0.2f meters" % bme280.altitude)
+        time.sleep(2)
 
 Contributing
 ============
@@ -66,7 +84,7 @@ Contributions are welcome! Please read our `Code of Conduct
 <https://github.com/adafruit/Adafruit_CircuitPython_BME280/blob/master/CODE_OF_CONDUCT.md>`_
 before contributing to help this project stay welcoming.
 
-Building locally
+Building Locally
 ================
 
 To build this library locally you'll need to install the
@@ -90,8 +108,8 @@ Then run the build:
 
     circuitpython-build-bundles --filename_prefix adafruit-circuitpython-veml6070 --library_location .
 
-Sphinx documentation
------------------------
+Sphinx Documentation
+--------------------
 
 Sphinx is used to build the documentation based on rST files and comments in the code. First,
 install dependencies (feel free to reuse the virtual environment from above):