Fingerstyle Taiwan Backend Project

Fingerstyle Taiwan page backend project, using django and postresql for development.

Table of content

• Getting Started
• Built With
• Contributing
• License
• Get Help
• Acknowledgments

Getting Started

Clone project

git clone https://github.com/Fingerstyle-Taiwan/django-backend.git
cd django-backend

Build docker container and apps

make build

Start docker apps (Django and PostgreSQL)

This command will launch django server and database. See http://127.0.0.1:8000/admin

make up

If you get a database error after make up, just try the code below, it will remove the database from disk, then rebuild volume again.

make down

make database-init

make up

Setup a superuser for development

make superuser

See APIs docs

See http://127.0.0.1:8000/docs

Stop docker apps (Django and PostgreSQL)

make down

Usage

Lint and test (IMPORTANT:do this before you git push, github actions will auto lint and test)

• lint

make lint

• test

make test

Django commands

• create a django app

 make create-app NAME=YouAppName

• create superuser

make superuser

• migrations

make migrations

• migrate

make migrate

Git commit

Please use commitizen-tools to submit your commit message.

cz c

Built With

Docker

Docker is a software platform that allows you to quickly build, test, and deploy applications.

Make

Make is a tool which controls the generation of executables and other non-source files of a program from the program's source files.

Django

Django is a high-level Python web framework that encourages rapid development and clean, pragmatic design.

PostgreSQL

PostgreSQL is a powerful, open source object-relational database system with over 30 years of active development that has earned it a strong reputation for reliability, feature robustness, and performance.

Contributing

Issues

In the case of a bug report, bugfix or a suggestions, please feel very free to open an issue.

Pull request

Pull requests are always welcome, and I'll do my best to do reviews as fast as I can.

License

This project is licensed under the MIT License

Get Help

• Contact us on Discord
• If appropriate, open an issue on GitHub

Acknowledgements

Django REST Framework - Django REST framework is a powerful and flexible toolkit for building Web APIs.