Releases: meltano/sdk
Releases · meltano/sdk
v0.50.2
v0.50.1
Immutable
release. Only release title and notes can be modified.
v0.50.0
Immutable
release. Only release title and notes can be modified.
v0.50.0 (2025-10-01)
✨ New
- #3279 Emit structured logs and document this new capability for downstream consumers
🐛 Fixes
- #3287 Handle presence of
charsetinContent-Typeheader when retrieving schema from OpenAPI spec - #3286 Only write starting replication value for incremental streams -- Thanks @ReubenFrankel!
⚙️ Under the Hood
- #3292 Remove deprecated
SingerMetricsFormatter - #3291 Remove unsupported
common_optionsmodule - #3290 Remove
metrics_log_levelsetting in favor of application log level - #3289 Move some noisy logs to the DEBUG level
- #3281 Emit structured exception information
- #3285 Use the stream logger to log events in HTTP streams
- #3283 Pass around raw
Pointinstance for metrics - #3282 Avoid printing raw tracebacks to keep stderr clean
Contributors
ReubenFrankel
Assets 2
v0.49.1
Immutable
release. Only release title and notes can be modified.
v0.49.0
Immutable
release. Only release title and notes can be modified.
v0.49.0 (2025-09-11)
✨ New
- #3262 By default
ObjectTypefields now useadditionalProperties: true - #3196 Use
tyto check types in tap, target and mapper templates
🐛 Fixes
- #3257 Add
DecimalTypealias forNumberType
⚙️ Under the Hood
- #3269 Move all SQLAlchemy-related classes to
singer_sdk.sql, deprecate old locations and add asqldependency extra - #3268 Deprecate the
streamattribute in authenticator constructors and also deprecate thecreate_for_streammethod - #3267 Use
typing.overridein mapper and tap templates - #3177 Remove unused
plugin_typeattribute from test template classes - #3253 Use slotted dataclasses
📚 Documentation Improvements
- #3258 Update docs landing page
- #3254 Link to https://github.com/meltano/sdk/contribute
📦 Packaging changes
- #3252 Dropped support for Python 3.9
v0.48.1
v0.48.1 (2025-08-21)
✨ New
- #3238 Auto-detect and load YAML-formatted OpenAPI specs
- #3227 Get the supported Python versions in
--aboutoutput from PyPI classifiers if they are available - #3226 Declare Python 3.14 support in templates
- #3223 Add a metrics exclusion filter
- #3222 Dropped support for Python 3.9 in tap, target and mapper templates
🐛 Fixes
- #3236 Restore
<4Python version constraint forbackoffdependency - #3234 Avoid spamming warnings when record field is not found in schema
- #3216 Use
uvin templates README - #3215 Set the dependabot ecosystem to
uvin templates - #3214 Remove duplicate prefix from generated
.envin templates - #3212 Update the type annotation of
RESTStream.backoff_runtimeto support any number type
⚙️ Under the Hood
- #3233 Raise a
DiscoveryErrorwhen schema for stream is not provided - #3231 Add type parameters to decorated request function
- #3228 Move exception when schema is not provided to the stream outside of the constructor
📦 Packaging changes
- #3224 Bump hatch-vcs to 0.5.0
v0.48.0
v0.48.0 (2025-08-04)
Highlights
Schema sources
The Singer SDK now provides an extensible API for loading schemas from various sources through the SchemaSource API. For example,
from typing import ClassVar
from singer_sdk import OpenAPISchema, StreamSchema
# Load from OpenAPI spec
openapi_source = OpenAPISchema("https://api.example.com/openapi.json")
class UsersStream(RESTStream):
name = "users"
schema: ClassVar[StreamSchema] = StreamSchema(openapi_source, key="User") # Load "User" componentDocs: https://sdk.meltano.com/en/v0.48.0/guides/schema-sources.html
✨ New
- #3207 Automatically handle OpenAPI 2.0 and 3.0 specs
- #3200 Expose new variable
__original_stream_name__in stream maps -- Thanks @ReubenFrankel! - #3198 Update SQL tap and target templates with latest APIs
- #3190 Added an extensible API for stream schema sources
- #3189 Added
.env.examplefiles to tap, target and mapper templates - #3188 Update tap, target and mapper dependencies in templates
- #3151 Define internal schema for
stream_maps - #3141 Support disabling stream pagination logic -- Thanks @ReubenFrankel!
🐛 Fixes
- #3165 Honor order of primary key columns when creating an empty table
- #3160 Make output of
--about --format=markdowncompliant with CommonMark - #3147 Run mypy in templates inside of a virtualenv including the package
- #3148 Fixed the return type of
RESTStream.get_new_paginatorto indicate returningNoneis supported to indicate no pagination - #3145 Handle logging configuration not found gracefully
- #3065 Revert table name splitting by
-in SQL targets whendefault_target_schemais set, introduced in #3020 - #3127 Ensure Singer SDK warnings are logged
- #3114 Centralize state writing to avoid emitting duplicate STATE messages
⚙️ Under the Hood
- #3206 Make
RESTStream.records_jsonpathread-only by default - #3204 Make
get_stream_schemathe public API of theStreamSchemadescriptor - #3203 Make
SchemaSourcegeneric on any hashable key type - #3201 Make
capabilitiesa proper class attribute for tap, target and mapper classes - #3187 Consolidate test parameters in built-in tests
- #3181 Update type annotations of some functions to indicate they accept string path or a path-like object
- #3180 Remove no-op deadcode for handling secret values
- #3178 Check explicitly for a
BaseTestClasssubclass when generating built-in tests - #3175 Add type parameters to generic
SingerTestRunnerclass - #3172 Use explicit submodule imports
- #3166 Use the
jsonschemavalidator instance directly instead of routing throughjsonschema.validators.validator_for - #3164 Rename
TestSuite→SingerTestSuiteto prevent a pytest test collection warning - #3153 Read config files early
- #3152 Use a
clickcallback to parse config input arguments and deprecatePluginBase.config_from_cli_args - #3144 Pass catalog and state files early and pass the corresponding dictionaries to the tap class
- #3123 Remove
Fakerclass from stream maps - #3121 Remove
singer_sdk._singerlib
📚 Documentation Improvements
📦 Packaging changes
Contributors
ReubenFrankel