roms-api-backend

• Generates changelogs automatically from device trees in your org
• Create a changelog-page to telegraph
• Upload builds to your GDrive
• Posts automatically builds with changelogs, device name, rom banner, maintainer name and download link in your telegram channel
• Docker support
• Firebase support
• Checkout SwaggerHUB for requests

Generated log example

• Clone this repo, install requirements and generate Google Drive token:

$ git clone https://github.com/roms-rest-api/roms-api-backend

$ cd roms-api-backend

$ python3 -m pip install -r requirements.txt

$ python3 starter.py

• Visit Firebase Console
• Create a project
• Type in a project name
• Create a Firestore Database and choose Productionmode
• Go to Projectsettings and go to service account, then click on Firebase Admin SDK and create your private key (add it later to roms-api-backend as firebase_credentials.json)
• Create a Realtime Database and choose lockmode
• Copy your database url (in config: firebase_rldb)

• Visit the Google Cloud Console
• Go to the OAuth Consent tab, fill it, and save.
• Go to the Credentials tab and click Create Credentials -> OAuth Client ID
• Choose Desktop and Create.
• Use the download button to download your credentials.
• Move that file to the root of roms-api-backend, and rename it to credentials.json
• Visit Google API page
• Search for Drive and enable it, if it is disabled
• Finally, start roms-api-backend and generate your token.json file for Google Drive:

$ python3 starter.py

• Please execute only after the firebase instance has been created and the config file is complete!
• The return value will be your token, you need this token to upload builds and add other users

$ python3 starter.py DEVICE USERNAME

$ curl -X POST -d \
        '{"devices":["YOURDEVICE"],"token":"YOURADMINTOKEN","name":"NEWUSER","admin":"ADMINNAME"}' \
        http://GET.YOUROWN.DOMAIN/auth/add_user

• Create in your organization a repository, for example official_devices, and add a devices.yaml file like here with same syntax
• You have to use the predefined fields, otherwise the program may not work.

• Clone Traefik-Configs and follow the instructions in readme file

• Create your Google Drive token:

$ python3 starter.py

• Build Docker image:

$ sudo docker build . -t backend

• Replace your domain name in docker-compose-yml

• Run the image, if you replaced your domain name in docker-compose.yml:

$ sudo docker-compose up -d

$ python3 -m uvicorn api:app --reload --host 0.0.0.0 (use gunicorn in production)

This is an example for uploading builds. Replace your values with ones written in caps lock.

$  curl -X 'POST' 'https://api.YOUR.DOMAIN/api/upload' \   
                    -H 'accept: application/json' \  
                    -H 'Content-Type: multipart/form-data' \
                    -F 'codename=DEVICENAME' 
                    -F 'version=YOURANDROIDVERSION' \   
                    -F 'username=YOURUSERNAME' \  
                    -F 'file=@PATH/TO/YOUR/BUILD.ZIP;type=text/plain' \
                    -F 'token=YOURTOKEN' \