Skip to main content

Tideway

Simplified Python library for BMC Discovery API Interface that makes use of the Python Requests module https://github.com/psf/requests and uses the same response handler.

>>> import tideway
>>> tw = tideway.appliance('appliance-hostname','auth-token')
>>> tw.api_about.url
'https://appliance-hostname/api/about'
>>> tw.api_about.status_code
200
>>> tw.api_about.text
{
    "api_versions": [
        "1.0","1.1","1.2","1.3","1.4","1.5","1.6","1.7","1.8","1.9","1.10","1.11","1.12","1.13","1.14","1.15","1.16"
    ],
    "component": "REST API",
    "version":"DaaS",
    "product": "BMC Helix Discovery",
    "version": "25.2.00"
}

Tideway follows BMC Discovery's well-structured and documented REST API which can be viewed from https://<appliance>/swagger-ui/.

Tideway removes the extra layer of manually constructing a URL and parameters for python requests allowing you to query API supported features of Discovery seamlessly and faster than if you were to navigate via the GUI.

Documentation

Documentation can be found at https://traversys.github.io/Tideway/.

  • Example notebook: notebooks/admin_api.ipynb (download via curl -O https://raw.githubusercontent.com/traversys/Tideway/main/notebooks/admin_api.ipynb)

Installation

  • Tideway can be installed via PyPI:
$ python -m pip install tideway
  • Tideway supports BMC Discovery 11.3+, API v1.0-1.16 using Python 3.

Releases

Version Summary Known Issues Fixed
0.1.1 - Updated to API v1.2
- Added help(), search_bulk()
search call retains last parameters for offset, results_id
0.1.2 Bug Fixes Bulk search with larger limit than dataset will fail on missing next_offset - Fixed issue with offset and results_id values
- Fixed issue with bulk search parameter lower limit.
0.1.3 Bug Fixes Added check for next_offset.
0.1.4 Search bulk update Discovery 12.3 (21.3) enforces strict case for "Bearer" header - api calls will not current work. Now includes headers for non-formatted search.
0.1.5 Updated to support Discovery 12.3 (API version 1.3) - Missing 'complete' parameter option on graphNode() function. - Fixed issue with Bearer capitalisation.
- Search Bulk will now return the full response on failure
0.2.0 Updated to include Kerberos, Models and Taxonomy endpoints.

Added new high level generic endpoint function calls

Refactored function names/decorators to match API endpoints as close as possible.

Supports Discovery 22.2 (12.5) (API version 1.5) and Outpost API version 1.0
Project missing tkinter module: https://github.com/traversys/Tideway/issues/15 Added 'complete' parameter to get_data_nodes_graph() (replaces graphNode())
0.2.1 Added complete flag for graph calls, bug fixes to pagination and default focus.

Can retrieve condition templates without an ID.

Kerberos realm detection fixed and parameters are reset after each request.

Removed unused Tkinter library.

Updated to support API version 1.14
May not work with all new endpoints.
0.3.0 Removed deprecated helper aliases and routed all modules through the top-level REST wrappers.

Documentation refreshed to reflect the lean API surface.
Deprecated helper functions removed; docs and examples updated.

Metadata

Release files for tideway 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tideway 0.3.0
File Size Uploaded
tideway-0.3.0.tar.gz 32.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for tideway 0.3.0
File Interpreter ABI Platform
tideway-0.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 66.0 kB

Release files / tideway-0.3.0.tar.gz

Download URL tideway-0.3.0.tar.gz
Size 32.6 kB
Tags Source
SHA-256 checksum
How to use checksums
a7e12b0e7b0832413f1d4bed259f4ab495ef5c46844736241215bd9ea6304655
BLAKE2b-256 checksum
How to use checksums
ec1cc7be824e1614b1b01ee5230afc7f2bd7951ed5595513c197b060dc1838cf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Release files / tideway-0.3.0-py3-none-any.whl

Download URL tideway-0.3.0-py3-none-any.whl
Size 33.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
991d9361601a06117fa31ce3e4b4a4219bcf84ae96434e27d19264d884607cb8
BLAKE2b-256 checksum
How to use checksums
692e31c04fc20e545421baf6880097a0f7c9ccf6d92805a9edb89ab485c2d1e5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Release history Release notifications | RSS feed

This release

0.3.0 This release

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page