Skip to main content

A Python module to access Slack's API from user-space, to circumvent all the artificial API limitations put in by greedy Salesforce. 🤑

Project description

slackish

A Python module to access Slack's API from user-space, to circumvent all the artificial API limitations put in by greedy Salesforce. 🤑

Why slackish?

While there exists an official Slack client for Python, Salesforce has introduced arbitrary restrictions on which API calls can be made based on different plans. This puts developers in a challenging position, as there's uncertainty regarding which API calls can be relied upon when building applications for others. slackish aims to provide a more reliable, robust, and less selective base for developers to build upon.

For example, invites.py shows you how to retrieve the list of invitations for your workspace, a feature that is only available to the API for Enterprise Grid customers.

Installation

pip install slackish

Usage

Here's a basic example of how to use slackish:

import slackish

session = slackish.login_slack(
    workspace="YOUR_WORKSPACE_NAME_OR_URL",
    email="YOUR_EMAIL",
    password="YOUR_PASSWORD"
)

print("Slack workspace: ", session.workspace)
print("Slack cookie:    ", session.auth_cookie)
print("Slack token:     ", session.auth_token)

Replace YOUR_WORKSPACE_NAME_OR_URL, YOUR_EMAIL, and YOUR_PASSWORD with your actual credentials.

Features

  • Bypass Salesforce's artificial API limitations.
  • Reliable and consistent access to Slack's API.
  • User-friendly interface for easy integration.

Contributing

We welcome contributions! Please check out our GitHub repository for more details.

The next milestone is to wrap the functionality in a sub-class requests.Session() that automatically injects the authentication cookie/token when appropriate.

Disclaimer

Please ensure you're adhering to Slack's Terms of Service when using this package. The maintainers of slackish are not responsible for any misuse or violation of terms.

License

This project is licensed under The Unlicense. It means you can do anything you want with this, for whatever purposes, you don't have to credit me, this project, or anything.

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

slackish-0.4.0.tar.gz (5.2 kB view hashes)

Uploaded Source

Built Distribution

slackish-0.4.0-py3-none-any.whl (6.5 kB view hashes)

Uploaded Python 3

Supported by

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