mayela / backend

CodeBuddies back-end

Django proof-of-concept for CodeBuddies V3

Background: codebuddies/codebuddies#1136

The API spec all the proof-of-concepts: https://app.swaggerhub.com/apis-docs/billglover/CodeBuddies/0.0.1

Crowdsourced brainstorm of problems we want to solve: https://pad.riseup.net/p/BecKdThFsevRmmG_tqFa-keep

Setup

Although it is possible to run this locally, we recommend you run CodeBuddies locally using Docker. We assume you have Docker installed, but if not head on over to the Docker Getting Started guide and install Docker for your operating system.

These instructions have been used on the following operating systems.

• Linux
• Mac OS
• Windows 10 Pro

Please note that Windows 10 Home is not supported by Docker Desktop at this time.

1. Fork this repository. This creates a copy of the repository for you to work on. For more help see this GitHub guide: Fork a repo.
2. Clone your fork. This creates a copy on your local computer. For more help see this GitHub guide: Cloning a repository.

git clone [email protected]:codebuddies/django-concept.git cb

3. Navigate into the project directory.

cd cb

4. Start the local development environment.

docker-compose up -d

This will run the following components:

• Nginx, a web server: http://localhost:8000
• Adminer, a DB front-end: http://localhost:8001
• Mailhog, a dummy mailbox: http://localhost:8025
• A PostgreSQL database
• The Django web application

You can view the application or make API calls by using the Nginx URL.

You can access the database through the Adminer front-end or using a local PostgreSQL client and the following URL: postgres://babyyoda:mysecretpassword@localhost:5432/codebuddies.

To stop the application and remove all containers, run the following.

docker-compose down

5. Create a superuser so that you can log into http://localhost:8000/admin by running the following in your terminal: $ docker-compose run --rm app ./manage.py createsuperuser

6. You can populate the database with some random test data for development purposes by running $ docker-compose run --rm app ./manage.py init_data. All user accounts created by this command have the password codebuddies.

Editing Code

With the local environment running, you can modify the application code in your editor of choice. As you save changes, the application should reload automatically. There should be no need to restart containers to see code changes.

Other Tasks

Logs

View logs from all containers.

docker-compose logs

View logs from a single container (in this case the app container).

docker-compose logs app

You can use the same structure to view logs for the other containers; nginx, db, mailhog, adminer, app.

If you would like to tail the logs in the console then you remove the detach flag, -d, from the docker-compose up command that you use to start the application.

Django Management

The following are examples of some common Django management commands that you may need to run.

• Make Migrations: docker-compose run --rm app ./manage.py makemigrations
• Merge Migrations: docker-compose run --rm app ./manage.py makemigrations --merge
• Run Migrations: docker-compose run --rm app ./manage.py migrate

To see the full list of management commands use help.

docker-compose run --rm app ./manage.py help

Automated Tests

• We use pytest with the pytest-django plugin for running tests.
• Please add tests for your code when contributing.
• Run the test suite using docker-compose run --rm app pytest
• With test coverage report docker-compose run --rm app pytest --cov-report=term --cov=.

Import Postman collection

Postman is a free interactive tool for verifying the APIs of your project. You can download it at postman.com/downloads.

Postman is an interactive tool for verifying the APIs of your project in an isolated environment--think of it as a a virtual playground where we can safely experiment and edit our API before we deploy it on our web app--just like virtual environments help us isolate our python dependencies.

We've created a shared Postman collection (a .json file) in the postman folder to help contributors more easily reproduce observed behaviour in our dev API.

To get it set up, please follow these steps:

1. Download Postman

Downloading Postman Please make sure it is at least v7.6.0, if installed, or you are downloading the latest stable version. Linux,

• Distro package manager:
• use the search feature to find in your package manager
• (RECOMMENDED) Flatpak
• After setting up flatpak it through flatpak using flatpak install postman and enter "yes"/"y" for all the questions it will ask. Flatpak is designed to provide the most up-to-date versions of software for most distros, so if you have the option, use Flatpak to guarantee Linux OS compatibility and to keep Postman up-to-date.

2. Once you have Postman open, click on file -> import and import the .json file
3. Click on the settings gear icon on the far top right (next to the eye icon) and click to add a new environment.
4. Name your environment dev and create a variable called api_url. Give it a value of https://localhost:8000, which is the URL of your Django dev environment when it is running.
5. Now, as long you have the Django app (https://localhost:8000) running, you should be able to make requests like POST Create User and POST Authenticate. Click on this link to see what you should expect: https://imgur.com/hd9VB6k

POST Create User will create a new user in your localhost:8000 running Django app, and making a request to POST Authenticate will authenticate whether or not that user exists.

5. Now, as long you have the Django app (https://localhost:8000) running, you should be able to make requests like POST Create User and POST Authenticate by clicking on the blue "Send" button in Postman.

Removing Everything

To remove all containers run the following:

docker-compose rm

This will leave a copy of the data volume (holding the PostgreSQL data) behind. To remove that you will need to identify and remove the data volume.

docker volume ls

DRIVER              VOLUME NAME
local               django-concept_db_data

Note the name of the data volume, in this case django-concept_db_data and delete it.

docker volume rm django-concept_db_data

Note: it is likely that cached copies of your container images will be retained by Docker on your local machine. This is done to speed things up if you require these images in future. To completely remove unused container images and networks, we recommend you follow Docker pruning guide.

Proof-of-concept Goals

A resource datastore

• save resource
• delete resource
• update resource
• list resource
• search resources

Resource:

• title
• description
• type
• credit
• url
• referrer

The start of a resource bookmarking/archiving service.

• Calendar/hangouts
  • How easy would it be to make a calendar widget that lets users block out times they're free for hangouts?

Findings

Technologies Used

======= Please see instructions here

This project is not deployed yet, but will interact as the API supporting https://github.com/codebuddies/frontend