lubelogger-fuelio-importer

Python script to import fuel fill-ups from Fuelio's Google Drive backups to Lubelogger.

Usage

Defaults:

• The log level set in the execution args (--log-level) takes presedence over config.yml's log_level. If neither are set, it will default to INFO.
• If config_dir is unspecified, the default is to look for a directory named config in the script's current working direcory.
  It can also be set by defining the CONFIG_DIR environment variable.

Standalone

python3 main.py [-h|--help] [--dry-run] [--log-level {debug,info,warning,error,critical}] [config_dir]

Docker

docker run --rm -v ./config:/app/config ghcr.io/tigattack/lubelogger-fuelio-importer:latest [--dry-run]

Docker Compose

docker compose up [-d]

Tip

You will need to download docker-compose.yml to current directory before running.

Getting Started

First, a couple of prerequisites:

• Fuelio must be configured to back up to Google Drive (docs).
• You must generate service or client credentials for the Google Drive API. Client credentials require interactive (browser) authentication, while service accounts do not. Pick the most appropriate option for your case and follow the instructions in the relevant sections below.

Now you can complete the configuration for the importer:

1. Copy config.example.yml to config.yml, and open it in an editor.
2. Define your vehicle('s) IDs in Fuelio & Lubelogger.
3. Set your Lubelogger domain, username, and password.
4. Set your Google Drive folder ID (see instructions below).
5. Create your Google authentication credentials JSON (see instructions below) and move the file in place
6. Set your credentials filename and the relevant auth_type in the config.
7. Run the importer per the Usage section above.

Retrieve your Fuelio vehicle ID

Fuelio vehicle IDs are chronological, i.e. the first vehicle you add to Fuelio is ID 1, the second is ID 2, and so on.

If you're unsure, download and extract the backup ZIP of each vehicle and inspect the CSV inside.

Retrieve your Lubelogger vehicle ID

1. Open Lubelogger in a browser.
2. Navigate to the vehicle in question.
3. The vehicle ID will be in the URL like so: https://lubelogger.domain.tld/Vehicle/Index?vehicleId=<vehicle ID here>

Retrieve your Google Drive Folder ID

1. Open Google Drive in a browser.
2. Navigate to the folder in which Fulio stores its backups.
3. The folder ID will be in the URL like so: https://drive.google.com/drive/folders/<folder ID here>

Generate your Google Drive API credentials

1. Go to APIs Console and make your own project.
2. Search for "Google Drive API", select the entry, and click "Enable".
3. Based on the authentication type you've chosen, follow the relevant set of instructions below.

Client Credentials

1. Click Create Credentials at https://console.cloud.google.com/apis/credentials
2. Select "OAuth client ID".
3. Now, the product name and consent screen need to be set -> click "Configure consent screen" and follow the instructions. Once finished:
   1. Select "Application type" to be Web application.
   2. Enter an appropriate name.
   3. Input http://localhost:8080/ for "Authorized redirect URIs".
   4. Click "Create".
4. Click "Download JSON" on the right side of Client ID to download client_secret_<really long ID>.json.
5. The downloaded file has all authentication information of your application. Rename the file to “client_secrets.json” and place it in your working directory.

Service Account Credentials

1. Click Create Credentials at https://console.cloud.google.com/apis/credentials
2. Select "Service Account".
3. Enter an appropriate name.
4. Continue through steps 2 & 3.
5. Select the service account in the list.
6. Copy the service account's email address. We'll use this later.
7. Select the "Keys" tab and create a new key:
   1. Click "Add key"
   2. Select "Create new key"
   3. Select "JSON"
   4. Click "Create"
8. The service account key will be downloaded. Rename the file to "service_secrets.json" and place it in your working directory.
9. Open Google Drive in a browser.
10. Navigate to the folder in which Fulio stores its backups.
11. Share the folder with the service account using email address you copied in step 6. The "Viewer" role is all it needs.