Metadata-Version: 2.4
Name: parsons
Version: 6.1.0
Summary: A python library of connectors for the progressive community.
Author-email: The Movement Cooperative <info@movementcooperative.org>
Maintainer: Shauna Gordon-McKeon
Project-URL: homepage, https://www.parsonsproject.org/
Project-URL: documentation, https://move-coop.github.io/parsons/html/stable/index.html
Project-URL: releasenotes, https://github.com/move-coop/parsons/releases
Project-URL: funding, https://secure.actblue.com/donate/parsonsproject?refcode=parsonswebsite
Project-URL: issues, https://github.com/move-coop/parsons/issues
Project-URL: github, https://github.com/move-coop/parsons
Project-URL: repository, https://github.com/move-coop/parsons.git
Keywords: PROGRESSIVE,API,ETL
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: petl>=1.7.17
Requires-Dist: python-dateutil>=2.0
Requires-Dist: requests>=2.0
Requires-Dist: requests-oauthlib>=1.0
Requires-Dist: simplejson>=3.18
Provides-Extra: airtable
Requires-Dist: pyairtable>=3.0; extra == "airtable"
Provides-Extra: alchemer
Requires-Dist: surveygizmo>=1.0; extra == "alchemer"
Provides-Extra: avro
Requires-Dist: fastavro>=1.12; extra == "avro"
Provides-Extra: azure
Requires-Dist: azure-storage-blob>=12.0; extra == "azure"
Provides-Extra: box
Requires-Dist: boxsdk[jwt]>=4.0; extra == "box"
Requires-Dist: requests-toolbelt>=1.0; extra == "box"
Provides-Extra: braintree
Requires-Dist: braintree>=4.0; extra == "braintree"
Provides-Extra: catalist
Requires-Dist: paramiko>=3.0; extra == "catalist"
Provides-Extra: civis
Requires-Dist: civis>=2.0; extra == "civis"
Provides-Extra: dbt-duckdb
Requires-Dist: dbt-duckdb>=1.8; extra == "dbt-duckdb"
Requires-Dist: dbt-core>=1.8; python_version < "3.14" and extra == "dbt-duckdb"
Requires-Dist: dbt-core>=1.12; python_version >= "3.14" and extra == "dbt-duckdb"
Requires-Dist: rich>=14.0; extra == "dbt-duckdb"
Provides-Extra: dbt-redshift
Requires-Dist: dbt-redshift>=1.8; extra == "dbt-redshift"
Requires-Dist: dbt-core>=1.8; python_version < "3.14" and extra == "dbt-redshift"
Requires-Dist: dbt-core>=1.12; python_version >= "3.14" and extra == "dbt-redshift"
Requires-Dist: lxml>=6.0.1; extra == "dbt-redshift"
Requires-Dist: rich>=14.0; extra == "dbt-redshift"
Provides-Extra: dbt-bigquery
Requires-Dist: dbt-bigquery>=1.8; extra == "dbt-bigquery"
Requires-Dist: dbt-core>=1.8; python_version < "3.14" and extra == "dbt-bigquery"
Requires-Dist: dbt-core>=1.12; python_version >= "3.14" and extra == "dbt-bigquery"
Requires-Dist: rich>=14.0; extra == "dbt-bigquery"
Provides-Extra: dbt-postgres
Requires-Dist: dbt-postgres>=1.8; extra == "dbt-postgres"
Requires-Dist: dbt-core>=1.8; python_version < "3.14" and extra == "dbt-postgres"
Requires-Dist: dbt-core>=1.12; python_version >= "3.14" and extra == "dbt-postgres"
Requires-Dist: rich>=14.0; extra == "dbt-postgres"
Provides-Extra: dbt-snowflake
Requires-Dist: dbt-snowflake>=1.8; extra == "dbt-snowflake"
Requires-Dist: dbt-core>=1.8; python_version < "3.14" and extra == "dbt-snowflake"
Requires-Dist: dbt-core>=1.12; python_version >= "3.14" and extra == "dbt-snowflake"
Requires-Dist: rich>=14.0; extra == "dbt-snowflake"
Provides-Extra: facebook
Requires-Dist: joblib>=1.0; extra == "facebook"
Requires-Dist: facebook-business>=20.0; extra == "facebook"
Provides-Extra: geocode
Requires-Dist: censusgeocode>=0.5; extra == "geocode"
Requires-Dist: urllib3>=2.6.3; extra == "geocode"
Provides-Extra: github
Requires-Dist: PyGitHub>=2.0; extra == "github"
Provides-Extra: google
Requires-Dist: apiclient>=1.0.4; extra == "google"
Requires-Dist: email-validator>=2.2; extra == "google"
Requires-Dist: google-api-python-client>=2.150; extra == "google"
Requires-Dist: google-cloud-bigquery>=3.35; extra == "google"
Requires-Dist: google-cloud-storage>=3.1; extra == "google"
Requires-Dist: google-cloud-storage-transfer>=1.12; extra == "google"
Requires-Dist: gspread>=4.0; extra == "google"
Requires-Dist: httplib2>=0.15; extra == "google"
Requires-Dist: oauth2client>=4.0; extra == "google"
Requires-Dist: protobuf>=6.0; extra == "google"
Provides-Extra: mysql
Requires-Dist: mysql-connector-python!=9.7.0,>=7.0; extra == "mysql"
Requires-Dist: sqlalchemy>=1.4; extra == "mysql"
Provides-Extra: newmode
Requires-Dist: newmode>=0.1.6; extra == "newmode"
Provides-Extra: ngpvan
Requires-Dist: suds>=1; extra == "ngpvan"
Provides-Extra: mobilecommons
Requires-Dist: beautifulsoup4>=4.0; extra == "mobilecommons"
Requires-Dist: xmltodict>=1.0; extra == "mobilecommons"
Provides-Extra: pandas
Requires-Dist: pandas>=2.3; extra == "pandas"
Provides-Extra: postgres
Requires-Dist: psycopg2-binary>=2.9.11; extra == "postgres"
Requires-Dist: sqlalchemy>=1.4; extra == "postgres"
Provides-Extra: redshift
Requires-Dist: boto3>=1.0; extra == "redshift"
Requires-Dist: psycopg2-binary>=2.9.11; extra == "redshift"
Requires-Dist: sqlalchemy>=1.4; extra == "redshift"
Provides-Extra: s3
Requires-Dist: boto3>=1.0; extra == "s3"
Provides-Extra: salesforce
Requires-Dist: simple-salesforce>=1.0; extra == "salesforce"
Provides-Extra: scytl
Requires-Dist: defusedxml>=0.7; extra == "scytl"
Provides-Extra: sftp
Requires-Dist: paramiko>=3.0; extra == "sftp"
Provides-Extra: slack
Requires-Dist: slack-sdk>=3.26; extra == "slack"
Provides-Extra: smtp
Requires-Dist: email-validator>=2.2; extra == "smtp"
Provides-Extra: targetsmart
Requires-Dist: defusedxml>=0.7; extra == "targetsmart"
Requires-Dist: paramiko>=3.0; extra == "targetsmart"
Requires-Dist: xmltodict>=1.0; extra == "targetsmart"
Provides-Extra: twilio
Requires-Dist: twilio>=9.0; extra == "twilio"
Provides-Extra: ssh
Requires-Dist: sshtunnel>=0.4; extra == "ssh"
Requires-Dist: psycopg2-binary>=2.9.11; extra == "ssh"
Requires-Dist: sqlalchemy>=1.4; extra == "ssh"
Provides-Extra: all
Requires-Dist: parsons[airtable]; extra == "all"
Requires-Dist: parsons[alchemer]; extra == "all"
Requires-Dist: parsons[avro]; extra == "all"
Requires-Dist: parsons[azure]; extra == "all"
Requires-Dist: parsons[box]; extra == "all"
Requires-Dist: parsons[braintree]; extra == "all"
Requires-Dist: parsons[catalist]; extra == "all"
Requires-Dist: parsons[civis]; extra == "all"
Requires-Dist: parsons[dbt-duckdb]; extra == "all"
Requires-Dist: parsons[dbt-redshift]; extra == "all"
Requires-Dist: parsons[dbt-bigquery]; extra == "all"
Requires-Dist: parsons[dbt-postgres]; extra == "all"
Requires-Dist: parsons[dbt-snowflake]; extra == "all"
Requires-Dist: parsons[facebook]; extra == "all"
Requires-Dist: parsons[geocode]; extra == "all"
Requires-Dist: parsons[github]; extra == "all"
Requires-Dist: parsons[google]; extra == "all"
Requires-Dist: parsons[mysql]; extra == "all"
Requires-Dist: parsons[newmode]; extra == "all"
Requires-Dist: parsons[ngpvan]; extra == "all"
Requires-Dist: parsons[mobilecommons]; extra == "all"
Requires-Dist: parsons[pandas]; extra == "all"
Requires-Dist: parsons[postgres]; extra == "all"
Requires-Dist: parsons[redshift]; extra == "all"
Requires-Dist: parsons[s3]; extra == "all"
Requires-Dist: parsons[salesforce]; extra == "all"
Requires-Dist: parsons[scytl]; extra == "all"
Requires-Dist: parsons[sftp]; extra == "all"
Requires-Dist: parsons[slack]; extra == "all"
Requires-Dist: parsons[smtp]; extra == "all"
Requires-Dist: parsons[targetsmart]; extra == "all"
Requires-Dist: parsons[twilio]; extra == "all"
Requires-Dist: parsons[ssh]; extra == "all"
Dynamic: license-file

# Parsons

[![Documentation - Latest Version](https://img.shields.io/github/v/tag/move-coop/parsons?sort=semver&filter=v*&label=Documentation)](https://move-coop.github.io/parsons/)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/parsons?label=Python)](https://pypi.org/project/parsons/)

[![PyPI - Latest Version](https://img.shields.io/pypi/v/parsons?label=PyPI)](https://pypi.org/project/parsons/)
[![PyPI - Total Downloads](https://static.pepy.tech/personalized-badge/parsons?period=total&units=INTERNATIONAL_SYSTEM&left_color=GREY&right_color=BLUE&left_text=Total+PyPI+Downloads)](https://pepy.tech/projects/parsons)
[![PyPI - Monthly Downloads](https://static.pepy.tech/personalized-badge/parsons?period=monthly&units=INTERNATIONAL_SYSTEM&left_color=GREY&right_color=BLUE&left_text=Monthly+PyPI+Downloads)](https://pepy.tech/projects/parsons)

[![Docker Image Version](https://img.shields.io/docker/v/movementcooperative/parsons?label=Docker)](https://hub.docker.com/r/movementcooperative/parsons)
[![Total Docker Pulls](https://img.shields.io/docker/pulls/movementcooperative/parsons?label=Total%20Docker%20Pulls)](https://hub.docker.com/r/movementcooperative/parsons)

[![Build, Test, & Publish](https://img.shields.io/github/actions/workflow/status/move-coop/parsons/release.yml?branch=main&label=Build%2C%20Test%2C%20%26%20Publish)](https://github.com/move-coop/parsons/actions/workflows/release.yml)
[![Python Checks](https://img.shields.io/github/actions/workflow/status/move-coop/parsons/python-checks.yml?branch=main&label=Python%20Checks)](https://github.com/move-coop/parsons/actions/workflows/python-checks.yml)
[![Coverage](https://raw.githubusercontent.com/move-coop/parsons/python-coverage-comment-action-data/badge.svg)](https://htmlpreview.github.io/?https://github.com/move-coop/parsons/blob/python-coverage-comment-action-data/htmlcov/index.html)

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](https://movementcooperative.org/) and is named
after [Lucy Parsons](https://en.wikipedia.org/wiki/Lucy_Parsons). The Movement Cooperative is a member-led organization
focused on providing data, tools, and strategic support for the progressive community.

## Table of Contents

- [License and Usage](#license-and-usage)
- [Documentation](#documentation)
- [Installation](#installation)
- [Quickstart](#quickstart)
- [Community](#community)

## License and Usage

Usage of Parsons is governed by
a [modified Apache License with author attribution statement](https://github.com/move-coop/parsons/blob/main/LICENSE.md).

## Documentation

To gain a full understanding of all of the features of Parsons, please review the
Parsons [documentation](https://move-coop.github.io/parsons/).

## 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](https://hub.docker.com/r/movementcooperative/parsons) 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](docs/quickstart.csv). We use the `assert` statements to verify that the data has been loaded
correctly.

```python
# 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](https://github.com/move-coop/parsons/blob/main/CONTRIBUTING.md) 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!
