egutierrez
af9ad48c9b
- 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>
47 lines
1.5 KiB
Markdown
47 lines
1.5 KiB
Markdown
---
|
|
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'.
|