Meridian Synthetic Plugin

meridian-plugin-synthetic is the in-process, deterministic synthetic-data generation plugin for Meridian V1. It generates schema-valid Records, relation-aware fixtures, canonical datasets, and provider-neutral Events. Every write goes through released Meridian public contracts.

This repository contains exactly one Python distribution and is licensed under the Apache License, Version 2.0.

Install

The plugin requires the released Meridian V1 Core, Semantics, Query, Evidence, and Streaming distributions. After those artifacts are available:

python -m pip install meridian-plugin-synthetic

Use

from meridian_storage.plugins.synthetic import Generator, MemorySink, SyntheticSpec

spec = SyntheticSpec.load(spec_document)
sink = MemorySink(max_bytes=spec.bounds.max_memory_bytes)
run = Generator(spec).run(sink, workers=4)

assert run.validation.passed
records = sink.records(run.run_id)

SyntheticSpec pins the package coordinate, optional implementation digest, schema fingerprints, seed, locale set, time interval, counts, generators, relations, validation rules, output mode, and execution bounds. Random streams are derived from logical coordinates, so partitioning, worker count, and run ID do not change generated values.

Available sinks are:

  • MemorySink for bounded tests and fixtures;
  • MeridianRecordSink for public structured.put writes;
  • MeridianStreamingSink for public streaming.publish_batch writes; and
  • CanonicalDatasetSink for canonical NDJSON partitions followed by an explicit ArtifactPublisher hand-off.

Direct Record writes require a DirectWritePolicy. Production targets require an explicit approval flag from the owning process. Dataset publication never uses the Object Catalog directly; the caller supplies the Configuration & Artifact plugin bridge.

Source-backed generation accepts only an explicit, projected structured.query Expression and a digest-pinned deterministic transform. Run evidence includes source boundaries, query fingerprints, transform digests, and row counts, but never source values.

Contracts and support

Serialized schemas are in contracts, design alignment is in docs/architecture.md, and the compatibility pin is in compatibility.json. Python 3.12 through 3.14 is supported. Report vulnerabilities using SECURITY.md.

Project links

Data verified by PyPI on Aug 27, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for vanzeph from gravatar.com vanzeph

Credits

Author: Meridian contributors

GitHub Statistics

Data verified by PyPI on Aug 27, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

Apache-2.0
View SPDX License List

Requires

Python <3.15, >=3.12

Provides Extra

test

Tags

fixtures meridian streaming synthetic-data testing

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

meridian_plugin_synthetic-1.0.0.tar.gz (61.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

meridian_plugin_synthetic-1.0.0-py3-none-any.whl (58.4 kB view details)

Uploaded Python 3

File details

Details for the file meridian_plugin_synthetic-1.0.0.tar.gz.

File metadata

File hashes

Hashes for meridian_plugin_synthetic-1.0.0.tar.gz
Algorithm Hash digest
SHA256 d3bfb831100c177338fd7fa3f3796cf6aab4596312e8fd9726d911bb1369b897
MD5 36ddb175ad80272f87b6d19bc4d3d9e3
BLAKE2b-256 3f8801bea1ca0dde23297338401888cea79cd4704d3cf65ae691e8d934270d50

See more details on using hashes here.

Provenance

The following attestation bundles were made for meridian_plugin_synthetic-1.0.0.tar.gz:

Publisher: publish-pypi.yml on zephytiju/meridian-plugin-synthetic

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file meridian_plugin_synthetic-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for meridian_plugin_synthetic-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 da874332a9adc9102a84feb808a5dae35f3c6cb9352aa09a703fdb91fce4c715
MD5 15caab0699d44cdff0e9eac519e80086
BLAKE2b-256 adbfea60d46b8d0b3d3e3a7287efd3aa692eefb1438c4a3312f3d10a49397a21

See more details on using hashes here.

Provenance

The following attestation bundles were made for meridian_plugin_synthetic-1.0.0-py3-none-any.whl:

Publisher: publish-pypi.yml on zephytiju/meridian-plugin-synthetic

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page