---
id: pipelinewise-singer-python
version: "3.0.2"
license: unclear
license_treatment: permissive
maintenance: active
---

# pipelinewise-singer-python — Singer.io utility library - PipelineWise compatible

License: permissive · Maintenance: active · Downloads: 934.9K/mo

## What it is and what it does

pipelinewise-singer-python is a Python library that implements the Singer protocol for writing standardized data records. It's a maintained fork of the original Singer library, adapted for use within PipelineWise data pipelines. The package provides functions to write schemas, records, and state information in Singer format—a line-delimited JSON standard used in data extraction and loading workflows.

The library depends on common utilities like jsonschema for validation, orjson for fast JSON serialization, and backoff for retry logic. It's designed to be used within a Python environment (typically a virtualenv) to emit Singer-formatted output that downstream tools can consume. The package supports optional logging configuration via an environment variable, allowing callers to integrate it into their own logging infrastructure.

Use it for:

- Build custom data extractors that emit Singer-formatted records for ingestion into PipelineWise.
- Integrate Python-based data sources into Singer-compatible ETL pipelines.
- Write schema and state metadata alongside record data in a standardized format for data synchronization.
- Extend PipelineWise tap connectors with Python logic that outputs Singer protocol messages.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Writes data in Singer format from Python, enabling standardized data pipeline integration compatible with PipelineWise.

Yes, if you are building or extending PipelineWise data pipelines and need to emit Singer-formatted output from Python. The package is actively maintained, has low install friction, and carries a permissive license. The narrow Python version constraint (3.12–3.13) is a significant limitation if your project targets a wider range; verify compatibility with your environment before committing.

## Install

pip install pipelinewise-singer-python
uv add pipelinewise-singer-python
poetry add pipelinewise-singer-python

## Installing pipelinewise-singer-python

Before you install: Low install friction with a pure-Python wheel and seven common dependencies. Active maintenance with a recent release, though the repository has modest visibility (8 stars).

License in practice: Permissive Apache License 2.0 allows commercial and private use with minimal restrictions.

Quickstart:

pip install pipelinewise-singer-python

import singer

singer.write_schema('my_table', {'properties': {'id': {'type': 'string', 'key': True}}}, ['id'])
singer.write_records('my_table', [{'id': 'b'}, {'id': 'd'}])
singer.write_state({'my_table': 'd'})

Requires Python 3.12 or 3.13 (capped_below_current); earlier or later versions will not work.

Verify before relying:

- Whether the narrow Python version range (3.12–3.13) is intentional or a packaging constraint that may be relaxed.
- How actively the PipelineWise fork diverges from the upstream singer-python project and whether upstream fixes are backported.

## Package facts

- License: not declared (permissive)
- Python support: capped_below_current
- Install friction: low
- Maintenance: active
- Downloads: 934.9K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

singer format python library, data pipeline singer protocol, pipelinewise singer integration, write singer schema records, etl singer format output, data extraction singer standard, data-pipeline, etl, singer-protocol

[View on SkillFed](https://skillfed.io/packages/pipelinewise-singer-python) · [View on PyPI](https://pypi.org/project/pipelinewise-singer-python/)