ibahd-api 1.2.0

Package for handling Python calls to ibaHD-Servers using the ibaHD-API

Package for handling Python calls to ibaHD-Servers using the ibaHD-API

🎉🎉🎉 ibahd-api v1.2.0 is now available. 🎉🎉🎉

pip install --upgrade ibahd-api

Tutorial • LinkedIn • YouTube

Overview
Code
Downloads
License

📡 ibahd-api Python package

ibahd-api is a Python package with the aim of simplifying the access to data from the ibaHD-Server directly from inside Python code. It includes the existing functions of the ibaHD-API and extends it with some Python-specific helper functions.

The main advantage of this Python package is therefore the ease of installation and maintenance as well as the simplicity of use.

🚀 Installation via PyPi

ibahd-api is tested and supported on 64-bit systems with:

• Python: 3.10, 3.11, 3.12 or 3.13
• Windows 10 or newer

You can install ibahd-api with Python's package manager pip.

⚡ Quickstart (Tutorial)

1. Install this package and all dependencies to run the tutorial notebook by using the following shell command:

> python -m pip install ibahd_api[tutorial]

2. Get the Jupyter Notebook tutorial.ipynb and the HD store backup from the GitHub project.
3. In the tutorial notebook there are step-by-step instructions about how to restore the backup to your ibaHD-Server.
4. Run tutorial.ipynb cell by cell to get used to the ibahd-api functions and outputs.

Note: The tutorial does not show every single API function and does not go into detail about every single parameter. For an exhaustive list of functions and further information refer to the ibaHD-API manual which you can get from the homepage. Log in with your account and search for "api" in the download area.

⚡ Quickstart (General)

1. Install only this package by using the following shell command:

> python -m pip install ibahd_api

2. Use one of the following lines to import the package in Python and to access its functions afterwards:

import ibahd_api
# ibahd_api.ibahd_api.<function>
# ibahd_api.ibahd_api_pb2_grpc.<function>

from ibahd_api import ibahd_api_pb2_grpc
# ibahd_api_pb2_grpc.<function>

from ibahd_api import *
# ibahd_api.<function>
# ibahd_api_pb2_grpc.<function>

3. For more information and examples for the included functions, refer to the tutorial notebook and the ibaHD-API manual. You can obtain the latter from the homepage. Log in with your account and search for "api" in the download area.

👥 Who should use ibahd-api?

ibahd-api is a library that you can use to extract data from an ibaHD-Server directly into Python. The package simplifies and extends the functions of the ibaHD-API and is ideal for data scientists who want to work on data from ibaHD stores in Python.

📄 License

This package contains components under mixed licensing terms:

• Most parts of this package are proprietary and may only be used with a valid software license.
  • See LICENSE-PROPRIETARY.txt for more information and iba AG License Agreement for the complete license text.
  • The proprietary license applies to the files ibahd_api_pb2.py and ibahd_api_pb2_grpc.py.
• Some files are released under the MIT License:
  • Those files may be freely used, modified, and redistributed, even independently of the rest of the package.
  • See LICENSE-MIT.txt for the complete license text.
  • The open source license applies to the file utils.py.

By installing or using this package, you agree to the applicable license terms.

💡 More Information

Important Links	Description
🌟 Homepage	Company homepage of iba AG
📄 License Details	License for iba AG software
🔧 Changelog	Changes and release notes
📚 Tutorial notebook	Jupyter notebook showing functions by example