https://github.com/jlumbroso/slackish
A Python module to access Slack's API from user-space, to circumvent all the artificial API limitations put in by greedy Salesforce. 🤑
https://github.com/jlumbroso/slackish
slack-api slack-invite
Last synced: 4 months ago
JSON representation
A Python module to access Slack's API from user-space, to circumvent all the artificial API limitations put in by greedy Salesforce. 🤑
- Host: GitHub
- URL: https://github.com/jlumbroso/slackish
- Owner: jlumbroso
- License: unlicense
- Created: 2023-10-14T18:06:50.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-10-14T22:05:05.000Z (about 2 years ago)
- Last Synced: 2025-05-29T11:14:42.435Z (5 months ago)
- Topics: slack-api, slack-invite
- Language: Python
- Homepage: https://pypi.org/project/slackish/
- Size: 33.2 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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
```bash
pip install slackish
```
## Usage
Here's a basic example of how to use `slackish`:
```python
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](https://github.com/jlumbroso/slackish) 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](https://unlicense.org/).
It means you can do anything you want with this, for whatever purposes, you don't
have to credit me, this project, or anything.