Metadata-Version: 2.4
Name: prep2go-exam-facts
Version: 1.0.1
Summary: Open, source-linked facts on citizenship language exams: CIPLE, DELE, DELF, CELI + PT/ES/FR/IT language requirements
Author: Prep2Go
License: MIT (code); CC-BY-4.0 (data)
Project-URL: Homepage, https://www.prep2go.study
Project-URL: Repository, https://github.com/marfa77/prep2go-exam-facts
Project-URL: Documentation, https://marfa77.github.io/prep2go-exam-facts/
Project-URL: DOI, https://doi.org/10.5281/zenodo.23322073
Keywords: CIPLE,DELE,DELF,CELI,citizenship,language requirement,open data
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: LICENSE-DATA
Dynamic: license-file

# prep2go-exam-facts

[![PyPI](https://img.shields.io/pypi/v/prep2go-exam-facts.svg)](https://pypi.org/project/prep2go-exam-facts/)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.23322073.svg)](https://doi.org/10.5281/zenodo.23322073)

Open, source-linked facts on citizenship language exams: CIPLE, DELE, DELF, CELI + PT/ES/FR/IT language requirements

Python package bundling the open dataset **prep2go-exam-facts: Citizenship language exam facts (CIPLE, DELE, DELF, CELI)** from
[github.com/marfa77/prep2go-exam-facts](https://github.com/marfa77/prep2go-exam-facts) with a tiny pure-stdlib API (Python >= 3.8).

- Product: [https://www.prep2go.study](https://www.prep2go.study)
- Dataset DOI: [10.5281/zenodo.23322073](https://doi.org/10.5281/zenodo.23322073)
- Documentation: https://marfa77.github.io/prep2go-exam-facts/
- Data source: Official exam issuer and government pages (source URLs per record in the data).

## Install

```
pip install prep2go-exam-facts
```

## Usage

```python
import prep2go_exam_facts

prep2go_exam_facts.files()        # bundled files: `facts.csv`, `facts.json`, `requirements.csv`
data = prep2go_exam_facts.load()  # parsed facts.json
rows = prep2go_exam_facts.records()
prep2go_exam_facts.get("ciple-a2")
prep2go_exam_facts.load("facts.csv")  # CSV as list of dicts
```

## Licence

- Code: MIT (see `LICENSE`).
- Data: Creative Commons Attribution 4.0 International (CC BY 4.0) (see `LICENSE-DATA`). Attribution: "prep2go-exam-facts by Prep2Go (https://www.prep2go.study)".

## Citation

Please cite the dataset DOI: https://doi.org/10.5281/zenodo.23322073
