Python Connection Examples
==========================

.. |checkmark| unicode:: U+2713

The `redis-py <https://github.com/andymccurdy/redis-py>`_ package is the recommended client for Redis when using Python.

Installation
------------

Install redis-py at the command prompt if you haven't yet:

.. code-block:: bash

   $ pip install redis


Connecting with SSL
--------------------
Connecting to your instance via SSL requires using a certificate authority. See documentation for `certificates and fingerprints <https://objectrocket.com/docs/redis_ssl_faq.html#certificates-fingerprints>`_ for more details.

.. code-block:: python

    import redis

    try:
        conn = redis.StrictRedis(
            host='#####.publb.rackspaceclouddb.com',
            port=6380,
            password='YOUR_PASSWORD',
            ssl=True,
            ssl_ca_certs='LOCAL/PATH/TO/rackspace-ca-2016.pem')
        print conn
        conn.ping()
        print 'Connected!'
    except Exception as ex:
        print 'Error:', ex
        exit('Failed to connect, terminating.')


Connecting without SSL
-----------------------

.. code-block:: python

    import redis

    try:
        conn = redis.StrictRedis(
            host='#####.publb.rackspaceclouddb.com',
            port=6379,
            password='YOUR_PASSWORD')
        print conn
        conn.ping()
        print 'Connected!'
    except Exception as ex:
        print 'Error:', ex
        exit('Failed to connect, terminating.')


Creating, Reading, Updating and Deleting Records
-------------------------------------------------

.. code-block:: python

    import redis

    try:
        conn = redis.StrictRedis(
            host='#####.publb.rackspaceclouddb.com',
            port=6380,
            password='YOUR_PASSWORD',
            ssl=True,
            ssl_ca_certs='LOCAL/PATH/TO/rackspace-ca-2016.pem')
        print 'Set Record:', conn.set("best_car_ever", "Tesla Model S")
        print 'Get Record:', conn.get("best_car_ever")
        print 'Delete Record:', conn.delete("best_car_ever")
        print 'Get Deleted Record:', conn.get("best_car_ever")
    except Exception as ex:
        print 'Error:', ex


Output from above:

.. code-block:: bash

    Set Record: True
    Get Record: Tesla Model S
    Delete Record: 1
    Get Deleted Record: None

.. note::

   'del' is a reserved keyword in the Python syntax. Therefore redis-py uses 'delete' instead.

More Information
----------------

If you need additional help with redis-py, here are some useful links:

* `redis-py Official Documentation <https://github.com/andymccurdy/redis-py>`_

As always, if you have any questions, please don't hesitate to reach out to our `support team <mailto:support@objectrocket.com>`_!