Webexpythonsdk

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.

This release is a hotfix that merges Pull request 175 into the main branch.

What's Changed
* Fix for 147 by fbradyirl in https://github.com/CiscoDevNet/webexteamssdk/pull/157
* Bump pygments from 2.6.1 to 2.7.4 by dependabot in https://github.com/CiscoDevNet/webexteamssdk/pull/158
* Fix type check in `update` by mallamanis in https://github.com/CiscoDevNet/webexteamssdk/pull/150
* Added option to disable ssl cert verification by sQu4rks in https://github.com/CiscoDevNet/webexteamssdk/pull/142
* Update Cards Handling to check correct attribute for instance of AdaptiveCards (solves 140) by sQu4rks in https://github.com/CiscoDevNet/webexteamssdk/pull/141
* fixing OpenUrl action by craigers521 in https://github.com/CiscoDevNet/webexteamssdk/pull/175

New Contributors
* fbradyirl made their first contribution in https://github.com/CiscoDevNet/webexteamssdk/pull/157
* dependabot made their first contribution in https://github.com/CiscoDevNet/webexteamssdk/pull/158
* mallamanis made their first contribution in https://github.com/CiscoDevNet/webexteamssdk/pull/150
* craigers521 made their first contribution in https://github.com/CiscoDevNet/webexteamssdk/pull/175

**Full Changelog**: https://github.com/CiscoDevNet/webexteamssdk/compare/v1.6...v1.6.1

In v1.6, we have updated all of the currently wrapped and supported Webex Teams API endpoints and closed out all existing issues that users opened on the v1.x releases. The library should now be up-to-date in supporting the Webex Teams APIs documented at developer.webex.com. It ***is not*** yet up-to-date in supporting the newer and broader Webex Meetings, Calling, and Devices APIs. We are tracking adding these additional API endpoints in issue 113, and we will work to add full support for all of the published Webex APIs in v2.x of the library.

With release v1.6, we are wrapping up active development on the v1.x release and shifting our focus to the next major release v2!

Breaking Change(s)

We have introduced **one (1)** breaking change in v1.6:

- We have changed the function signature (parameter names) for the `WebexTeamsAPI.guest_issuer.create()` method to align it with the developer documentation at developer.webex.com.

Previous method definition:

python
def create(self, subject, displayName, issuerToken, expiration, secret):
...


python
def create(self, sub, name, iss, exp, secret):
...

- Webex Tracking IDs are now prominently displayed for all API errors and warnings.

**Example Error Message:**

ApiError: [401] Unauthorized - The request requires a valid access token set in the Authorization request header. [Tracking ID: ROUTER_5F05F384-D9E9-01BB-00FF-4B0C804F00FF]
`

You can also access the Tracking IDs via the `tracking_id` attribute available on the raised exception and warning objects.

python
api = webexteamssdk.WebexTeamsAPI(access_token="abc")

try:
api.people.me()
except webexteamssdk.ApiError as e:
print(e.tracking_id)

* The webexteamssdk library now sends a custom User-Agent header (inspired by PIP's User-Agent header).

**Example User-Agent Header:**

webexteamssdk/1.5 {"implementation": {"name": "CPython", "version": "3.7.8"}, "distro": {"name": "macOS", "version": "10.15.5"}, "system": {"name": "Darwin", "release": "19.5.0"}, "cpu": "x86_64"}


* Minor package and PEP8 improvements.

Version 1.4 adds support for the Admin Audit Events API; however, you should note that pagination is currently broken ☹️ on responses from the `/v1/adminAudit/events` API endpoint. Hopefully, the Developer Support Team will get this fixed quickly.

Also in this release we...
- Squashed a timezone info bug that was affecting Python v2.7 and 3.5

This minor update adds official support for adding attachments to messages via `WebexTeamsAPI.messages.create()` thanks to bradh11, jianchen2580, zhanto97, and jwa1 🙌!

jpjpjp has created an excellent [Webex Teams bot example](https://github.com/CiscoDevNet/webexteamssdk/blob/master/examples/bot-with-card-example-flask.py) that demonstrates using webhooks, Adaptive Cards, and response actions! 😎

Python Adaptive Cards *Beta*
This release includes a **beta** of sQu4rks Python Adaptive Cards, but please do not get too attached using this functionality directly from the Webex Teams SDK as ***we will be migrating this functionality*** to leverage sQu4rks newer (and independently maintained) [pyadaptivecards](https://github.com/CiscoSE/pyadaptivecards) library.