Skip to main content

No project description provided

Project description

Parsons

Downloads PyPI - Python Version PyPI CircleCI Coverage badge

A Python package that provides a simple interface to a variety of utilities and tools frequently used by progressive organizations, political and issue campaigns, activists, and other allied actors.

Parsons offers simplified interactions with these services and tools, including a growing number of CRMs, organizing tools, cloud compute service providers, as well as tools to easily transform data in transit.

This project is maintained by The Movement Cooperative and is named after Lucy Parsons. The Movement Cooperative is a member-led organization focused on providing data, tools, and strategic support for the progressive community.

Parsons is only supported for Python 3.9-13.

Table of Contents

License and Usage

Usage of Parsons is governed by a modified Apache License with author attribution statement.

Documentation

To gain a full understanding of all of the features of Parsons, please review the Parsons documentation.

Installation

PYPI

You can install the most recent release by running: pip install parsons[all]

Install from Github

To access the most recent code base that may contain features not yet included in the latest release, download this repository and then run python -m pip install git+https://github.com/move-coop/parsons.git.

Docker Container

We have a Parsons Docker container hosted on DockerHub for each release of Parsons, including the latest.

Quickstart

For this Quickstart, we are looking to generate a list of voters with cell phones using a dummy data file. We use the assert statements to verify that the data has been loaded correctly.

# Download the Census data from the Parsons GitHub repository
from parsons import GitHub

github = GitHub()
dummy_data = github.download_table('move-coop/parsons', 'docs/quickstart.csv')
assert dummy_data.num_rows == 1000  # Check that we got all 1,000 people

# Filter down to people with cell phones
people_with_cell_phones = dummy_data.select_rows(lambda row: row['is_cell'] == 'true')
assert people_with_cell_phones.num_rows == 498  # Check that we filtered down to our 498 people

# Extract only the columns we need (first name, last name, phone number)
people_with_cell_phones = people_with_cell_phones.cut('first_name', 'last_name', 'phone_number')
assert people_with_cell_phones.columns == ['first_name', 'last_name', 'phone_number']  # Check columns

# Output the list to a local CSV file
filename = people_with_cell_phones.to_csv()  # filename will be the path to the local CSV file

# In order to upload data to a Google Sheet, you will need to set the GOOGLE_DRIVE_CREDENTIALS
# environment variable
from parsons import GoogleSheets

sheets = GoogleSheets()
sheet_id = sheets.create_spreadsheet('Voter Cell Phones')
sheets.append_to_sheet(sheet_id, people_with_cell_phones)

Community

We hope to foster a strong and robust community of individuals who use and contribute to further development. Individuals are encouraged to submit issues with bugs, suggestions and feature requests. Here are the guidelines and best practices for contributing to Parsons.

You can also stay up to date by joining the Parsons Slack group, an active community of Parsons contributors and progressive data engineers. For an invite, just reach out to engineering+parsons@movementcooperative.org!

Project details


Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

parsons-5.0.0-py3-none-any.whl (516.4 kB view details)

Uploaded Python 3

File details

Details for the file parsons-5.0.0-py3-none-any.whl.

File metadata

  • Download URL: parsons-5.0.0-py3-none-any.whl
  • Upload date:
  • Size: 516.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.4

File hashes

Hashes for parsons-5.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0b7d91c8be8d420bf7849bac484994b26e7c470e39accad9341eb9bf5f2a3d2a
MD5 8c899da4f030ea1c2bb38f49fed3d7de
BLAKE2b-256 adefa0da7052a25d8849f1ad829b8040906ef7e905042d5c67cc18d0c5d943d7

See more details on using hashes here.

Supported by

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