==============
webexpythonsdk
==============
*Work with the Webex APIs in native Python!*
.. image:: https://img.shields.io/badge/license-MIT-blue.svg
:target: https://github.com/WebexCommunity/WebexPythonSDK/blob/master/LICENSE
:alt: License MIT
.. image:: https://img.shields.io/pypi/v/webexpythonsdk
:target: https://pypi.org/project/webexpythonsdk/
:alt: PyPI Version
.. image:: https://img.shields.io/pypi/dw/webexpythonsdk?label=webexpythonsdk
:target: https://pypistats.org/packages/webexpythonsdk
:alt: webexpythonsdk PyPI Downloads
.. image:: https://img.shields.io/pypi/dw/webexteamssdk?label=webexteamssdk
:target: https://pypistats.org/packages/webexteamssdk
:alt: webexteamssdk PyPI Downloads
.. image:: https://img.shields.io/github/actions/workflow/status/WebexCommunity/WebexPythonSDK/.github%2Fworkflows%2Fbuild-and-test.yml?label=tests
:target: https://github.com/WebexCommunity/WebexPythonSDK/actions/workflows/build-and-test.yml
:alt: Tests Status
.. image:: https://img.shields.io/github/actions/workflow/status/WebexCommunity/WebexPythonSDK/.github%2Fworkflows%2Fdocs.yml?label=docs
:target: https://webexcommunity.github.io/WebexPythonSDK/
:alt: Documentation Status
---------------------------------------------------------------------------------------------------
Welcome to the new **webexpythonsdk** library! The latest release removes support for Python v2 and
is compatible with Python v3.10+. The new Webex Python SDK replaces the previous `webexteamssdk`_;
and with the exception of the Python version support and the name change, the two libraries are
functionally equivalent. The new library is the recommended choice for new projects, and
webexteamssdk users are encouraged to `migrate`_ to **webexpythonsdk**.
---------------------------------------------------------------------------------------------------
**webexpythonsdk** is a *community developed* Python library for working with the Webex APIs. Our
goal is to make working with Webex in Python a *native* and *natural* experience!
.. code-block:: Python
from webexpythonsdk import WebexAPI
api = WebexAPI()
# Find all rooms that have 'webexpythonsdk Demo' in their title
all_rooms = api.rooms.list()
demo_rooms = [room for room in all_rooms if 'webexpythonsdk Demo' in room.title]
# Delete all of the demo rooms
for room in demo_rooms:
api.rooms.delete(room.id)
# Create a new demo room
demo_room = api.rooms.create('webexpythonsdk Demo')
# Add people to the new demo room
email_addresses = ["test01@cmlccie.com", "test02@cmlccie.com"]
for email in email_addresses:
api.memberships.create(demo_room.id, personEmail=email)
# Post a message to the new room, and upload a file
api.messages.create(demo_room.id, text="Welcome to the room!",
files=["https://www.webex.com/content/dam/wbx/us/images/navigation/CiscoWebex-Logo_white.png"])
That's more than 6 Webex API calls in less than 23 lines of code (with comments and whitespace),
and likely more than that, since webexpythonsdk handles pagination_ for you automatically!
webexpythonsdk makes your life better... `Learn how!`__
__ Introduction_
Features
--------
webexpythonsdk does all of this for you:
* Transparently sources your Webex access token from your local environment
* Provides and uses default arguments and settings everywhere possible, so you don't have to think
about things like API endpoint URLs, HTTP headers and JSON formats
* Represents all Webex API interactions using native Python tools
* Authentication and Connection to the Webex Cloud ==> **WebexAPI** "connection object"
* API Calls ==> Hierarchically organized methods underneath the **WebexAPI** 'Connection Object'
* Returned Data Objects ==> Native Python objects
* **Automatic and transparent pagination!**
* **Automatic rate-limit handling!** *(wait|retry)*
* Multipart encoding and uploading of local files
* Auto-completion in your favorite IDE, descriptive exceptions, and so much more...
Installation
------------
Installing and upgrading webexpythonsdk is easy:
**Install via PIP**
.. code-block:: bash
$ pip install webexpythonsdk
**Upgrade to the latest version**
.. code-block:: bash
$ pip install webexpythonsdk --upgrade
Documentation
-------------
**Excellent documentation is now available at:**
https://webexcommunity.github.io/WebexPythonSDK
Check out the Quickstart_ to dive in and begin using webexpythonsdk.
Examples
--------
Are you looking for some sample scripts? Check out the examples_ folder!
Have a good example script you would like to share? Please feel free to `contribute`__!
__ Contribution_
Release Notes
-------------
Please see the releases_ page for release notes on the incremental functionality and bug fixes
incorporated into the published releases.
Questions, Support & Discussion
-------------------------------
webexpythonsdk is a *community developed* and *community-supported* project. If you experience any
issues using this package, please report them using the issues_ page.
Please join the `Webex Python SDK - Python Community Contributors`__ Webex space to ask questions,
join the discussion, and share your projects and creations.
__ Community_
Contribution
------------
webexpythonsdk is a community development project. Feedback, thoughts, ideas, and code
contributions are welcome! Please see the `Contributing`_ guide for more information.
History
-------
The Webex Python SDK (webexpythonsdk) library started as Cisco Spark API (ciscosparkapi) which
became Webex Teams SDK and then Webex Python SDK (webexpythonsdk). We updated the library's name in
alignment with Cisco's re-brand of Cisco Spark to Webex and then again to align the name with the
broader set of Webex APIs accessible via the SDK (meetings, recordings, etc.). The previous
versions of the library are deprecated and no longer supported; however, their open-source codebase
is still available in the `release/v0/ciscosparkapi`_ and `release/v1/webexteamssdk`_ branches in
this repository.
* `webexpythonsdk`_ (current) is compatible with Python v3.10+ and is the recommended library for
new projects.
* `webexteamssdk`_ (deprecated) is compatible with Python v2 and v3 (<= v3.10) and is still
available for existing projects. Users are encouraged to migrate to `webexpythonsdk`_.
* `ciscosparkapi`_ (deprecated) is compatible with Python v2 and v3 (<= v3.6) and should no longer
be used.
*Copyright (c) 2016-2024 Cisco and/or its affiliates.*
.. _ciscosparkapi: https://github.com/WebexCommunity/WebexPythonSDK/tree/release/v0/ciscosparkapi
.. _Community: https://eurl.io/#BJ0A8gfOQ
.. _Contributing: https://github.com/WebexCommunity/WebexPythonSDK/blob/master/docs/contributing.rst
.. _examples: https://github.com/WebexCommunity/WebexPythonSDK/tree/master/examples
.. _Introduction: https://webexcommunity.github.io/WebexPythonSDK/user/intro.html
.. _issues: https://github.com/WebexCommunity/WebexPythonSDK/issues
.. _migrate: https://webexcommunity.github.io/WebexPythonSDK/user/migrate.html
.. _pagination: https://developer.webex.com/docs/basics#pagination
.. _projects: https://github.com/WebexCommunity/WebexPythonSDK/projects
.. _pull request: https://github.com/WebexCommunity/WebexPythonSDK/pulls
.. _pull requests: https://github.com/WebexCommunity/WebexPythonSDK/pulls
.. _Quickstart: https://webexcommunity.github.io/WebexPythonSDK/user/quickstart.html
.. _Release Plan: https://github.com/WebexCommunity/WebexPythonSDK/wiki/Release-Plans
.. _release/v0/ciscosparkapi: https://github.com/WebexCommunity/WebexPythonSDK/tree/release/v0/ciscosparkapi
.. _release/v1/webexteamssdk: https://github.com/WebexCommunity/WebexPythonSDK/tree/release/v1/webexteamssdk
.. _releases: https://github.com/WebexCommunity/WebexPythonSDK/releases
.. _the repository: https://github.com/WebexCommunity/WebexPythonSDK
.. _webexpythonsdk: https://github.com/WebexCommunity/WebexPythonSDK
.. _webexteamssdk: https://github.com/WebexCommunity/WebexPythonSDK/tree/release/v1/webexteamssdk
Raw data
{
"_id": null,
"home_page": "https://github.com/WebexCommunity/WebexPythonSDK",
"name": "webexpythonsdk",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "cisco, webex, api, sdk, python",
"author": "Chris Lunsford",
"author_email": "cm@lunsford.io",
"download_url": "https://files.pythonhosted.org/packages/20/41/543559613f5370afb1313361ee97b773b25e6e8e83503f914c34de06e5f6/webexpythonsdk-2.0.2.tar.gz",
"platform": null,
"description": "==============\nwebexpythonsdk\n==============\n\n*Work with the Webex APIs in native Python!*\n\n.. image:: https://img.shields.io/badge/license-MIT-blue.svg\n :target: https://github.com/WebexCommunity/WebexPythonSDK/blob/master/LICENSE\n :alt: License MIT\n.. image:: https://img.shields.io/pypi/v/webexpythonsdk\n :target: https://pypi.org/project/webexpythonsdk/\n :alt: PyPI Version\n.. image:: https://img.shields.io/pypi/dw/webexpythonsdk?label=webexpythonsdk\n :target: https://pypistats.org/packages/webexpythonsdk\n :alt: webexpythonsdk PyPI Downloads\n.. image:: https://img.shields.io/pypi/dw/webexteamssdk?label=webexteamssdk\n :target: https://pypistats.org/packages/webexteamssdk\n :alt: webexteamssdk PyPI Downloads\n.. image:: https://img.shields.io/github/actions/workflow/status/WebexCommunity/WebexPythonSDK/.github%2Fworkflows%2Fbuild-and-test.yml?label=tests\n :target: https://github.com/WebexCommunity/WebexPythonSDK/actions/workflows/build-and-test.yml\n :alt: Tests Status\n.. image:: https://img.shields.io/github/actions/workflow/status/WebexCommunity/WebexPythonSDK/.github%2Fworkflows%2Fdocs.yml?label=docs\n :target: https://webexcommunity.github.io/WebexPythonSDK/\n :alt: Documentation Status\n\n\n---------------------------------------------------------------------------------------------------\n\nWelcome to the new **webexpythonsdk** library! The latest release removes support for Python v2 and\nis compatible with Python v3.10+. The new Webex Python SDK replaces the previous `webexteamssdk`_;\nand with the exception of the Python version support and the name change, the two libraries are\nfunctionally equivalent. The new library is the recommended choice for new projects, and\nwebexteamssdk users are encouraged to `migrate`_ to **webexpythonsdk**.\n\n---------------------------------------------------------------------------------------------------\n\n\n**webexpythonsdk** is a *community developed* Python library for working with the Webex APIs. Our\ngoal is to make working with Webex in Python a *native* and *natural* experience!\n\n.. code-block:: Python\n\n from webexpythonsdk import WebexAPI\n\n api = WebexAPI()\n\n # Find all rooms that have 'webexpythonsdk Demo' in their title\n all_rooms = api.rooms.list()\n demo_rooms = [room for room in all_rooms if 'webexpythonsdk Demo' in room.title]\n\n # Delete all of the demo rooms\n for room in demo_rooms:\n api.rooms.delete(room.id)\n\n # Create a new demo room\n demo_room = api.rooms.create('webexpythonsdk Demo')\n\n # Add people to the new demo room\n email_addresses = [\"test01@cmlccie.com\", \"test02@cmlccie.com\"]\n for email in email_addresses:\n api.memberships.create(demo_room.id, personEmail=email)\n\n # Post a message to the new room, and upload a file\n api.messages.create(demo_room.id, text=\"Welcome to the room!\",\n files=[\"https://www.webex.com/content/dam/wbx/us/images/navigation/CiscoWebex-Logo_white.png\"])\n\n\nThat's more than 6 Webex API calls in less than 23 lines of code (with comments and whitespace),\nand likely more than that, since webexpythonsdk handles pagination_ for you automatically!\n\nwebexpythonsdk makes your life better... `Learn how!`__\n\n__ Introduction_\n\n\nFeatures\n--------\n\nwebexpythonsdk does all of this for you:\n\n* Transparently sources your Webex access token from your local environment\n\n* Provides and uses default arguments and settings everywhere possible, so you don't have to think\n about things like API endpoint URLs, HTTP headers and JSON formats\n\n* Represents all Webex API interactions using native Python tools\n\n * Authentication and Connection to the Webex Cloud ==> **WebexAPI** \"connection object\"\n\n * API Calls ==> Hierarchically organized methods underneath the **WebexAPI** 'Connection Object'\n\n * Returned Data Objects ==> Native Python objects\n\n* **Automatic and transparent pagination!**\n\n* **Automatic rate-limit handling!** *(wait|retry)*\n\n* Multipart encoding and uploading of local files\n\n* Auto-completion in your favorite IDE, descriptive exceptions, and so much more...\n\n\nInstallation\n------------\n\nInstalling and upgrading webexpythonsdk is easy:\n\n**Install via PIP**\n\n.. code-block:: bash\n\n $ pip install webexpythonsdk\n\n**Upgrade to the latest version**\n\n.. code-block:: bash\n\n $ pip install webexpythonsdk --upgrade\n\n\nDocumentation\n-------------\n\n**Excellent documentation is now available at:**\nhttps://webexcommunity.github.io/WebexPythonSDK\n\nCheck out the Quickstart_ to dive in and begin using webexpythonsdk.\n\n\nExamples\n--------\n\nAre you looking for some sample scripts? Check out the examples_ folder!\n\nHave a good example script you would like to share? Please feel free to `contribute`__!\n\n__ Contribution_\n\n\nRelease Notes\n-------------\n\nPlease see the releases_ page for release notes on the incremental functionality and bug fixes\nincorporated into the published releases.\n\n\nQuestions, Support & Discussion\n-------------------------------\n\nwebexpythonsdk is a *community developed* and *community-supported* project. If you experience any\nissues using this package, please report them using the issues_ page.\n\nPlease join the `Webex Python SDK - Python Community Contributors`__ Webex space to ask questions,\njoin the discussion, and share your projects and creations.\n\n__ Community_\n\n\nContribution\n------------\n\nwebexpythonsdk is a community development project. Feedback, thoughts, ideas, and code\ncontributions are welcome! Please see the `Contributing`_ guide for more information.\n\n\nHistory\n-------\n\nThe Webex Python SDK (webexpythonsdk) library started as Cisco Spark API (ciscosparkapi) which\nbecame Webex Teams SDK and then Webex Python SDK (webexpythonsdk). We updated the library's name in\nalignment with Cisco's re-brand of Cisco Spark to Webex and then again to align the name with the\nbroader set of Webex APIs accessible via the SDK (meetings, recordings, etc.). The previous\nversions of the library are deprecated and no longer supported; however, their open-source codebase\nis still available in the `release/v0/ciscosparkapi`_ and `release/v1/webexteamssdk`_ branches in\nthis repository.\n\n* `webexpythonsdk`_ (current) is compatible with Python v3.10+ and is the recommended library for\n new projects.\n\n* `webexteamssdk`_ (deprecated) is compatible with Python v2 and v3 (<= v3.10) and is still\n available for existing projects. Users are encouraged to migrate to `webexpythonsdk`_.\n\n* `ciscosparkapi`_ (deprecated) is compatible with Python v2 and v3 (<= v3.6) and should no longer\n be used.\n\n\n*Copyright (c) 2016-2024 Cisco and/or its affiliates.*\n\n\n.. _ciscosparkapi: https://github.com/WebexCommunity/WebexPythonSDK/tree/release/v0/ciscosparkapi\n.. _Community: https://eurl.io/#BJ0A8gfOQ\n.. _Contributing: https://github.com/WebexCommunity/WebexPythonSDK/blob/master/docs/contributing.rst\n.. _examples: https://github.com/WebexCommunity/WebexPythonSDK/tree/master/examples\n.. _Introduction: https://webexcommunity.github.io/WebexPythonSDK/user/intro.html\n.. _issues: https://github.com/WebexCommunity/WebexPythonSDK/issues\n.. _migrate: https://webexcommunity.github.io/WebexPythonSDK/user/migrate.html\n.. _pagination: https://developer.webex.com/docs/basics#pagination\n.. _projects: https://github.com/WebexCommunity/WebexPythonSDK/projects\n.. _pull request: https://github.com/WebexCommunity/WebexPythonSDK/pulls\n.. _pull requests: https://github.com/WebexCommunity/WebexPythonSDK/pulls\n.. _Quickstart: https://webexcommunity.github.io/WebexPythonSDK/user/quickstart.html\n.. _Release Plan: https://github.com/WebexCommunity/WebexPythonSDK/wiki/Release-Plans\n.. _release/v0/ciscosparkapi: https://github.com/WebexCommunity/WebexPythonSDK/tree/release/v0/ciscosparkapi\n.. _release/v1/webexteamssdk: https://github.com/WebexCommunity/WebexPythonSDK/tree/release/v1/webexteamssdk\n.. _releases: https://github.com/WebexCommunity/WebexPythonSDK/releases\n.. _the repository: https://github.com/WebexCommunity/WebexPythonSDK\n.. _webexpythonsdk: https://github.com/WebexCommunity/WebexPythonSDK\n.. _webexteamssdk: https://github.com/WebexCommunity/WebexPythonSDK/tree/release/v1/webexteamssdk\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Work with the Webex APIs in native Python!",
"version": "2.0.2",
"project_urls": {
"Documentation": "https://webexcommunity.github.io/WebexPythonSDK",
"Homepage": "https://github.com/WebexCommunity/WebexPythonSDK",
"Repository": "https://github.com/WebexCommunity/WebexPythonSDK"
},
"split_keywords": [
"cisco",
" webex",
" api",
" sdk",
" python"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "709c2ae10b8b275632b1be9c1c05e6aaaa2827970798144e1e2eb9bebbc45dca",
"md5": "d52f3fad3cad8ed7a449b3d4ab43eb7e",
"sha256": "f1957d61873004b3e4f39b6b8547435f31762196d0438ff28852ef7583f3ccd2"
},
"downloads": -1,
"filename": "webexpythonsdk-2.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d52f3fad3cad8ed7a449b3d4ab43eb7e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 152756,
"upload_time": "2024-12-16T18:30:01",
"upload_time_iso_8601": "2024-12-16T18:30:01.493608Z",
"url": "https://files.pythonhosted.org/packages/70/9c/2ae10b8b275632b1be9c1c05e6aaaa2827970798144e1e2eb9bebbc45dca/webexpythonsdk-2.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2041543559613f5370afb1313361ee97b773b25e6e8e83503f914c34de06e5f6",
"md5": "db7a10637bd707b87f6e37549a540dfa",
"sha256": "0aad7e5c04087e3be6edf11fd949969c4b78d743f9bbd334119614efd23d94a3"
},
"downloads": -1,
"filename": "webexpythonsdk-2.0.2.tar.gz",
"has_sig": false,
"md5_digest": "db7a10637bd707b87f6e37549a540dfa",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 68562,
"upload_time": "2024-12-16T18:30:04",
"upload_time_iso_8601": "2024-12-16T18:30:04.151118Z",
"url": "https://files.pythonhosted.org/packages/20/41/543559613f5370afb1313361ee97b773b25e6e8e83503f914c34de06e5f6/webexpythonsdk-2.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-16 18:30:04",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "WebexCommunity",
"github_project": "WebexPythonSDK",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "webexpythonsdk"
}
JSON
