Skip to main content

A library of API wrappers for US Federal Government datasets.

Project description

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


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")

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fedwrap-1.0.0.tar.gz (28.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fedwrap-1.0.0-py3-none-any.whl (30.8 kB view details)

Uploaded Python 3

File details

Details for the file fedwrap-1.0.0.tar.gz.

File metadata

  • Download URL: fedwrap-1.0.0.tar.gz
  • Upload date:
  • Size: 28.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for fedwrap-1.0.0.tar.gz
Algorithm Hash digest
SHA256 ec20c7cb7c1649f62cf85972564107e9b8a74e311beb2e3d290a0e87faf6cf05
MD5 caf162ac9a07fc93686b1b3915fe8804
BLAKE2b-256 6a65d8548e9a6538374d18befe65f3d0a37c7e087636c4488a5a88246cbecdd8

See more details on using hashes here.

File details

Details for the file fedwrap-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: fedwrap-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 30.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for fedwrap-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 313c2884506d68975dd07d5666e9fb7a5128f1708918625ac6b2817030786387
MD5 66a4504c0d8b1436104aa86212321c5e
BLAKE2b-256 5889551f02e08cbe00d74ec9dbbf68f3f80d1b9c00ca3682c9d716b006c4f07c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page