This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

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!
  • 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 ciscosparkapi

Upgrading to the latest Version

$ pip install ciscosparkapi --upgrade

Documentation

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.

Support

This is a community developed and community supported project. If you experience any issues using this package, please report them using the issues log.

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?

  1. 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.
  2. Review the project charter for coding standards and practices.
  3. Fork a copy of the repository.
  4. Add your code to your forked repository.
  5. Submit a pull request.

Copyright (c) 2016 Cisco Systems, Inc.

Release History

Release History

This version
History Node

0.6.1

History Node

0.6

History Node

0.5.5

History Node

0.5

History Node

0.4.2

History Node

0.4.1

History Node

0.4

History Node

0.3.1

History Node

0.3

History Node

0.2.4

History Node

0.2.3

History Node

0.2.2

History Node

0.2.1

History Node

0.2

History Node

0.1.2

History Node

0.1.1

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
ciscosparkapi-0.6.1.tar.gz (35.8 kB) Copy SHA256 Checksum SHA256 Source Jun 20, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting