mirror of
https://github.com/Unleash/unleash.git
synced 2025-02-09 00:18:00 +01:00
docs: Add Python YouTube Video tutorial (#7033)
<!-- Thanks for creating a PR! To make it easier for reviewers and everyone else to understand what your changes relate to, please add some relevant content to the headings below. Feel free to ignore or delete sections that you don't think are relevant. Thank you! ❤️ --> ## About the changes <!-- Describe the changes introduced. What are they and why are they being introduced? Feel free to also add screenshots or steps to view the changes if they're visual. --> <!-- Does it close an issue? Multiple? --> Closes # <!-- (For internal contributors): Does it relate to an issue on public roadmap? --> <!-- Relates to [roadmap](https://github.com/orgs/Unleash/projects/10) item: # --> ### Important files <!-- PRs can contain a lot of changes, but not all changes are equally important. Where should a reviewer start looking to get an overview of the changes? Are any files particularly important? --> ## Discussion points <!-- Anything about the PR you'd like to discuss before it gets merged? Got any questions or doubts? --> Adding the Python video tutorial to our docs for following along <img width="887" alt="Screenshot 2024-05-10 at 7 06 21 AM" src="https://github.com/Unleash/unleash/assets/22972707/69cdc8a3-b52f-49f7-857d-f907ada2744c"> https://youtu.be/-Rf0y2Gq8OA?si=udl3eIE9DdxQYGAY
This commit is contained in:
Nnenna Ndukwe
GitHub
parent
958ccabb54
commit
0c284ca143
@ -3,6 +3,8 @@ title: How to Implement Feature Flags in Python
|
||||
slug: /feature-flag-tutorials/python
|
||||
---
|
||||
|
||||
import VideoContent from '@site/src/components/VideoContent.jsx';
|
||||
|
||||
[Python](https://www.python.org/) is a popular programming language used for a variety of software applications and services. It is supported widely in the developer community and is known for being intuitive, readable, and friendly to new and experienced developers.
|
||||
|
||||
Leveraging feature flags allows developers to toggle new features on and off, whether you’re experimenting in your local environment, testing for QA purposes, or rolling out changes to users in production. Feature flags play a critical role in optimizing the entire software development lifecycle. With Unleash, an open-source feature flag service, you can use our tooling to implement feature flags into your application and release new features faster, strategically, and safely. But how can you do this in Python?
|
||||
@ -16,6 +18,7 @@ In this tutorial, you will learn how to set up and use Python feature flags with
|
||||
At the end of this tutorial, you will be able to turn on the feature flag and activate a route that will remove surveys from the database.
|
||||
|
||||
Here are the steps we will cover in this tutorial:
|
||||
|
||||
1. [Feature flag best practices for back-end applications](#1-unleash-best-practice-for-backend-apps)
|
||||
2. [Spin up a local flag provider](#2-install-a-local-feature-flag-provider)
|
||||
3. [Configure a feature flag](#3-create-and-configure-the-feature-flag)
|
||||
@ -24,17 +27,19 @@ Here are the steps we will cover in this tutorial:
|
||||
6. [Verify the toggle experience](#6-verify-the-toggle-experience)
|
||||
7. [Improve feature flag error handling](#7-improve-a-feature-flag-implementation-with-error-handling)
|
||||
|
||||
Watch the video tutorial and follow along with the code from this documentation.
|
||||
|
||||
<VideoContent videoUrls={["https://youtube.com/embed/-Rf0y2Gq8OA?si=udl3eIE9DdxQYGAY"]}/>
|
||||
|
||||
## Prerequisites
|
||||
|
||||
|
||||
In this tutorial, you will need the following:
|
||||
|
||||
- A web browser like Chrome or Firefox
|
||||
- Git
|
||||
- Docker
|
||||
- (Optional) a code editor like Visual Studio Code
|
||||
|
||||
|
||||
|
||||
|
||||
This architecture diagram breaks down how the Python app works with Unleash to control feature flags. We connect the Unleash service to your Python app using the Python SDK.
|
||||
@ -56,10 +61,8 @@ Additionally, our SDKs cache your feature flag configuration to help reduce netw
|
||||
|
||||
For a complete list of architectural guidelines, see our [best practices for building and scaling feature flag systems](https://docs.getunleash.io/topics/feature-flags/feature-flag-best-practices).
|
||||
|
||||
|
||||
## 2. Install a local feature flag provider
|
||||
|
||||
|
||||
There are many feature flag tools available. In this section, you will install Unleash, run the instance locally, log in, and create a feature flag, but you can use other tools in place of Unleash if you prefer. You’ll need to edit the code accordingly, but the basic steps will probably be the same.
|
||||
|
||||
Use Git to clone the Unleash repository and Docker to build and run it. Open a terminal window and run the following commands:
|
||||
@ -81,26 +84,20 @@ Password: unleash4all
|
||||
|
||||
Click the ‘New feature toggle’ button to create a new feature flag. Once you have created a flag, you will see it here.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## 3. Create and configure the feature flag
|
||||
|
||||
|
||||
Next, you will create a feature flag and turn it on for your Python app.
|
||||
|
||||
In the Create Toggle view, give your feature flag a unique name and click ‘Create toggle feature’.
|
||||
|
||||
For the purpose of this tutorial, name the feature flag `delete_survey_flag`. Use the default values in the rest of the feature flag form.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Your new feature flag has been created and is ready to be used. Enable the flag for your development environment, which makes it accessible for use in the Python app we will clone into your local environment.
|
||||
|
||||
|
||||
|
||||
|
||||
Next, generate an API token to authenticate calls made to Unleash servers from your project. This API token will eventually be pulled into a configuration object within your Python application to toggle features.
|
||||
@ -111,21 +108,16 @@ From your project view on the platform, go to "Project Settings" and then "API A
|
||||
|
||||
Select the ‘New API token’ button.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Name the API token and select the “Server-side SDK” token type, since we’ll be doing our flag evaluation on the server using the Python SDK. You can read more about [Unleash API tokens in our documentation](https://docs.getunleash.io/reference/api-tokens-and-client-keys#client-tokens).
|
||||
|
||||
The token should have access to the “development” environment, as shown in the platform screenshot below.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
The API token you generated can be managed in the API Access view in your project settings. It will become handy in Step 4.
|
||||
|
||||
|
||||
## 4. Add Unleash to a Python app
|
||||
|
||||
In this section, you will clone an open-source Python application called [Flask Surveys Container app](https://github.com/pamelafox/flask-surveys-container-app), which we are using to model a service that provides routing, serves HTML pages, and performs actions against a database. This app uses Flask, SQLAlchemy, and a PostgreSQL database.
|
||||
@ -140,7 +132,6 @@ Next, navigate into your repository directory and create a `.env` file.
|
||||
|
||||
Copy this code snippet into your `.env` file:
|
||||
|
||||
|
||||
```py
|
||||
FLASK_DEBUG=True
|
||||
DBHOST=db
|
||||
@ -149,26 +140,20 @@ DBUSER=app_user
|
||||
DBPASS=app_password
|
||||
```
|
||||
|
||||
|
||||
Next, install the Python SDK. Open your repository in a code editor and navigate to `requirements.txt` inside the `src` folder. Reference the Python SDK for installation.
|
||||
|
||||
|
||||
```py
|
||||
UnleashClient==5.11.1
|
||||
```
|
||||
|
||||
|
||||
In `src/backend/__init__.py`, import `UnleashClient`:
|
||||
|
||||
|
||||
```py
|
||||
from UnleashClient import UnleashClient
|
||||
```
|
||||
|
||||
|
||||
In the same file, call the Unleash client for initialization when the app runs with this code snippet:
|
||||
|
||||
|
||||
```py
|
||||
client = UnleashClient(
|
||||
url="http://host.docker.internal:4242/api",
|
||||
@ -187,18 +172,14 @@ You can check our [API token and client keys documentation](https://docs.getunle
|
||||
|
||||
Next, go to your terminal and build the app using this command:
|
||||
|
||||
|
||||
```
|
||||
docker-compose up --build
|
||||
```
|
||||
|
||||
|
||||
Navigate to [localhost://50505](http://localhost://50505) and the Surveys list should eventually display:
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Create 1 or more new surveys so they’re populated in your database!
|
||||
|
||||
## 5. Use a feature flag to release a delete method
|
||||
@ -208,6 +189,7 @@ In a real-world use case for your feature flag, you can roll out new features to
|
||||
In this case, our app currently supports creating a survey, but once we create one, we can’t get rid of it. We want to roll out a ‘delete’ button in our list of surveys to all users so we have the option to remove them from our database.
|
||||
|
||||
This will require us to:
|
||||
|
||||
- Create a new route in our app
|
||||
- Create a method that deletes a survey based on survey ID
|
||||
- Create a delete button
|
||||
@ -225,7 +207,6 @@ from flask import redirect, render_template, request, url_for, abort
|
||||
|
||||
Add `client` to the `backend` import statement on line 4. The full import line will now look like this:
|
||||
|
||||
|
||||
```py
|
||||
from backend import db, client
|
||||
```
|
||||
@ -265,7 +246,13 @@ In `src/backend/templates/surveys_list.html`, add the following code to your sur
|
||||
|
||||
```html
|
||||
{% if client.is_enabled('delete_survey_flag') %}
|
||||
<td class="text-end"><a href="{{ url_for('surveys.delete_survey', survey_id=survey.id) }}" class="btn btn-sm btn-danger">Delete</a></td>
|
||||
<td class="text-end">
|
||||
<a
|
||||
href="{{ url_for('surveys.delete_survey', survey_id=survey.id) }}"
|
||||
class="btn btn-sm btn-danger"
|
||||
>Delete</a
|
||||
>
|
||||
</td>
|
||||
{% endif %}
|
||||
```
|
||||
|
||||
@ -273,16 +260,12 @@ This code wraps a delete button in a conditional statement that checks whether o
|
||||
|
||||
Your surveys page will now look something like this:
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Test the new functionality by deleting one of your surveys. The page should refresh without the survey you deleted.
|
||||
|
||||
|
||||
## 6. Verify the toggle experience
|
||||
|
||||
|
||||
Now that we’ve added in new functionality and connected it to our feature flag, we can verify that if you disable the flag in your development environment, your Python app will no longer serve an HTML page with the option to delete surveys you’ve created.
|
||||
|
||||
In your local Unleash instance, turn off the feature flag by disabling it in the development environment.
|
||||
@ -295,10 +278,8 @@ Next, return to your Survey app and refresh the browser. With the flag disabled,
|
||||
|
||||
|
||||
|
||||
|
||||
## Conclusion
|
||||
|
||||
|
||||
In this tutorial, we ran Unleash locally, created a new feature flag, installed the Python SDK into a Python Flask app, and toggled new functionality that altered a database with a containerized project!
|
||||
|
||||
Continue to our [Python Examples docs](/feature-flag-tutorials/python/examples) for more advanced applications of feature flags in Python using our Flask Surveys Containers App!
|
||||
|
||||
Loading…
Reference in New Issue
Block a user