Metadata-Version: 2.4
Name: pyrefiqda
Version: 0.2.0
Summary: A modern, Pydantic-based parser for REFI-QDA (.qdpx) qualitative research files.
Project-URL: Homepage, https://github.com/cbrincoveanu/pyrefiqda
Author-email: Constantin Brîncoveanu <brincoveanu@wiwi.uni-frankfurt.de>
License: MIT
License-File: LICENSE
Requires-Python: >=3.9
Requires-Dist: lxml>=5.0
Requires-Dist: pydantic>=2.0
Requires-Dist: xsdata-pydantic>=24.0
Requires-Dist: xsdata>=24.0
Description-Content-Type: text/markdown

# pyrefiqda
A modern Python parser mapping REFI-QDA qualitative research files (.qdpx) to strict Pydantic models for seamless integration.

## Installation

```bash
pip install pyrefiqda
```

## Quickstart

```python
from pyrefiqda.parser import RefiProject

# 1. Load your .qdpx file exported from your qualitative software
project = RefiProject.load("my_research.qdpx")

# 2. Access strictly-typed Pydantic objects
print(f"Project GUID: {project.guid}")

# Iterate through your codebook
for code in project.code_book.codes:
    print(f"Code Name: {code.name}")
    print(f"Color: {code.color}")
```

## Why this exists

In qualitative studies, researchers use the REFI-QDA standard to exchange data. However, previous Python tools were GUI-heavy or outdated. `pyrefiqda` uses `xsdata` to auto-generate pure Pydantic models directly from the official XML schema, meaning you get flawless type-hinting, validation, and zero parsing bloat.
