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:
@@ -0,0 +1,46 @@
|
||||
---
|
||||
name: dotenv_load
|
||||
kind: function
|
||||
lang: py
|
||||
domain: infra
|
||||
version: "1.0.0"
|
||||
purity: impure
|
||||
signature: "dotenv_load(path: str) -> None"
|
||||
description: "Parsea un archivo .env (KEY=VALUE) e inyecta pares en os.environ. Ignora comentarios # y lineas vacias. No sobreescribe variables ya presentes. Soporta valores con comillas simples o dobles."
|
||||
tags: [dotenv, env, config, os, infra, python]
|
||||
uses_functions: []
|
||||
uses_types: []
|
||||
returns: []
|
||||
returns_optional: false
|
||||
error_type: "error_go_core"
|
||||
imports: [os]
|
||||
params:
|
||||
- name: path
|
||||
desc: "ruta al archivo .env a parsear (ej: '.env', 'config/.env.production')"
|
||||
output: "None — efecto lateral: variables seteadas en os.environ"
|
||||
tested: true
|
||||
tests:
|
||||
- "parsea key value y setea variable"
|
||||
- "ignora comentarios y lineas vacias"
|
||||
- "no sobreescribe variables existentes"
|
||||
- "valores con comillas dobles se stripean"
|
||||
- "valores con comillas simples se stripean"
|
||||
- "archivo inexistente lanza error"
|
||||
- "linea sin igual lanza value error"
|
||||
test_file_path: "python/functions/infra/dotenv_load_test.py"
|
||||
file_path: "python/functions/infra/dotenv_load.py"
|
||||
---
|
||||
|
||||
## Ejemplo
|
||||
|
||||
```python
|
||||
from dotenv_load import dotenv_load
|
||||
import os
|
||||
|
||||
dotenv_load(".env")
|
||||
db_url = os.environ["DATABASE_URL"]
|
||||
```
|
||||
|
||||
## Notas
|
||||
|
||||
Solo stdlib (os). Semantica de no-sobreescritura: variables inyectadas por Docker/CI/CD tienen precedencia sobre el .env local. Separador es el primer '=' encontrado en la linea (permite valores con '='). Formato: KEY=VALUE, KEY="val", KEY='val'.
|
||||
Reference in New Issue
Block a user