Skip to content

supermanny81/ciscosupportsdk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

53 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ciscosupportsdk

Python API wrapper for the Cisco Support APIs.

devnet docs tests coverage pypi


The ciscosupportsdk supports all of the Cisco Support API interactions via a native Python library. This makes working with these APIs a more natural experience and eases the burden of writing your own boilerplate code to deal with API semantics, like authentication and pagination.

For detailed information and onboarding information, see the support api documentation on DevNet.

Quick Usage

from ciscosupportsdk.api import CiscoSupportAPI

api = CiscoSupportAPI(CS_API_KEY, CS_API_SECRET)

# find if a serial number is covered and when it's warranty expires
for item in api.serial_information.get_coverage_status(['FXS2130Q286']):
   print(f'{item.is_covered} {item.warranty_end_date}')

Features

  • Represents all of the Cisco Support API interactions in native python
    • Authentication and connection management
    • All APIs organized hierarchically as attributes and methods under the main API object
    • Returned data objects are all native python objects
  • Pagination is automatic and transparent
  • API documentation will appear in your IDE to ease development

Installation

Installing and upgrading the ciscosupportsdk is easy with pip

pip install ciscosupportsdk
# or to upgrade use...
pip install ciscosupportsdk --upgrade

If you want to setup a development environment, use poetry instead:

# Install poetry using pipx
python -m pip install pipx
python -m pipx ensurepath
pipx install poetry

# Clone repository
git clone https://github.com/supermanny81/ciscosupportsdk.git
cd ciscosupportsdk/

# Install dependencies
poetry install

Examples

Looking for some sample usage? Check out the examples folder!