edf.assess()

Compute a structured data-quality assessment for a dataset.

Signature
edf.assess(dataset) -> AssessmentReport

Compute 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

NameTypeDefaultDescription
datasetstr | pathlib.Path | pandas.DataFrameA pandas DataFrame or path to a supported CSV or Excel dataset.

Returns

AssessmentReportStructured dataset information, completeness and uniqueness metrics, quality scores, recommendations and validations.

Raises

  • FileNotFoundErrorthe supplied path does not exist.
  • ValueErrorthe supplied file type is not supported.

Examples

Assess a CSV file

assess_example.py
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.11Expected output
>>> report = edf.assess("employees.csv")
>>> report.dataset_info.rows, report.dataset_info.columns
(12, 8)
>>> report.completeness.total_missing_values
5
>>> report.quality.score
82.76

Export the report

assess_example.py
report = edf.assess("employees.csv")
report.to_html("quality.html")
report.to_json("quality.json")

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.

See Also