Merge pull request #98 from tecladocode/develop

Author: jslvtr

.github/workflows/algolia-scraper.yml

@@ -0,0 +1,21 @@
+name: Run Algolia Scraper
+
+on:
+  push:
+    branches: ["master", "develop"]
+  pull_request:
+    branches: ["master", "develop"]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: darrenjennings/algolia-docsearch-action@master
+        with:
+          algolia_application_id: "1BEGBIP9SH"
+          algolia_api_key: ${{ secrets.ALGOLIA_API_KEY }}
+          file: "docs/algolia.config.json"

README.md

@@ -6,7 +6,7 @@
 
 <div align="center">
 
-[![Udemy rating 4.6/5](https://img.shields.io/badge/udemy-4.6%2F5-brightgreen)](https://go.tecla.do/rest-apis-sale) ![GitHub last commit](https://img.shields.io/github/last-commit/tecladocode/rest-apis-flask-python/develop) ![Python 3.10](https://img.shields.io/badge/python-3.10-yellow) [![Discord](https://img.shields.io/discord/614395983807250433)](https://discord.gg/78Nvd3p) [![Twitter Follow](https://img.shields.io/twitter/follow/jslvtr?style=social) ](https://twitter.com/jslvtr)
+[![Udemy rating 4.6/5](https://img.shields.io/badge/udemy-4.6%2F5-brightgreen)](https://go.tecla.do/rest-apis-ebook) ![GitHub last commit](https://img.shields.io/github/last-commit/tecladocode/rest-apis-flask-python/develop) ![Python 3.10](https://img.shields.io/badge/python-3.10-yellow) [![Discord](https://img.shields.io/discord/614395983807250433)](https://discord.gg/78Nvd3p) [![Twitter Follow](https://img.shields.io/twitter/follow/jslvtr?style=social) ](https://twitter.com/jslvtr)
 
 </div>
 
@@ -16,7 +16,7 @@
 
 ## Getting started
 
-Enrol in the course by going to [this link](https://go.tecla.do/rest-apis-sale).
+Enrol in the course by going to [this link](https://go.tecla.do/rest-apis-ebook).
 
 Then you can come back here to download the repository. This repository contains the code that we develop in each section of the course.
 

docs/algolia.config.json

@@ -0,0 +1,49 @@
+{
+    "index_name": "docusaurus-2",
+    "start_urls": [
+        "https://rest-apis-flask.teclado.com/"
+    ],
+    "sitemap_urls": [
+        "https://rest-apis-flask.teclado.com/sitemap.xml"
+    ],
+    "sitemap_alternate_links": true,
+    "stop_urls": [
+        "/tests"
+    ],
+    "selectors": {
+        "lvl0": {
+        "selector": "(//ul[contains(@class,'menu__list')]//a[contains(@class, 'menu__link menu__link--sublist menu__link--active')]/text() | //nav[contains(@class, 'navbar')]//a[contains(@class, 'navbar__link--active')]/text())[last()]",
+        "type": "xpath",
+        "global": true,
+        "default_value": "Documentation"
+        },
+        "lvl1": "header h1",
+        "lvl2": "article h2",
+        "lvl3": "article h3",
+        "lvl4": "article h4",
+        "lvl5": "article h5, article td:first-child",
+        "lvl6": "article h6",
+        "text": "article p, article li, article td:last-child"
+    },
+    "strip_chars": " .,;:#",
+    "custom_settings": {
+        "separatorsToIndex": "_",
+        "attributesForFaceting": [
+        "language",
+        "version",
+        "type",
+        "docusaurus_tag"
+        ],
+        "attributesToRetrieve": [
+        "hierarchy",
+        "content",
+        "anchor",
+        "url",
+        "url_without_anchor",
+        "type"
+        ]
+    },
+    "conversation_id": [
+        "833762294"
+    ]
+}

docs/docs-upcoming/11_celery_background_tasks/01_project_overview/README.md

@@ -5,4 +5,7 @@ description: A brief description of the lecture goes here.
 
 # Curriculum overview
 
-The curriculum overview goes here.
+import DocCategoryIndex from '@theme/DocCardList';
+import {useDocsSidebar} from '@docusaurus/theme-common/internal';
+
+<DocCategoryIndex items={useDocsSidebar().items} />

docs/docs-upcoming/11_celery_background_tasks/README.md

@@ -84,7 +84,7 @@ An API client can be any device, such as a web app or a mobile app.
 
 ### Making an API for your own consumption
 
-Make software companies make APIs that only they use (so they aren't fully public).
+Many software companies make APIs that only they use (so they aren't fully public).
 
 Here's an example. You're making a multiplayer mobile game, and you need to store information about the moves that your character is making.
 
@@ -109,7 +109,7 @@ REST APIs deal in resources, so every individual "thing" that can be named is a
 The main characteristics (or constraints) of a REST API are:
 
 1. **Uniform interface**. Whichever way clients should access a certain resource should also be the way the access other resources. Clients should have a single way to retrieve resources.
-2. **Client-server**. Clients should know the endpoints of the API, but they should not be coupled to the development of the API. A client or a servevr may be swapped out for a different implementation without the other noticing.
+2. **Client-server**. Clients should know the endpoints of the API, but they should not be coupled to the development of the API. A client or a server may be swapped out for a different implementation without the other noticing.
 3. **Stateless**. The server (API) doesn't store anything about previous client requests. Each client request is treated as a brand new client. If the client needs the server to personalize the response, then the client must send the server whatever information the server needs in order to do so.
 4. **Cacheable**. The client or server must be able to cache the resources returned by the API. This is a very general constraint, but it's an important one.
 5. **Layered system**. REST APIs may be developed as multiple layers, where each layer interacts [only with the layer above and below it](https://excalidraw.com/#json=or3Umoigss4yIeuKg3cO8,qH6uDDCXc7DSjweqNvlmzw).
@@ -156,7 +156,7 @@ We'll deal with user authentication in a later section, but that's what the lock
 | `GET`  | `/store`      | Get a list of all stores.                |
 | `POST` | `/store`      | Create a store.                          |
 | `GET`  | `/store/{id}` | Get a single store, given its unique id. |
-| `POST` | `/store/{id}` | Delete a store, given its unique id.     |
+| `DELETE` | `/store/{id}` | Delete a store, given its unique id.     |
 
 ### Items
 
@@ -191,4 +191,4 @@ Then, over the following sections, we'll improve on this REST API. We'll add:
 - Add user authentication.
 - Add item tagging.
 - Add an admin panel so changing data manually is a bit easier.
-- And much more!
+- And much more!

docs/docs-upcoming/11_celery_background_tasks/_category_.json

@@ -4,6 +4,12 @@ id: intro
 
 # REST APIs with Flask and Python
 
+import VideoEmbed from "@site/src/components/VideoEmbed";
+
+<div style={{ maxWidth: "720px", margin: "3rem auto", boxShadow: "0 5px 15px 0 rgba(0, 0, 0, 0.15)" }}>
+<VideoEmbed url="https://customer-zmitazl0ztnd2pvm.cloudflarestream.com/1c4db6119cf0c6e682a88a737af146eb/iframe?poster=https%3A%2F%2Fcustomer-zmitazl0ztnd2pvm.cloudflarestream.com%2F1c4db6119cf0c6e682a88a737af146eb%2Fthumbnails%2Fthumbnail.jpg%3Ftime%3D%26height%3D600" />
+</div>
+
 Hi, and welcome!
 
 REST APIs with Flask and Python is a complete course that teaches you how to develop complete, professional REST APIs using **Flask**, **PostgreSQL**, and **Docker**.

docs/docs/01_course_intro/01_curriculum_overview/README.md

@@ -5,6 +5,12 @@ description: A first look at the project we'll build in this section.
 
 # Overview of your first REST API
 
+import VideoEmbed from "@site/src/components/VideoEmbed";
+
+<div style={{ maxWidth: "720px", margin: "3rem auto", boxShadow: "0 5px 15px 0 rgba(0, 0, 0, 0.15)" }}>
+<VideoEmbed url="https://customer-zmitazl0ztnd2pvm.cloudflarestream.com/cda9c0473bdc485a36905144f13f4d3f/iframe?poster=https%3A%2F%2Fcustomer-zmitazl0ztnd2pvm.cloudflarestream.com%2Fcda9c0473bdc485a36905144f13f4d3f%2Fthumbnails%2Fthumbnail.jpg%3Ftime%3D%26height%3D600" />
+</div>
+
 In this section we'll make a simple REST API that allows us to:
 
 - Create stores, each with a `name` and a list of stocked `items`.
@@ -15,6 +21,10 @@ In this section we'll make a simple REST API that allows us to:
 
 This is how the interaction will go!
 
+:::tip Insomnia files
+Remember to get the Insomnia files for this section or for all sections [here](/insomnia-files/)!
+:::
+
 ## Create stores
 
 Request: