{"id":48546864,"url":"https://github.com/davidpoblador/diafan","last_synced_at":"2026-04-08T07:01:53.302Z","repository":{"id":343925103,"uuid":"1179670424","full_name":"davidpoblador/diafan","owner":"davidpoblador","description":"Eina CLI per consultar i descarregar dades del Portal de Transparència de Catalunya | CLI tool for the Catalan open data portal","archived":false,"fork":false,"pushed_at":"2026-04-02T00:25:42.000Z","size":45,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-02T12:42:51.246Z","etag":null,"topics":["catalunya","cli","csv","dades-obertes","generalitat","open-data","python","socrata","transparencia"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/davidpoblador.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-12T09:04:02.000Z","updated_at":"2026-03-13T12:24:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/davidpoblador/diafan","commit_stats":null,"previous_names":["davidpoblador/diafan"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/davidpoblador/diafan","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidpoblador%2Fdiafan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidpoblador%2Fdiafan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidpoblador%2Fdiafan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidpoblador%2Fdiafan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/davidpoblador","download_url":"https://codeload.github.com/davidpoblador/diafan/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidpoblador%2Fdiafan/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31544087,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T16:28:08.000Z","status":"online","status_checked_at":"2026-04-08T02:00:06.127Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["catalunya","cli","csv","dades-obertes","generalitat","open-data","python","socrata","transparencia"],"created_at":"2026-04-08T07:01:53.037Z","updated_at":"2026-04-08T07:01:53.294Z","avatar_url":"https://github.com/davidpoblador.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# diafan\n\nEina de línia de comandes per consultar i descarregar conjunts de dades del [Portal de Transparència de la Generalitat de Catalunya](https://analisi.transparenciacatalunya.cat). Permet consultar metadades, inspeccionar l'estructura, llistar versions històriques i descarregar snapshots en format CSV o JSON.\n\n## Ús ràpid\n\n```\nuvx diafan info gn9e-3qhr\nuvx diafan schema gn9e-3qhr\nuvx diafan versions gn9e-3qhr\nuvx diafan download gn9e-3qhr 1352\nuvx diafan download-current gn9e-3qhr -f json\n```\n\n## Instal·lació\n\nLa manera més senzilla d'executar `diafan` és amb [`uvx`](https://docs.astral.sh/uv/), que no requereix instal·lació prèvia del paquet:\n\n```\nuvx diafan --help\n```\n\nSi no teniu `uv` instal·lat, podeu obtenir-lo amb:\n\n```\n# macOS / Linux\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# macOS (Homebrew)\nbrew install uv\n\n# Windows\npowershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n```\n\nConsulteu la [documentació oficial d'uv](https://docs.astral.sh/uv/getting-started/installation/) per a més opcions.\n\nPer instal·lar `diafan` permanentment:\n\n```\nuv tool install diafan\n```\n\nO amb `pip`:\n\n```\npip install diafan\n```\n\n### Des del codi font\n\n```\ngit clone https://github.com/davidpoblador/diafan.git\ncd diafan\nuv sync\n```\n\n## Comandes\n\n### `info`\n\nMostra les metadades d'un conjunt de dades: nom, categoria, atribució, llicència, estadístiques d'ús, dates amb temps relatiu, descripció i etiquetes.\n\n```\nuvx diafan info gn9e-3qhr\n```\n\n```\n╭── Quantitat d'aigua als embassaments de les Conques Internes de Catalunya ───╮\n│  Nom                  Quantitat d'aigua als embassaments de les Conques      │\n│                       Internes de Catalunya                                  │\n│  ID                   gn9e-3qhr                                              │\n│  Categoria            Medi Ambient                                           │\n│  Atribució            Agència Catalana de l'Aigua (ACA)                      │\n│  Enllaç               https://administraciodigital.gencat.cat/ca/dades/dad…  │\n│  Publicat per         Dades Obertes Catalunya                                │\n│  Procedència          official                                               │\n│  Llicència            See Terms of Use                                       │\n│  Visualitzacions      372.377                                                │\n│  Descàrregues         21.731                                                 │\n│  Columnes             5                                                      │\n│  Creat                2021-01-22 12:27  (fa 5 anys)                          │\n│  Publicat             2023-10-18 11:48  (fa 2 anys)                          │\n│  Dades actualitzades  2026-03-11 11:00  (fa 23 hores)                        │\n│  Última modificació   2026-03-11 11:00  (fa 23 hores)                        │\n│                                                                              │\n│  Descripció                                                                  │\n│  Estat dels embassaments de les Conques Internes de Catalunya a partir dels  │\n│  valors de Nivell de l'aigua a l'embassament, Volum embassat i Percentatge   │\n│  del volum embassat respecte la capacitat de l'embassament (dades agregades  │\n│  del dia anterior).                                                          │\n│                                                                              │\n│  Etiquetes                                                                   │\n│  #embassaments #nivell #msnm #volum #hm3 #ods6_aigua neta i sanejament       │\n│  #ods13_acció pel clima #ods12_producció i consum responsable #aca           │\n│  #percentatge                                                                │\n╰──────────────────────────────────────────────────────────────────────────────╯\n```\n\n### `schema`\n\nMostra l'estructura (columnes) d'un conjunt de dades, incloent-hi el nom, el nom del camp intern i el tipus de dada.\n\n```\nuvx diafan schema gn9e-3qhr\n```\n\n```\n    Quantitat d'aigua als embassaments de les Conques Internes de Catalunya\n┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓\n┃ Nom                            ┃ Camp                       ┃ Tipus         ┃\n┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━┩\n│ Dia                            │ dia                        │ calendar_date │\n│ Estació                        │ estaci                     │ text          │\n│ Nivell absolut (msnm)          │ nivell_absolut             │ number        │\n│ Percentatge volum embassat (%) │ percentatge_volum_embassat │ number        │\n│ Volum embassat (hm3)           │ volum_embassat             │ number        │\n└────────────────────────────────┴────────────────────────────┴───────────────┘\n```\n\n### `versions`\n\nLlista les versions arxivades d'un conjunt de dades, de la més recent a la més antiga. Per defecte mostra les 15 més recents.\n\n```\nuvx diafan versions gn9e-3qhr\n```\n\n```\nQuantitat d'aigua als embassaments de les\n      Conques Internes de Catalunya\n┏━━━━━━━━┳━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━┓\n┃ Versió ┃            Creat ┃           ┃\n┡━━━━━━━━╇━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━┩\n│   1352 │ 2026-03-11 10:00 │ fa 1 dia  │\n│   1351 │ 2026-03-10 10:00 │ fa 2 dies │\n│   1350 │ 2026-03-09 10:00 │ fa 3 dies │\n│   1349 │ 2026-03-08 10:00 │ fa 4 dies │\n│   1348 │ 2026-03-07 10:00 │ fa 5 dies │\n└────────┴──────────────────┴───────────┘\n\nMostrant les 5 versions més recents. Feu servir --all per veure-les totes.\n```\n\nPer veure totes les versions:\n\n```\nuvx diafan versions gn9e-3qhr --all\n```\n\nO limitar a un nombre concret:\n\n```\nuvx diafan versions gn9e-3qhr --limit 50\n```\n\n### `download`\n\nDescarrega una versió específica arxivada d'un conjunt de dades. Activa la materialització de l'arxiu al servidor (si cal) i després descarrega el resultat amb una barra de progrés.\n\n```\nuvx diafan download gn9e-3qhr 1352\n```\n\n```\nSol·licitant arxiu per gn9e-3qhr v1352...\n  Construint arxiu... [00:05] fet\nDescarregant: 100%|████████████████| 4.20M/4.20M [00:02\u003c00:00, 1.85MB/s]\nDesat a quantitat-d-aigua-als-embassaments-...-gn9e-3qhr-v1352.csv (4.2 MB)\n```\n\nPer especificar el fitxer de sortida o el format:\n\n```\nuvx diafan download gn9e-3qhr 1352 -o embassaments.csv\nuvx diafan download gn9e-3qhr 1352 -f json\n```\n\n**Nota:** La materialització d'arxius pot ser lenta o pot fallar per a conjunts de dades molt grans (19M+ files). En aquest cas, feu servir `download-current`.\n\n### `download-current`\n\nDescarrega la versió actual (més recent) d'un conjunt de dades. No requereix materialització d'arxius i funciona sempre, fins i tot amb conjunts de dades molt grans.\n\n```\nuvx diafan download-current gn9e-3qhr\n```\n\n```\nDescarregant snapshot actual de gn9e-3qhr...\nDescarregant: 100%|████████████████| 4.20M/4.20M [00:02\u003c00:00, 1.85MB/s]\nDesat a quantitat-d-aigua-als-embassaments-...-gn9e-3qhr-actual.csv (4.2 MB)\n```\n\nPer descarregar en format JSON:\n\n```\nuvx diafan download-current gn9e-3qhr -f json\n```\n\n## Format de sortida\n\nLes comandes `download` i `download-current` accepten l'opció `--format` (`-f`) per triar el format:\n\n- `csv` (per defecte)\n- `json`\n\n## Autor\n\n[David Poblador i Garcia](https://poblador.cat/) · [LinkedIn](https://www.linkedin.com/in/davidpoblador) · [X/Twitter](https://x.com/davidpoblador)\n\n## Llicència\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidpoblador%2Fdiafan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdavidpoblador%2Fdiafan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidpoblador%2Fdiafan/lists"}