Git Product home page Git Product logo

flask-react-mini-challenge-cheesemakers's Introduction

Practice Challenge - Cheesemakers

Congratulations! You have been hired by the American Fromger Association and for your first job, you have been tasked with building out a website to log cheesemakers with their cheeses.

In this repo, there is a Flask application with some features built out. There is also a fully built React frontend application, so you can test if your API is working (don't be afraid to use an API clients (such as Postman, Insomnia, Thunder Client) as well).

Your job is to build out the Flask API to add the functionality described in the deliverables below.

This project is separated into two applications:

  • A React frontend, in the client directory.
  • A Flask backend, in the server directory.

All of the features for the React frontend are built out, so you do not need to make any changes there.


Frontend Setup

Let's take a quick tour of what we have so far.

To get started, cd into the client directory. Then run:

$ npm install
$ npm start

Then visit http://localhost:4000 in the browser to get a sense of the application.

You are not being assessed on React, and you don't have to update any of the React code; the frontend code is available just so that you can test out the behavior of your API in a realistic setting.


Backend Setup

In another terminal, run pipenv install; pipenv shell to install the dependencies and enter your virtual environment, then cd into the server directory to start running your Python code.

In this directory, you're given a bare-bones template for a Flask API application. It should look familiar to other Flask labs you've seen and has all the code set up so you can focus on building out your model and API routes (unless you would prefer to include flask-restful).

You'll be responsible for:

  • Creating the models and migrations.
  • Setting up the necessary routes to handle requests.
  • Performing CRUD actions and validations with SQLAlchemy.
  • Sending the necessary JSON data in the responses.

Instructions

You can run your Flask server from the server/ directory with:

$ export FLASK_APP=app.py
$ export FLASK_RUN_PORT=5555
$ flask run

OR

$ python app.py

If you would prefer to include Flask Restful complete the following otherwise skip to Models section

This application is using vanilla Flask. If you would like to use flask-restful you can. To setup Flask-restful complete the following steps:

  • in the main install flask-restful:
$ pipenv install flask-restful
  • in the app.py file import Api and Resource from flask-restful
from flask_restful import Api, Resource
  • connect flask-restful to you app
api = Api(app)
  • remove the routes index route currently setup in app.py
  • create classes that inherit Resource (imported from flask-restful)
  • add resources to your api

Models

You need to create the following relationship:

  • A Producer has many Cheeses
  • A Cheese belongs to a Producer

Start by creating the models and migrations for the following database tables:

domain diagram

Validations

Add validations to the Producer model:

  • must have a name
  • founding_year must be 1900 to present
  • operation_size must be one of "small", "medium", "large", "family", "corporate"

Add validations to the Cheese model:

  • production_date must be before today
  • price must be between 1.00 and 45.00

After creating the model and migrations, run the migrations and use the provided seed.py file to seed the database:

$ flask db migrate -m'your message'
$ flask db upgrade
$ python seed.py

If you run into errors with the migrate or upgrade try:

  • deleting the migrations folder and the database
  • run the following command to restart the db setup
$ flask db init
  • try the migrate and upgrade commands again

Routes

Set up the following routes. Make sure to return JSON data in the format specified along with the appropriate HTTP verb.

GET /producers

Return JSON data in the format below. Note: you should return a JSON response in this format, without any additional nested data related to each cheese.

[
  {
    "founding_year": 1972,
    "id": 1,
    "image": "https://placekitten.com/35/989",
    "name": "Hill, Hunter and West",
    "operation_size": "small",
    "region": "Iowa"
  },
  {
    "founding_year": 1979,
    "id": 2,
    "image": "https://dummyimage.com/685x303",
    "name": "Austin, Bennett and Herrera",
    "operation_size": "family",
    "region": "Pennsylvania"
  }
]

GET /producers/:id

If the Producer exists, return JSON data in the format below. Note: you will need to serialize the data for this response differently than for the GET /producers route. Make sure to include an array of cheeses for each producer.

{
  "cheeses": [
    {
      "id": 4,
      "image": "https://images.pexels.com/photos/773253/pexels-photo-773253.jpeg?auto=compress&cs=tinysrgb&w=1600",
      "is_raw_milk": false,
      "kind": "camembert",
      "price": 21.71,
      "producer_id": 1,
      "production_date": "2019-12-19 00:00:00"
    },
    {
      "id": 11,
      "image": "https://images.pexels.com/photos/4198018/pexels-photo-4198018.jpeg?auto=compress&cs=tinysrgb&w=1600",
      "is_raw_milk": false,
      "kind": "manchego",
      "price": 6.97,
      "producer_id": 1,
      "production_date": "2021-05-23 00:00:00"
    }
  ],
  "founding_year": 1972,
  "id": 1,
  "image": "https://placekitten.com/35/989",
  "name": "Hill, Hunter and West",
  "operation_size": "small",
  "region": "Iowa"
}

DELETE /producers/:id

If the Producer exists, it should be removed from the database, along with any Cheeses that are associated with it (a Cheese belongs to an Producer, so you need to delete the Cheeses before the Producer can be deleted).

After deleting the Producer, return an empty response body, along with the appropriate HTTP status code.

If the Producer does not exist, return the following JSON data, along with the appropriate HTTP status code:

{
  "error": "Resource not found"
}

POST /cheeses

This route should create a new Cheese that is associated with an existing Producer. It should accept an object with the following properties in the body of the request:

{
  "kind": "roquefort",
  "is_raw_milk": true,
  "production_date": "2023-08-16",
  "image":  "https://images.pexels.com/photos/3522515/pexels-photo-3522515.jpeg?auto=compress&cs=tinysrgb&w=1600",
  "price": 13.65,
  "producer_id": 5
}

If the Cheese is created successfully, send back a response with the data created Cheese object, along with the appropriate HTTP status code.:

{
  "id": 22,
  "image": "https://images.pexels.com/photos/3522515/pexels-photo-3522515.jpeg?auto=compress&cs=tinysrgb&w=1600",
  "is_raw_milk": true,
  "kind": "roquefort",
  "price": 13.65,
  "producer": {
    "name": "Anderson, Harrison and Gregory"
  },
  "producer_id": 5,
  "production_date": "2023-08-16 00:00:00"
}

If the Cheese is not created successfully, return the following JSON data, along with the appropriate HTTP status code:

{
  "errors": ["validation errors"]
}

PATCH /cheeses/:id

If the Cheese exists, this route should update the Cheese with the given data. It should accept an object with some of a Cheese's properties in the body of the request:

{
  "is_raw_milk": false,
  "production_date": "2023-08-18"
}

If the Cheese is updated successfully, send back a response with the created Cheese object only (no producer), along with the appropriate HTTP status code.:

{
  "id": 22,
  "image": "https://images.pexels.com/photos/3522515/pexels-photo-3522515.jpeg?auto=compress&cs=tinysrgb&w=1600",
  "is_raw_milk": false,
  "kind": "roquefort",
  "price": 13.65,
  "producer_id": 5,
  "production_date": "2023-08-18 00:00:00"
}

f the Cheese is not created successfully, return the following JSON data, along with the appropriate HTTP status code:

{
  "errors": ["validation errors"]
}

DELETE /cheeses/:id

If the Chese exists, it should be removed from the database.

After deleting the Cheese, return an empty response body, along with the appropriate HTTP status code.

If the Cheese does not exist, return the following JSON data, along with the appropriate HTTP status code:

{
  "error": "Resource not found"
}

flask-react-mini-challenge-cheesemakers's People

Contributors

betalantz avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.