Installation

Installation

Requirements

• Python 3.10, 3.11, or 3.12
• pip 23.0+

From source (recommended)

git clone https://github.com/wzsisshadiao-crypto/dq-questionbank-core
cd dq-questionbank-core
pip install -e ".[docx]"

Optional dependencies

Extra	Installs	Purpose
docx	python-docx>=1.1	DOCX import and export
dev	pytest, ruff, build, jsonschema	Running tests and linting

# Full development install
pip install -e ".[docx,dev]"

Verify

dq --version
# dq-questionbank-core 0.2.1

dq formats
# Import formats: docx, json, latex, markdown
# Export formats: docx, json, latex, markdown

From PyPI (future)

PyPI publication is planned. Track progress on GitHub Issues.

Platform notes

• Windows: Python from python.org. Use .venv\Scripts\activate.
• macOS: brew install python@3.12 or python.org installer.
• Linux: Use your distribution s Python 3.10+ package, or python.org.

Troubleshooting

• ModuleNotFoundError: No module named 'docx' -- install with pip install ".[docx]"
• SchemaNotFoundError -- reinstall from an official distribution
• dq: command not found -- ensure your venv is activated, or use python -m dq_questionbank.cli