Skip to main content

Hotglue SDK for Taps

This is a fork of Melanto's SingerSDK for special use in hotglue, an embedded integration platform for running Singer Taps and Targets.

Taps and targets built on the SDK are automatically compliant with the Singer Spec, the de-facto open source standard for extract and load pipelines.

OAuth Access Token Support

Taps can implement the --access-token CLI flag to refresh OAuth access tokens without running the tap directly.

Implementing Access Token Support

To enable this feature in your tap, override the access_token_support class method to return a tuple of (authenticator_class, auth_endpoint):

from hotglue_singer_sdk import Tap
from my_tap.auth import MyOAuthAuthenticator

class MyTap(Tap):
    name = "tap-myservice"

    @classmethod
    def access_token_support(cls, connector=None):
        """Return the authenticator class and auth endpoint for token refresh.

        Returns:
            A tuple of (authenticator_class, auth_endpoint).
        """
        default_url = "https://api.myservice.com/oauth/token"
        # ommit if token url is not dynamic
        dynamic_url = connector.config.get("auth_url")
        url = dynamic_url or default_url
        return (MyOAuthAuthenticator, url)

Authenticator Requirements

The authenticator class must implement the following methods:

  • is_token_valid() - Returns True if the current access token is still valid
  • update_access_token() - Refreshes the access token and updates the config file

The authenticator will be instantiated with these parameters:

  • stream - A dummy stream object with logger, tap_name, and config attributes
  • config_file - Path to the config file for writing updated tokens
  • auth_endpoint - The OAuth token endpoint URL

Usage

Once implemented, users can refresh the access token using:

tap-myservice --config config.json --access-token

This will output the new access token as JSON:

{
  "access_token": "new_token_value"
}

Note: The --access-token flag requires a config file path. It will not work with --config ENV or when omitting the config.

Metadata

Release files for hotglue-singer-sdk 1.0.52

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

Source distribution (sdist)

Source distribution for hotglue-singer-sdk 1.0.52
File Size Uploaded Provenance Actions
hotglue_singer_sdk-1.0.52.tar.gz 116.2 kB Without provenance Details for hotglue_singer_sdk-1.0.52.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for hotglue-singer-sdk 1.0.52
File Interpreter ABI Platform Actions
hotglue_singer_sdk-1.0.52-py3-none-any.whl Python 3 none any Details for hotglue_singer_sdk-1.0.52-py3-none-any.whl

Total release size: 259.0 kB

Release files / hotglue_singer_sdk-1.0.52.tar.gz

Download URL hotglue_singer_sdk-1.0.52.tar.gz
Size 116.2 kB
Tags Source
SHA-256 checksum
How to use checksums
54fd6b6592d9b4e31446f08c5ece1e31ed75e25e6af33f3f496d49c49bc60c30
BLAKE2b-256 checksum
How to use checksums
a620469d0d92f28a2c077efa52b687bc06816bad127cb5373cd43c706e6d6d6e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.22

Release files / hotglue_singer_sdk-1.0.52-py3-none-any.whl

Download URL hotglue_singer_sdk-1.0.52-py3-none-any.whl
Size 142.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fb92e0c99b1a940822eb5c4b102e8333dc1934df48460f54cd4d00f23c76574b
BLAKE2b-256 checksum
How to use checksums
f2a5fcadc61a9569aba88e4f1e47cd61c3f51003dfc36c7f3427dc2d9d635a16
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.22

Security for hotglue-singer-sdk 1.0.52

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.52 This release

2 release files No provenance

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