KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #deepseek-harness #typescript #ai-agent #codex #developer-tools #claude-code #windows #mcp #python #desktop-app

devo-abastecer

★ 10 Open GitHub ↗

Twitter bot that publishes weekly the fuel prices updates on Madeira island.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ⛽️ Devo Abastecer (_beta_)

> [!IMPORTANT]
>
> [![⛽️ Update Gas Prices from DRETT](https://github.com/carlosrsabreu/devo-abastecer/actions/workflows/update_gas_prices.yml/badge.svg?branch=main)](https://github.com/carlosrsabreu/devo-abastecer/actions/workflows/update_gas_prices.yml) [![📈 Publish History Plot](https://github.com/carlosrsabreu/devo-abastecer/actions/workflows/plot_history.yml/badge.svg)](https://github.com/carlosrsabreu/devo-abastecer/actions/workflows/plot_history.yml) [![💅 Format Codebase](https://github.com/carlosrsabreu/devo-abastecer/actions/workflows/format_codebase.yml/badge.svg?branch=main)](https://github.com/carlosrsabreu/devo-abastecer/actions/workflows/format_codebase.yml)

🇵🇹 Informação acessível com os preços dos combustíveis na Madeira, publicada semanalmente no Twitter recorrendo a um bot.<br> 🇬🇧 Up-to-date fuel prices in Madeira, conveniently updated weekly on Twitter via our automated bot.

## Fuel price history

![Gas History](https://raw.githubusercontent.com/carlosrsabreu/devo-abastecer/main/history/gas_history.png)

## Functionality Overview

This project automates the end-to-end lifecycle of fuel price monitoring in Madeira. The system is designed for reliability, using GitHub Actions as a serverless orchestrator to handle extraction, archival, and multi-channel publication.

### Workflow

```mermaid
sequenceDiagram
    autonumber
    participant 🤖 GitHub Action
    participant 🐍 Orchestrator (update_gas_prices.py)
    participant 📄 JORAM (PDF Archive)
    participant 🗄️ Database (CSV/JSON)
    participant 📢 Social Media (X/BSky/FB)
    participant 📈 Visualization (plot_history.py)

Note over 🤖 GitHub Action: 📅 Weekly update trigger
    🤖 GitHub Action ->> 🐍 Orchestrator (update_gas_prices.py): 🚀 Start update process
    🐍 Orchestrator (update_gas_prices.py) ->> 📄 JORAM (PDF Archive): 🔍 Extract latest fuel prices
    📄 JORAM (PDF Archive) -->> 🐍 Orchestrator (update_gas_prices.py): 🏷️ New price data

alt 🆕 New Prices Found
        🐍 Orchestrator (update_gas_prices.py) ->> 🗄️ Database (CSV/JSON): 🏛️ Archive record (add_history.py)
        🐍 Orchestrator (update_gas_prices.py) ->> 📢 Social Media (X/BSky/FB): 📬 Post to platforms
        🐍 Orchestrator (update_gas_prices.py) ->> 🤖 GitHub Action: 💾 Commit updated history files
    else 💤 Data already exists
        🐍 Orchestrator (update_gas_prices.py) -->> 🤖 GitHub Action: 🔚 End workflow
    end

Note over 🤖 GitHub Action: 📈 Monthly visualization trigger
    🤖 GitHub Action ->> 📈 Visualization (plot_history.py): 🎨 Generate trend chart
    📈 Visualization (plot_history.py) ->> 🗄️ Database (CSV/JSON): 📖 Read historical data
    📈 Visualization (plot_history.py) ->> 📈 Visualization (plot_history.py): 🖼️ Render gas_history.png
    📈 Visualization (plot_history.py) ->> 🤖 GitHub Action: 📎 Commit updated plot
```

devo-abastecer

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README