pcobra 10.0.9__tar.gz

pcobra-10.0.9/.env.example

@@ -0,0 +1,40 @@
+##############################################
+# 🌐 Configuración general de Cobra
+##############################################
+
+# Idioma de la interfaz: es | en
+COBRA_LANG=es
+
+# URL del backend de CobraHub (dejar en blanco si no se usa)
+COBRAHUB_URL=https://cobrahub.example.com/api
+
+##############################################
+# 🧩 Configuración de archivos
+##############################################
+
+# Archivo de mapeo de módulos Cobra
+COBRA_MODULE_MAP=./cobra.mod
+
+# Configuración general del lenguaje Cobra
+COBRA_CONFIG=./cobra.toml
+
+# Configuración extendida para pCobra
+PCOBRA_CONFIG=./pcobra.toml
+PCOBRA_TOML=./pcobra.toml
+
+##############################################
+# 🧠 Estados y almacenamiento
+##############################################
+
+# Archivo donde guardar el estado de Qualia (AGI)
+QUALIA_STATE_PATH=src/core/qualia_state.json
+
+# Carpeta para caché de árboles sintácticos (AST)
+COBRA_AST_CACHE=./cache
+
+##############################################
+# 🧪 Parser (opcional)
+##############################################
+
+# Usar parser alternativo: dejar vacío o usar "lark"
+COBRA_PARSER=

pcobra-10.0.9/CHANGELOG.md

@@ -0,0 +1,143 @@
+## v10.0.9 - 2025-08-17
+- Ajuste en `SafeUnpickler` para aceptar los módulos `core.ast_nodes` y `cobra.core.ast_nodes`.
+- `corelibs.sistema.ejecutar` ahora exige una lista blanca de comandos
+  mediante el parámetro `permitidos` o la variable de entorno
+  `COBRA_EJECUTAR_PERMITIDOS`. Invocarlo sin esta configuración produce
+  `ValueError` y la lista de la variable de entorno se fija al importar
+  el módulo, evitando modificaciones en tiempo de ejecución.
+- Reemplazo del uso de `pickle` por serialización JSON segura en la caché
+  de AST y tokens.
+
+## v10.0.8 - Pendiente de liberación
+- Integración de la biblioteca **holobit** para la creación y manipulación de holobits.
+- Pruebas en `tests` que verifican la funcionalidad de holobit.
+- `tests/unit/test_holobit_generation.py` construye holobits de diferentes tamaños y valida la conversión a JSON.
+- `tests/unit/test_benchmark_execution.py` ejecuta los comandos de benchmark y comprueba que los tiempos se mantienen dentro de un rango razonable utilizando `time.perf_counter`.
+
+## v10.0.7 - Pendiente de liberación
+- Nota: versión en desarrollo, sin cambios liberados.
+
+## v10.0.6 - 2025-07-26
+- Actualización de documentación y archivos de configuración.
+
+## v10.0.0 - 2025-07-25
+- Incremento de versión principal a 10.0.0.
+- Actualización de documentación y ejemplos.
+
+## v9.1.0 - 2025-07-16
+- Incremento de versión menor a 9.1.0.
+- Actualización de documentación y ejemplos.
+- Ajustes en el empaquetado y generación de binarios.
+
+## v9.0.0 - 2025-07-13
+- Mejoras de empaquetado que simplifican la distribución.
+- Integración de notebooks de ejemplo en el paquete.
+- Otros ajustes menores.
+- Requisito mínimo de Python actualizado a la versión 3.9.
+
+## v8.0.0 - 2025-07-08
+- Incremento de versión principal a 8.0.0.
+- Documentación y pruebas actualizadas.
+
+## v7.2.0 - 2025-07-06
+- Incremento de versión menor a 7.2.0.
+- Documentación y pruebas actualizadas.
+
+## v7.1.0 - 2025-07-06
+- Se actualiza la versión del proyecto y del kernel de Jupyter.
+- Documentación actualizada con nuevas referencias de versión.
+
+## v7.0.0 - 2025-07-06
+- Se incrementa la versión principal del proyecto.
+- Documentación y pruebas adaptadas a la nueva versión.
+
+## v6.0.0 - 2025-07-04
+- Actualización mayor del lenguaje Cobra y de las herramientas de desarrollo.
+- Documentación reorganizada con nuevos ejemplos.
+- Integración de procesos de lanzamiento automatizados a través de GitHub Actions.
+- Los transpiladores exponen el método `generate_code` y permiten guardar el resultado con `save_file`.
+
+## v5.6.3 - 2025-07-02
+- Ajustes de documentación y versión.
+
+## v5.6.2 - 2025-07-02
+- Actualización de versión a 5.6.2 y ajustes de documentación y pruebas.
+
+## v5.6 - 2025-06-29
+- Paquete actualizado a la versión 5.6.
+- Documentación y kernel reflejan la nueva versión.
+- Prueba de plugins ajustada a "dummy 5.6".
+
+## v5.5 - 2025-06-29
+- Paquete actualizado a la versión 5.5.
+- Documentación y kernel reflejan la nueva versión.
+- Prueba de plugins ajustada a "dummy 5.5".
+
+## v5.4 - 2025-06-29
+- Paquete actualizado a la versión 5.4.
+- Documentación y kernel reflejan la nueva versión.
+- Prueba de plugins ajustada a "dummy 5.4".
+
+## v5.2 - 2025-06-29
+- Paquete actualizado a la versión 5.2.
+- Documentación y kernel reflejan la nueva versión.
+- Prueba de plugins ajustada a "dummy 5.2".
+
+## v5.1 - 2025-06-28
+- Paquete actualizado a la versión 5.1.
+- Documentación y kernel reflejan la nueva versión.
+- Prueba de plugins ajustada a "dummy 5.1".
+
+## v5.0 - 2025-06-28
+- Paquete actualizado a la versión 5.0.
+- Documentación y kernel reflejan la nueva versión.
+- Prueba de plugins ajustada a "dummy 5.0".
+
+## v4.6 - 2025-06-28
+- Paquete actualizado a la versión 4.6.
+- Documentación y kernel reflejan la nueva versión.
+- Prueba de plugins ajustada a "dummy 4.6".
+
+## v4.5 - 2025-06-28
+- Paquete actualizado a la versión 4.5.
+- Documentación y kernel reflejan la nueva versión.
+- Prueba de plugins ajustada a "dummy 4.5".
+
+## v4.4 - 2025-06-28
+- Paquete actualizado a la versión 4.4.
+- Documentación y kernel reflejan la nueva versión.
+- Prueba de plugins ajustada a "dummy 4.4".
+
+## v4.3 - 2025-06-28
+- Paquete actualizado a la versión 4.3.
+- Documentación y kernel reflejan la nueva versión.
+- Prueba de plugins ajustada a "dummy 4.3".
+
+## v3.0 - 2025-06-27
+- Paquete actualizado a la versión 3.0.
+- Documentación y kernel reflejan la nueva versión.
+- Prueba de plugins ajustada a "dummy 3.0".
+
+## v2.2 - 2025-06-27
+- Paquete actualizado a la versión 2.2.
+- Documentación y kernel reflejan la nueva versión.
+- Prueba de plugins ajustada a "dummy 2.2".
+
+## v2.1 - 2025-06-27
+- Actualización del paquete a la versión 2.1.
+- Nuevos comandos `init` y `package`.
+- Incorporación del puente ctypes y del helper de importación de transpiladores.
+- Documentación y kernel actualizados.
+
+## v2.0 - 2025-06-26
+- Actualización de la versión del paquete a 2.0.
+- Documentación y archivos de configuración actualizados a la versión 2.0.
+- El kernel de Jupyter refleja la nueva versión.
+
+## v1.4 - 2025-06-26
+- Publicación en PyPI con metadata completa.
+- Soporte de instalación mediante pipx.
+- Inicio de la internacionalización en la CLI y documentación.
+
+## v1.3 - 2024-06-01
+- Versión inicial migrada al changelog.

pcobra-10.0.9/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Adolfo González Hernández
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pcobra-10.0.9/MANIFEST.in

@@ -0,0 +1,25 @@
+include LICENSE
+include README.md
+include CHANGELOG.md
+include docs/MANUAL_COBRA.md
+include cobra.mod
+include cobra.toml
+include pcobra.toml
+include pyproject.toml
+include Makefile
+include scripts/install.sh
+include scripts/run.sh
+include .env.example
+
+recursive-include src/pcobra *.py
+recursive-include src/pcobra *.toml
+recursive-include src/pcobra *.yaml
+recursive-include src/pcobra *.json
+recursive-include src/pcobra *.ini
+recursive-include src/pcobra *.cfg
+recursive-include src/pcobra *.md
+recursive-include src/pcobra *.txt
+recursive-include src/pcobra *.html
+
+recursive-include notebooks *
+recursive-include docs/frontend *

pcobra-10.0.9/Makefile

@@ -0,0 +1,84 @@
+# ========== VARIABLES CONFIGURABLES ==========
+PYTHON=python
+VENV=.venv
+SRC=src/pcobra
+TESTS=tests
+SPHINXBUILD=sphinx-build
+SPHINXOPTS=
+SOURCEDIR=docs/frontend
+BUILDDIR=docs/build
+GRAMMAR_COV?=30
+
+# ========= TAREAS GENÉRICAS ==========
+
+help:
+	@echo "Comandos disponibles:"
+	@echo "  make install         Instala el entorno en modo desarrollo"
+	@echo "  make run             Ejecuta Cobra usando dotenv"
+	@echo "  make test            Ejecuta tests con pytest y coverage"
+	@echo "  make coverage        Ejecuta coverage y genera reporte HTML"
+	@echo "  make lint            Ejecuta linters: ruff, mypy, bandit"
+	@echo "  make format          Formatea con black + isort"
+	@echo "  make typecheck       Verifica tipos con mypy + pyright"
+	@echo "  make docker          Construye todos los contenedores"
+	@echo "  make docs            Genera documentación Sphinx"
+	@echo "  make clean           Limpia archivos temporales"
+	@echo "  make secrets         Busca secretos con gitleaks"
+	@echo "  make check           Linter + Tests + Typecheck (pre-commit/release)"
+	@echo "  make publicar-blog FILE=archivo.md  Publica una entrada en el blog"
+
+install:
+	$(PYTHON) -m venv $(VENV)
+	. $(VENV)/bin/activate 2>/dev/null || . $(VENV)/Scripts/activate && \
+		pip install --upgrade pip && \
+		pip install -e .[dev]
+
+run:
+$(PYTHON) -m dotenv -f .env run -- $(PYTHON) -m pcobra
+
+test:
+	$(PYTHON) scripts/grammar_coverage.py --threshold=$(GRAMMAR_COV)
+	pytest --cov=$(SRC) $(TESTS) --cov-report=term-missing --cov-fail-under=90
+
+coverage:
+	coverage run -m pytest
+	coverage html
+
+lint:
+        ruff check $(SRC)
+        mypy $(SRC)
+        bandit -r $(SRC)
+
+format:
+	isort $(SRC)
+	black $(SRC)
+
+typecheck:
+        mypy $(SRC)
+        @command -v pyright >/dev/null 2>&1 && pyright || echo "ℹ️ pyright no está instalado"
+
+secrets:
+	gitleaks detect --source . --redact
+
+check: lint test typecheck
+	@echo "✅ Todo en orden. Código listo para commit o build."
+
+docker:
+	docker build -t cobra -f docker/Dockerfile .
+	docker build -t cobra-cpp -f docker/cpp.Dockerfile .
+	docker build -t cobra-js -f docker/js.Dockerfile .
+	docker build -t cobra-python -f docker/python.Dockerfile .
+	docker build -t cobra-rust -f docker/rust.Dockerfile .
+
+docs:
+	$(SPHINXBUILD) -M html "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS)
+
+publicar-blog:
+	bash scripts/publicar_blog.sh $(FILE)
+clean:
+	find . -type d -name "__pycache__" -exec rm -rf {} +
+	find . -type f -name "*.pyc" -delete
+	rm -rf .pytest_cache .mypy_cache .coverage htmlcov \
+	       $(BUILDDIR) .venv dist build bench_results.json
+
+.PHONY: help install run test coverage lint format typecheck secrets docker docs publicar-blog clean check