Flask blog starter project

Blog application built with Flask and SQLAlchemy.

Get started

Start by setting up your development environment. First, make sure that you have Python 3.7.1 or later available in your terminal. The easiest way to manage multiple versions of Python is to use pyenv.

Next, in your project root, install the Python dependencies by executing:

make dev_install

then create the database

make db_upgrade

then seed the database with some initial data

make seed_db

then run the application by executing:

make run

now you can access your application by navigating to http://127.0.0.1:5000/ in your browser.

Linting

To lint your Python code using flake8 run:

make lint

Testing

Run the automated tests by executing:

make test

GraphQL

This starter features a GraphQL API built with graphene. To access the GraphiQL of your running server navigate to http://127.0.0.1:5000/graphql in your browser.

Create a new post

To create a new post via the GraphQL API execute the following mutation in GraphiQL:

mutation {
  createPost (input: {
    title: "Test Post"
    content: "Test content"
  }) {
    __typename
    ... on CreatePostSuccess {
      post {
        id
        title
        content
        createdAt
        updatedAt
      }
    }
  }
}

Fetch all posts

To fetch all posts execute the following query in GraphiQL:

{
  posts {
    edges {
      node {
        id
        title
        content
        createdAt
      }
    }
  }
}

What you need to do

We need you to take this sample project, fork the repository, and add some extra features.

Key goals and deliverables

• We would like to be able to tag posts by associating zero or more tags with a single post.
• We would like to filter the list of posts by tag.
• We would like to filter posts by the date they were created.
• Some of our client consume the blog content via the GraphQL API. Currently they can only list and create posts, but have asked for the ability to edit and delete posts.
• We would also like to filter posts by tag and creation date via the GraphQL API.

Bonus points

• Implement user authentication (consider using Flask-Login)
• Deploy the project in AWS, Azure or GCP
• Add unit tests for the new features

Dependencies and tools

You may install any other third-party dependencies and tools.

Assignment submission

In order to submit this assignment you will need clone this project and then push the repo to your own GitHub account. When you are done, submit a link of your public repo to [email protected] (Please do not create a pull-request).

NOTE: Do not remove the Plagiarism declaration.

Plagiarism declaration

1. I know that plagiarism is wrong. Plagiarism is to use another’s work and pretend that it is one’s own.
2. This assignment is my own work.
3. I have not allowed, and will not allow, anyone to copy my work with the intention of passing it off as his or her own work.
4. I acknowledge that copying someone else’s assignment (or part of it) is wrong and declare that my assignments are my own work.