/work-at-olist

Apply for a job at Olist's Development Team: https://olist.gupy.io/

Primary LanguagePython

Python labs Challenge project

*Used:

Windows 10

Python 3.8.1

Django 2.2.12

Heroku Postgres

Gunicorn 20.0.4

*Steps:

1- Install the requirements

  • Download or clone the project into your preferred folder.
  • In a CMD, browse to your folder.
  • Create/Activate the virtual enviroment.
  • Install the "requirements.txt"

py -m pip install -r requirements.txt

2- Django Migrate

  • Run the migrations:

py manage.py migrate

3- Import Authors

  • Run the custom command:

py manage.py import_authors authors.csv

4- Run tests

  • Run the tests:

py manage.py test

OK

Destroying test database for alias 'default'

5- Create a superuser

  • Run the command:

py manage.py createsuperuser

6- Run server and login

Run the command:

py manage.py runserver

7- Access and use the API

Work at Olist

Olist is a company that offers an integration platform for sellers and marketplaces allowing them to sell their products across multiple channels.

The Olist development team consists of developers who love what they do. Our agile development processes and our search for the best development practices provide a great environment for professionals who like to create quality software in good company.

We are always looking for good programmers who love to improve their work. We give preference to small teams with qualified professionals over large teams with average professionals.

This repository contains a problem used to evaluate candidate skills. It's important to notice that satisfactorily solving the problem is just a part of what will be evaluated. We also consider other programming disciplines like documentation, testing, commit timeline, design and coding best practices.

Hints:

  • Carefully read the specification to understand all the problem and artifact requirements before starting, if you don't understand something tell us;
  • Check the recommendations and reference material at the end of this specification;
  • We appreciate simplicity, so create a good project setup that will help us in your evaluation;
  • Please make tests ... we appreciate tests <3... tests make the world better.

How to participate

  1. Make a fork of this repository on Github. If you can't create a public fork of this project, make a private repository (bitbucket/gitlab/github offers free private repos) and add read permission for one of these users below:
  2. Follow the instructions of README.md (this file);
  3. Deploy your project on a hosting service (we recommend Heroku);
  4. Apply for the position at our career page with:
    • Link to the fork on Github (or bitbucket/gitlab);
    • Link to the deployed project in a hosting service.

Specification

You should implement an application for a library to store book and authors data.

This application must provide an HTTP REST API to attend the requirements.

#1. Receive a CSV with authors and import to database

Given a CSV file with many authors (more than a million), you need to build a command to import the data into the database. The CSV file will have the following format:

name Luciano Ramalho Osvaldo Santana Neto David Beazley Chetan Giridhar Brian K. Jones J.K Rowling

Each author record in the database must have the following fields:

  • id (self-generated)
  • name

You need to store the authors' data to complement the book data that will be stored afterward (see item #3).

Extra tip: If you use Django Framework you can do something like this...

python manage.py import_authors authors.csv

#2. Expose authors' data in an endpoint

This endpoint needs to return a paginated list with the authors' data. Optionally the authors can be searched by name.

#3. CRUD (Create, Read, Update and Delete) of books

You need to implement these actions in your API:

  • Create a book
  • Read book's data
  • Update book's data
  • Delete book's data

Each book record has the fields:

  • id (self-generated)
  • name
  • edition
  • publication_year
  • authors (more than one author can write a book)

To retrieve a book (in easy mode) we can filter by 4 fields (or a composition of these four):

  • name
  • publication_year
  • edition
  • author

But these 4 filters are optional. It must be possible to navigate all the books' data without any filter.

To create a book you need to send this payload (in json format) below:

{ "name": // Name of the book; "edition": // Edition number; "publication_year": // Publication year of the book; "authors": // List of author ids, same ids of previous imported data }

Project Requirements:

  • Provide a working environment with your project (eg. Heroku)
  • Application must be written in Python or Go.
  • Python
    • Use Python >= 3.5
    • Choose any Python web framework you want to solve the problem
    • Use PEP-8 for code style
    • Python Coding Style
  • Go
  • Every text or code must be in English
  • Write the project documentation containing:
    • Description;
    • Installing (setup) and testing instructions;
    • If you provide a docker solution for setup, ensure it works without docker too.
    • Brief description of the work environment used to run this project (Computer/operating system, text editor/IDE, libraries, etc).
  • Provide API documentation (in English);
  • Variables, code and strings must be all in English.

Recommendations

  • Write tests! Please make tests ... we appreciate tests <3... tests make the world better;
  • Practice the 12 Factor-App concepts;
  • Use SOLID design principles;
  • Use programming good practices;
  • Use git best practices, with clear messages (written in English);
  • Be aware when modeling the database;
  • Be careful with REST API details. They can bite you!

Have fun!