{"id":16908606,"url":"https://github.com/micolous/python-slackrealtime","last_synced_at":"2025-09-10T07:35:03.804Z","repository":{"id":24516568,"uuid":"27922490","full_name":"micolous/python-slackrealtime","owner":"micolous","description":"Python/Twisted client for the Slack Real-Time Messaging API (RTM)","archived":false,"fork":false,"pushed_at":"2020-09-19T10:02:20.000Z","size":55,"stargazers_count":11,"open_issues_count":0,"forks_count":5,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-25T11:52:15.336Z","etag":null,"topics":["python","slack","twisted"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/micolous.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-12-12T13:57:12.000Z","updated_at":"2020-09-19T10:02:22.000Z","dependencies_parsed_at":"2022-08-22T10:10:15.859Z","dependency_job_id":null,"html_url":"https://github.com/micolous/python-slackrealtime","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/micolous%2Fpython-slackrealtime","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/micolous%2Fpython-slackrealtime/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/micolous%2Fpython-slackrealtime/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/micolous%2Fpython-slackrealtime/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/micolous","download_url":"https://codeload.github.com/micolous/python-slackrealtime/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248433158,"owners_count":21102517,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["python","slack","twisted"],"created_at":"2024-10-13T18:52:09.660Z","updated_at":"2025-04-11T15:42:07.762Z","avatar_url":"https://github.com/micolous.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"``python-slackrealtime``\n========================\n\nPython library for the `Slack Real-Time Messaging API`_.  Requires Python 3, Twisted and Autobahn.\n\nThis library was a work in progress, and probably won't be \"finished\".  I started writing this in\n2014, to migrate some bots from Slack's IRC gateway, when the state of Python bindings for Slack\nwas very poor.  \"One day\" I'll migrate those bots to some other library.\n\n**tl;dr: Please use `python-slackclient`_ instead!**\n\nThe project aims to provide a light wrapping around Slack's API in order to make objects of some of it's constructs, and provide some convenience functionality (such as converting timestamps to fully-fledged ``datetime`` objects).  As such, the API will adapt (to a degree) to Slack RTM API changes.\n\nIt also includes a very thin wrapper around Slack's `REST API`_ (``slackrealtime.api``), for the purposes of setting up the initial connection.\n\nIt is designed primarily to allow writing bots that interact with the Slack API.  I have a `repository with examples available`_.\n\nLGPLv3+ license.\n\nThere **also** exists a Python library written by Slack themselves which doesn't use Twisted, `python-slackclient`_.\n\n.. _Slack Real-Time Messaging API: https://api.slack.com/rtm\n.. _REST API: https://api.slack.com/\n.. _repository with examples available: https://github.com/micolous/slackbots\n.. _python-slackclient: https://github.com/slackhq/python-slackclient\n\n\nInstalling the dev version\n--------------------------\n\nYou'll need to install non-Python dependencies::\n\n  # apt install libffi-dev python-dev build-essential\n\nIn order to install the development version from the git repository::\n\n  $ pip install 'git+https://github.com/micolous/python-slackrealtime.git#egg=slackrealtime'\n\nThis can also be included in a ``requirements.txt`` file like this::\n\n  git+https://github.com/micolous/python-slackrealtime.git#egg=slackrealtime\n\nGetting an API token\n--------------------\n\nThere are three ways to get an API token for this library:\n\n* ``xoxb``: Add a Bots integration to your team, which has some `additional restrictions`_.\n* ``xoxp``: Use the `Legacy Token Generator`_ to create a token for your user, or implement OAuth2 (batteries not included).\n* ``xoxs``: Scrape the Slack Web UI for a variable called ``boot_data.api_token``, which additionally allows you access to the ``users.admin`` family of undocumented methods.\n\n.. _Legacy Token Generator: https://api.slack.com/custom-integrations/legacy-tokens\n.. _additional restrictions: https://api.slack.com/bot-users\n\nThis library does not presently support OAuth or other such authentication mechanisms, only static API tokens.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicolous%2Fpython-slackrealtime","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicolous%2Fpython-slackrealtime","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicolous%2Fpython-slackrealtime/lists"}