librestats 0.1.0

A Python library for accessing open and community-curated datasets

librestats

A Python library for accessing open and community-curated datasets enabling data scientists, researchers and students to load, analyze and visualize reliable data in just a few lines of code.

Installation

pip install librestats

Quick Start

import librestats as ls

# 1. List available domains
print(ls.list_domains())  
# ➝ ['awards', 'economy', 'sports']

# 2. List datasets inside a domain
print(ls.list_datasets("awards"))  
# ➝ ['fields_medal_winners_data', 'nobel_prize']

# 3. Load a dataset in a DataFrame (df)
df = ls.load_dataset("awards", "fields_medal_winners_data")

# 4. Access data from a DataFrame (df)
ls.get(df,"Belgium","1978")

Dataset Organization

Datasets are stored in structured domains making it easy to browse, extend and contribute!

datasets/
├── awards/
│   ├── fields_medal.csv
│   ├── nobel_prize.csv
|   ...
├── economy/
│   ├── gdp.csv
│   ├── inflation.csv
|   ...
├── sports/
│   ├── olympics.csv
│   ├── world_cup.csv
|   ...
...

With LibreStats, open data becomes more accessible, powerful and fun!
We welcome dataset contributions and feature ideas!