{"id":35731229,"url":"https://github.com/esgf/esgf-vocab","last_synced_at":"2026-06-01T17:00:49.538Z","repository":{"id":273842852,"uuid":"887209859","full_name":"ESGF/esgf-vocab","owner":"ESGF","description":"CLI + library to deal with WCRP CVs","archived":false,"fork":false,"pushed_at":"2026-05-28T10:06:55.000Z","size":10344,"stargazers_count":6,"open_issues_count":12,"forks_count":8,"subscribers_count":6,"default_branch":"main","last_synced_at":"2026-05-28T11:22:52.116Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://esgf.github.io/esgf-vocab/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ESGF.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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":"2024-11-12T11:00:50.000Z","updated_at":"2026-05-28T10:05:27.000Z","dependencies_parsed_at":"2025-02-06T15:32:49.656Z","dependency_job_id":"0b9a2136-2a9b-4619-8560-ff6a60dccc54","html_url":"https://github.com/ESGF/esgf-vocab","commit_stats":null,"previous_names":["esgf/esgf-vocab"],"tags_count":25,"template":false,"template_full_name":null,"purl":"pkg:github/ESGF/esgf-vocab","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ESGF%2Fesgf-vocab","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ESGF%2Fesgf-vocab/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ESGF%2Fesgf-vocab/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ESGF%2Fesgf-vocab/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ESGF","download_url":"https://codeload.github.com/ESGF/esgf-vocab/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ESGF%2Fesgf-vocab/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33784631,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-01T02:00:06.963Z","response_time":115,"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":[],"created_at":"2026-01-06T11:03:39.075Z","updated_at":"2026-06-01T17:00:49.532Z","avatar_url":"https://github.com/ESGF.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ESGVOC Library\n\nESGVOC is a Python library designed to simplify interaction with controlled vocabularies (CVs) used in WCRP climate data projects. It supports querying, caching, and validating terms across various CV repositories like the [universe](https://github.com/WCRP-CMIP/WCRP-universe/tree/esgvoc) and project-specific repositories (e.g., [CMIP6Plus](https://github.com/WCRP-CMIP/CMIP6Plus_CVs/tree/esgvoc), [CMIP6](https://github.com/WCRP-CMIP/CMIP6_CVs/tree/esgvoc), etc.).\n\nFull documentation is available at [https://esgf.github.io/esgf-vocab/](https://esgf.github.io/esgf-vocab/).\n\n---\n\n## Features\n\n- **Query controlled vocabularies**:\n  - Retrieve terms, collections, or descriptors.\n  - Perform cross-validation and search operations.\n  - Supports case-sensitive, wildcard, and approximate matching.\n\n- **Caching**:\n  - Download CVs to a local database for offline use.\n  - Keep the local cache up-to-date.\n  - Note: at present, this is a design choice.\n    You can't use esgvoc without this cache,\n    it always downloads the CVs to a local database first\n\n- **Validation**:\n  - Validate strings against CV terms and templates.\n\n- **Apps**:\n  - Ease some treatment using the CV.\n\n\n## Installation\n\nESGVOC is available on PyPI. Install it with pip:\n\n```bash\npip install esgvoc\n```\n\nAfter installing ESGVOC,\nuse this command to install the latest CVs\n(or update them if you have already installed ESGVOC).\n\n```bash\nesgvoc install\n```\n\n### For developers\n\n* with pip\n\n```bash\npip install -e .\npip install pre-commit\npre-commit install\n```\n\n* with uv\n\n```bash\nuv sync\nuv run pre-commit install\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fesgf%2Fesgf-vocab","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fesgf%2Fesgf-vocab","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fesgf%2Fesgf-vocab/lists"}