Skip to main content

A python library for making Excel files from FEC filings

Project description

Microsoft Excel can be a powerful tool for analyzing FEC filings. This library (hopefully) makes it easy to create multi-sheet Excel files from files in the .fec file format, with a sheet for the summary data and a sheet for each type of itemization.


Note: this library works best with version 3.7+ of Python due to the ordering of dictionary keys being guaranteed to be in insertion order. The library should still work in older version of Python, but the columns on each sheet might be in a nonsensical order.

First, install from PyPi:

pip install fec2xlsx

Then, call one of the two methods for generating Excel files:

import fec2xlsx

fec2xlsx.file_number_xlsx(1326061, 'Gillibrand_Q1.xlsx')

fec2xlsx.file_location_xlsx('/path/to/1326016.fec', 'Harris_Q1.xlsx')

The file_number_xlsx method requests the specified file_number via http from the FEC's server's, first trying the URL for digital filings, then trying the URL for paper filings if the first response returns a 404 status code.

The file_location_xlsx method reads from the specified file_path (which takes anything you might pass to Python's open method) then writes to the specified filename output.

Both methods take an optional options keyword argument.


  • filter_memo_x: (default: True) if True, ignores rows that have "X" as their memo_code. If, for example, a contribution comes in through a conduit committee like ActBlue, there are two rows: one for the contribution from an individual to the conduit and one from the conduit to the committee filing the report. Generally the second of those rows is marked with an "X" in the memo_code field and is the less useful of the two.

  • money_format: (default: $#,##0.00) The format used for displaying monetary values. See here for more details/documentation.

  • date_format: (default: d mmm yyyy) The format used for displaying date values. See here for more details/documentation.

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

fec2xlsx-0.1.2.tar.gz (3.5 kB view hashes)

Uploaded source

Built Distribution

fec2xlsx-0.1.2-py3-none-any.whl (4.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page