Metadata-Version: 2.4
Name: qti_package_maker
Version: 26.3
Summary: A package to create, manage, and convert QTI packages for quizzes and assessments in Canvas, Blackboard, Moodle, and LibreTexts ADAPT.
Author: Dr. Neil Voss
Project-URL: Homepage, https://biologyproblems.org
Project-URL: Repository, https://github.com/vosslab/qti_package_maker
Project-URL: PyPI, https://pypi.org/project/qti-package-maker/
Keywords: QTI,quiz,assessment,test package,Canvas,Blackboard,Moodle,LibreTexts ADAPT,e-learning,LMS,question bank,quiz converter,online learning,exam generator,QTI exporter,IMS Question and Test Interoperability specification,Question and Test Interoperability,XML,QTI v2.1,QTI v1.2
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Education :: Testing
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: crcmod
Requires-Dist: lxml
Requires-Dist: num2words
Requires-Dist: pyyaml
Requires-Dist: tabulate

# QTI Package Maker

qti_package_maker is a Python package and CLI for converting Blackboard Question Upload (BBQ)
text files into QTI packages and other export formats (Canvas QTI v1.2, Blackboard QTI v2.1,
human-readable text, and HTML self-tests). It is aimed at instructors and developers who need
to move assessments across LMSs.

## Documentation
Core docs:
- [docs/INSTALL.md](docs/INSTALL.md): Setup and dependencies.
- [docs/USAGE.md](docs/USAGE.md): CLI usage and examples.
- [docs/FORMATS.md](docs/FORMATS.md): Input/output formats and engine list.
- [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md): Common issues and fixes.
- [docs/CODE_ARCHITECTURE.md](docs/CODE_ARCHITECTURE.md): System design overview.
- [docs/FILE_STRUCTURE.md](docs/FILE_STRUCTURE.md): Repo layout and file map.

More docs:
- [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md): Developer workflows and testing.
- [docs/CHANGELOG.md](docs/CHANGELOG.md): Change history.

## Quick start
```sh
python3 -m venv .venv
source .venv/bin/activate
pip install -r pip_requirements.txt
pip install -e .
python3 tools/bbq_converter.py -i bbq-example-questions.txt -1
```

Input files must follow the `bbq-<name>-questions.txt` naming pattern. For the BBQ format and
more examples, see [docs/USAGE.md](docs/USAGE.md).
