Skip to content

Conversation

@a-klos
Copy link
Member

@a-klos a-klos commented Oct 30, 2025

This pull request introduces major improvements to documentation, metadata, and configuration for the three main Python libraries in the STACKIT RAG template: admin-api-lib, extractor-api-lib, and rag-core-api. The changes focus on adding comprehensive README files for each library, updating package metadata in pyproject.toml for clarity and compliance, and refining dependency and configuration management. These updates make the libraries easier to understand, install, and extend, and improve maintainability for both operators and developers.

Documentation enhancements:

  • Added detailed README.md files for libs/admin-api-lib, libs/extractor-api-lib, and libs/rag-core-api, describing module responsibilities, features, endpoints, configuration, usage, extension, and contribution guidelines. [1] [2] [3]

Package metadata and configuration improvements:

  • Updated pyproject.toml for all three libraries to include new version numbers (v3.2.1), expanded author and maintainer information, license, repository, homepage, and readme fields for better package distribution and compliance. [1] [2] [3]
  • Improved dependency specification in libs/extractor-api-lib/pyproject.toml by switching fasttext to a stable PyPI version and adjusting other package versions.
  • Refined pytest and flake8 configuration for consistency and clarity, such as changing log_cli to boolean and updating exclusions. [1] [2]

These changes collectively strengthen the documentation, usability, and maintainability of the STACKIT RAG template libraries, making them more accessible for new users and contributors.

…oject.toml with metadata and remove unused secret provider
…pi-lib, rag-core-api, and rag-core-lib; adjust dependencies and metadata
@a-klos a-klos requested a review from Copilot October 30, 2025 09:08
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR updates package versions and dependencies across the RAG template monorepo to version 3.2.0, adds comprehensive README documentation for all library packages, and removes an unused SecretProvider interface.

  • Updated all library and service versions from 1.0.1 to v3.2.0 with improved descriptions
  • Added comprehensive README files for rag-core-lib, rag-core-api, admin-api-lib, and extractor-api-lib
  • Updated dependencies including FastAPI (0.116.x → 0.118.3), langchain packages, langfuse (3.3.4 → 3.6.1), and others
  • Replaced git-based fasttext dependency with PyPI version 0.9.3
  • Removed unused SecretProvider interface from rag-core-lib
  • Added metadata fields (maintainers, license, repository, homepage) to library pyproject.toml files

Reviewed Changes

Copilot reviewed 12 out of 19 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
services/rag-backend/pyproject.toml Updated name, version to 3.2.0, added description, removed trailing whitespace
services/rag-backend/poetry.lock Updated dependencies: FastAPI, langchain, langfuse, requests, uvicorn, and local libs
services/document-extractor/pyproject.toml Updated version to 3.2.0 and description
services/document-extractor/poetry.lock Updated dependencies: FastAPI, fasttext (git→PyPI), langchain-core, unstructured, uvicorn, extractor-api-lib
services/admin-backend/pyproject.toml Updated name, version to 3.2.0, and description
services/admin-backend/poetry.lock Updated local library versions (admin-api-lib, rag-core-lib)
libs/rag-core-lib/pyproject.toml Version bump, description update, added metadata (maintainers, license, repository, homepage, readme), changed pytest log_cli to boolean
libs/rag-core-lib/src/rag_core_lib/secret_provider/secret_provider.py Removed unused SecretProvider interface file
libs/rag-core-lib/README.md Added comprehensive library documentation
libs/rag-core-api/pyproject.toml Version bump, description update, added metadata fields
libs/rag-core-api/poetry.lock Updated rag-core-lib dependency version
libs/rag-core-api/README.md Added comprehensive API layer documentation
libs/extractor-api-lib/pyproject.toml Version bump, added metadata, changed fasttext from git to PyPI, changed pytest log_cli to boolean
libs/extractor-api-lib/poetry.lock Updated fasttext (git→PyPI), updated content-hash
libs/extractor-api-lib/README.md Added comprehensive extractor library documentation
libs/admin-api-lib/pyproject.toml Version bump, description update, added metadata fields
libs/admin-api-lib/poetry.lock Updated rag-core-lib dependency version
libs/admin-api-lib/README.md Added comprehensive admin API documentation

a-klos and others added 4 commits October 30, 2025 10:13
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@a-klos a-klos requested a review from Copilot October 30, 2025 09:16
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

Copilot reviewed 12 out of 19 changed files in this pull request and generated no new comments.

@a-klos a-klos merged commit 1d95afe into main Oct 30, 2025
15 checks passed
@a-klos a-klos deleted the fix/pyproject_toml_files branch October 30, 2025 09:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants