Metadata-Version: 2.4
Name: balderhub-data
Version: 0.0.1b7
Summary: balderhub-data: BalderHub Project that can be used to manage data
Home-page: https://hub.balder.dev/projects/data
Author: Max Stahlschmidt
License: MIT
Project-URL: Source, https://github.com/balder-dev/balderhub-data/
Project-URL: Tracker, https://github.com/balder-dev/balderhub-data/issues
Keywords: test,systemtest,reusable,scenario,junit,balder
Platform: unix
Platform: linux
Platform: osx
Platform: cygwin
Platform: win32
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: baldertest
Requires-Dist: pydantic~=2.12.5
Provides-Extra: auth
Requires-Dist: balderhub-auth>=0.0.1b2; extra == "auth"
Provides-Extra: all
Requires-Dist: balderhub-html[auth]; extra == "all"
Dynamic: license-file

# BalderHub Package ``balderhub-data``

This is a BalderHub package for the [Balder](https://docs.balder.dev) test framework. If you are new to Balder check out the
[official documentation](https://docs.balder.dev) first.

**balderhub-data** is the official BalderHub package for **structured, reusable test data** in the
[Balder test framework](https://github.com/balder-dev/balder). If you are new to Balder check out the
[official documentation](https://docs.balder.dev) first.

It makes data-driven testing clean, type-safe, and maintainable by giving you powerful building blocks to define, load,
sync, and query test data - whether you are working with a simulator, staging environment, or real device under test.


## What you will find in this package

This documentation is organised around the core pieces you will use every day:

* **Data Models**
  Define your own type-safe data items with `balderhub.data.lib.utils.SingleDataItem`.
  Built on Pydantic - supports nested objects, lists, relationships, and unique identifiers.

* **Data Environment Feature**
  Use `balderhub.data.lib.feature.DataEnvironmentFeature` inside Scenarios to load sample data and automatically
  keep the device under test in sync.

* **Initial Data Configuration**
  Control exactly what data your test setups can see with `balderhub.data.lib.feature.InitialDataConfig` and
  `balderhub.data.lib.feature.AccessibleInitialDataConfig` (perfect for permission and visibility testing).

* **Powerful Utilities**
  Collections, filters, factories, and query helpers that let you find the exact data you need with clean, readable
  syntax (e.g. ``author__last_name="Smith"``).

* **Ready-to-use Examples**
  Concrete code snippets and full scenarios that you can copy straight into your own tests.

Then head to the [Topic Intro of the Documentation](https://hub.balder.dev/projects/data/en/latest/topic_intro.html), 
to see how everything fits together - or jump straight into the 
[Examples Section of the Documentation](https://hub.balder.dev/projects/data/en/latest/examples.html), if
you prefer to learn by code.

## Installation

You can install the latest release with pip:

```
python -m pip install balderhub-data
```

# Check out the documentation

If you need more information, 
[checkout the ``balderhub-data`` documentation](https://hub.balder.dev/projects/data).


# License

This BalderHub package is free and Open-Source

Copyright (c)  2025  balderhub-data

Distributed under the terms of the MIT license
