feat(infra): funciones Python config_from_env y dotenv_load con tests

- config_from_env_py_infra: dataclass + field metadata, tipos str/int/float/bool/list
- dotenv_load_py_infra: parser .env con semantica de no-sobreescritura
- 15 tests unitarios Python, todos PASS
- registry.db actualizado con fn index (685 funciones, 109 tipos)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-04-13 02:01:56 +02:00
parent ebf246beb0
commit c7998de8bb
6 changed files with 442 additions and 0 deletions
+54
View File
@@ -0,0 +1,54 @@
---
name: config_from_env
kind: function
lang: py
domain: infra
version: "1.0.0"
purity: impure
signature: "config_from_env(target_class: type) -> object"
description: "Crea una instancia de un dataclass poblada desde variables de entorno usando field metadata (env, required, default, secret). Soporta str, int, float, bool, list. Acumula todos los errores antes de lanzar ValueError."
tags: [config, env, dataclass, infra, python]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: [os, dataclasses]
params:
- name: target_class
desc: "clase dataclass con field metadata declarando env, required, default y/o secret por cada campo"
output: "instancia del dataclass con todos los campos poblados desde env o defaults"
tested: true
tests:
- "populate string desde env"
- "populate int con conversion"
- "populate bool true"
- "populate float field"
- "populate list comma separated"
- "default usado cuando env no seteada"
- "required sin valor lanza error"
- "no dataclass lanza type error"
test_file_path: "python/functions/infra/config_from_env_test.py"
file_path: "python/functions/infra/config_from_env.py"
---
## Ejemplo
```python
from dataclasses import dataclass, field
from config_from_env import config_from_env
@dataclass
class AppConfig:
host: str = field(default="localhost", metadata={"env": "HOST", "default": "localhost"})
port: int = field(default=8080, metadata={"env": "PORT", "default": "8080", "required": True})
api_key: str = field(default="", metadata={"env": "API_KEY", "required": True, "secret": True})
tags: list = field(default_factory=list, metadata={"env": "TAGS", "default": "prod,stable"})
cfg = config_from_env(AppConfig)
print(cfg.port) # 8080 o el valor de PORT
```
## Notas
Solo stdlib (os, dataclasses). Conversion de tipos: str sin cambio, int/float con parseo, bool desde "1"/"true"/"yes", list desde split por coma. El tag secret no tiene efecto en runtime. La funcion inspecciona todos los fields via dataclasses.fields() y solo procesa los que tienen metadata["env"].