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.

Release files for hotglue-singer-sdk 1.0.49

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.49
File	Size	Uploaded
hotglue_singer_sdk-1.0.49.tar.gz	114.9 kB	Sep 23, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for hotglue-singer-sdk 1.0.49
File	Interpreter	ABI	Platform	Reset
hotglue_singer_sdk-1.0.49-py3-none-any.whl 141.6 kB Sep 23, 2026	Python 3	none	any	Details

Total release size: 256.5 kB

Release files / hotglue_singer_sdk-1.0.49.tar.gz

Download URL	hotglue_singer_sdk-1.0.49.tar.gz
Size	114.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`34c38df3cfede6db8021e05c04e397d97590aa850c2bbff3d1cd7dd243fbb167`
BLAKE2b-256 checksum How to use checksums	`61b518193dea969ea54440497b948dda81ae5f53ae08b330a721ce0c5fbdb329`
Upload date	Sep 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.10.21`

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

Download URL	hotglue_singer_sdk-1.0.49-py3-none-any.whl
Size	141.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b9fe95bd3468704045063b988c631dd0a90c55ade99049c58a1fc3288a72f6a9`
BLAKE2b-256 checksum How to use checksums	`5d98617779bd477139bf19fed1e6628f0c39a7628305e5b6d42738d5ad8cdb74`
Upload date	Sep 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.10.21`