desarrollo · Referencia de comando
qzx traceEnvVar
Qué hace
Rastrea el uso de una variable de entorno en código, .env y plantillas .env.example.
Madurez del comando: Alpha
Disponible para uso real y retroalimentación mientras su interfaz y comportamiento todavía pueden evolucionar. Esta es la evaluación actual del checkout de desarrollo. Cada futuro tag inmutable de release conservará la evaluación exacta incluida en esa versión. Disponible en PyPI 0.2.2.0.15. La documentación corresponde al checkout alpha 0.2.2.0.15.
Comportamiento y protecciones integradas
Inspecciona sin cambiar el estado
Ejecución directa para esta operación
Funciona sin invocar programas nativos
Funciona sin usar la red
Diseñado para funcionar sin elevación
Esta clasificación de seguridad fue revisada por Claude Opus 5.5 (Anthropic) contra el digest de implementación sha256:9cbac23ede96724bb1d062bb7af1288c858771ad04579a52d52735ebcd3908c9 el 2026-10-08.
Sintaxis exacta
qzx traceEnvVar <var_name> [project_path] [recursive] --jsonParámetros
Desliza o usa la barra horizontal para ver todas las columnas.
| Nombre | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
| var_name | str | Sí | No declarado | Nombre de la variable de entorno que se buscará (por ejemplo, DATABASE_URL o PORT) |
| project_path | str | No | "." | Ruta del directorio raíz del proyecto (valor predeterminado: directorio actual) |
| recursive | bool | No | true | Indica si se buscan directorios recursivamente (valor predeterminado: True) |
Ejemplos de entrada
qzx traceEnvVar "PORT"Rastrear el uso de la variable de entorno PORT en el directorio actual
qzx traceEnvVar "STRIPE_API_KEY" "C:/my-project"Rastrear el uso de STRIPE_API_KEY en C:/my-project
Para obtener la carga estructurada completa, añade --json: qzx traceEnvVar <var_name> [project_path] [recursive] --json
Ejemplo de salida representativa
Este JSON ilustrativo deriva del contrato de resultado respaldado por la implementación actual. Muestra lo que el comando puede devolver sin afirmar que es una ejecución grabada; los valores varían según entradas, equipo, permisos y herramientas opcionales.
Comando del ejemplo: qzx traceEnvVar "PORT" --json
{
"success": true,
"message": "Traces usage of an environment variable across code files, .env, and .env.example templates. In this illustrative example, the command completed successfully.",
"meta": {
"command": "traceEnvVar",
"command_maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
},
"duration_ms": 0,
"schema_version": 1
},
"analysis_complete": true,
"env_files_diagnostics": "C:\\project\\example.txt",
"project_path": "C:\\project\\example.txt",
"references": [
{
"path": "src/settings.py",
"line": 12,
"context": "API_URL = os.getenv(\"API_URL\")"
}
],
"references_count": 3,
"scan_issues": [
{
"name": "example",
"status": "ok"
}
],
"var_name": "Example value"
}Ver el contrato de resultado JSON
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": [
"success",
"message",
"meta"
],
"properties": {
"success": {
"type": "boolean"
},
"message": {
"type": "string"
},
"meta": {
"type": "object",
"required": [
"command",
"command_maturity",
"duration_ms",
"schema_version"
],
"properties": {
"command": {
"type": "string"
},
"command_maturity": {
"type": "object",
"required": [
"stage",
"label",
"sequence",
"public_executable",
"stability",
"summary",
"promotion_review_required",
"assessment_scope"
],
"properties": {
"stage": {
"type": "string"
},
"label": {
"type": "string"
},
"sequence": {
"type": "integer"
},
"public_executable": {
"type": "boolean"
},
"stability": {
"type": "string"
},
"summary": {
"type": "string"
},
"promotion_review_required": {
"type": "boolean"
},
"assessment_scope": {
"type": "string"
},
"note": {
"type": "string"
},
"review": {
"type": "object",
"required": [
"reviewed_on",
"rationale",
"evidence"
],
"properties": {
"reviewed_on": {
"type": "string",
"format": "date"
},
"rationale": {
"type": "string"
},
"evidence": {
"type": "array",
"minItems": 1,
"items": {
"type": "string"
}
},
"replacement": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": true
},
"duration_ms": {
"type": "number"
},
"schema_version": {
"type": "integer"
}
},
"additionalProperties": true
},
"analysis_complete": [],
"env_files_diagnostics": [],
"project_path": [],
"references": [],
"references_count": [],
"scan_issues": [],
"var_name": []
},
"additionalProperties": true
}Errores y límites
El contrato público exige success=false y un message descriptivo en fallos. Este catálogo aún no declara una taxonomía de errores específica para cada comando; revisa el resultado y no infieras códigos inexistentes.
QZX está en alpha. Dependencias opcionales, permisos y capacidades del host pueden cambiar el resultado.
Flujo de evidencia: lista para captura automática determinista.
Evidencia y procedencia
- Implementación
- src/qzx/commands/development/trace_env_var.py
- Canal de documentación
- Documentación de desarrollo 0.2.2.0.15 · main · sha256:b91acee86268edb7cb018a94e089ff8e95835eda3f2cf08b39796c0ab9654693
- Disponibilidad
- 0.2.2.0.15 o anterior
Sigue explorando
Comandos relacionados
Estos comandos también pertenecen a la categoría de desarrollo. Compáralos para elegir la operación que mejor resuelva tu tarea.
qzx traceCircularImportsSigue importaciones de módulos e identifica dependencias circulares.qzx addPythonDocstringsPrevisualiza o añade docstrings generadas a funciones, métodos y clases de un archivo Python.qzx scaffoldTypeScriptCrea una estructura básica para un programa en TypeScript.qzx analyzeComplexityAnaliza métricas de complejidad del código en archivos o proyectos.