Skip to main content

slack-objects

A focused Python package for working with Slack objects commonly used in administration and automation workflows.

slack-objects provides opinionated, testable wrappers around the Slack Web API, Admin API, and SCIM API—favoring object-based access over raw endpoint calls.


Supported Slack Objects

The following Slack object types are supported:

  • Users
  • Conversations (e.g, channels)
  • Messages
  • Files
  • Workspaces
  • IDP Groups (SCIM - e.g., Okta groups)

Overview

slack-objects is designed for:

  • Slack administration automation
  • Identity and access management (IAM) workflows
  • Internal tooling and bots
  • Auditing and cleanup scripts

This package is not a replacement for slack_sdk. Instead, it focuses on higher-level object operations that typically require:

  • multiple API calls
  • pagination
  • rate limiting
  • Admin API or SCIM usage
  • non-trivial orchestration logic

Design Highlights

Factory-based API

All object helpers are created from a single entry point:

from slack_objects.client import SlackObjectsClient

slack = SlackObjectsClient(cfg)

users = slack.users()
alice = slack.users("U123")

conversations = slack.conversations()
general = slack.conversations("C123")

This avoids global state while keeping usage concise and consistent.


Explicit token model

Slack APIs have different authorization requirements. This package keeps tokens explicit and separate:

Token Used for
bot_token Slack Web API (most read/write operations)
user_token Slack Admin API
scim_token Slack SCIM API (IdP / provisioning)

Tokens are optional in configuration, but required by methods that need them. Errors are raised at call time with clear messages.


Strict method boundaries

Each object follows a consistent internal structure:

public method
    → wrapper method
        → SlackApiCaller / SCIM request

Keyword-only APIs

Methods with multiple optional parameters use keyword-only arguments to avoid ambiguity and future breaking changes.


Testability

The codebase is designed to be tested without hitting Slack.


Installation

pip install slack-objects

Configuration

from slack_objects.config import SlackObjectsConfig, RateTier

cfg = SlackObjectsConfig(
    bot_token="xoxb-...",
    user_token="xoxp-...",
    scim_token="xoxp-...",
    default_rate_tier=RateTier.TIER_3,
)

Testing

Run all smoke tests:

python -m tests.run_all_smoke

Notes

  • SCIM v1 is the default; v2 is supported where applicable
  • Guest expiration dates use PC_Utils.Datetime if installed
  • This package is intended for automation and administration workflows

Metadata

Release files for slack-objects 0.0.post34

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for slack-objects 0.0.post34
File Size Uploaded Provenance Actions
slack_objects-0.0.post34.tar.gz 115.9 kB Without provenance Details for slack_objects-0.0.post34.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for slack-objects 0.0.post34
File Interpreter ABI Platform Actions
slack_objects-0.0.post34-py3-none-any.whl Python 3 none any Details for slack_objects-0.0.post34-py3-none-any.whl

Total release size: 146.2 kB

Release files / slack_objects-0.0.post34.tar.gz

Download URL slack_objects-0.0.post34.tar.gz
Size 115.9 kB
Tags Source
SHA-256 checksum
How to use checksums
820135ace2a1e39b323027123814c4e1433b8e38eb163694ac65f3f7d291e4f9
BLAKE2b-256 checksum
How to use checksums
d959d9f65708306c88ee5ec979f9bd33f74fcf61c91a707151003692bf723015
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.2

Release files / slack_objects-0.0.post34-py3-none-any.whl

Download URL slack_objects-0.0.post34-py3-none-any.whl
Size 30.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
32096d0befd5efbea01e311b22536201c99b06178b9a52a248d6db2843980f65
BLAKE2b-256 checksum
How to use checksums
db3f6f081c872a4e1ac134dd90fe42c2575ecf343e3e2557a3e0e561b4bb80dd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.2

Security for slack-objects 0.0.post34

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page