tap-fedidb


Nametap-fedidb JSON
Version 0.4.0 PyPI version JSON
download
home_pageNone
SummarySinger tap for FediDB, built with the Meltano SDK for Singer Taps.
upload_time2025-07-14 21:22:13
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseNone
keywords elt fedidb singer.io
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # tap-fedidb

Singer tap for [FediDB.org](https://fedidb.org).

Built with the [Meltano Tap SDK](https://sdk.meltano.com) for Singer Taps.

# Capabilities

* `catalog`
* `state`
* `discover`
* `about`
* `stream-maps`
* `schema-flattening`
* `batch`

## Supported Python Versions

* 3.10
* 3.11
* 3.12
* 3.13
* 3.14

## Settings

This tap doesn't have any settings of its own, but it does support the following built-in SDK settings:

| Setting                           | Required | Default | Description                                                                                                                                                                                                                                              |
| :-------------------------------- | :------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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).                                                                                                              |
| stream_map_config                 | False    | None    | User-defined config values to be used within map expressions.                                                                                                                                                                                            |
| 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 addtional 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    |                                                                                                                                                                                                                                                          |
| 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 is available by running: `tap-fedidb --about`

### Source Authentication and Authorization

The FediDB API doesn't require authentication at this time.

## Usage

You can easily run `tap-fedidb` by itself or in a pipeline using [Meltano](https://meltano.com/).

### Executing the Tap Directly

```bash
tap-fedidb --version
tap-fedidb --help
tap-fedidb --config CONFIG --discover > ./catalog.json
```

## Developer Resources

### Initialize your Development Environment

You will need the following tools to develop and test this tap:

- Python 3.10+
- [uv](https://docs.astral.sh/uv/getting-started/installation/)

### Create and Run Tests

Run integration tests:

```bash
uvx --with=tox-uv tox -e 3.10
```

You can also test the `tap-fedidb` CLI interface directly:

```bash
uvx --with=tox-uv tox -e sync
```

### Testing with [Meltano](https://www.meltano.com)

_**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. Go ahead and [install Meltano](https://docs.meltano.com/getting-started/installation/) if you haven't already.

1. Install all plugins

   ```bash
   meltano install
   ```

1. Check that the extractor is working properly

   ```bash
   meltano invoke tap-fedidb --version
   ```

1. Execute an ELT pipeline

   ```bash
   meltano run tap-fedidb target-jsonl
   ```

### SDK Dev Guide

See the [dev guide](https://sdk.meltano.com/en/latest/dev_guide.html) for more instructions on how to use the SDK to
develop your own taps and targets.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "tap-fedidb",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": "Edgar Ram\u00edrez-Mondrag\u00f3n <edgarrmondragon@hey.com>",
    "keywords": "ELT, FediDB, singer.io",
    "author": null,
    "author_email": "Edgar Ram\u00edrez-Mondrag\u00f3n <edgarrmondragon@hey.com>",
    "download_url": "https://files.pythonhosted.org/packages/6b/82/1fc148fa2a59a5fedede81284c18f9d7392dbd35c10afa0b7452ec809d04/tap_fedidb-0.4.0.tar.gz",
    "platform": null,
    "description": "# tap-fedidb\n\nSinger tap for [FediDB.org](https://fedidb.org).\n\nBuilt with the [Meltano Tap SDK](https://sdk.meltano.com) for Singer Taps.\n\n# Capabilities\n\n* `catalog`\n* `state`\n* `discover`\n* `about`\n* `stream-maps`\n* `schema-flattening`\n* `batch`\n\n## Supported Python Versions\n\n* 3.10\n* 3.11\n* 3.12\n* 3.13\n* 3.14\n\n## Settings\n\nThis tap doesn't have any settings of its own, but it does support the following built-in SDK settings:\n\n| Setting                           | Required | Default | Description                                                                                                                                                                                                                                              |\n| :-------------------------------- | :------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| 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).                                                                                                              |\n| stream_map_config                 | False    | None    | User-defined config values to be used within map expressions.                                                                                                                                                                                            |\n| 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 addtional dependency (through the `singer-sdk` `faker` extra or directly). |\n| faker_config.seed                 | False    | None    | Value to seed the Faker generator for deterministic output: https://faker.readthedocs.io/en/master/#seeding-the-generator                                                                                                                                |\n| faker_config.locale               | False    | None    | One or more LCID locale strings to produce localized output for: https://faker.readthedocs.io/en/master/#localization                                                                                                                                    |\n| flattening_enabled                | False    | None    | 'True' to enable schema flattening and automatically expand nested properties.                                                                                                                                                                           |\n| flattening_max_depth              | False    | None    | The max depth to flatten schemas.                                                                                                                                                                                                                        |\n| batch_config                      | False    | None    |                                                                                                                                                                                                                                                          |\n| batch_config.encoding             | False    | None    | Specifies the format and compression of the batch files.                                                                                                                                                                                                 |\n| batch_config.encoding.format      | False    | None    | Format to use for batch files.                                                                                                                                                                                                                           |\n| batch_config.encoding.compression | False    | None    | Compression format to use for batch files.                                                                                                                                                                                                               |\n| batch_config.storage              | False    | None    | Defines the storage layer to use when writing batch files                                                                                                                                                                                                |\n| batch_config.storage.root         | False    | None    | Root path to use when writing batch files.                                                                                                                                                                                                               |\n| batch_config.storage.prefix       | False    | None    | Prefix to use when writing batch files.                                                                                                                                                                                                                  |\n\nA full list of supported settings and capabilities is available by running: `tap-fedidb --about`\n\n### Source Authentication and Authorization\n\nThe FediDB API doesn't require authentication at this time.\n\n## Usage\n\nYou can easily run `tap-fedidb` by itself or in a pipeline using [Meltano](https://meltano.com/).\n\n### Executing the Tap Directly\n\n```bash\ntap-fedidb --version\ntap-fedidb --help\ntap-fedidb --config CONFIG --discover > ./catalog.json\n```\n\n## Developer Resources\n\n### Initialize your Development Environment\n\nYou will need the following tools to develop and test this tap:\n\n- Python 3.10+\n- [uv](https://docs.astral.sh/uv/getting-started/installation/)\n\n### Create and Run Tests\n\nRun integration tests:\n\n```bash\nuvx --with=tox-uv tox -e 3.10\n```\n\nYou can also test the `tap-fedidb` CLI interface directly:\n\n```bash\nuvx --with=tox-uv tox -e sync\n```\n\n### Testing with [Meltano](https://www.meltano.com)\n\n_**Note:** This tap will work in any Singer environment and does not require Meltano.\nExamples here are for convenience and to streamline end-to-end orchestration scenarios._\n\nYour project comes with a custom `meltano.yml` project file already created. Go ahead and [install Meltano](https://docs.meltano.com/getting-started/installation/) if you haven't already.\n\n1. Install all plugins\n\n   ```bash\n   meltano install\n   ```\n\n1. Check that the extractor is working properly\n\n   ```bash\n   meltano invoke tap-fedidb --version\n   ```\n\n1. Execute an ELT pipeline\n\n   ```bash\n   meltano run tap-fedidb target-jsonl\n   ```\n\n### SDK Dev Guide\n\nSee the [dev guide](https://sdk.meltano.com/en/latest/dev_guide.html) for more instructions on how to use the SDK to\ndevelop your own taps and targets.\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Singer tap for FediDB, built with the Meltano SDK for Singer Taps.",
    "version": "0.4.0",
    "project_urls": {
        "Documentation": "https://github.com/edgarrmondragon/tap-fedidb#readme",
        "Homepage": "https://github.com/edgarrmondragon/tap-fedidb",
        "Repository": "https://github.com/edgarrmondragon/tap-fedidb"
    },
    "split_keywords": [
        "elt",
        " fedidb",
        " singer.io"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "529c700d8ab1845aa9a9538ad4a9e3ab489e55b8c6b652c03d2aff92c1d15774",
                "md5": "f8702ecfecac1d032b6bb30f9919655d",
                "sha256": "e6b122d6dc9334141c48ecc339271d704aaecc59e161d75d9d77bd282268df0f"
            },
            "downloads": -1,
            "filename": "tap_fedidb-0.4.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "f8702ecfecac1d032b6bb30f9919655d",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 9711,
            "upload_time": "2025-07-14T21:22:12",
            "upload_time_iso_8601": "2025-07-14T21:22:12.233279Z",
            "url": "https://files.pythonhosted.org/packages/52/9c/700d8ab1845aa9a9538ad4a9e3ab489e55b8c6b652c03d2aff92c1d15774/tap_fedidb-0.4.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "6b821fc148fa2a59a5fedede81284c18f9d7392dbd35c10afa0b7452ec809d04",
                "md5": "ea2b42cefb570c1640aba02ff81327ee",
                "sha256": "f6ea90b7551e56121ee6a45c1cb7dd3018580d36779f18c649bcc58d07d0b9f9"
            },
            "downloads": -1,
            "filename": "tap_fedidb-0.4.0.tar.gz",
            "has_sig": false,
            "md5_digest": "ea2b42cefb570c1640aba02ff81327ee",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 64016,
            "upload_time": "2025-07-14T21:22:13",
            "upload_time_iso_8601": "2025-07-14T21:22:13.546577Z",
            "url": "https://files.pythonhosted.org/packages/6b/82/1fc148fa2a59a5fedede81284c18f9d7392dbd35c10afa0b7452ec809d04/tap_fedidb-0.4.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-14 21:22:13",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "edgarrmondragon",
    "github_project": "tap-fedidb#readme",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "tap-fedidb"
}
        
Elapsed time: 0.52459s