edf.assess()
Compute a structured data-quality assessment for a dataset.
Signature
edf.assess(dataset) -> AssessmentReportCompute a structured data-quality assessment for a dataset.
Description
Measures completeness, uniqueness and the package's quality dimensions for a supported file or pandas DataFrame. The returned AssessmentReport includes dataset information, recommendations, validations and export helpers for HTML, JSON, Markdown, CSV, Excel and PDF.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
| dataset | str | pathlib.Path | pandas.DataFrame | — | A pandas DataFrame or path to a supported CSV or Excel dataset. |
Returns
AssessmentReport — Structured dataset information, completeness and uniqueness metrics, quality scores, recommendations and validations.
Raises
FileNotFoundError— the supplied path does not exist.ValueError— the supplied file type is not supported.
Examples
Assess a CSV file
assess_example.py
python
import eazydatafix as edf
report = edf.assess("employees.csv")
print(report.dataset_info.rows, report.dataset_info.columns)
print(report.completeness.total_missing_values)
print(report.uniqueness.duplicate_rows)
print(report.quality.score, report.quality.grade)Python 3.11— Expected output
>>> report = edf.assess("employees.csv")>>> report.dataset_info.rows, report.dataset_info.columns(12, 8)>>> report.completeness.total_missing_values5>>> report.quality.score82.76Export the report
Notes
- assess() never mutates its input; call fix() to obtain a cleaned copy.
- The quality score is available at report.quality.score, not report.quality_score.
Best Practices
- Run assess() before and after controlled cleaning to measure the effect.
- Use a report export method when you need a durable CI or audit artefact.