---
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, pendiente-usar]
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'.
