semvec/pypi-packages huggingface dataset:
gmail-message-processor 0.1.3
A module for processing Gmail messages.

# Gmail Message Processor

The `gmail_message_processor` module is an essential part of the Gmail Label Email Processor toolkit, designed to fetch and process emails from Gmail based on specified labels. It leverages the Gmail API to retrieve email messages, enabling users to filter, extract, and process email data efficiently.

## Features

- Fetch emails from Gmail by label.
- Process email messages to extract specific data such as 'To', 'Cc', 'Bcc', and email content.
- Seamlessly integrates with the Gmail API Authentication and Label Management modules for comprehensive email handling.

## Installation

Make sure you have Python 3.6 or higher installed. This module is a component of the Gmail Label Email Processor toolkit.

Proceed to install the necessary dependencies for the project.


## Prerequisites

Before utilizing the gmail_message_processor, ensure that you have completed the authentication setup with gmail_api_auth.py and have identified the specific Gmail labels of interest using gmail_label_manager.py.

## Usage

The gmail_message_processor module is designed to be used in conjunction with other components of the toolkit. Here's a basic usage example:

```bash
from gmail_message_processor import fetch_emails_by_label

# Specify the label name you're interested in
label_name = "YOUR_LABEL_NAME_HERE"

# Fetch and process emails by the specified label
processed_emails = fetch_emails_by_label(label_name)

# Continue with further processing or exporting

Replace "YOUR_LABEL_NAME_HERE" with the actual label you wish to process.
```

## Contributing

Contributions to enhance the gmail_message_processor or any aspect of the Gmail Label Email Processor toolkit are highly appreciated. 

## License

This project is licensed under the MIT License - see the LICENSE for details.
gmail-label-email-processor 1.0.3
A comprehensive toolkit for processing emails via Gmail API, including authentication, label management, message processing, and data exporting.
Requires Python: >=3.6

# Gmail Label Email Processor

The Gmail Label Email Processor is a Python toolkit designed to automate the process of managing and processing emails through the Gmail API. This tool facilitates the fetching of emails based on specific labels, extraction of email addresses from these emails, and exporting the processed data into a CSV file for further analysis or use. Ideal for individuals and businesses looking to enhance their email management and data extraction workflows.

## Features

- Authenticate with the Gmail API securely.
- Fetch emails by user-defined labels.
- Extract 'To', 'Cc', and 'Bcc' email addresses from emails.
- Export extracted email addresses to a CSV file.
- Simplify the automation of email processing tasks.

## Prerequisites

Before you begin, ensure you have met the following requirements:

- Python 3.6 or higher installed on your machine.
- Access to a Google Cloud Platform account with the Gmail API enabled.
- A `credentials.json` file obtained from the Google Developer Console for your Gmail API project.

## Installation

# From GitHub

Clone and install dependencies:

```bash
git clone https://github.com/SokinjoNS/gmail-label-email-processor.git
cd gmail-label-email-processor
pip install -r requirements.txt
```

# From PyPI

Install directly:

```bash
pip install gmail-label-email-processor
```

## Usage

After installation, configure credentials.json in the project's root and modify main.py or use the command-line interface:

```bash
gmail-processor --label "Your Label Name"
```
Replace "Your Label Name" with the actual label you're interested in.

Place your credentials.json file in the root directory of the project.

## Contributing

Contributions are welcome.

## License
This project is licensed under the MIT License - see the LICENSE file for details.
gmail-label-manager 0.1.3
A module for managing Gmail labels.

# Gmail Label Manager

The `gmail_label_manager` module is a crucial component of the Gmail Label Email Processor toolkit, designed to interact with Gmail labels. It allows for fetching the ID of specific Gmail labels, enabling precise control and filtering of emails for processing based on label criteria.

## Features

- Retrieve the ID of a specific Gmail label.
- Supports integration with Gmail API to manage and utilize labels for email processing tasks.

## Installation

This module is part of the Gmail Label Email Processor toolkit. To use it, ensure you have Python 3.6 or higher installed.

```bash
git clone https://github.com/yourusername/gmail-label-email-processor.git
cd gmail-label-email-processor


## Prerequisites

Before using the gmail_label_manager, you must have completed the authentication setup provided by gmail_api_auth.py, including obtaining a credentials.json file from the Google Developer Console and ensuring it is placed in the project root.

## Usage

The gmail_label_manager module can be used to fetch label IDs as part of email processing workflows. Here's a simple example:

```bash
from gmail_label_manager import get_label_id_by_name

# Fetch the ID of a specific label
label_id = get_label_id_by_name("YOUR_LABEL_NAME_HERE")

if label_id:
    print(f"Label ID for 'YOUR_LABEL_NAME_HERE': {label_id}")
else:
    print("Label not found.")

Replace "YOUR_LABEL_NAME_HERE" with the actual name of the Gmail label you wish to manage.
```

## Contributing

Contributions to the gmail_label_manager or any other component of the Gmail Label Email Processor toolkit are welcome.

## License

This project is licensed under the MIT License - see the LICENSE file for details.
data-exporter 0.1.3
A module for exporting email data to CSV format.

# Data Exporter for Gmail Label Email Processor

The `data_exporter` module is a key component of the Gmail Label Email Processor toolkit, designed to export processed email data into a CSV file. It provides a straightforward and efficient way to save extracted email addresses and other relevant data, making it ideal for further analysis or integration with other tools.

## Features

- Export extracted email addresses to a CSV file.
- Simple interface for specifying output file paths.
- Integrates seamlessly with the Gmail Message Processor to handle large datasets.

## Installation

Before using the `data_exporter`, ensure you have Python 3.6 or later installed on your system. Since `data_exporter` is part of the Gmail Label Email Processor toolkit, you should clone the entire repository to get started:

```bash
git clone https://github.com/yourusername/gmail-label-email-processor.git
cd gmail-label-email-processor
```

No additional Python packages are required specifically for data_exporter, but ensure all dependencies for the Gmail Label Email Processor toolkit are installed.


## Usage

To use the data_exporter module, import it into your Python script where you're processing Gmail data. Here's a simple example that demonstrates how to export a list of email addresses:

```bash
from data_exporter import export_emails_to_csv

# Example list of email addresses
email_addresses = ['example1@example.com', 'example2@example.com']

# Specify the output CSV file path
output_file_path = 'exported_emails.csv'

# Export the email addresses
export_emails_to_csv(email_addresses, output_file_path)

print(f'Email addresses have been exported to {output_file_path}')
```

Replace the email_addresses list with your actual data processed through the Gmail Label Email Processor toolkit.

## Contributing

Contributions to improve the data_exporter or any other part of the Gmail Label Email Processor are welcome.

## License

This project is licensed under the MIT License - see the LICENSE file for details.
gmail-api-auth 0.1.3
A module for authenticating Gmail API access.

# Gmail API Authentication Module

The `gmail_api_auth` module serves as the foundation of the Gmail Label Email Processor toolkit, providing secure authentication with the Gmail API. This module handles the OAuth2 flow, allowing other components of the toolkit to access and manipulate Gmail data under user consent.

## Features

- Implements OAuth2 authentication flow for Gmail API.
- Securely manages tokens, including token refresh.
- Facilitates seamless integration with Gmail API for email processing tasks.

## Installation

Ensure you have Python 3.6 or later installed on your system. This module is part of the Gmail Label Email Processor toolkit,

## Setup

Before using the gmail_api_auth module, you need to create a project in the Google Developer Console, enable the Gmail API, and obtain your credentials.json file. Follow these steps:

Visit the Google Developer Console.
Create a new project.
Search for the Gmail API and enable it.
Go to the Credentials page, create OAuth client ID credentials, and download the credentials.json file.
Place the credentials.json file in the root directory of the cloned repository.

## Usage

The gmail_api_auth module is used internally by other components of the Gmail Label Email Processor toolkit. However, you can directly utilize it for testing or extending the toolkit:

```bash
from gmail_api_auth import authenticate_gmail_api

# Authenticate and get the Gmail API service object
service = authenticate_gmail_api()

# Now you can use the service object to make Gmail API calls
```

## Contributing

Contributions to the Gmail API Authentication Module or any part of the Gmail Label Email Processor toolkit are welcome. 

## License

This project is licensed under the MIT License - see the LICENSE file for details.