Skip to content

Commit d26bc47

Browse files
authored
Source plaid: Migrate to manifest-only (#44086)
1 parent bb49428 commit d26bc47

File tree

11 files changed

+39
-1496
lines changed

11 files changed

+39
-1496
lines changed

airbyte-integrations/connectors/source-plaid/README.md

+27-53
Original file line numberDiff line numberDiff line change
@@ -1,89 +1,63 @@
11
# Plaid source connector
22

3+
This directory contains the manifest-only connector for `source-plaid`.
4+
This _manifest-only_ connector is not a Python package on its own, as it runs inside of the base `source-declarative-manifest` image.
35

4-
This is the repository for the Plaid source connector, written in Python.
5-
For information about how to use this connector within Airbyte, see [the documentation](https://docs.airbyte.com/integrations/sources/plaid).
6+
For information about how to configure and use this connector within Airbyte, see [the connector's full documentation](https://docs.airbyte.com/integrations/sources/plaid).
67

78
## Local development
89

9-
### Prerequisites
10-
* Python (~=3.9)
11-
* Poetry (~=1.7) - installation instructions [here](https://python-poetry.org/docs/#installation)
10+
We recommend using the Connector Builder to edit this connector.
11+
Using either Airbyte Cloud or your local Airbyte OSS instance, navigate to the **Builder** tab and select **Import a YAML**.
12+
Then select the connector's `manifest.yaml` file to load the connector into the Builder. You're now ready to make changes to the connector!
1213

14+
If you prefer to develop locally, you can follow the instructions below.
1315

14-
### Installing the connector
15-
From this connector directory, run:
16-
```bash
17-
poetry install --with dev
18-
```
19-
20-
21-
### Create credentials
22-
**If you are a community contributor**, follow the instructions in the [documentation](https://docs.airbyte.com/integrations/sources/plaid)
23-
to generate the necessary credentials. Then create a file `secrets/config.json` conforming to the `source_plaid/spec.yaml` file.
24-
Note that any directory named `secrets` is gitignored across the entire Airbyte repo, so there is no danger of accidentally checking in sensitive information.
25-
See `sample_files/sample_config.json` for a sample config file.
26-
27-
28-
### Locally running the connector
29-
```
30-
poetry run source-plaid spec
31-
poetry run source-plaid check --config secrets/config.json
32-
poetry run source-plaid discover --config secrets/config.json
33-
poetry run source-plaid read --config secrets/config.json --catalog sample_files/configured_catalog.json
34-
```
16+
### Building the docker image
3517

36-
### Running unit tests
37-
To run unit tests locally, from the connector directory run:
38-
```
39-
poetry run pytest unit_tests
40-
```
18+
You can build any manifest-only connector with `airbyte-ci`:
4119

42-
### Building the docker image
4320
1. Install [`airbyte-ci`](https://github.com/airbytehq/airbyte/blob/master/airbyte-ci/connectors/pipelines/README.md)
4421
2. Run the following command to build the docker image:
22+
4523
```bash
4624
airbyte-ci connectors --name=source-plaid build
4725
```
4826

4927
An image will be available on your host with the tag `airbyte/source-plaid:dev`.
5028

29+
### Creating credentials
30+
31+
**If you are a community contributor**, follow the instructions in the [documentation](https://docs.airbyte.com/integrations/sources/plaid)
32+
to generate the necessary credentials. Then create a file `secrets/config.json` conforming to the `spec` object in the connector's `manifest.yaml` file.
33+
Note that any directory named `secrets` is gitignored across the entire Airbyte repo, so there is no danger of accidentally checking in sensitive information.
5134

5235
### Running as a docker container
53-
Then run any of the connector commands as follows:
54-
```
36+
37+
Then run any of the standard source connector commands:
38+
39+
```bash
5540
docker run --rm airbyte/source-plaid:dev spec
5641
docker run --rm -v $(pwd)/secrets:/secrets airbyte/source-plaid:dev check --config /secrets/config.json
5742
docker run --rm -v $(pwd)/secrets:/secrets airbyte/source-plaid:dev discover --config /secrets/config.json
5843
docker run --rm -v $(pwd)/secrets:/secrets -v $(pwd)/integration_tests:/integration_tests airbyte/source-plaid:dev read --config /secrets/config.json --catalog /integration_tests/configured_catalog.json
5944
```
6045

61-
### Running our CI test suite
62-
You can run our full test suite locally using [`airbyte-ci`](https://github.com/airbytehq/airbyte/blob/master/airbyte-ci/connectors/pipelines/README.md):
63-
```bash
64-
airbyte-ci connectors --name=source-plaid test
65-
```
46+
### Running the CI test suite
6647

67-
### Customizing acceptance Tests
68-
Customize `acceptance-test-config.yml` file to configure acceptance tests. See [Connector Acceptance Tests](https://docs.airbyte.com/connector-development/testing-connectors/connector-acceptance-tests-reference) for more information.
69-
If your connector requires to create or destroy resources for use during acceptance tests create fixtures for it and place them inside integration_tests/acceptance.py.
48+
You can run our full test suite locally using [`airbyte-ci`](https://github.com/airbytehq/airbyte/blob/master/airbyte-ci/connectors/pipelines/README.md):
7049

71-
### Dependency Management
72-
All of your dependencies should be managed via Poetry.
73-
To add a new dependency, run:
7450
```bash
75-
poetry add <package-name>
51+
airbyte-ci connectors --name=source-plaid test
7652
```
7753

78-
Please commit the changes to `pyproject.toml` and `poetry.lock` files.
79-
8054
## Publishing a new version of the connector
81-
You've checked out the repo, implemented a million dollar feature, and you're ready to share your changes with the world. Now what?
82-
1. Make sure your changes are passing our test suite: `airbyte-ci connectors --name=source-plaid test`
83-
2. Bump the connector version (please follow [semantic versioning for connectors](https://docs.airbyte.com/contributing-to-airbyte/resources/pull-requests-handbook/#semantic-versioning-for-connectors)):
55+
56+
If you want to contribute changes to `source-plaid`, here's how you can do that:
57+
1. Make your changes locally, or load the connector's manifest into Connector Builder and make changes there.
58+
2. Make sure your changes are passing our test suite with `airbyte-ci connectors --name=source-plaid test`
59+
3. Bump the connector version (please follow [semantic versioning for connectors](https://docs.airbyte.com/contributing-to-airbyte/resources/pull-requests-handbook/#semantic-versioning-for-connectors)):
8460
- bump the `dockerImageTag` value in in `metadata.yaml`
85-
- bump the `version` value in `pyproject.toml`
86-
3. Make sure the `metadata.yaml` content is up to date.
8761
4. Make sure the connector documentation and its changelog is up to date (`docs/integrations/sources/plaid.md`).
8862
5. Create a Pull Request: use [our PR naming conventions](https://docs.airbyte.com/contributing-to-airbyte/resources/pull-requests-handbook/#pull-request-title-convention).
8963
6. Pat yourself on the back for being an awesome contributor.

airbyte-integrations/connectors/source-plaid/acceptance-test-config.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ connector_image: airbyte/source-plaid:dev
44
acceptance_tests:
55
spec:
66
tests:
7-
- spec_path: "source_plaid/spec.yaml"
7+
- spec_path: "manifest.yaml"
88
connection:
99
tests:
1010
- config_path: "secrets/config.json"

airbyte-integrations/connectors/source-plaid/main.py

-8
This file was deleted.

airbyte-integrations/connectors/source-plaid/source_plaid/manifest.yaml airbyte-integrations/connectors/source-plaid/manifest.yaml

+6-1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
version: 0.50.0
1+
version: 4.3.0
22
type: DeclarativeSource
33
check:
44
type: CheckStream
@@ -70,26 +70,31 @@ streams:
7070
- path:
7171
- available
7272
value: "{{record['balances']['available']}}"
73+
type: AddedFieldDefinition
7374
- type: AddFields
7475
fields:
7576
- path:
7677
- current
7778
value: "{{record['balances']['current']}}"
79+
type: AddedFieldDefinition
7880
- type: AddFields
7981
fields:
8082
- path:
8183
- iso_currency_code
8284
value: "{{record['balances']['iso_currency_code']}}"
85+
type: AddedFieldDefinition
8386
- type: AddFields
8487
fields:
8588
- path:
8689
- limit
8790
value: "{{record['balances']['limit']}}"
91+
type: AddedFieldDefinition
8892
- type: AddFields
8993
fields:
9094
- path:
9195
- unofficial_currency_code
9296
value: "{{record['balances']['unofficial_currency_code']}}"
97+
type: AddedFieldDefinition
9398
- type: RemoveFields
9499
field_pointers:
95100
- - balances

airbyte-integrations/connectors/source-plaid/metadata.yaml

+4-4
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,15 @@ data:
22
connectorSubtype: api
33
connectorType: source
44
definitionId: ed799e2b-2158-4c66-8da4-b40fe63bc72a
5-
dockerImageTag: 0.4.13
5+
dockerImageTag: 0.5.0
66
dockerRepository: airbyte/source-plaid
77
githubIssueLabel: source-plaid
88
icon: plaid.svg
99
license: MIT
1010
name: Plaid
1111
remoteRegistries:
1212
pypi:
13-
enabled: true
13+
enabled: false
1414
packageName: airbyte-source-plaid
1515
registryOverrides:
1616
cloud:
@@ -20,8 +20,8 @@ data:
2020
releaseStage: alpha
2121
documentationUrl: https://docs.airbyte.com/integrations/sources/plaid
2222
tags:
23-
- language:python
2423
- cdk:low-code
24+
- language:manifest-only
2525
ab_internal:
2626
sl: 100
2727
ql: 100
@@ -38,5 +38,5 @@ data:
3838
# type: GSM
3939
# alias: airbyte-connector-testing-secret-store
4040
connectorBuildOptions:
41-
baseImage: docker.io/airbyte/python-connector-base:2.0.0@sha256:c44839ba84406116e8ba68722a0f30e8f6e7056c726f447681bb9e9ece8bd916
41+
baseImage: docker.io/airbyte/source-declarative-manifest:4.4.1@sha256:a8c0f0d32782957beef2c65bac98756b04fff2f3ffc4568a6676d3c83a422a5b
4242
metadataSpecVersion: "1.0"

0 commit comments

Comments
 (0)