Singer tap for Jotform, built with the Meltano SDK for Singer Taps.
Project description
Capabilities
catalog
state
discover
about
stream-maps
schema-flattening
Settings
Setting | Required | Default | Description |
---|---|---|---|
api_key | True | None | Authentication key. See https://api.jotform.com/docs/#authentication |
api_url | False | https://api.jotform.com | API Base URL |
user_agent | False | tap-jotform/0.0.1 | User-Agent header |
start_date | False | None | Start date for data collection |
requests_cache | False | None | Cache configuration for HTTP requests |
stream_maps | False | None | Config object for stream maps capability. For more information check out Stream Maps. |
stream_map_config | False | None | User-defined config values to be used within map expressions. |
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. |
A full list of supported settings and capabilities is available by running: tap-jotform --about
Source Authentication and Authorization
To generate an API key, follow the instructions in https://api.jotform.com/docs/#gettingstarted.
Usage
You can easily run tap-jotform
by itself or in a pipeline using Meltano.
Executing the Tap Directly
tap-jotform --version
tap-jotform --help
tap-jotform --config CONFIG --discover > ./catalog.json
Developer Resources
Initialize your Development Environment
pipx install poetry
poetry install
Create and Run Tests
Create tests within the tap_jotform/tests
subfolder and
then run:
poetry run pytest
You can also test the tap-jotform
CLI interface directly using poetry run
:
poetry run tap-jotform --help
Testing 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.
Your project comes with a custom meltano.yml
project file already created. Open the meltano.yml
and follow any "TODO" items listed in
the file.
Next, install Meltano (if you haven't already) and any needed plugins:
# Install meltano
pipx install meltano
# Initialize meltano within this directory
cd tap-jotform
meltano install
Now you can test and orchestrate using Meltano:
# Test invocation:
meltano invoke tap-jotform --version
# OR run a test `elt` pipeline:
meltano elt tap-jotform target-jsonl
SDK Dev Guide
See the dev guide for more instructions on how to use the SDK to develop your own taps and targets.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for tap_jotform-0.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b4ed2b2f09545f80fdcd3615f2797bdb6e4794e29692ed31edef5a9f7112d6db |
|
MD5 | 8a7e0d5da0bfb3b382d33711d11c2a11 |
|
BLAKE2b-256 | 1f8fe2893b04f60cf3503f5bf24a226a40909597e5c6b813b61618a58a07eb20 |