Skip to content

balder-dev/balderhub-crud

Repository files navigation

BalderHub Package balderhub-crud

Test data management reliably - across any platform.

This is a BalderHub package for the Balder test framework. If you are new to Balder check out the official documentation first.

balderhub-crud is a BalderHub package that provides ready-to-use, high-quality test scenarios and building blocks for comprehensively validating Create, Read, Update and Delete (CRUD) operations on any kind of data.

Whether you are testing a REST API, a database, a mobile app backend, a desktop application, a file-based store, or an embedded device - this package lets you write powerful, reusable data-management tests once and run them against completely different systems with minimal extra effort.

What you will find in this package

  • Ready-to-use Scenarios - Pre-built Balder scenarios for all essential CRUD operations:

    • Single-item: Create, Read, Update (Delete coming soon)
    • Multi-item: Read operations
    • Advanced Triangle scenarios (modify on one device, verify on another - perfect for client-server or distributed systems)
  • Feature Building Blocks - Clean base feature classes you only need to implement for your specific System Under Test (SUT):

    • SingleCreatorFeature, SingleReaderFeature, SingleUpdaterFeature
    • MultipleReaderFeature
    • Support for both direct devices and separate “Point of Truth” verification devices
  • Strong Data Modeling (powered by balderhub-data) - Pydantic-style DataItem models with automatic handling of:

    • Mandatory / optional fields
    • Default values
    • Special markers: UNSET and NOT_DEFINABLE
    • Smart automatic example generation (valid, invalid, and edge-case data)
  • Validation & Utilities - Comprehensive helpers for before/after state checks, field-level comparison, diffing, success/error handling, and cross-device consistency verification.

Installation

You can install the latest release with pip:

python -m pip install balderhub-crud

Check out the documentation

If you need more information, checkout the balderhub-crud documentation.

License

This BalderHub package is free and Open-Source

Copyright (c) 2025 balderhub-crud

Distributed under the terms of the MIT license

About

Balderhub Project for CREATE, RETRIEVE, UPDATE and DELETE data.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages