DataStax-Examples/getting-started-with-astra-python

This sample Python backend provides a REST API service that is used with the Getting Started with Astra UI to show asimple example of how to connect to and query DataStax Astra databases.Contributor(s):ObjectivesHow to connect to DataStax Astra using the secure connect bundleHow to share a DataStax Driver Session throughout a Python applicationHow to expose a basic REST API using the DataStax DriverProject Layoutgetting_started_with_astra.py - entrypoint for the backend, registers controller blueprints with Flask appschema.cql - database schema used by the applicationservice - acts as the middle-man to take requests from the controllers and calls the corresponding dao methods.Note how this and session_manager.py are used to share a single DataStax Driver Session across API requests, this is a best practice.model - defines the Python objects that correspond to the database tablesdao - methods for accessing the database, contains the DataStax Driver API callscontroller - defines the API endpoints using Flask decoratorsHow this worksThis project is built in Python and uses Flask to expose a REST API backend for use with the Getting Started with Astra UI.This application is the middle man that receives requests from the UI web page and serves data from the underlying DataStax Astra database.Setup & RunningSetupIf you are familiar with Python, then you've likely gotten your hands on Python virtual environments.We'll be leveraging pyenv while setting up this backend, which will serve ourSpacecraft frontend that will have you flying through the stars.If you aren't familiar with Python, hop over to our official documentationfor setting that up on your machine, and come back here after you have it installed ( specifically after Step 5 of the Procedure ).Now that we have that out of the way, we'll use pyenv to install Python 3.6.9pyenv install 3.6.9Next create a new virtualenv using that Python version we just installed.pyenv virtualenv 3.6.9 astra-venvAlmost off to the races, go ahead and activate that virtualenvpyenv activate astra-venvWoot, now 3 quick dependencies ( Flask, Flask CORS, and the DataStax Cassandra Driver )pip install Flask flask-cors cassandra-driverLast one, clone this repogit clone https://github.com/DataStax-Examples/getting-started-with-astra-python.gitRunningIf everything above went smoothly, fingers crossed, then we are ready to rock.Go to the directory that you just cloned this repo intocd getting-started-with-astra-pythonFire up the enginesFLASK_ENV=development FLASK_APP=getting_started_with_astra.py flask runYou should be met with the following output, note that it's running on localhost and port 5000 * Serving Flask app "getting_started_with_astra.py" (lazy loading) * Environment: development * Debug mode: on * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit) * Restarting with stat * Debugger is active! * Debugger PIN: 204-527-831Once the backend is running, you can start the Getting Started with Astra UI in order to use a web page that leverages this backend.