tap-tempo is a Singer tap for Tempo.
Built with the Meltano Tap SDK for Singer Taps.
catalogstatediscoveractivate-versionaboutstream-mapsschema-flatteningbatch
- 3.10
- 3.11
- 3.12
- 3.13
- 3.14
| Setting | Required | Default | Description |
|---|---|---|---|
| auth_token | True | None | The token to authenticate against the API service |
| start_date | False | None | The earliest record date to sync |
| api_url | False | https://api.tempo.io/4 | The url for the API service |
| user_agent | False | None | A custom User-Agent header to send with each request. Default is '<tap_name>/<tap_version>' |
| stream_maps | False | None | Config object for stream maps capability. For more information check out Stream Maps. |
| stream_maps.else | False | None | Currently, only setting this to __NULL__ is supported. This will remove all other streams. |
| stream_map_config | False | None | User-defined config values to be used within map expressions. |
| faker_config | False | None | Config for the Faker instance variable fake used within map expressions. Only applicable if the plugin specifies faker as an additional dependency (through the singer-sdk faker extra or directly). |
| faker_config.seed | False | None | Value to seed the Faker generator for deterministic output: https://faker.readthedocs.io/en/master/#seeding-the-generator |
| faker_config.locale | False | None | One or more LCID locale strings to produce localized output for: https://faker.readthedocs.io/en/master/#localization |
| flattening_enabled | False | None | 'True' to enable schema flattening and automatically expand nested properties. |
| flattening_max_depth | False | None | The max depth to flatten schemas. |
| batch_config | False | None | Configuration for BATCH message capabilities. |
| batch_config.encoding | False | None | Specifies the format and compression of the batch files. |
| batch_config.encoding.format | False | None | Format to use for batch files. |
| batch_config.encoding.compression | False | None | Compression format to use for batch files. |
| batch_config.storage | False | None | Defines the storage layer to use when writing batch files |
| batch_config.storage.root | False | None | Root path to use when writing batch files. |
| batch_config.storage.prefix | False | None | Prefix to use when writing batch files. |
A full list of supported settings and capabilities for this tap is available by running:
tap-tempo --about --format=markdownThis Singer tap will automatically import any environment variables within the working directory's
.env if the --config=ENV is provided, such that config values will be considered if a matching
environment variable is set either in the terminal context or in the .env file.
Bearer token is used for authorization. See more details: https://apidocs.tempo.io/#section/Authentication
You can easily run tap-tempo by itself or in a pipeline using Meltano.
tap-tempo --version
tap-tempo --help
tap-tempo --config CONFIG --discover > ./catalog.jsonFollow these instructions to contribute to this project.
Prerequisites:
- Python 3.10+
- uv
uv syncCreate tests within the tests subfolder and
then run:
uv run pytestYou can also test the tap-tempo CLI interface directly using uv run:
uv run tap-tempo --helpTesting with Meltano
Note: This tap will work in any Singer environment and does not require Meltano. Examples here are for convenience and to streamline end-to-end orchestration scenarios.
Next, install Meltano (if you haven't already) and any needed plugins:
# Install meltano
uv tool install meltano
# Initialize meltano within this directory
cd tap-tempo
meltano installNow you can test and orchestrate using Meltano:
# Test invocation:
meltano invoke tap-tempo --version
# OR run a test ELT pipeline:
meltano run tap-tempo target-jsonlSee the dev guide for more instructions on how to use the SDK to develop your own taps and targets.