Add files via upload

Author: january1073

readme.md

@@ -0,0 +1,12 @@
+## simple_flask_server
+- server1.py: Simple Flask server
+- server2.py: Flask server with set response status code
+- server3.py: Flask server processing input arguments
+- server4.py: Flask server with dynamic URLs (GET /count, GET /person/id, and DELETE /person/id endpoints)
+- server5.py: Flask server parsing JSON from request body
+- server6.py: Flask server with custom error handler
+
+### Required framework:
+- Flask
+
+(Practice projects as part of the IBM course “Developing AI Applications with Python and Flask”.)

server1.py

@@ -0,0 +1,18 @@
+# Basic structure of a Flask server
+
+# Import the Flask class from the flask module
+from flask import Flask
+
+# Create an instance of the Flask class, passing in the name of the current module
+app = Flask(__name__)
+
+# Define a route for the root URL ("/")
+@app.route('/')
+def index():
+    # Function that handles requests to the root URL
+    # Return a plain text response
+    return "Hello, Flask!"
+
+# Run the server
+if __name__ == '__main__':
+    app.run(debug=True)

server2.py

@@ -0,0 +1,33 @@
+# Flask server with set response status code
+
+from flask import Flask, make_response
+
+# Create an instance of the Flask class, passing in the name of the current module
+app = Flask(__name__)
+
+# Define a route for the root URL ("/")
+@app.route("/")
+def index():
+    # Function that handles requests to the root URL
+    # Return a plain text response
+    return "Hello, Flask!"
+
+# Define a route for the "/no_content" URL
+@app.route("/no_content")
+def no_content():
+    # Create a dictionary with a message and return it with a 204 No Content status code
+    return ({"message": "No content found"}, 204)
+
+# Define a route for the "/exp" URL
+@app.route("/exp")
+def index_explicit():
+    # Create a response object with the message "Hello, Flask!"
+    resp = make_response({"message": "Hello, Flask!"})
+    # Set the status code of the response to 200
+    resp.status_code = 200
+    # Return the response object
+    return resp
+
+# Run the server
+if __name__ == '__main__':
+    app.run(debug=True)

server3.py

@@ -0,0 +1,33 @@
+# Flask server processing input arguments
+
+from flask import Flask, request
+app = Flask(__name__)
+
+# The data is generated with Mockaroo (https://www.mockaroo.com/)
+data = [{"id":1,"first_name":"Baxy","last_name":"Escalera","email":"[email protected]","ip_address":"107.160.207.177"},
+{"id":2,"first_name":"Marigold","last_name":"Tillyer","email":"[email protected]","ip_address":"80.162.216.11"},
+{"id":3,"first_name":"Ware","last_name":"Jenson","email":"[email protected]","ip_address":"117.133.217.112"},
+{"id":4,"first_name":"Joline","last_name":"Phette","email":"[email protected]","ip_address":"54.54.173.177"}]
+
+# Create an end point that returns the person’s data to the client in JSON format
+@app.route("/name_search")
+def name_search():
+    # Get the argument 'q' from the query parameters of the request
+    query = request.args.get('q')
+    # Check if the query parameter 'q' is missing
+    if not query:
+        # Return a JSON response with a message indicating 'q' is missing and a 422 Unprocessable Entity status code
+        return {"message": "Query parameter 'q' is missing"}, 422
+    # Iterate through the 'data' list to look for the person whose first name matches the query
+    for person in data:
+        if query.lower() in person["first_name"].lower():
+            # If a match is found, return the person as a JSON response with a 200 OK status code
+            return person
+    # If no match is found, return a JSON response with a message indicating the person was not found and a 404 Not Found status code
+    return {"message": "Person not found"}, 404
+
+# Run the server
+if __name__ == '__main__':
+    app.run(debug=True)
+
+# Test: curl -X GET -i -w '\n' "localhost:5000/name_search?q=Joline"

server4.py

@@ -0,0 +1,56 @@
+# Flask server with dynamic URLs (GET /count, GET /person/id, and DELETE /person/id endpoints)
+
+from flask import Flask, request
+app = Flask(__name__)
+
+data = [{"id":"3b58aade-8415-49dd-88db-8d7bce14932a","first_name":"Baxy","last_name":"Escalera","email":"[email protected]","ip_address":"107.160.207.177"},
+{"id":"d64efd92-ca8e-40da-b234-47e6403eb167","first_name":"Marigold","last_name":"Tillyer","email":"[email protected]","ip_address":"80.162.216.11"},
+{"id":"66c09925-589a-43b6-9a5d-d1601cf53287","first_name":"Ware","last_name":"Jenson","email":"[email protected]","ip_address":"117.133.217.112"},
+{"id":"a3d8adba-4c20-495f-b4c4-f7de8b9cfb15","first_name":"Joline","last_name":"Phette","email":"[email protected]","ip_address":"54.54.173.177"}]
+
+# Create GET /count endpoint
+@app.route("/count")
+def count():
+    try:
+        # Attempt to return a JSON response with the count of items in 'data'
+        return {"data count": len(data)}, 200
+    except NameError:
+        # If 'data' is not defined and raises a NameError
+        return {"message": "data not defined"}, 500
+
+# Create GET /person/id endpoint
+@app.route("/person/<var_name>")
+def find_by_uuid(var_name):
+    # Iterate through the 'data' list to search for a person with a matching ID
+    for person in data:
+        # Check if the 'id' field of the person matches the 'var_name' parameter
+        if person["id"] == str(var_name):
+            # Return the person as a JSON response if a match is found
+            return person
+
+    # Return a JSON response with a message and a 404 Not Found status code if no matching person is found
+    return {"message": "Person not found"}, 404
+
+# Create DELETE /person/id endpoint
+@app.route("/person/<uuid:id>", methods=['DELETE'])
+def delete_by_uuid(id):
+    # Iterate through the 'data' list to search for a person with a matching ID
+    for person in data:
+        # Check if the 'id' field of the person matches the 'id' parameter
+        if person["id"] == str(id):
+            # Remove the person from the 'data' list
+            data.remove(person)
+            # Return a JSON response with a message confirming deletion and a 200 OK status code
+            return {"message": f"Person with ID {id} deleted"}, 200
+    # If no matching person is found, return a JSON response with a message and a 404 Not Found status code
+    return {"message": "person not found"}, 404
+
+# Run the server
+if __name__ == '__main__':
+    app.run(debug=True)
+
+# Test GET /count endpoint: curl -X GET -i -w '\n' "localhost:5000/count"
+# Test GET /person/id endpoint: curl -X GET -i localhost:5000/person/66c09925-589a-43b6-9a5d-d1601cf53287
+# Test DELETE /person/id endpoint:
+# - Delete: curl -X DELETE -i localhost:5000/person/66c09925-589a-43b6-9a5d-d1601cf53287
+# - Check:

server5.py

@@ -0,0 +1,37 @@
+# Flask server parsing JSON from request body
+
+from flask import Flask, request
+app = Flask(__name__)
+
+data = [{"id":"3b58aade-8415-49dd-88db-8d7bce14932a","first_name":"Baxy","last_name":"Escalera","email":"[email protected]","ip_address":"107.160.207.177"},
+{"id":"d64efd92-ca8e-40da-b234-47e6403eb167","first_name":"Marigold","last_name":"Tillyer","email":"[email protected]","ip_address":"80.162.216.11"},
+{"id":"66c09925-589a-43b6-9a5d-d1601cf53287","first_name":"Ware","last_name":"Jenson","email":"[email protected]","ip_address":"117.133.217.112"},
+{"id":"a3d8adba-4c20-495f-b4c4-f7de8b9cfb15","first_name":"Joline","last_name":"Phette","email":"[email protected]","ip_address":"54.54.173.177"}]
+
+@app.route("/person", methods=['POST'])
+def add_by_uuid():
+    new_person = request.json
+    if not new_person:
+        return {"message": "Invalid input parameter"}, 422
+    # code to validate new_person ommited
+    try:
+        data.append(new_person)
+    except NameError:
+        return {"message": "data not defined"}, 500
+    return {"message": f"{new_person['id']}"}, 200
+
+# Run the server
+if __name__ == '__main__':
+    app.run(debug=True)
+
+# Test:
+# curl -X POST -i -w '\n' \
+#   --url http://localhost:5000/person \
+#   --header 'Content-Type: application/json' \
+#   --data '{
+#         "id": "0z7e61b4-6b27-87ed-00eb-0662ac139993",
+#         "first_name": "Peter",
+#         "last_name": "Parker",
+#         "email": "[email protected]",
+#         "ip_address": "24.54.173.177"
+#     }'

server6.py

@@ -0,0 +1,13 @@
+# Flask server with custom error handler
+
+from flask import Flask
+app = Flask(__name__)
+
+@app.errorhandler(404)
+def api_not_found(error):
+    # Custom error handler for 404 Not Found errors
+    return {"message": "API not found"}, 404
+
+# Run the server
+if __name__ == '__main__':
+    app.run(debug=True)