Skip to content

Commit 5bd172d

Browse files
chore: Update README (#140)
1 parent d91dc50 commit 5bd172d

File tree

1 file changed

+29
-8
lines changed

1 file changed

+29
-8
lines changed

README.md

Lines changed: 29 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -33,13 +33,37 @@ Built with the [Meltano Tap SDK](https://sdk.meltano.com) for Singer Taps.
3333

3434
## Settings
3535

36-
- [ ] `Developer TODO:` Declare tap settings here.
36+
| Setting | Required | Default | Description |
37+
| :--------- | :------- | :------ | :--------------------------------- |
38+
| api_key | True | None | API Key for Socket |
39+
| start_date | False | None | Earliest datetime to get data from |
3740

3841
A full list of supported settings and capabilities is available by running: `tap-socketdev --about`
3942

43+
### Builtin Settings
44+
45+
The following settings are available to all taps.
46+
47+
| Setting | Required | Default | Description |
48+
| :-------------------------------- | :------- | :------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
49+
| stream_maps | False | None | Config object for stream maps capability. For more information check out [Stream Maps](https://sdk.meltano.com/en/latest/stream_maps.html). |
50+
| stream_map_config | False | None | User-defined config values to be used within map expressions. |
51+
| faker_config | False | None | Config for the [`Faker`](https://faker.readthedocs.io/en/master/) 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). |
52+
| faker_config.seed | False | None | Value to seed the Faker generator for deterministic output: https://faker.readthedocs.io/en/master/#seeding-the-generator |
53+
| faker_config.locale | False | None | One or more LCID locale strings to produce localized output for: https://faker.readthedocs.io/en/master/#localization |
54+
| flattening_enabled | False | None | 'True' to enable schema flattening and automatically expand nested properties. |
55+
| flattening_max_depth | False | None | The max depth to flatten schemas. |
56+
| batch_config | False | None | Configuration for BATCH message capabilities. |
57+
| batch_config.encoding | False | None | Specifies the format and compression of the batch files. |
58+
| batch_config.encoding.format | False | None | Format to use for batch files. |
59+
| batch_config.encoding.compression | False | None | Compression format to use for batch files. |
60+
| batch_config.storage | False | None | Defines the storage layer to use when writing batch files |
61+
| batch_config.storage.root | False | None | Root path to use when writing batch files. |
62+
| batch_config.storage.prefix | False | None | Prefix to use when writing batch files. |
63+
4064
### Source Authentication and Authorization
4165

42-
- [ ] `Developer TODO:` If your tap requires special access on the source system, or any special authentication requirements, provide those here.
66+
- [Creating and Managing API Tokens](https://docs.socket.dev/reference/creating-and-managing-api-tokens).
4367

4468
## Usage
4569

@@ -55,12 +79,10 @@ tap-socketdev --config CONFIG --discover > ./catalog.json
5579

5680
## Developer Resources
5781

58-
- [ ] `Developer TODO:` As a first step, scan the entire project for the text "`TODO:`" and complete any recommended steps, deleting the "TODO" references once completed.
59-
6082
### Initialize your Development Environment
6183

6284
```bash
63-
pipx install poetry
85+
uv tool install poetry
6486
poetry install
6587
```
6688

@@ -83,14 +105,13 @@ poetry run tap-socketdev --help
83105
_**Note:** This tap will work in any Singer environment and does not require Meltano.
84106
Examples here are for convenience and to streamline end-to-end orchestration scenarios._
85107

86-
Your project comes with a custom `meltano.yml` project file already created. Open the `meltano.yml` and follow any _"TODO"_ items listed in
87-
the file.
108+
Your project comes with a custom `meltano.yml` project file already created.
88109

89110
Next, install Meltano (if you haven't already) and any needed plugins:
90111

91112
```bash
92113
# Install meltano
93-
pipx install meltano
114+
uv tool install meltano
94115
# Initialize meltano within this directory
95116
cd tap-socketdev
96117
meltano install

0 commit comments

Comments
 (0)