CLI

Unealta de linie de comandă eocube se instalează cu extra-ul cli (pip install "eocube[cli]"). Fiecare comandă și sub-comandă acceptă --help; această pagină este o privire de ansamblu asupra arborelui de comenzi.

Opțiuni globale

Opțiune	Semnificație
--context <nume>	Folosește un anumit context; implicit context.primary.
--log-level <nivel>	DEBUG, INFO, WARNING (implicit), ERROR, CRITICAL.
--version	Afișează versiunea și commit-ul de build, apoi iese.

eocube --context=eocube.ro services stac collection list

eocube setup

Inițializează și editează fișierul de configurare (vezi Configurare).

Comandă	Descriere
setup init [--force]	Resetează configurația la valorile implicite ROCS.
setup auth add --name <n> oidc --discovery-url <url>	Adaugă o sursă de autentificare OIDC.
setup storage add --name <n> --endpoint <url> [--auth-ref <nume> \| --auth-oidc]	Adaugă o definiție de stocare.
setup stac add --name <n> --endpoint <url> [--auth <ref>]	Adaugă un endpoint STAC.
setup context add --name <n> --auth <a> --stac <s> [--storage <s>] [--user-storage <s>] [--primary]	Adaugă un context.

eocube auth

Autentificare și funcții pentru credențiale.

Comandă	Descriere
auth login [--device-flow]	Autentificare (implicit în browser, sau prin OAuth device flow).
auth logout	Revocă și șterge token-urile stocate.
auth info	Afișează claim-urile decodate ale token-ului curent.
auth get-access-token	Afișează un token de acces OIDC valid la stdout.
auth get-storage-credentials [--endpoint <url>] [--duration <s>] [--as-json]	Obține credențiale S3 temporare prin STS.
auth get-storage-credentials-with-token --token <jwt> [--endpoint <url>]	La fel, folosind un token furnizat de tine.

auth login scrie refresh token-ul tău în contextul activ din eocube.yml; comenzile ulterioare regenerează automat token-uri de acces din el. În container / CI, setează variabilele de mediu în loc să te autentifici.

eocube services

services stac

CRUD, căutare și gestionarea endpoint-urilor pentru catalogul STAC. Vezi Autorizarea catalogului STAC pentru regulile de proprietate și vizibilitate care se aplică la publicare.

Comandă	Descriere
stac collection create \| list \| get \| update \| delete	Gestionează colecții.
stac item add \| get \| update \| delete	Gestionează item-uri într-o colecție.
stac search	Caută în catalog (după colecție, bbox, datetime, …).
stac endpoint get-default \| set-default	Afișează sau setează endpoint-ul STAC implicit.
stac endpoint alias add \| remove \| list	Gestionează alias-uri de endpoint STAC.

services geospatialorg

Caută unități administrative și județe din România de la geo-spatial.org.

Comandă	Descriere
geospatialorg get-county-by-name --name <nume>	Județ după nume.
geospatialorg get-county-by-mnemonic --name <cod>	Județ după mnemonic (ex. TM).
geospatialorg get-administrative-unit-by-name --name <nume>	Unitate administrativă după nume.
geospatialorg get-administrative-unit-by-code --code <siruta>	Unitate administrativă după cod SIRUTA.

Necesită extra-ul services

Aceste comenzi au nevoie de geopandas / owslib. Instalează-le cu pip install "eocube[services]". O comandă rulată fără ele eșuează cu un mesaj clar, fără a bloca CLI-ul.

services proxy

Pornește un proxy invers local, autentificat, către un serviciu EOCube. Acesta injectează token-ul tău OIDC în fiecare cerere transmisă, astfel încât o unealtă care nu „vorbește” OIDC (un browser, curl, QGIS, un notebook) poate accesa serviciul prin URL-ul local.

eocube services proxy --endpoint https://stac.eocube.ro --port 9112
curl http://127.0.0.1:9112/collections

Opțiune	Implicit	Semnificație
--endpoint <url>	(obligatoriu)	Serviciul upstream către care se face proxy.
--port <n>	9112	Portul local.
--bind <adresă>	127.0.0.1	Adresa locală de legare (vezi nota de securitate din --help).
--anonymous	dezactivat	Nu injecta un token.

eocube mcp serve

Pornește un server Model Context Protocol (MCP) care expune setul de unelte EOCube agenților LLM. Rulează implicit pe stdio, sau pe streamable HTTP cu --http. Valorile implicite (host, port, stateless, allow-destructive) provin din secțiunea mcp a configurației; opțiunile le suprascriu. Necesită extra-ul mcp.

eocube mcp serve                       # stdio
eocube mcp serve --http --host 0.0.0.0 --port 8002

eocube tools

Funcții offline care nu necesită acces la API — de exemplu tools stac create-item, care construiește un Item STAC din fișiere raster.