Merge branch 'master' into flush-print

Author: KateFinegan

build-a-rest-api-frontend/.gitignore

@@ -0,0 +1 @@
+*.db

build-a-rest-api-frontend/.prettierrc

@@ -0,0 +1,3 @@
+{
+  "printWidth": 79
+}

build-a-rest-api-frontend/README.md

@@ -0,0 +1,43 @@
+# Build a Front End for a REST API
+
+This repository contains code related to the Real Python tutorial on [building a front end for a REST API](https://realpython.com/build-a-rest-api-frontend/).
+
+## Setup
+
+You should first create a virtual environment:
+
+```console
+$ python -m venv venv
+$ source venv/bin/activate
+```
+
+Install the pinned dependencies from `requirements.txt`:
+
+```console
+(venv) $ python -m pip install -r requirements.txt
+```
+
+Then you can navigate into the folder `source_code_start/` and create a new database:
+
+```sh
+(venv) $ cd source_code_start
+(venv) $ python init_database.py
+```
+
+This will create or update the `people.db` database that you can use with your project.
+
+After building the database, you can start the Flask server:
+
+```sh
+(venv) $ python app.py
+```
+
+When the Flask server is running, you can visit the front end on `http://localhost:8000` and the API documentation on `http://localhost:8000/api/ui`.
+
+## Author
+
+- **Philipp Acsany**, E-mail: [[email protected]]([email protected])
+
+## License
+
+Distributed under the MIT license. See [`LICENSE`](../LICENSE) for more information.

build-a-rest-api-frontend/requirements.txt

@@ -0,0 +1,27 @@
+attrs==22.1.0
+certifi==2022.9.24
+charset-normalizer==2.1.1
+click==8.1.3
+clickclick==20.10.2
+connexion==2.14.1
+Flask==2.2.2
+flask-marshmallow==0.14.0
+Flask-SQLAlchemy==3.0.2
+idna==3.4
+inflection==0.5.1
+itsdangerous==2.1.2
+Jinja2==3.1.2
+jsonschema==4.16.0
+MarkupSafe==2.1.1
+marshmallow==3.18.0
+marshmallow-sqlalchemy==0.28.1
+packaging==21.3
+pyparsing==3.0.9
+pyrsistent==0.19.1
+PyYAML==6.0
+requests==2.28.1
+six==1.16.0
+SQLAlchemy==1.4.42
+swagger-ui-bundle==0.0.9
+urllib3==1.26.12
+Werkzeug==2.2.2

build-a-rest-api-frontend/source_code_final/app.py

@@ -0,0 +1,17 @@
+from flask import render_template
+
+import config
+from models import Person
+
+app = config.connex_app
+app.add_api(config.basedir / "swagger.yml")
+
+
+@app.route("/")
+def home():
+    people = Person.query.all()
+    return render_template("home.html", people=people)
+
+
+if __name__ == "__main__":
+    app.run(host="0.0.0.0", port=8000, debug=True)

build-a-rest-api-frontend/source_code_final/config.py

@@ -0,0 +1,15 @@
+import pathlib
+
+import connexion
+from flask_marshmallow import Marshmallow
+from flask_sqlalchemy import SQLAlchemy
+
+basedir = pathlib.Path(__file__).parent.resolve()
+connex_app = connexion.App(__name__, specification_dir=basedir)
+
+app = connex_app.app
+app.config["SQLALCHEMY_DATABASE_URI"] = f"sqlite:///{basedir / 'people.db'}"
+app.config["SQLALCHEMY_TRACK_MODIFICATIONS"] = False
+
+db = SQLAlchemy(app)
+ma = Marshmallow(app)

build-a-rest-api-frontend/source_code_final/init_database.py

@@ -0,0 +1,93 @@
+from datetime import datetime
+from sqlalchemy.exc import OperationalError
+
+from config import app, db
+from models import Note, Person
+
+PEOPLE_NOTES = [
+    {
+        "lname": "Fairy",
+        "fname": "Tooth",
+        "notes": [
+            ("I brush my teeth after each meal.", "2022-01-06 17:10:24"),
+            (
+                "The other day a friend said, I have big teeth.",
+                "2022-03-05 22:17:54",
+            ),
+            ("Do you pay per gram?", "2022-03-05 22:18:10"),
+        ],
+    },
+    {
+        "lname": "Ruprecht",
+        "fname": "Knecht",
+        "notes": [
+            (
+                "I swear, I'll do better this year.",
+                "2022-01-01 09:15:03",
+            ),
+            (
+                "Really! Only good deeds from now on!",
+                "2022-02-06 13:09:21",
+            ),
+        ],
+    },
+    {
+        "lname": "Bunny",
+        "fname": "Easter",
+        "notes": [
+            (
+                "Please keep the current inflation rate in mind!",
+                "2022-01-07 22:47:54",
+            ),
+            ("No need to hide the eggs this time.", "2022-04-06 13:03:17"),
+        ],
+    },
+]
+
+
+def get_data_from_table(model):
+    try:
+        data = db.session.query(model).all()
+        db.session.close()
+        return data
+    except OperationalError:
+        return []
+
+
+def create_database(db):
+    db.create_all()
+    for data in PEOPLE_NOTES:
+        new_person = Person(lname=data.get("lname"), fname=data.get("fname"))
+        for content, timestamp in data.get("notes", []):
+            new_person.notes.append(
+                Note(
+                    content=content,
+                    timestamp=datetime.strptime(
+                        timestamp, "%Y-%m-%d %H:%M:%S"
+                    ),
+                )
+            )
+        db.session.add(new_person)
+    db.session.commit()
+    print("Created new database")
+
+
+def update_database(db, existing_people, existing_notes):
+    db.drop_all()
+    db.create_all()
+    for person in existing_people:
+        db.session.merge(person)
+    for note in existing_notes:
+        db.session.merge(note)
+    db.session.commit()
+    print("Updated existing database")
+
+
+with app.app_context():
+    existing_people = get_data_from_table(Person)
+    existing_notes = get_data_from_table(Note)
+
+    if not existing_people:
+        create_database(db)
+    else:
+        update_database(db, existing_people, existing_notes)

build-a-rest-api-frontend/source_code_final/models.py

@@ -0,0 +1,56 @@
+from datetime import datetime
+
+from marshmallow_sqlalchemy import fields
+
+from config import db, ma
+
+
+class Note(db.Model):
+    __tablename__ = "note"
+    id = db.Column(db.Integer, primary_key=True)
+    person_id = db.Column(db.Integer, db.ForeignKey("person.id"))
+    content = db.Column(db.String, nullable=False)
+    timestamp = db.Column(
+        db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow
+    )
+
+
+class NoteSchema(ma.SQLAlchemyAutoSchema):
+    class Meta:
+        model = Note
+        load_instance = True
+        sqla_session = db.session
+        include_fk = True
+
+
+class Person(db.Model):
+    __tablename__ = "person"
+    id = db.Column(db.Integer, primary_key=True)
+    lname = db.Column(db.String(32), nullable=False)
+    fname = db.Column(db.String(32))
+    timestamp = db.Column(
+        db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow
+    )
+
+    notes = db.relationship(
+        Note,
+        backref="person",
+        cascade="all, delete, delete-orphan",
+        single_parent=True,
+        order_by="desc(Note.timestamp)",
+    )
+
+
+class PersonSchema(ma.SQLAlchemyAutoSchema):
+    class Meta:
+        model = Person
+        load_instance = True
+        sqla_session = db.session
+        include_relationships = True
+
+    notes = fields.Nested(NoteSchema, many=True)
+
+
+note_schema = NoteSchema()
+person_schema = PersonSchema()
+people_schema = PersonSchema(many=True)

build-a-rest-api-frontend/source_code_final/notes.py

@@ -0,0 +1,50 @@
+from flask import abort, make_response
+
+from config import db
+from models import Note, Person, note_schema
+
+
+def read_one(note_id):
+    note = Note.query.get(note_id)
+
+    if note is not None:
+        return note_schema.dump(note)
+    else:
+        abort(404, f"Note with ID {note_id} not found")
+
+
+def update(note_id, note):
+    existing_note = Note.query.get(note_id)
+
+    if existing_note:
+        update_note = note_schema.load(note, session=db.session)
+        existing_note.content = update_note.content
+        db.session.merge(existing_note)
+        db.session.commit()
+        return note_schema.dump(existing_note), 201
+    else:
+        abort(404, f"Note with ID {note_id} not found")
+
+
+def delete(note_id):
+    existing_note = Note.query.get(note_id)
+
+    if existing_note:
+        db.session.delete(existing_note)
+        db.session.commit()
+        return make_response(f"{note_id} successfully deleted", 204)
+    else:
+        abort(404, f"Note with ID {note_id} not found")
+
+
+def create(note):
+    person_id = note.get("person_id")
+    person = Person.query.get(person_id)
+
+    if person:
+        new_note = note_schema.load(note, session=db.session)
+        person.notes.append(new_note)
+        db.session.commit()
+        return note_schema.dump(new_note), 201
+    else:
+        abort(404, f"Person not found for ID: {person_id}")

build-a-rest-api-frontend/source_code_final/people.py

@@ -0,0 +1,50 @@
+from flask import abort, make_response
+
+from config import db
+from models import Person, people_schema, person_schema
+
+
+def read_all():
+    people = Person.query.all()
+    return people_schema.dump(people)
+
+
+def create(person):
+    new_person = person_schema.load(person, session=db.session)
+    db.session.add(new_person)
+    db.session.commit()
+    return person_schema.dump(new_person), 201
+
+
+def read_one(person_id):
+    person = Person.query.get(person_id)
+
+    if person is not None:
+        return person_schema.dump(person)
+    else:
+        abort(404, f"Person with ID {person_id} not found")
+
+
+def update(person_id, person):
+    existing_person = Person.query.get(person_id)
+
+    if existing_person:
+        update_person = person_schema.load(person, session=db.session)
+        existing_person.fname = update_person.fname
+        existing_person.lname = update_person.lname
+        db.session.merge(existing_person)
+        db.session.commit()
+        return person_schema.dump(existing_person), 201
+    else:
+        abort(404, f"Person with ID {person_id} not found")
+
+
+def delete(person_id):
+    existing_person = Person.query.get(person_id)
+
+    if existing_person:
+        db.session.delete(existing_person)
+        db.session.commit()
+        return make_response(f"{person_id} successfully deleted", 200)
+    else:
+        abort(404, f"Person with ID {person_id} not found")