fedwrap

A Python package providing convenient wrappers for accessing and working with US federal datasets, including the American Community Survey and CDC PLACES.

Table of Contents

• fedwrap
  • Table of Contents
  • Overview
  • Features
  • Installation
  • Quick Start
  • Widget
  • Modules
  • Dependencies
  • License
  • Contact

Overview

fedwrap simplifies access to federal datasets by providing Pythonic wrappers for public APIs and data downloads. The package is designed for researchers, analysts, and developers who need streamlined access to high-value US government data.

Features

• Easy access to the American Community Survey (ACS) and the CDC PLACES dataset
• Data returned as pandas DataFrames for easy analysis

Installation

pip install fedwrap

Quick Start

from fedwrap import get_acs_data, get_places_data, get_brfss_data

# Example: Fetch ACS data
acs_df = get_acs_data(
    measureid="HOUSEHOLD_TYPE", 
    year=2022, 
    geography="county"
)

# Example: Fetch CDC PLACES data
places_df = get_places_data(
    geo='county',
    year='2022',
    measureid='ARTHRITIS',
    datavaluetypid='CrdPrv'
)

# Example: Fetch BRFSS data
brfss_df = get_brfss_data(geo="state",
            measure="crude",
            year=2023,
            question_id="CHECKUP1",
            break_out_category="Sex")

Widget

To browse data using a widget with dropdown menus

from fedwrap.widget import display_explorer

display_explorer()

Modules

• census_acs provides functions for accessing data from the American Community Survey API
• cdc_places provides functions for accessing data from the CDC PLACES dataset
• cdc_brfss provides functions for accessing data from the CDC BRFSS dataset

Dependencies

• pandas
• requests
• beautifulsoup4

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contact

For any questions or suggestions, open an issue or contact Mark Aronson.