Metadata-Version: 2.4
Name: carboncalc
Version: 1.0.0
Summary: Carbon footprint calculator library for small businesses
Author: Mohammed Hassan Ahmed
Author-email: x25120280@student.ncirl.ie
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: requires-python
Dynamic: summary

# CarbonCalc

A Python library for calculating carbon footprints of small businesses. Provides emission factor databases, calculators for different emission categories (electricity, transportation, waste, etc.), and report generation utilities based on the GHG Protocol.

## Installation

```bash
pip install carboncalc
```

## Usage

```python
from carboncalc import CarbonCalculator, EmissionFactorDB, EmissionRecord, EmissionCategory

calc = CarbonCalculator()
record = EmissionRecord(
    category=EmissionCategory.ELECTRICITY,
    quantity=1000,
    unit="kwh",
    date="2026-01-15",
    description="January office electricity"
)
result = calc.calculate_single(record)
print(f"CO2: {result.co2_kg} kg")
```

## Features

- Emission factor database based on EPA/DEFRA data
- Support for 7 emission categories across all 3 GHG Protocol scopes
- Batch calculation and period comparison
- Report generation with recommendations
- Monthly trend analysis and intensity metrics
