Comando Create

Carga una nueva colección.

Ejemplos

Usando el comando con un nombre de colección:

python src/main.py create -f my_folder -c my_collection

Sintaxis alternativa con nombres completos de parámetros:

python src/main.py create --folder my_folder --collection my_collection

Esto creará una colección llamada my_collection usando los archivos en input/my_folder.

Para sobrescribir una colección existente, usa la bandera -o u --overwrite:

python src/main.py create -f my_folder -o

Usando un nombre de colección específico:

python src/main.py create -f my_folder -c my_collection -o

Usando nombres completos de parámetros:

python src/main.py create --folder my_folder --collection my_collection --overwrite

Estos comandos sobrescribirán la colección si ya existe, usando los archivos de input/my_folder.

La carpeta de la colección debe ubicarse en el directorio input.
La carpeta de entrada debe contener:
- Un archivo collection.json que describa la colección.
- Los archivos de capa correspondientes (.tif).
El archivo collection.json debe seguir la especificación descrita en la documentación.
Usa el archivo collection.example.json como plantilla para crear la configuración de tu colección.

Si no se proporciona un nombre de colección con -c, se usará el id del archivo collection.json.
Sin la bandera -o, el comando fallará si la colección ya existe.
Con la bandera -o, cualquier colección existente con el mismo nombre será reemplazada completamente.
Con la bandera --delete-local-cog, se eliminarán los COG locales de la carpeta output/<folder> después de subirlos exitosamente. Si la carpeta queda vacía tras la limpieza, también será eliminada.

El campo id se normaliza automáticamente a PascalCase (ej: "huella_humana" → "HuellaHumana", "bosque-seco" → "BosqueSeco").
Los campos title y description se normalizan automáticamente quitando tildes y caracteres especiales para evitar problemas de codificación UTF-8 (ej: "Colección" → "Coleccion", "análisis" → "analisis").
Esta normalización se aplica automáticamente antes de subir la colección al servidor STAC.

Antes de subir, se valida el formato JSON del archivo collection.json.
Se verifica que el archivo esté codificado en UTF-8.
Se valida que el campo id esté en PascalCase (se sugiere el valor normalizado si no cumple).
Se verifica el cumplimiento con el estándar STAC definido en la especificación.