netrias_client 0.0.7

Python client for the Netrias harmonization API

Netrias Client

"""Explain how to install and exercise the Netrias harmonization client."""

Install with uv

• Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh
• Create, activate, and sync virtual environment:

uv venv
source .venv/bin/activate
uv sync

"""Use the Netrias to harmonize data via the Netrias API."""

import os
from pathlib import Path
from typing import Final

from dotenv import load_dotenv
from netrias_client import NetriasClient

# Create a Netrias Client and populate it with your API key
netrias_client = NetriasClient(api_key={Insert API key here})

# Point to the csv file to harmonize
CSV_PATH: Final[Path] = Path("data") / "primary_diagnosis_1.csv"

# Determine the data -> CDE mapping
cde_map = netrias_client.discover_cde_mapping(source_csv=CSV_PATH, target_schema="ccdi")

# Harmonize the data
result = netrias_client.harmonize(source_path=CSV_PATH, cde_map=cde_map)
print(f\"Harmonize job id: {result.job_id}\")  # available immediately for tracking
print(f\"Harmonized file: {result.file_path}\")
print(f\"Manifest file: {result.manifest_path}\")

Configuration Options

NetriasClient(...) accepts additional tuning knobs (and you can still call configure(...) to reconfigure an existing instance). You can mix and match the ones you need:

Parameter	Type	Purpose
api_key	str	Required. Bearer token for authenticating with the Netrias services.
confidence_threshold	`float	None`
timeout	`float	None`
log_level	`LogLevel	str
discovery_use_gateway_bypass	`bool	None`
log_directory	`Path	str

Configure only the options you need; unspecified values fall back to sensible defaults.

Usage Notes

• discover_cde_mapping(...) samples CSV values and returns a CDE map payload
• Call harmonize(...) or harmonize_async(...) (async) with the CDE map to download a harmonized CSV and its manifest parquet. The result object reports status, description, and output paths.
• The package exposes __version__ so callers can assert the installed release.
• Optional extras (netrias_client[aws]) add boto3 helpers for the temporary gateway bypass.