Simple, lightweight, scalable Python API wrapper for the Cisco Spark APIs
Project description
Simple, lightweight, scalable Python API wrapper for the Cisco Spark APIs
ciscosparkapi is a community developed Pythonic wrapping of the Cisco Spark APIs, which makes working with Cisco Spark in Python a native and natural experience!
from ciscosparkapi import CiscoSparkAPI
api = CiscoSparkAPI()
# Find all rooms that have 'ciscosparkapi Demo' in their title
all_rooms = api.rooms.list()
demo_rooms = [room for room in all_rooms if 'ciscosparkapi 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('ciscosparkapi 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://developer.ciscospark.com/images/logo_spark_lg@256.png"])That’s more than 6 Spark API calls in less than 23 lines of code (with comments and whitespace), and likely more than that since ciscosparkapi handles pagination for you automatically!
ciscosparkapi makes your life better… Learn how!
Features
ciscosparkapi does all of this for you…
Transparently sources your Spark credentials 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 Cisco Spark API interactions using native Python tools
Authentication and Connection to the Cisco Spark Cloud ==> CiscoSparkAPI ‘Connection Object’
API Calls ==> Hierarchically organized method calls underneath a CiscoSparkAPI ‘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 ciscosparkapi is easy:
Install via PIP
$ pip install ciscosparkapiUpgrading to the latest Version
$ pip install ciscosparkapi --upgradeDocumentation
Excellent documentation is now available at: http://ciscosparkapi.readthedocs.io
Check out the Quickstart to dive in and begin using ciscosparkapi.
Examples
Looking for some examples or sample scripts? Check out the examples folder!
Have a good example script you would like to share? Please feel free to contribute!
Release Notes
Complete and fully functional Beta releases have been published. Please see the releases page for release notes on the incremental functionality and bug fixes incorporated into the published releases.
Note: The package APIs may change, while the package is in beta.
Questions, Support & Discussion
This is a community developed and community supported project. If you experience any issues using this package, please report them using the issues log.
Please join the Python Spark Devs community Spark room to ask questions, join the discussion and share your projects and creations.
Contribution
ciscosparkapi and it’s sister project ciscosparksdk are community development projects. Feedback, thoughts, ideas and code contributions are most welcome!
Feedback, issues, thoughts and ideas…
Please use the issues log.
Interested in contributing code?
Check for open issues or create a new ‘issue’ for the item you want to work on.
Assign yourself to the issue, and communicate with any others that may be working the issue.
Review the project charter for coding standards and practices.
Fork a copy of the repository.
Add your code to your forked repository.
Submit a pull request.
Copyright (c) 2016-2018 Cisco and/or its affiliates.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
