Skip to main content

Identity resolution and Customer 360 libraries (Splink, DuckDB).

Project description

SPAN

span_data is a Python library for customer data resolution and unification.

Early release. This package is under active development, and the public API and import paths may change between releases. We expect to follow semantic versioning more strictly after a 1.0 stable baseline; until then, treat upgrades as potentially breaking. Pin a specific version in production and review span_data/packaging_info/CHANGELOG.md before upgrading.

Modules

id_grapher

Identity resolution built on Splink and DuckDB. Links records that refer to the same entity across one or more source datasets and produces a unified ID graph keyed on profile_id.

from span_data.id_grapher import IDGrapher, FieldDefinitionMap, Overrides

Key capabilities:

  • Ingest source data from pandas DataFrames, CSV files, and Snowflake tables or views.
  • Clean and normalise source fields (text, email, phone number).
  • Resolve entities into profile clusters with Splink-based probabilistic matching.
  • Export graph results to DataFrames, CSV, Parquet, DuckDB relations, and Snowflake.
  • Apply manual override workflows for merge, split, and assign operations.

See span_data/id_grapher/README.md for usage, test options, and benchmarks.

c360_compiler

Customer 360 pipeline built on DuckDB. Reads a YAML config to consolidate data from multiple source systems into a single unified customer view.

from span_data.c360_compiler import C360Compiler, load_config

Key capabilities:

  • Merge customer demographics from multiple dimension sources with configurable waterfall precedence.
  • Compute rolling-window metrics (6-month, 12-month, lifetime) from fact tables.
  • Build a consent fact table with two-tier taxonomy (purpose / medium) and conflict resolution.
  • Generate boolean and categorical customer segments.
  • Enrich fact tables with profile_id and deterministic hash keys.

See span_data/c360_compiler/README.md for full configuration reference and usage.

Python Support

This package currently supports Python >=3.11,<3.12.

Usage

See SPAN Product Documentation for usage instructions.

License

This project is licensed under the BSD 3-Clause License. See span_data/packaging_info/LICENSE.

Third-party dependency license information is documented in span_data/packaging_info/THIRD_PARTY_NOTICES.md.

Release history is documented in span_data/packaging_info/CHANGELOG.md.

Project details


Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

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

span_data-0.2.0-cp311-cp311-win_amd64.whl (1.2 MB view details)

Uploaded CPython 3.11Windows x86-64

span_data-0.2.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (1.6 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

span_data-0.2.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl (1.5 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.17+ ARM64manylinux: glibc 2.28+ ARM64

span_data-0.2.0-cp311-cp311-macosx_11_0_arm64.whl (1.1 MB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

span_data-0.2.0-cp311-cp311-macosx_10_9_x86_64.whl (1.2 MB view details)

Uploaded CPython 3.11macOS 10.9+ x86-64

File details

Details for the file span_data-0.2.0-cp311-cp311-win_amd64.whl.

File metadata

  • Download URL: span_data-0.2.0-cp311-cp311-win_amd64.whl
  • Upload date:
  • Size: 1.2 MB
  • Tags: CPython 3.11, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for span_data-0.2.0-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 93ce9a1a0e94d83c547676f4daad9e92c9eef4253e32c09724dccb039d6873f1
MD5 493717dc49c5ca2fa59105258b295e1b
BLAKE2b-256 604ffa764ce589006dcda87106f66e9697d7fe5903252f176a97d6948726bc26

See more details on using hashes here.

Provenance

The following attestation bundles were made for span_data-0.2.0-cp311-cp311-win_amd64.whl:

Publisher: build-wheels.yml on thedataloft/SPAN

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

File details

Details for the file span_data-0.2.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for span_data-0.2.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 f11729d523c88a901651f0afba569b29a8d67134c8642923e89b6e2f401c9db4
MD5 85e8ca0ad0f9dfdcaf664082d90f95ad
BLAKE2b-256 1fe36468a1144fca5ccfecf566a562407fc146072352834ef987edb0d9eb7aea

See more details on using hashes here.

Provenance

The following attestation bundles were made for span_data-0.2.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl:

Publisher: build-wheels.yml on thedataloft/SPAN

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

File details

Details for the file span_data-0.2.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for span_data-0.2.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 37fd72b1599de8a420c7dcc34d5d08ae557f6cb791661b7037bac77087795597
MD5 cfd1c58ae6b059f28c8fc108bcca59c8
BLAKE2b-256 a0796a98090714bd501414e5d6f5f7a326865f01116f24202ccf23537f3c2a90

See more details on using hashes here.

Provenance

The following attestation bundles were made for span_data-0.2.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl:

Publisher: build-wheels.yml on thedataloft/SPAN

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

File details

Details for the file span_data-0.2.0-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for span_data-0.2.0-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 a332b19d34bdeadf5707a51bab1de5d60e9278ea6bbc85728903ac8553114383
MD5 e44c47bccabc63b111489b6694a33d27
BLAKE2b-256 8dc19dfabef4f41cc6820d2a1a36c101da0651f22925147ccccd3adfa4a040fa

See more details on using hashes here.

Provenance

The following attestation bundles were made for span_data-0.2.0-cp311-cp311-macosx_11_0_arm64.whl:

Publisher: build-wheels.yml on thedataloft/SPAN

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

File details

Details for the file span_data-0.2.0-cp311-cp311-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for span_data-0.2.0-cp311-cp311-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 6c59cdaca340727dd77633d1bea3d80baa1e6c2c45994ba09d13bb77cf11673d
MD5 68e295633a192cad749f895ce37d1bbe
BLAKE2b-256 06d65320df5f893676a97559f7ab40ecded70f45c10653956e0f23e1b8f9db2b

See more details on using hashes here.

Provenance

The following attestation bundles were made for span_data-0.2.0-cp311-cp311-macosx_10_9_x86_64.whl:

Publisher: build-wheels.yml on thedataloft/SPAN

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

Supported by

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