An open API service indexing awesome lists of open source software.

https://github.com/b-ryan/cookiecutter-singer-tap


https://github.com/b-ryan/cookiecutter-singer-tap

Last synced: about 2 months ago
JSON representation

Awesome Lists containing this project

README

          

# cookiecutter-singer-tap

A [cookiecutter](https://github.com/audreyr/cookiecutter) template for creating
[Singer](https://github.com/singer-io) taps.

## Usage

The best way to demonstrate creating your tap structure is with an example.
Below I will initialize the "tap-foobar" project:

```bash
$ pip install cookiecutter
$ # the next command will ask for some input:
$ cookiecutter https://github.com/b-ryan/cookiecutter-singer-tap.git
project_name [tap-zendesk-chat]: tap-foobar
package_name [tap_foobar]:
$ # For the package_name, I just hit enter since tap_foobar is what I wanted
$ cd tap-foobar
```

Now that the project exists, you can make a virtualenv and invoke the tap:

```bash
$ mkvirtualenv -p $(which python3) tap-foobar
...
$ ./setup.py develop
...
$ tap-foobar
usage: tap-foobar [-h] -c CONFIG [-s STATE] [-p PROPERTIES]
[--catalog CATALOG] [-d]
tap-foobar: error: the following arguments are required: -c/--config
```

Now you build the tap!

## Example Taps

These taps were built using this template:

- [tap-zendesk-chat](https://github.com/singer-io/tap-zendesk-chat)
- [tap-jira](https://github.com/singer-io/tap-jira)