besser-troubleshootinglisted

Diagnose and fix BESSER errors fast. Use this skill whenever the user is staring at a Python traceback, ImportError, ModuleNotFoundError, ValueError, TypeError, AttributeError, jinja2.TemplateNotFoundError, subprocess.CalledProcessError, or any other failure originating from BESSER (besser.BUML, besser.generators, besser.utilities). Covers installation failures (`pip install besser` errors, native dependency build failures for psycopg2/pyodbc/oracledb, Python version mismatches, Windows venv path quirks), import errors (`String` vs `StringType`, missing `bocl==0.3.1`, `antlr4-python3-runtime` version mismatch), model construction errors (spaces or hyphens in names, duplicate enum literals, invalid multiplicities, generalization-to-self, more than one is_id per class), generator crashes (Invalid DBMS, Django subprocess failures, missing GUIModel for WebApp, silent SQLGenerator failures, invalid Qiskit backend), Docker and deployment problems (port conflicts, docker-compose vs docker compose, missing system lib
BESSER-PEARL/BESSER-Skills · ★ 3 · AI & Automation · score 82

Install: claude install-skill BESSER-PEARL/BESSER-Skills

# BESSER Troubleshooting Quick reference for diagnosing and fixing common issues. Organized by symptom. --- ## Installation Issues ### `pip install besser` fails with native dependency errors Several BESSER dependencies require system libraries: | Dependency | Requires | Fix (Ubuntu/Debian) | Fix (macOS) | |------------|----------|---------------------|-------------| | `psycopg2-binary` | PostgreSQL client libs | `apt install libpq-dev` | `brew install postgresql` | | `pyodbc` | ODBC driver manager | `apt install unixodbc-dev` | `brew install unixodbc` | | `oracledb` | Oracle Instant Client | Download from Oracle | Download from Oracle | If you don't need a specific database, these won't block core BESSER functionality — most generators work fine with SQLite (no native deps needed). ### `pip install -e .` fails or installs nothing - Must be run from the repository root where `pyproject.toml` lives. - Requires `setuptools>=42` and `wheel`. Upgrade first: `pip install --upgrade setuptools wheel`. - Check you're in the right virtual environment: `which python` (Unix) or `where python` (Windows). ### Python version incompatibility BESSER requires **Python 3.10+** (Django 5.x dependency). Check with: ```bash python --version ``` If you're on 3.9 or earlier, upgrade Python or use `pyenv`/`conda` to manage versions. ### Windows-specific: `venv\Scripts\activate` not found The activation path is `venv\Scripts\activate` (capital S). A common mistake in some docs is `venv