{"id":22400144,"url":"https://github.com/scalefreecom/tap-personio","last_synced_at":"2025-03-27T00:17:32.734Z","repository":{"id":112947377,"uuid":"473524114","full_name":"ScalefreeCOM/tap-personio","owner":"ScalefreeCOM","description":"Singer Tap for Personio staging","archived":false,"fork":false,"pushed_at":"2024-04-25T08:36:00.000Z","size":29,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-01T05:42:15.352Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ScalefreeCOM.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-03-24T08:48:04.000Z","updated_at":"2024-04-25T08:36:03.000Z","dependencies_parsed_at":null,"dependency_job_id":"a9a5a85a-c651-4d55-aec0-c59bbf206948","html_url":"https://github.com/ScalefreeCOM/tap-personio","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScalefreeCOM%2Ftap-personio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScalefreeCOM%2Ftap-personio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScalefreeCOM%2Ftap-personio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScalefreeCOM%2Ftap-personio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ScalefreeCOM","download_url":"https://codeload.github.com/ScalefreeCOM/tap-personio/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245755683,"owners_count":20667027,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-05T08:11:32.849Z","updated_at":"2025-03-27T00:17:32.709Z","avatar_url":"https://github.com/ScalefreeCOM.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tap-personio by [Scalefree International GmbH](https://www.scalefree.com)\r\n\r\n[\u003cimg src=\"https://user-images.githubusercontent.com/78537603/191483803-8cd4fc72-54a1-45f6-ab39-d798ec83e4c9.jpg\" width=50% align=right\u003e](https://www.scalefree.com)\r\n\r\n\r\n`tap-personio` is a Singer tap for Personio.\r\n\r\nThis tap:\r\n\r\n- Pulls raw data from (http://personio.com)\r\n- Extracts the following resources:\r\n  - attendances\r\n  - employees\r\n- Outputs the schema for each resource\r\n- Incrementally pulls data based on the input state (not implemented yet)\r\n\r\n## Installation\r\n\r\n- [ ] `Developer TODO:` Update the below as needed to correctly describe the install procedure. For instance, if you do not have a PyPi repo, or if you want users to directly install from your git repo, you can modify this step as appropriate.\r\n\r\n```bash\r\npipx install tap-personio\r\n```\r\n\r\n## Configuration\r\n\r\n### Accepted Config Options\r\n\r\n- [ ] `Developer TODO:` Provide a list of config options accepted by the tap.\r\n\r\nA full list of supported settings and capabilities for this\r\ntap is available by running:\r\n\r\n```bash\r\ntap-personio --about\r\n```\r\n\r\n### Source Authentication and Authorization\r\n\r\n- [ ] `Developer TODO:` If your tap requires special access on the source system, or any special authentication requirements, provide those here.\r\n\r\n## Usage\r\n\r\nYou can easily run `tap-personio` by itself or in a pipeline using [Meltano](https://meltano.com/).\r\n\r\n### Executing the Tap Directly\r\n\r\n```bash\r\ntap-personio --version\r\ntap-personio --help\r\ntap-personio --config CONFIG --discover \u003e ./catalog.json\r\n```\r\n\r\n## Developer Resources\r\n\r\n- [ ] `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.\r\n\r\n### Initialize your Development Environment\r\n\r\n```bash\r\npipx install poetry\r\npoetry install\r\n```\r\n\r\n### Create and Run Tests\r\n\r\nCreate tests within the `tap_personio/tests` subfolder and\r\n  then run:\r\n\r\n```bash\r\npoetry run pytest\r\n```\r\n\r\nYou can also test the `tap-personio` CLI interface directly using `poetry run`:\r\n\r\n```bash\r\npoetry run tap-personio --help\r\n```\r\n\r\n### Testing with [Meltano](https://www.meltano.com)\r\n\r\n_**Note:** This tap will work in any Singer environment and does not require Meltano.\r\nExamples here are for convenience and to streamline end-to-end orchestration scenarios._\r\n\r\nYour project comes with a custom `meltano.yml` project file already created. Open the `meltano.yml` and follow any _\"TODO\"_ items listed in\r\nthe file.\r\n\r\nNext, install Meltano (if you haven't already) and any needed plugins:\r\n\r\n```bash\r\n# Install meltano\r\npipx install meltano\r\n# Initialize meltano within this directory\r\ncd tap-personio\r\nmeltano install\r\n```\r\n\r\nNow you can test and orchestrate using Meltano:\r\n\r\n```bash\r\n# Test invocation:\r\nmeltano invoke tap-personio --version\r\n# OR run a test `elt` pipeline:\r\nmeltano elt tap-personio target-jsonl\r\n```\r\n\r\n---\r\n\r\nCopyright \u0026copy; 2022 Scalefree International\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscalefreecom%2Ftap-personio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fscalefreecom%2Ftap-personio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscalefreecom%2Ftap-personio/lists"}