mirror of
https://github.com/hubHarmony/servii-backend.git
synced 2024-11-18 05:50:31 +00:00
74 lines
2.6 KiB
Markdown
74 lines
2.6 KiB
Markdown
# Servii - Backend
|
|
|
|
[![PyPI](https://img.shields.io/pypi/v/PyGithub.svg)](https://pypi.python.org/pypi/PyGithub)
|
|
[![Docker Image CI](https://github.com/hubHarmony/servii-backend/actions/workflows/docker-image.yml/badge.svg)](https://github.com/hubHarmony/servii-backend/actions/workflows/docker-image.yml)
|
|
![Static Badge](https://img.shields.io/badge/servii-V1.0.0-pink?style=flat)
|
|
[![Static Badge](https://img.shields.io/badge/%F0%9F%93%9A-%202.7.1%20-36A4A4)](https://www.servii.fr/api-docs/)
|
|
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
|
|
![Static Badge](https://img.shields.io/badge/Python-3.12.3-yellow)
|
|
|
|
|
|
Servii is a cutting-edge project designed to streamline the management of Minecraft servers and facilitate seamless integration with frontend applications.
|
|
Built with modern technologies like [Firebase], Servii offers a robust backend for launching Minecraft servers and serves as a comprehensive API for frontend projects, enhancing the gaming experience through efficient server management and automation.
|
|
This [GitHub] repository has a production goal, workflows will be soon integrated.
|
|
|
|
[Firebase]: https://firebase.google.com/
|
|
[GitHub]: https://github.com
|
|
|
|
## Installation guide
|
|
#### Download the repository.
|
|
```bash
|
|
git clone https://github.com/charleslemaux/servii-backend.git
|
|
cd servii-backend
|
|
```
|
|
#### Install virtualenv.
|
|
```bash
|
|
pip3 install virtualenv
|
|
```
|
|
|
|
#### Enable it.
|
|
```bash
|
|
virtualenv venv
|
|
|
|
//UNIX
|
|
source venv/bin/activate
|
|
|
|
//windows
|
|
venv\Scripts\activate
|
|
```
|
|
#### Install dependencies.
|
|
```bash
|
|
pip install -r requirements.txt
|
|
```
|
|
#### Launch !
|
|
```bash
|
|
gunicorn -w 4 -b 0.0.0.0:3000 app:app
|
|
```
|
|
|
|
*you also may be tempted to use parameters*
|
|
```bash
|
|
gunicorn -w 4 -b 0.0.0.0:3000 app:app --interval 20
|
|
```
|
|
|
|
## Documentation
|
|
The API's {[Documentation]} is now complete !!
|
|
This project is self documented and ready to understand.
|
|
Start reading at app.py, and even if the rest isn't that self explainatory, read the "generic_executor.py' file to understand how everything globally works.
|
|
|
|
[Documentation]: https://www.servii.fr/api-docs/
|
|
|
|
## Development
|
|
|
|
### Contributing
|
|
|
|
Long-term discussion and bug reports are maintained via GitHub Issues.
|
|
Code review is done via GitHub Pull Requests.
|
|
|
|
### Maintainership
|
|
|
|
We're actively seeking maintainers that will triage issues and pull requests and cut releases.
|
|
If you work on a project that leverages Servii and have a vested interest in keeping the code alive and well, send an email to [charles@le-maux.dev], thank you for reading.
|
|
|
|
|
|
[charles@le-maux.dev]: mailto:charles@le-maux.dev
|