Skip to content

Align with LangChain integration standards#5

Merged
loookashow merged 5 commits intomainfrom
chore/langchain-integration-standards
Mar 23, 2026
Merged

Align with LangChain integration standards#5
loookashow merged 5 commits intomainfrom
chore/langchain-integration-standards

Conversation

@loookashow
Copy link
Copy Markdown
Contributor

@loookashow loookashow commented Mar 23, 2026

Summary

  • Restructure tests into unit_tests/ and integration_tests/ per LangChain partner conventions
  • Add langchain-tests standard suite (RetrieversIntegrationTests) with env-var skip guards
  • Add runtime top_k/k override support in invoke()/ainvoke() (required by standard tests)
  • Fix vector search modes defaulting limit to top_k
  • Add mypy type checking, test_imports.py, CI integration job with secrets verification
  • Bump version to 0.3.1

Test plan

  • make lint — ruff + mypy pass
  • make test — 187 unit tests pass with --disable-socket
  • make integration_test — 8 standard + live tests pass (requires FoxNose credentials)

- Restructure tests into unit_tests/ and integration_tests/ per LangChain convention
- Add langchain-tests standard suite (RetrieversIntegrationTests)
- Add test_imports.py for public API validation
- Add runtime top_k override support in retriever (required by standard tests)
- Add mypy type checking with disallow_untyped_defs
- Update CI workflow: mypy in lint, integration test job on push to main
- Update pyproject.toml: pinned langchain-tests, project URLs, mypy config
- Update Makefile: unit/integration test separation, --disable-socket
- Update CONTRIBUTING.md with new test paths
Vector search and vector_field_search did not pass top_k as the
default limit, unlike text and hybrid modes. This caused the API
to return all matching results instead of respecting the requested
count. Also tune integration test params for the live test dataset.
- Add "Verify required secrets" pre-step in CI integration job
  to fail fast when env vars are missing (prevents false-green)
- Add sync/async tests for runtime k alias (invoke/ainvoke with k=N)
- Add sync/async tests for k + top_k dual-arg conflict (ValueError)
@codecov
Copy link
Copy Markdown

codecov Bot commented Mar 23, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@loookashow loookashow merged commit 61ee049 into main Mar 23, 2026
15 checks passed
@loookashow loookashow deleted the chore/langchain-integration-standards branch March 23, 2026 21:44
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.

1 participant