Skip to main content

Urgap - node wrapping framework

Urgap is a cloud-native framework for file-based data engineering, containing abstraction layers for data and meta data, extensive re-run skipping logic and data versioning. Urgap can be incorporated with any scheduling/pipelining tool making pipeline development independent from business logic and data storage, while offering standardized logging and execution, which makes monitoring and debugging easy.

Urgap gives us the governance constraints required for a decentralized data domain autonomy as Urgap will enforce shared common data IO for storage, a common meta data capturing process in form of an interface thus can be plugged into any existing processes and finally global data lineages.

ADO CI status

Learn More

Watch our introduction talk urgap - unified resource governance and data provenance by Christian Fufezan to get a comprehensive overview of urgap’s design and capabilities:

Watch the video

How to Setup

Prerequisites

We recommend using a virtual environment for Python projects. This guide uses uv for dependency management.

Installation

Basic Installation (local file system access only):

uv sync

With Cloud Storage Support:

uv sync --extra cloud

With All Runtime Extras:

uv sync --extra all

Available extras include:

  • server: FastAPI/Flask/uvicorn + MCP server for uctl run

  • tabular: pandas/polars/pyarrow and Excel engines for tabular unodes

  • viz: plotly-based reporting and visualizer unodes

  • github: GitHub-backed file IO

  • cloud: Azure and Google Cloud storage backends

  • databases: PostgreSQL backend

  • docs: Sphinx documentation build

  • dev: test tooling (pytest) plus all runtime extras

  • all: every runtime extra above (not dev or docs)

Running Tests

Install test dependencies:

uv sync --extra dev

Run the test suite:

uv run pytest tests

Quickstart: Writing Your First Pipeline

The best way to learn urgap is through a complete example. Check out the end-to-end filter CSV pipeline:

  • Location: tests/integrationtests/end2end/test_filter_csv_pipeline.py

  • What it demonstrates: Complete pipeline setup, node configuration, and execution

  • Requirements: Everything needed to run this example is included in the repository

This example can be run entirely on your local machine without any external dependencies.

To run the example:

pytest tests/integrationtests/end2end/test_filter_csv_pipeline.py

Documentation

Please use sphinx in the docs folder

Metadata

Release files for urgap 3.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for urgap 3.6.0
File Size Uploaded
urgap-3.6.0.tar.gz 349.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for urgap 3.6.0
File Interpreter ABI Platform
urgap-3.6.0-py3-none-any.whl Python 3 none any Details

Total release size: 770.1 kB

Release files / urgap-3.6.0.tar.gz

Download URL urgap-3.6.0.tar.gz
Size 349.3 kB
Tags Source
SHA-256 checksum
How to use checksums
5c979692ab4d1f9303187dacf81b1b6c2929abef0fd4d5695b7c2aa1b190da32
BLAKE2b-256 checksum
How to use checksums
2526294cf4371be5d47c72e98f5ec12b1ff1d495f1b6760dd2d7ea58f52b3aa4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / urgap-3.6.0-py3-none-any.whl

Download URL urgap-3.6.0-py3-none-any.whl
Size 420.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
34a8d867f52ee6a27cdb0f1bf20fa4c5efaf2965fbc0761cb84a94adcd754dc3
BLAKE2b-256 checksum
How to use checksums
d134b60e8c3ddbb397ccd5ad21b0026a780b00f64d8404d07adbe8db49be72bc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Release history Release notifications | RSS feed

This release

3.6.0 This release

2 release files

3.5.1

2 release files

3.5.0

2 release files

3.4.1

2 release files

3.4.0

2 release files

3.3.14

2 release files

3.3.13

2 release files

3.3.12

2 release files

3.3.11

2 release files

3.3.9

2 release files

3.3.8

2 release files

3.3.7

2 release files

3.3.6

2 release files

3.3.5

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page