A lightweight Python library to access structured information about Malawi's districts, agriculture, currency exchange rates, health facilities, and demographics.
# mw_info
A lightweight Python library to access structured information about Malawi’s districts, agriculture, currency exchange rates, health facilities, and demographics.
---
## Features
### District-level insights
Region, coordinates, population, climate, timezone, elevation, and more
### Currency conversion
Convert between MWK and major currencies (USD, EUR, ZAR, etc.)
### Agricultural info
Query crops and fish species using Chichewa, English, or scientific name
### Health data
Get health facility counts (hospitals, clinics, health posts) by district
### Demographics
Population totals, gender ratios, age distribution, and urban/rural splits
---
## Installation
```bash
pip install mw-info
```
## Usage
## DistrictInfo Class, Methods & Examples
### get_all_districts()
```
from mw_info.districts import DistrictInfo
districts = DistrictInfo()
all_districts = districts.get_all_districts()
print(all_districts)
# Output: ['Lilongwe', 'Blantyre', 'Machinga', ...]
```
### get_district_info(district_name, fields=None)
```
from mw_info.districts import DistrictInfo
districts = DistrictInfo()
### Full info for Lilongwe
info = districts.get_district_info("Lilongwe")
print(info)
### Selected fields only
selected = districts.get_district_info("Mangochi", fields=["population_2023", "languages", "climate"])
print(selected)
```
### filter_by_region(region_name)
Returns list of district dictionaries for districts in a given region.
```
districts = DistrictInfo()
southern_districts = districts.filter_by_region("Southern")
for d in southern_districts:
print(d["district"])
### Outputs districts in Southern region
```
### get_all_district_data()
Returns the full raw list of all district dictionaries.
```
districts = DistrictInfo()
all_data = districts.get_all_district_data()
print(all_data[0]) # Print first district data
```
## CurrencyConverter Class, Methods & Examples
### available_currencies()
Returns list of supported currency codes.
```
print(c …