{ "info": { "author": "Jose Bogar\u00edn", "author_email": "jbogarin@altus.cr", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "Intended Audience :: Education", "Intended Audience :: Information Technology", "Intended Audience :: System Administrators", "Intended Audience :: Telecommunications Industry", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Topic :: System", "Topic :: System :: Networking", "Topic :: Utilities" ], "description": "=============\ndnacentersdk\n=============\n\n*Work with the DNA Center APIs in native Python!*\n\n-------------------------------------------------------------------------------\n\n**dnacentersdk** is a *community developed* Python library for working with the DNA Center APIs. Our goal is to make working with DNA Center in Python a *native* and *natural* experience!\n\n.. code-block:: python\n\n from dnacentersdk import api\n\n # Create a DNACenterAPI connection object;\n # it uses DNA Center sandbox URL, username and password, with DNA Center API version 1.2.10.,\n # and requests to verify the server's TLS certificate with verify=True.\n dnac = api.DNACenterAPI(username=\"devnetuser\",\n password=\"Cisco123!\",\n base_url=\"https://sandboxdnac2.cisco.com:443\",\n version='1.2.10',\n verify=True)\n\n # Find all devices that have 'Switches and Hubs' in their family\n devices = dnac.devices.get_device_list(family='Switches and Hubs')\n\n # Print all of demo devices\n for device in devices.response:\n print('{:20s}{}'.format(device.hostname, device.upTime))\n\n # Find all tags\n all_tags = dnac.tag.get_tag(sort_by='name', order='des')\n demo_tags = [tag for tag in all_tags.response if 'Demo' in tag.name ]\n\n # Delete all of the demo tags\n for tag in demo_tags:\n dnac.tag.delete_tag(tag.id)\n\n # Create a new demo tag\n demo_tag = dnac.tag.create_tag(name='dna Demo')\n task_demo_tag = dnac.task.get_task_by_id(task_id=demo_tag.response.taskId)\n\n if not task_demo_tag.response.isError:\n # Retrieve created tag\n created_tag = dnac.tag.get_tag(name='dna Demo')\n\n # Update tag\n update_tag = dnac.tag.update_tag(id=created_tag.response[0].id, \n name='Updated ' + created_tag.response[0].name,\n description='DNA demo tag')\n\n print(dnac.task.get_task_by_id(task_id=update_tag.response.taskId).response.progress)\n\n # Retrieved updated\n updated_tag = dnac.tag.get_tag(name='Updated dna Demo')\n print(updated_tag)\n else:\n # Get task error details \n print('Unfortunately ', task_demo_tag.response.progress)\n print('Reason: ', task_demo_tag.response.failureReason)\n\n\nIntroduction_\n\n\nInstallation\n------------\n\nInstalling and upgrading dnacentersdk is easy:\n\n**Install via PIP**\n\n.. code-block:: bash\n\n $ pip install dnacentersdk\n\n**Upgrading to the latest Version**\n\n.. code-block:: bash\n\n $ pip install dnacentersdk --upgrade\n\n\nDocumentation\n-------------\n\n**Excellent documentation is now available at:**\nhttps://dnacentersdk.readthedocs.io\n\nCheck out the Quickstart_ to dive in and begin using dnacentersdk.\n\n\nRelease Notes\n-------------\n\nPlease see the releases_ page for release notes on the incremental functionality and bug fixes incorporated into the published releases.\n\n\nQuestions, Support & Discussion\n-------------------------------\n\ndnacentersdk is a *community developed* and *community supported* project. If you experience any issues using this package, please report them using the issues_ page.\n\n\nContribution\n------------\n\ndnacentersdk_ is a community development projects. Feedback, thoughts, ideas, and code contributions are welcome! Please see the `Contributing`_ guide for more information.\n\n\nInspiration\n------------\n\nThis library is inspired by the webexteamssdk_ library\n\n\n*Copyright (c) 2019 Cisco and/or its affiliates.*\n\n.. _Introduction: https://dnacentersdk.readthedocs.io/en/latest/api/intro.html\n.. _dnacentersdk.readthedocs.io: https://dnacentersdk.readthedocs.io\n.. _Quickstart: https://dnacentersdk.readthedocs.io/en/latest/api/quickstart.html\n.. _dnacentersdk: https://github.com/cisco-en-programmability/dnacentersdk\n.. _issues: https://github.com/cisco-en-programmability/dnacentersdk/issues\n.. _pull requests: https://github.com/cisco-en-programmability/dnacentersdk/pulls\n.. _releases: https://github.com/cisco-en-programmability/dnacentersdk/releases\n.. _the repository: dnacentersdk_\n.. _pull request: `pull requests`_\n.. _Contributing: https://github.com/cisco-en-programmability/dnacentersdk/blob/master/docs/contributing.rst\n.. _webexteamssdk: https://github.com/CiscoDevNet/webexteamssdk\n\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "https://pypi.python.org/pypi/dnacentersdk", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/cisco-en-programmability/dnacentersdk", "keywords": "cisco dna dnacenter python api sdk", "license": "MIT; Copyright (c) 2019 Cisco Systems, Inc.", "maintainer": "", "maintainer_email": "", "name": "dnacentersdk", "package_url": "https://pypi.org/project/dnacentersdk/", "platform": "", "project_url": "https://pypi.org/project/dnacentersdk/", "project_urls": { "Download": "https://pypi.python.org/pypi/dnacentersdk", "Homepage": "https://github.com/cisco-en-programmability/dnacentersdk" }, "release_url": "https://pypi.org/project/dnacentersdk/1.3.0.post5/", "requires_dist": [ "future", "requests (>=2.4.2)", "fastjsonschema (>=2.12)", "requests-toolbelt (>=0.9.1)" ], "requires_python": "", "summary": "Community-developed Python SDK for the DNA Center APIs", "version": "1.3.0.post5" }, "last_serial": 5924910, "releases": { "1.2.10": [ { "comment_text": "", "digests": { "md5": "ab5632ec0d9554d18a732e0d86377041", "sha256": "5671f039769ff34387add3d0346ecd5fa1870b73857322734e7126cccc77dcbb" }, "downloads": -1, "filename": "dnacentersdk-1.2.10-py3-none-any.whl", "has_sig": false, "md5_digest": "ab5632ec0d9554d18a732e0d86377041", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 355968, "upload_time": "2019-07-18T19:14:50", "url": "https://files.pythonhosted.org/packages/81/d0/6e4ab82f47c769d1f8022898cb7f41d06192dda22d8d5ee18e17ae53545d/dnacentersdk-1.2.10-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "c514dadcb94cf54125ded956debec0d9", "sha256": "93cd809d802bf0af107f571b5a5bc4544ffd91264949e1711aa26e09a152fbc9" }, "downloads": -1, "filename": "dnacentersdk-1.2.10.tar.gz", "has_sig": false, "md5_digest": "c514dadcb94cf54125ded956debec0d9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 121427, "upload_time": "2019-07-18T19:14:53", "url": "https://files.pythonhosted.org/packages/0b/df/de59f7ec6bd14c2d5ac31dd030d71dbdcbe01eb85e66346ef1cb6e578105/dnacentersdk-1.2.10.tar.gz" } ], "1.3.0": [ { "comment_text": "", "digests": { "md5": "03e396de1d2b876bd4534700d878b2eb", "sha256": "11cbe57f5ab6397d33eb92d803d5fac8cb32e764a1125bb4ea731bce4ddec8f2" }, "downloads": -1, "filename": "dnacentersdk-1.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "03e396de1d2b876bd4534700d878b2eb", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 693371, "upload_time": "2019-08-19T22:02:21", "url": "https://files.pythonhosted.org/packages/1a/d6/3f4e38f4b8f6f3f15237f11ebff6afd9377e76c596fbf04b9c51fb6c3a77/dnacentersdk-1.3.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "6febc47f852457e1aee641a4aa8f1b7a", "sha256": "942b9e368ecef63d53bed37dc7170bc94051e1c1d7c7c4f7f9ac01ffc8eebe4d" }, "downloads": -1, "filename": "dnacentersdk-1.3.0.tar.gz", "has_sig": false, "md5_digest": "6febc47f852457e1aee641a4aa8f1b7a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 207480, "upload_time": "2019-08-19T22:02:23", "url": "https://files.pythonhosted.org/packages/4f/f0/5e8431c8eabf670cff94d7e6d5c2601d2ea11463373e295c11f85c9d81b2/dnacentersdk-1.3.0.tar.gz" } ], "1.3.0.post1": [ { "comment_text": "", "digests": { "md5": "be4468c5147166a46fc47491fd8c7ff3", "sha256": "24091a09bd090e530d6d9b34d00c662ca36757ce10610b60743117bcef5eac5e" }, "downloads": -1, "filename": "dnacentersdk-1.3.0.post1-py3-none-any.whl", "has_sig": false, "md5_digest": "be4468c5147166a46fc47491fd8c7ff3", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 688048, "upload_time": "2019-08-24T05:00:46", "url": "https://files.pythonhosted.org/packages/ac/9f/8ca2fac3a0f5160c2e74dfe3e9f9513def84e6461ea6e99d9e56937c7c56/dnacentersdk-1.3.0.post1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "8abce7614b8e0c069ef5e1e039b4bdfa", "sha256": "031325c7736e0c31876664a35292baf949d7edeed667a287c3ee5ce76c020e49" }, "downloads": -1, "filename": "dnacentersdk-1.3.0.post1.tar.gz", "has_sig": false, "md5_digest": "8abce7614b8e0c069ef5e1e039b4bdfa", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 252494, "upload_time": "2019-08-24T05:00:48", "url": "https://files.pythonhosted.org/packages/b4/76/c9ae49dce96e5b598129dfaae00e63be18d224c3c3b1ad227fc4aec86fbb/dnacentersdk-1.3.0.post1.tar.gz" } ], "1.3.0.post2": [ { "comment_text": "", "digests": { "md5": "c9ab97df179087f45348ecd61f4979e0", "sha256": "e1b70311d210f2ba7b5b0e536ca7b1ba0a8b6087caf6de6ea715b8430fe1a4f3" }, "downloads": -1, "filename": "dnacentersdk-1.3.0.post2-py3-none-any.whl", "has_sig": false, "md5_digest": "c9ab97df179087f45348ecd61f4979e0", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 688073, "upload_time": "2019-08-24T13:16:55", "url": "https://files.pythonhosted.org/packages/d6/b3/5f2e92e9856a27546fe1f94e35e320f83893c6efb8c51eec725eafdcf7e5/dnacentersdk-1.3.0.post2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "7588118484950acbdc9400540211e843", "sha256": "6516ee032ac489b77774d853f709a18723086f71625728d6b574f657b558cfae" }, "downloads": -1, "filename": "dnacentersdk-1.3.0.post2.tar.gz", "has_sig": false, "md5_digest": "7588118484950acbdc9400540211e843", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 254816, "upload_time": "2019-08-24T13:16:58", "url": "https://files.pythonhosted.org/packages/0d/d0/56b189db65b559aaa8a1d49d6cfa01f7521590986806cd305f86504338e4/dnacentersdk-1.3.0.post2.tar.gz" } ], "1.3.0.post3": [ { "comment_text": "", "digests": { "md5": "23ed70b5ccbad552f0305aad6375d3d6", "sha256": "cf680dc165b3995a16c9ff85580b4099917ec348dd812f3d7dba76ec73fb4a6b" }, "downloads": -1, "filename": "dnacentersdk-1.3.0.post3-py3-none-any.whl", "has_sig": false, "md5_digest": "23ed70b5ccbad552f0305aad6375d3d6", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 689110, "upload_time": "2019-10-01T23:58:57", "url": "https://files.pythonhosted.org/packages/b1/95/822b7f5a6a2546deaed5015fe894d30a653d52388d1810f0de2931837de0/dnacentersdk-1.3.0.post3-py3-none-any.whl" } ], "1.3.0.post4": [ { "comment_text": "", "digests": { "md5": "17199641664f391f442b76076b3ed1d6", "sha256": "4732dd7546ae8e52fed860f60ab97c7f525072044540fe49d1313c91924287ba" }, "downloads": -1, "filename": "dnacentersdk-1.3.0.post4-py3-none-any.whl", "has_sig": false, "md5_digest": "17199641664f391f442b76076b3ed1d6", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 693096, "upload_time": "2019-10-03T17:08:09", "url": "https://files.pythonhosted.org/packages/0a/1b/ccc71139046d982d8f680177b63d0e89d240fedc39c52ce8cecfc4e0f963/dnacentersdk-1.3.0.post4-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ac652e26167bd6588ba600876f3abdea", "sha256": "c088837cb9361b97608647f83f1916cd59310454c918cc26d5798ca707d17d64" }, "downloads": -1, "filename": "dnacentersdk-1.3.0.post4.tar.gz", "has_sig": false, "md5_digest": "ac652e26167bd6588ba600876f3abdea", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 388215, "upload_time": "2019-10-03T17:08:12", "url": "https://files.pythonhosted.org/packages/37/34/6ed7105b1de28a7062004a919002fd35b82a47d782448836ff861bc7e311/dnacentersdk-1.3.0.post4.tar.gz" } ], "1.3.0.post5": [ { "comment_text": "", "digests": { "md5": "18a34739675b4c4c4b4190cb291bce48", "sha256": "475474caef3f0b07a775bce9908e5d418c8695fff12bc0b4c98b1f52711e234a" }, "downloads": -1, "filename": "dnacentersdk-1.3.0.post5-py3-none-any.whl", "has_sig": false, "md5_digest": "18a34739675b4c4c4b4190cb291bce48", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 693104, "upload_time": "2019-10-03T19:20:05", "url": "https://files.pythonhosted.org/packages/a4/f6/b0d6ff4ad3adcf80e6bd5504de8ea0012d91295116dbe36568d4463d5384/dnacentersdk-1.3.0.post5-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "51c615ae233ca28d71744ea46935cd44", "sha256": "6c5344470fad6b4dc793034a7e00e6ad65835f9a5ca5d036edf91fd93cf01fb6" }, "downloads": -1, "filename": "dnacentersdk-1.3.0.post5.tar.gz", "has_sig": false, "md5_digest": "51c615ae233ca28d71744ea46935cd44", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 388300, "upload_time": "2019-10-03T19:20:08", "url": "https://files.pythonhosted.org/packages/db/ef/1b2f7a1af0e95eb1bc4bf4810c8ba5f672a202fdc7c163576efb07447381/dnacentersdk-1.3.0.post5.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "18a34739675b4c4c4b4190cb291bce48", "sha256": "475474caef3f0b07a775bce9908e5d418c8695fff12bc0b4c98b1f52711e234a" }, "downloads": -1, "filename": "dnacentersdk-1.3.0.post5-py3-none-any.whl", "has_sig": false, "md5_digest": "18a34739675b4c4c4b4190cb291bce48", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 693104, "upload_time": "2019-10-03T19:20:05", "url": "https://files.pythonhosted.org/packages/a4/f6/b0d6ff4ad3adcf80e6bd5504de8ea0012d91295116dbe36568d4463d5384/dnacentersdk-1.3.0.post5-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "51c615ae233ca28d71744ea46935cd44", "sha256": "6c5344470fad6b4dc793034a7e00e6ad65835f9a5ca5d036edf91fd93cf01fb6" }, "downloads": -1, "filename": "dnacentersdk-1.3.0.post5.tar.gz", "has_sig": false, "md5_digest": "51c615ae233ca28d71744ea46935cd44", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 388300, "upload_time": "2019-10-03T19:20:08", "url": "https://files.pythonhosted.org/packages/db/ef/1b2f7a1af0e95eb1bc4bf4810c8ba5f672a202fdc7c163576efb07447381/dnacentersdk-1.3.0.post5.tar.gz" } ] }