{"id":18395838,"url":"https://github.com/deepset-ai/document-store","last_synced_at":"2025-04-07T03:35:19.203Z","repository":{"id":187559514,"uuid":"674269341","full_name":"deepset-ai/document-store","owner":"deepset-ai","description":null,"archived":false,"fork":false,"pushed_at":"2024-05-01T08:24:22.000Z","size":54,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-05-01T09:24:33.282Z","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":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/deepset-ai.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":"2023-08-03T14:26:47.000Z","updated_at":"2024-05-01T09:24:36.497Z","dependencies_parsed_at":null,"dependency_job_id":"582685d5-d708-4c25-b73a-8402b4604ab4","html_url":"https://github.com/deepset-ai/document-store","commit_stats":null,"previous_names":["deepset-ai/document-store"],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepset-ai%2Fdocument-store","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepset-ai%2Fdocument-store/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepset-ai%2Fdocument-store/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepset-ai%2Fdocument-store/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deepset-ai","download_url":"https://codeload.github.com/deepset-ai/document-store/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223271116,"owners_count":17117303,"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-11-06T02:12:09.145Z","updated_at":"2024-11-06T02:12:11.368Z","avatar_url":"https://github.com/deepset-ai.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![test](https://github.com/deepset-ai/document-store/actions/workflows/test.yml/badge.svg)](https://github.com/deepset-ai/document-store/actions/workflows/test.yml)\n\n# Example Store\n\nThis Github repository is a template that can be used to create custom document stores to extend\nthe new [Haystack](https://github.com/deepset-ai/haystack/) API available from version 2.0.\n\n## Template features\n\nBy creating a new repo using this template, you'll get the following advantages:\n- Ready-made code layout and scaffold to build a custom document store.\n- Support for packaging and distributing the code through Python wheels using Hatch.\n- Github workflow to build and upload a package when tagging the repo.\n- Github workflow to run the tests on Pull Requests.\n\n## How to use this repo\n\n1. Create a new repository starting from this template. If you never used this feature before, you\n   can find more details in [Github docs](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template).\n2. If possible, follow the convention `technology-haystack` for the name of the new repository,\n   where `technology` can be for example the name of a vector database you're integrating.\n3. Rename the package `src/example_store` to something more meaningful and adjust the Python\n   import statements.\n4. Replace any occurrence of `example_store` and `example-store` across the repo, according\n   to the name you chose in the previous steps.\n5. Search the whole codebase for the string `#FIXME`, that's where you're supposed to change or add\n   code specific for the database you're integrating.\n6. If Apache 2.0 is not suitable for your needs, change the software license.\n\nWhen your custom document store is ready and working, feel free to add it to the list of available\n[Haystack Integrations](https://haystack.deepset.ai/integrations) by opening a Pull Request in\n[this repo](https://github.com/deepset-ai/haystack-integrations).\n\n\n## Test\n\nYou can use `hatch` to run the linters:\n\n```console\n~$ hatch run lint:all\ncmd [1] | ruff .\ncmd [2] | black --check --diff .\nAll done! ✨ 🍰 ✨\n6 files would be left unchanged.\ncmd [3] | mypy --install-types --non-interactive src/example_store tests\nSuccess: no issues found in 6 source files\n```\n\nSimilar for running the tests:\n\n```console\n~$ hatch run cov\ncmd [1] | coverage run -m pytest tests\n...\n```\n\n## Build\n\nTo build the package you can use `hatch`:\n\n```console\n~$ hatch build\n[sdist]\ndist/example_store-0.0.1.tar.gz\n\n[wheel]\ndist/example_store-0.0.1-py3-none-any.whl\n```\n\n## Release\n\nTo automatically build and push the package to PyPI, you need to set a repository secret called `PYPI_API_TOKEN`\ncontaining a valid token for your PyPI account.\nThen set the desired version number in `src/example_store/__about__.py` and tag the commit using the format\n`vX.Y.Z`. After pushing the tag, a Github workflow will start and take care of building and releasing the package.\n\n## License\n\n`example-store` is distributed under the terms of the [Apache-2.0](https://spdx.org/licenses/Apache-2.0.html) license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeepset-ai%2Fdocument-store","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeepset-ai%2Fdocument-store","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeepset-ai%2Fdocument-store/lists"}