update to use codespace (#413)

Author: martinohanlon

asciidoc/courses/app-python/course.adoc

@@ -7,7 +7,7 @@
 :duration: 7 hours
 // tag::config[]
 :repository: neo4j-graphacademy/app-python
-:python-version: 3.10.6
+:python-version: 3.12
 :cypher-repository: neo4j-graphacademy/neoflix-cypher
 // end::config[]
 

asciidoc/courses/app-python/modules/0-setup/lessons/1-setup/lesson.adoc

@@ -5,17 +5,56 @@
 :lab: {repository-link}
 :language: Python
 :disable-cache: true
+:branch: main
 
 
-include::{shared}/courses/gitpod/introduction.adoc[leveloffset=+2]
+You must set up a development environment to run the code examples and exercises.
 
-The repository, link:{repository-link}[github.com/neo4j-graphacademy/app-python^] contains all the starter code and workspace for this course.
+include::../../../../../../shared/courses/codespace/get-started.adoc[]
 
-== Explore the Repository
 
-You can open the repository by clicking the link below:
+[%collapsible]
+.Develop on your local machine
+====
+You will need link:https://python.org[Python] installed and the ability to install packages using `pip`.
+
+You may want to set up a virtual environment using link:https://docs.python.org/3/library/venv.html[`venv`^] or link:https://virtualenv.pypa.io/en/latest/[`virtualenv`^] to keep your dependencies separate from other projects.
+
+Clone the link:{repository-link}[github.com/neo4j-graphacademy/app-python] repository:
+
+[source,bash]
+----
+git clone https://github.com/neo4j-graphacademy/app-python
+----
+
+Install the required packages using `pip`:
 
-lab::Explore Repository in GitPod[]
+[source,bash]
+----
+cd app-python
+pip install -r requirements.txt
+----
+====
+
+== Setup the environment
+
+Create a copy of the `.env.example` file and name it `.env`.
+Update the required values.
+
+[source]
+.Create a .env file
+----
+include::{repository-raw}/{branch}/.env.example[]
+----
+
+Update the Neo4j sandbox connection details:
+
+NEO4J_URI:: [copy]#neo4j://{instance-ip}:{instance-boltPort}#
+NEO4J_USERNAME:: [copy]#{instance-username}#
+NEO4J_PASSWORD:: [copy]#{instance-password}#
+
+
+== Explore the Repository
 
 Here are some of the important directories in the project:
 
@@ -26,7 +65,17 @@ Here are some of the important directories in the project:
 ** `routes/` - Route handlers that are registered on the server.  You shouldn't need to edit these files.
 * `public/` - Minified build files for the SPA.  *Do not edit these files*.
 
+== Run the Application
+
+You can run the application using the following commands:
 
+[source,bash]
+.Run the application
+----
+export FLASK_APP=api
+export FLASK_ENV=development
+flask run
+----
 
 // == Setting Environment Variables
 
@@ -58,35 +107,6 @@ Here are some of the important directories in the project:
 // 7. The username for your Neo4j Sandbox instance
 // 8. The password for your Neo4j Sandbox instance
 
-[%collapsible]
-.Develop on your local machine
-====
-You will need link:https://python.org[Python] installed and the ability to install packages using `pip`.
-
-You may want to set up a virtual environment using link:https://docs.python.org/3/library/venv.html[`venv`^] or link:https://virtualenv.pypa.io/en/latest/[`virtualenv`^] to keep your dependencies separate from other projects.
-
-Clone the link:{repository-link}[github.com/neo4j-graphacademy/app-python] repository:
-
-[source,bash]
-----
-git clone https://github.com/neo4j-graphacademy/app-python
-----
-
-Install the required packages using `pip` and download the required data:
-
-[source,bash]
-----
-cd app-python
-pip install -r requirements.txt
-----
-====
-
-== Course Challenges
-
-For each challenge, you will be provided with a link to re-open the correct file within the repository.
-Clicking these links will also set the credentials
-load environment variables for your link:https://sandbox.neo4j.com[Neo4j Sandbox^] instance.
-
 == Your Sandbox Instance
 
 include::{shared}/courses/apps/sandbox.adoc[tag="info",leveloffset=+]

asciidoc/courses/app-python/modules/0-setup/lessons/2c-installing-driver/lesson.adoc

@@ -20,7 +20,7 @@ Inside `api/neo4j.py`, you will see an `init_driver()` function.
 include::{repository-raw}/main/api/neo4j.py[tag=initDriver]
 ----
 
-lab::Open `api/neo4j.py`[]
+Open `api/neo4j.py`.
 
 This function should use the `uri`, `username` and `password` parameters supplied to create an instance of the Neo4j Python Driver.
 The driver instance should then be assigned to the `current_app` variable to ensure that it is available throughout the application.
@@ -43,7 +43,7 @@ To do this, we will need to:
 2. Import the `GraphDatabase` object from `neo4j` into `neo4j.py`.
 3. Create the driver instance with the  `uri`, `username` and `password` parameters passed to the function and use the `verify_connectivity()` method to assert that the credentials are correct.
 
-lab::Open `api/neo4j.py`[]
+Open `api/neo4j.py`.
 
 
 === 1. Install the `neo4j` Dependency

asciidoc/courses/app-python/modules/0-setup/module.adoc

@@ -12,7 +12,7 @@ In the early stages you will learn some of the theory required and then use that
 We have built a repository that takes care of the boiler plate, so you can focus on implementing the functionality.
 
 
-* The project is designed to work with Python version **3.10**
+* The project is designed to work with Python version **3.12**
 * Packages can be installed with pip
 * A web server has been built with link:https://flask.palletsprojects.com/en/2.0.x/[Flask^]
 ** Authentication is handled with link:https://jwt.io/[JWT Tokens^] and link:https://flask-jwt-extended.readthedocs.io/en/stable/[Flask-JWT-Extended^]