|
| 1 | +# Hibob Source |
| 2 | + |
| 3 | +This is the repository for the Hibob configuration based source connector. |
| 4 | +For information about how to use this connector within Airbyte, see [the documentation](https://docs.airbyte.com/integrations/sources/hibob). |
| 5 | + |
| 6 | +## Local development |
| 7 | + |
| 8 | +### Prerequisites |
| 9 | + |
| 10 | +- Python (`^3.10`) |
| 11 | +- Poetry (`^1.7`) - installation instructions [here](https://python-poetry.org/docs/#installation) |
| 12 | + |
| 13 | +### Installing the connector |
| 14 | + |
| 15 | +From this connector directory, run: |
| 16 | + |
| 17 | +```bash |
| 18 | +poetry install --with dev |
| 19 | +``` |
| 20 | + |
| 21 | +### Create credentials |
| 22 | + |
| 23 | +**If you are a community contributor**, follow the instructions in the [documentation](https://docs.airbyte.com/integrations/sources/hibob) |
| 24 | +to generate the necessary credentials. Then create a file `secrets/config.json` conforming to the `src/source_hibob/spec.yaml` file. |
| 25 | +Note that any directory named `secrets` is gitignored across the entire Airbyte repo, so there is no danger of accidentally checking in sensitive information. |
| 26 | +See `sample_files/sample_config.json` for a sample config file. |
| 27 | + |
| 28 | +### Locally running the connector |
| 29 | + |
| 30 | +``` |
| 31 | +poetry run source-hibob spec |
| 32 | +poetry run source-hibob check --config secrets/config.json |
| 33 | +poetry run source-hibob discover --config secrets/config.json |
| 34 | +poetry run source-hibob read --config secrets/config.json --catalog sample_files/configured_catalog.json |
| 35 | +``` |
| 36 | + |
| 37 | + |
| 38 | +### Building the docker image |
| 39 | + |
| 40 | +1. Install [`airbyte-ci`](https://github.com/airbytehq/airbyte/blob/master/airbyte-ci/connectors/pipelines/README.md) |
| 41 | +2. Run the following command to build the docker image: |
| 42 | + |
| 43 | +```bash |
| 44 | +airbyte-ci connectors --name=source-hibob build |
| 45 | +``` |
| 46 | + |
| 47 | +An image will be available on your host with the tag `airbyte/source-hibob:dev`. |
| 48 | + |
| 49 | +### Running as a docker container |
| 50 | + |
| 51 | +Then run any of the connector commands as follows: |
| 52 | + |
| 53 | +``` |
| 54 | +docker run --rm airbyte/source-hibob:dev spec |
| 55 | +docker run --rm -v $(pwd)/secrets:/secrets airbyte/source-hibob:dev check --config /secrets/config.json |
| 56 | +docker run --rm -v $(pwd)/secrets:/secrets airbyte/source-hibob:dev discover --config /secrets/config.json |
| 57 | +docker run --rm -v $(pwd)/secrets:/secrets -v $(pwd)/integration_tests:/integration_tests airbyte/source-hibob:dev read --config /secrets/config.json --catalog /integration_tests/configured_catalog.json |
| 58 | +``` |
| 59 | + |
| 60 | +### Running our CI test suite |
| 61 | + |
| 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 | + |
| 64 | +```bash |
| 65 | +airbyte-ci connectors --name=source-hibob test |
| 66 | +``` |
| 67 | + |
| 68 | +### Customizing acceptance Tests |
| 69 | + |
| 70 | +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. |
| 71 | +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. |
| 72 | + |
| 73 | +### Dependency Management |
| 74 | + |
| 75 | +All of your dependencies should be managed via Poetry. |
| 76 | +To add a new dependency, run: |
| 77 | + |
| 78 | +```bash |
| 79 | +poetry add <package-name> |
| 80 | +``` |
| 81 | + |
| 82 | +Please commit the changes to `pyproject.toml` and `poetry.lock` files. |
| 83 | + |
| 84 | +## Publishing a new version of the connector |
| 85 | + |
| 86 | +You've checked out the repo, implemented a million dollar feature, and you're ready to share your changes with the world. Now what? |
| 87 | + |
| 88 | +1. Make sure your changes are passing our test suite: `airbyte-ci connectors --name=source-hibob test` |
| 89 | +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)): |
| 90 | + - bump the `dockerImageTag` value in in `metadata.yaml` |
| 91 | + - bump the `version` value in `pyproject.toml` |
| 92 | +3. Make sure the `metadata.yaml` content is up to date. |
| 93 | +4. Make sure the connector documentation and its changelog is up to date (`docs/integrations/sources/hibob.md`). |
| 94 | +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). |
| 95 | +6. Pat yourself on the back for being an awesome contributor. |
| 96 | +7. Someone from Airbyte will take a look at your PR and iterate with you to merge it into master. |
| 97 | +8. Once your PR is merged, the new version of the connector will be automatically published to Docker Hub and our connector registry. |
0 commit comments