Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

BM25Retriever: UnicodeError Handling and Encoding Flexibility Improvement #17643

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

Restodecoca
Copy link

This improvement introduces the parameterization of character encoding in the data persistence and loading methods of the BM25Retriever, providing greater flexibility in handling stored JSON files. The enhancement addresses previous challenges encountered when dealing with different character sets across various environments, such as working with files generated on systems with diverse regional settings.

Previously, the encoding was fixed to utf-8, which caused difficulties when processing data containing special characters not properly supported in certain contexts, such as documents in multiple languages or file transfers between different operating systems. By adding the encoding parameter, users can now specify the desired encoding when saving and loading data, ensuring compatibility with different requirements, including Windows and Linux environments.

This enhancement also contributes to better system maintainability by allowing quick adjustments without requiring direct modifications to the source code. Additionally, it helps prevent common encoding-related errors, such as UnicodeDecodeError or incompatibilities when sharing data with third parties.

Description

Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context. List any dependencies that are required for this change.

Fixes # (issue)

New Package?

Did I fill in the tool.llamahub section in the pyproject.toml and provide a detailed README.md for my new integration or package?

  • Yes
  • No

Version Bump?

Did I bump the version in the pyproject.toml file of the package I am updating? (Except for the llama-index-core package)

  • Yes
  • No

Type of Change

Please delete options that are not relevant.

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • This change requires a documentation update

How Has This Been Tested?

Your pull-request will likely not be merged unless it is covered by some form of impactful unit testing.

  • I added new unit tests to cover this change
  • I believe this change is already covered by existing unit tests

Suggested Checklist:

  • I have performed a self-review of my own code
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • I have added Google Colab support for the newly added notebooks.
  • My changes generate no new warnings
  • I have added tests that prove my fix is effective or that my feature works
  • New and existing unit tests pass locally with my changes
  • I ran make format; make lint to appease the lint gods

This improvement introduces the parameterization of character encoding in the data persistence and loading methods of the BM25Retriever, providing greater flexibility in handling stored JSON files. The enhancement addresses previous challenges encountered when dealing with different character sets across various environments, such as working with files generated on systems with diverse regional settings.

Previously, the encoding was fixed to utf-8, which caused difficulties when processing data containing special characters not properly supported in certain contexts, such as documents in multiple languages or file transfers between different operating systems. By adding the encoding parameter, users can now specify the desired encoding when saving and loading data, ensuring compatibility with different requirements, including Windows and Linux environments.

This enhancement also contributes to better system maintainability by allowing quick adjustments without requiring direct modifications to the source code. Additionally, it helps prevent common encoding-related errors, such as UnicodeDecodeError or incompatibilities when sharing data with third parties.
@dosubot dosubot bot added the size:XS This PR changes 0-9 lines, ignoring generated files. label Jan 27, 2025
@dosubot dosubot bot added size:S This PR changes 10-29 lines, ignoring generated files. and removed size:XS This PR changes 0-9 lines, ignoring generated files. labels Jan 27, 2025
Copy link
Collaborator

@logan-markewich logan-markewich left a comment

Choose a reason for hiding this comment

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

You know, if you write the PR description instead of using chatgpt, its usually a lot shorter and to the point 😉

@dosubot dosubot bot added the lgtm This PR has been approved by a maintainer label Jan 27, 2025
@logan-markewich logan-markewich enabled auto-merge (squash) January 27, 2025 15:18
@Restodecoca
Copy link
Author

You know, if you write the PR description instead of using chatgpt, its usually a lot shorter and to the point 😉

I'll keep this in mind, thank you for the advice

with the addition of encoding param in the retriever, we also need to update the bm25s package to align with this change. Starting from version 0.2.7, bm25s includes support for encoding and non ascii characters.
auto-merge was automatically disabled January 27, 2025 16:02

Head branch was pushed to by a user without write access

@Restodecoca Restodecoca reopened this Feb 5, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
lgtm This PR has been approved by a maintainer size:S This PR changes 10-29 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants