Merge pull request #132 from CiscoDevNet/v1.x

v1.6 - The Catch-Up Release

LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2016-2019 Cisco and/or its affiliates.
+Copyright (c) 2016-2020 Cisco and/or its affiliates.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.rst

@@ -15,29 +15,22 @@ webexteamssdk
 .. image:: https://readthedocs.org/projects/webexteamssdk/badge/?version=latest
     :target: http://webexteamssdk.readthedocs.io/en/latest/?badge=latest
 
--------------------------------------------------------------------------------
+------------------------------------------------------------------------------------------------------------------------
 
 
-Looking for ``ciscosparkapi``?  You are in the right place.  ``ciscosparkapi`` is now ``webexteamssdk``!  It still has all of the native and natural Webex Teams Python functionality that you love and now we have made room for even more functionality to be added in the future.
+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!  Please see the work-in-progress `Release Plan`_ and contribute your ideas for v2.x enhancements by either
+opening enhancement issues_ or by joining our
+`webexteamssdk - Webex Teams SDK - Python Community Contributors <https://eurl.io/#BJ0A8gfOQ>`_ space and posting your
+ideas there.
 
-We will maintain the ``ciscosparkapi`` package (bug fixes, etc.) in the `ciscosparkapi`_ branch of this repository and continue to publish package updates with these fixes to PyPI (through the end of 2019). Maintaining the ``ciscosparkapi`` package should keep your code and projects up and running while giving you 12+ months to migrate your code to the new ``webexteamssdk`` library.
+------------------------------------------------------------------------------------------------------------------------
 
-*Migration Note:* Migrating should be easy.  The ``WebexTeamsAPI`` class and the Python objects returned by the API calls are nearly identical to their ``CiscoSparkAPI`` predecessors.  Does the word "nearly" scare you?  Here are some specifics:
 
-* The obvious top-level name change from ``CiscoSparkAPI`` to ``WebexTeamsAPI``.
-* ``WebexTeamsAPI``'s API structure: method and attribute names are *identical*.
-* The returned Python objects (now derivatives of an `ImmutableData` base class) are now immutable; so you can use them in sets and as keys in dictionaries.
-* ``WebexTeamsAPI`` converts object attributes that contain data-time strings (like a room's creation date) to Python ``datetime``'s (actually a derived class that has been customized to model the Webex Teams data-time format)
+**webexteamssdk** is a *community developed* Python library for working with the Webex Teams APIs.  Our goal is to make
+working with Webex Teams in Python a *native* and *natural* experience!
 
-There is also some new functionality under the hood that we will document, communicate, and generally make available in the future.
-
-
--------------------------------------------------------------------------------
-
-
-**webexteamssdk** is a *community developed* Python library for working with the Webex Teams APIs.  Our goal is to make working with Webex Teams in Python a *native* and *natural* experience!
-
-.. code-block:: python
+.. code-block:: Python
 
     from webexteamssdk import WebexTeamsAPI
 
@@ -64,7 +57,8 @@ There is also some new functionality under the hood that we will document, commu
                         files=["https://www.webex.com/content/dam/wbx/us/images/dg-integ/teams_icon.png"])
 
 
-That's more than 6 Webex Teams API calls in less than 23 lines of code (with comments and whitespace), and likely more than that since webexteamssdk handles pagination_ for you automatically!
+That's more than 6 Webex Teams API calls in less than 23 lines of code (with comments and whitespace), and likely more
+than that, since webexteamssdk handles pagination_ for you automatically!
 
 webexteamssdk makes your life better...  `Learn how!`__
 
@@ -78,7 +72,8 @@ webexteamssdk does all of this for you:
 
 * Transparently sources your Webex Teams 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
+* 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 Teams API interactions using native Python tools
 
@@ -108,7 +103,7 @@ Installing and upgrading webexteamssdk is easy:
 
     $ pip install webexteamssdk
 
-**Upgrading to the latest Version**
+**Upgrade to the latest version**
 
 .. code-block:: bash
 
@@ -137,29 +132,45 @@ __ Contribution_
 Release Notes
 -------------
 
-Please see the releases_ page for release notes on the incremental functionality and bug fixes incorporated into the published releases.
+Please see the releases_ page for release notes on the incremental functionality and bug fixes incorporated into the
+published releases.
 
 
 Questions, Support & Discussion
 -------------------------------
 
-webexteamssdk is a *community developed* and *community supported* project.  If you experience any issues using this package, please report them using the issues_ page.
+webexteamssdk 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 `Python Webex Teams Devs`__ Webex Teams space to ask questions, join the discussion, and share your projects and creations.
+Please join the `Python Webex Teams Devs`__ Webex Teams space to ask questions, join the discussion, and share your
+projects and creations.
 
 __ Community_
 
 
 Contribution
 ------------
 
-webexteamssdk_ is a community development projects.  Feedback, thoughts, ideas, and code contributions are welcome!  Please see the `Contributing`_ guide for more information.
+webexteamssdk_ is a community development project.  Feedback, thoughts, ideas, and code contributions are welcome!
+Please see the `Contributing`_ guide for more information.
 
 
-*Copyright (c) 2016-2019 Cisco and/or its affiliates.*
+History
+-------
 
+The Webex Teams SDK (webexteamssdk) library started as Cisco Spark API (ciscosparkapi). We updated the library's name in
+alignment with Cisco's re-brand of Cisco Spark to Webex Teams. The Cisco Spark API library has been deprecated and is no
+longer supported; however, its open-source codebase is still available in the `ciscosparkapi`_ branch of this
+repository.
 
-.. _ciscosparkapi: https://github.com/CiscoDevNet/ciscosparkapi/tree/ciscosparkapi
+The development team may make additional name changes as the library evolves with the Webex APIs published on
+developer.webex.com.
+
+
+*Copyright (c) 2016-2020 Cisco and/or its affiliates.*
+
+
+.. _Release Plan: https://github.com/CiscoDevNet/webexteamssdk/wiki/Release-Plans
 .. _Introduction: http://webexteamssdk.readthedocs.io/en/latest/user/intro.html
 .. _pagination: https://developer.webex.com/pagination.html
 .. _webexteamssdk.readthedocs.io: https://webexteamssdk.readthedocs.io
@@ -174,3 +185,4 @@ webexteamssdk_ is a community development projects.  Feedback, thoughts, ideas,
 .. _the repository: webexteamssdk_
 .. _pull request: `pull requests`_
 .. _Contributing: https://github.com/CiscoDevNet/webexteamssdk/blob/master/docs/contributing.rst
+.. _ciscosparkapi: https://github.com/CiscoDevNet/ciscosparkapi/tree/ciscosparkapi

docs/conf.py

@@ -11,7 +11,7 @@
 
 
 project = u'webexteamssdk'
-copyright = u'Copyright (c) 2016-2019 Cisco and/or its affiliates.'
+copyright = u'Copyright (c) 2016-2020 Cisco and/or its affiliates.'
 author = u'Chris Lunsford'
 version = get_versions()['version']
 release = get_versions()['version']

docs/index.rst

@@ -66,7 +66,7 @@ Webex Teams for Developers
 Leveraging the Webex Teams APIs and developing on top of the Webex Teams cloud is easy.  Signup for a `free account`_ and then head over to the `Webex Teams for Developers`_ website to learn more.
 
 
-*Copyright (c) 2016-2019 Cisco and/or its affiliates.*
+*Copyright (c) 2016-2020 Cisco and/or its affiliates.*
 
 
 .. _free account: `Webex Teams`

docs/installation.rst

@@ -58,7 +58,7 @@ command:
     $ python setup.py install
 
 
-*Copyright (c) 2016-2019 Cisco and/or its affiliates.*
+*Copyright (c) 2016-2020 Cisco and/or its affiliates.*
 
 
 .. _Python Package Index (PyPI): https://pypi.python.org/pypi/webexteamssdk

docs/user/api.rst

@@ -257,6 +257,15 @@ Room
     :inherited-members:
 
 
+.. _RoomMeetingInfo:
+
+Room Meeting Info
+-----------------
+
+.. autoclass:: RoomMeetingInfo()
+    :inherited-members:
+
+
 .. _Team:
 
 Team
@@ -266,7 +275,7 @@ Team
     :inherited-members:
 
 
-.. _Team Membership:
+.. _TeamMembership:
 
 Team Membership
 ---------------
@@ -425,4 +434,4 @@ Actions
 
 .. autoclass:: webexteamssdk.cards.actions.ShowCard
 
-*Copyright (c) 2016-2019 Cisco and/or its affiliates.*
+*Copyright (c) 2016-2020 Cisco and/or its affiliates.*

docs/user/api_structure_table.rst

@@ -22,6 +22,7 @@
 |                        |                           | :meth:`delete() <webeteamssdk.api.memberships.MembershipsAPI.delete>`           |
 +------------------------+---------------------------+---------------------------------------------------------------------------------+
 |                        | :ref:`messages`           | :meth:`list() <webeteamssdk.api.messages.MessagesAPI.list>`                     |
+|                        |                           | :meth:`list_direct() <webeteamssdk.api.messages.MessagesAPI.list_direct>`       |
 |                        |                           | :meth:`create() <webeteamssdk.api.messages.MessagesAPI.create>`                 |
 |                        |                           | :meth:`get() <webeteamssdk.api.messages.MessagesAPI.get>`                       |
 |                        |                           | :meth:`delete() <webeteamssdk.api.messages.MessagesAPI.delete>`                 |
@@ -41,6 +42,7 @@
 |                        | :ref:`rooms`              | :meth:`list() <webeteamssdk.api.rooms.RoomsAPI.list>`                           |
 |                        |                           | :meth:`create() <webeteamssdk.api.rooms.RoomsAPI.create>`                       |
 |                        |                           | :meth:`get() <webeteamssdk.api.rooms.RoomsAPI.get>`                             |
+|                        |                           | :meth:`get_meeting_info() <webeteamssdk.api.rooms.RoomsAPI.get_meeting_info>`   |
 |                        |                           | :meth:`update() <webeteamssdk.api.rooms.RoomsAPI.update>`                       |
 |                        |                           | :meth:`delete() <webeteamssdk.api.rooms.RoomsAPI.delete>`                       |
 +------------------------+---------------------------+---------------------------------------------------------------------------------+

docs/user/intro.rst

@@ -151,7 +151,7 @@ webexteamssdk License
 .. include:: ../../LICENSE
 
 
-*Copyright (c) 2016-2019 Cisco and/or its affiliates.*
+*Copyright (c) 2016-2020 Cisco and/or its affiliates.*
 
 
 .. _MIT Open Source License: https://opensource.org/licenses/MIT

docs/user/quickstart.rst

@@ -473,21 +473,21 @@ Extending the API with bound methods
 ------------------------------------
 
 As the Webex Teams API is developed and features are added, it may be necessary to extend the webexteamssdk to access those features.
-Extending the API is simple by binding your own methods to the WebexTeamsAPI connection object. By binding a method, you can 
+Extending the API is simple by binding your own methods to the WebexTeamsAPI connection object. By binding a method, you can
 extend functionality and leverage all of the objects and quality of life features of webexteamssdk.
 
 .. code-block:: python
 
     >>> new_method(self, param):
         ...     json_obj = self._session.get('/example/action/' + param)
         ...     return json_obj
-    
+
     >>> api = WebexTeamsAPI()
     >>> api.new_method = new_method
     >>> output = WebexTeamsAPI.new_method(param)
 
 
-*Copyright (c) 2016-2019 Cisco and/or its affiliates.*
+*Copyright (c) 2016-2020 Cisco and/or its affiliates.*
 
 
 .. _Webex Teams: https://www.webex.com/products/teams/index.html

examples/bot-example-flask.py

@@ -22,7 +22,7 @@
 
 This script supports Python versions 2 and 3.
 
-Copyright (c) 2016-2019 Cisco and/or its affiliates.
+Copyright (c) 2016-2020 Cisco and/or its affiliates.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -57,7 +57,7 @@
 __author__ = "Chris Lunsford"
 __author_email__ = "chrlunsf@cisco.com"
 __contributors__ = ["Brad Bester <brbester@cisco.com>"]
-__copyright__ = "Copyright (c) 2016-2019 Cisco and/or its affiliates."
+__copyright__ = "Copyright (c) 2016-2020 Cisco and/or its affiliates."
 __license__ = "MIT"
 
 

examples/bot-example-webpy.py

@@ -22,7 +22,7 @@
 the time of this writing web.py (v0.38) only supports Python 2.
 Therefore this script only supports Python 2.
 
-Copyright (c) 2016-2019 Cisco and/or its affiliates.
+Copyright (c) 2016-2020 Cisco and/or its affiliates.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -57,7 +57,7 @@
 __author__ = "Brad Bester"
 __author_email__ = "brbester@cisco.com"
 __contributors__ = ["Chris Lunsford <chrlunsf@cisco.com>"]
-__copyright__ = "Copyright (c) 2016-2019 Cisco and/or its affiliates."
+__copyright__ = "Copyright (c) 2016-2020 Cisco and/or its affiliates."
 __license__ = "MIT"
 
 

examples/local_file_upload.py

@@ -17,7 +17,7 @@
 variable set to run this script.
 
 
-Copyright (c) 2016-2019 Cisco and/or its affiliates.
+Copyright (c) 2016-2020 Cisco and/or its affiliates.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -49,7 +49,7 @@
 __author__ = "Jeff Levensailor"
 __author_email__ = "jeff@levensailor.com"
 __contributors__ = ["Chris Lunsford <chrlunsf@cisco.com>"]
-__copyright__ = "Copyright (c) 2016-2019 Cisco and/or its affiliates."
+__copyright__ = "Copyright (c) 2016-2020 Cisco and/or its affiliates."
 __license__ = "MIT"
 
 

examples/ngrokwebhook.py

@@ -13,7 +13,7 @@
 To use script simply launch ngrok, and then launch this script.  After ngrok is
 killed, run this script a second time to remove webhook from Webex Teams.
 
-Copyright (c) 2016-2019 Cisco and/or its affiliates.
+Copyright (c) 2016-2020 Cisco and/or its affiliates.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -48,7 +48,7 @@
 __author__ = "Brad Bester"
 __author_email__ = "brbester@cisco.com"
 __contributors__ = ["Chris Lunsford <chrlunsf@cisco.com>"]
-__copyright__ = "Copyright (c) 2016-2019 Cisco and/or its affiliates."
+__copyright__ = "Copyright (c) 2016-2020 Cisco and/or its affiliates."
 __license__ = "MIT"
 
 

examples/people.py

@@ -6,7 +6,7 @@
 WEBEX_TEAMS_ACCESS_TOKEN environment variable.  You must have this environment
 variable set to run this script.
 
-Copyright (c) 2016-2019 Cisco and/or its affiliates.
+Copyright (c) 2016-2020 Cisco and/or its affiliates.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -40,7 +40,7 @@
 __author__ = "Jose Bogarín Solano"
 __author_email__ = "jose@bogarin.co.cr"
 __contributors__ = ["Chris Lunsford <chrlunsf@cisco.com>"]
-__copyright__ = "Copyright (c) 2016-2019 Cisco and/or its affiliates."
+__copyright__ = "Copyright (c) 2016-2020 Cisco and/or its affiliates."
 __license__ = "MIT"
 
 from webexteamssdk import WebexTeamsAPI

examples/pyramidWebexTeamsBot/pyramidWebexTeamsBot/__init__.py

@@ -1,7 +1,7 @@
 #  -*- coding: utf-8 -*-
 """Main entry point.
 
-Copyright (c) 2016-2019 Cisco and/or its affiliates.
+Copyright (c) 2016-2020 Cisco and/or its affiliates.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -26,7 +26,7 @@
 __author__ = "Jose Bogarín Solano"
 __author_email__ = "jose@bogarin.co.cr"
 __contributors__ = ["Chris Lunsford <chrlunsf@cisco.com>"]
-__copyright__ = "Copyright (c) 2016-2019 Cisco and/or its affiliates."
+__copyright__ = "Copyright (c) 2016-2020 Cisco and/or its affiliates."
 __license__ = "MIT"
 
 

examples/pyramidWebexTeamsBot/pyramidWebexTeamsBot/views.py

@@ -22,7 +22,7 @@
 
 This script supports Python versions 2 and 3.
 
-Copyright (c) 2016-2019 Cisco and/or its affiliates.
+Copyright (c) 2016-2020 Cisco and/or its affiliates.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -60,7 +60,7 @@
     "Brad Bester <brbester@cisco.com>",
     "Chris Lunsford <chrlunsf@cisco.com>",
 ]
-__copyright__ = "Copyright (c) 2016-2019 Cisco and/or its affiliates."
+__copyright__ = "Copyright (c) 2016-2020 Cisco and/or its affiliates."
 __license__ = "MIT"
 
 

examples/pyramidWebexTeamsBot/setup.py

@@ -1,7 +1,7 @@
 #  -*- coding: utf-8 -*-
 """A simple bot script, built on Pyramid using Cornice.
 
-Copyright (c) 2016-2019 Cisco and/or its affiliates.
+Copyright (c) 2016-2020 Cisco and/or its affiliates.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -25,7 +25,7 @@
 __author__ = "Jose Bogarín Solano"
 __author_email__ = "jose@bogarin.co.cr"
 __contributors__ = ["Chris Lunsford <chrlunsf@cisco.com>"]
-__copyright__ = "Copyright (c) 2016-2019 Cisco and/or its affiliates."
+__copyright__ = "Copyright (c) 2016-2020 Cisco and/or its affiliates."
 __license__ = "MIT"
 
 

examples/simple.py

@@ -11,7 +11,7 @@
 variable set to run this script.
 
 
-Copyright (c) 2016-2019 Cisco and/or its affiliates.
+Copyright (c) 2016-2020 Cisco and/or its affiliates.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal