{"id":16250931,"url":"https://github.com/manio/elicznik-rs","last_synced_at":"2025-03-19T20:30:19.836Z","repository":{"id":57624181,"uuid":"453584178","full_name":"manio/elicznik-rs","owner":"manio","description":"Utility for scraping energy meter data from Tauron eLicznik service and saving to PostgreSQL","archived":false,"fork":false,"pushed_at":"2023-11-01T11:24:27.000Z","size":164,"stargazers_count":4,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-12T23:17:54.534Z","etag":null,"topics":["elicznik","json","postgresql","rust","scraper","tauron"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/manio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-01-30T04:09:08.000Z","updated_at":"2024-11-03T20:01:21.000Z","dependencies_parsed_at":"2023-02-09T10:46:31.535Z","dependency_job_id":"abd8c45a-9625-4c3f-9cbd-ebdca2afaaac","html_url":"https://github.com/manio/elicznik-rs","commit_stats":{"total_commits":24,"total_committers":1,"mean_commits":24.0,"dds":0.0,"last_synced_commit":"d567a046c607ba04e8587485717b414d72d8261b"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manio%2Felicznik-rs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manio%2Felicznik-rs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manio%2Felicznik-rs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manio%2Felicznik-rs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/manio","download_url":"https://codeload.github.com/manio/elicznik-rs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244501067,"owners_count":20462790,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["elicznik","json","postgresql","rust","scraper","tauron"],"created_at":"2024-10-10T15:07:48.847Z","updated_at":"2025-03-19T20:30:19.560Z","avatar_url":"https://github.com/manio.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 💡 elicznik\n\n[![Crates.io](https://img.shields.io/crates/v/elicznik.svg)](https://crates.io/crates/elicznik)\n[![Crates.io](https://img.shields.io/crates/l/elicznik.svg)](https://crates.io/crates/elicznik)\n\n## About\nA commandline tool for scraping energy meter data from [Tauron eLicznik](https://elicznik.tauron-dystrybucja.pl/) service.\nThe data are fetched in the CSV format. It consists of hourly records of energy imported and exported from/to grid.\nBy default obtained data is stored in the PostgreSQL database, but this tool can also save the data directly to a CSV file.\nIt can also load a data from the CSV (instead of using `Tauron`) and then save it in the database.\n\n## Usage\n```\nelicznik 0.1.0\nSimple program to fetch and process `Tauron eLicznik` CSV data. If none arguments are given, it is\nfetching last two days of data and updates missing values in the configured PostgreSQL database\n\nUSAGE:\n    elicznik [OPTIONS]\n\nOPTIONS:\n    -c, --config \u003cCONFIG\u003e    Config file path [default: /etc/elicznik.conf]\n    -d, --debug              Enable debug info\n    -e, --end \u003cEND\u003e          End date in format: YYYY-MM-DD [default: current date]\n    -h, --help               Print help information\n    -i, --input \u003cINPUT\u003e      Input CSV file to read instead of using `Tauron eLicznik`\n    -o, --output \u003cOUTPUT\u003e    Output CSV file to write output data (database will be also updated,\n                             if configured)\n    -p, --print              Print all CSV entries\n    -s, --start \u003cSTART\u003e      Start date in format: YYYY-MM-DD [default: two days ago]\n    -V, --version            Print version information\n```\n\nThe `Tauron` service is providing the data with some delay. Generally the last data available is for a previous day,\nbut even then it is sometimes not complete. This tool is intended to run in a daily manner to be able to fetch all data.\nDue to described data availability the program by default is trying to start fetching data from day before yesterday.\nOne can always adjust it to one's need by providing `start` and `end` parameters as described above.\n\n## Sample run\n![Sample output](images/elicznik.png)\n\n## Config file\nIf not specifed, the tool is searching for the following config file:\u003cbr\u003e\n`/etc/elicznik.conf`\u003cbr\u003e\n\nA sample file may have the following contents:\u003cbr\u003e\n```\n[tauron]\nusername = your_tauron_username\npassword = your_password\n\n[postgres]\nhost = 192.168.1.1\ndbname = database_name\nusername = database_user\npassword = database_password\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanio%2Felicznik-rs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmanio%2Felicznik-rs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanio%2Felicznik-rs/lists"}