langfun 0.1.2.dev202504280818__tar.gz → 0.1.2.dev202504300804__tar.gz

{langfun-0.1.2.dev202504280818 → langfun-0.1.2.dev202504300804}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langfun
-Version: 0.1.2.dev202504280818
+Version: 0.1.2.dev202504300804
 Summary: Langfun: Language as Functions.
 Home-page: https://github.com/google/langfun
 Author: Langfun Authors
@@ -193,7 +193,9 @@ To install a nightly build, include the `--pre` flag, like this:
 pip install langfun[all] --pre
 ```
 
-If you want to customize your installation, you can select specific features using package names like `langfun[X1, X2, ..., Xn]`, where `Xi` corresponds to a tag from the list below:
+If you want to customize your installation, you can select specific features
+using package names like `langfun[X1, X2, ..., Xn]`, where `Xi` corresponds to
+a tag from the list below:
 
 | Tag                 |  Description                             |
 | ------------------- | ---------------------------------------- |
@@ -201,15 +203,36 @@ If you want to customize your installation, you can select specific features usi
 | vertexai            | VertexAI access.                         |
 | mime                | All MIME supports.                       |
 | mime-auto           | Automatic MIME type detection.           |
-| mime-docx           | DocX format support.                     |
 | mime-pil            | Image support for PIL.                   |
-| mime-xlsx           | XlsX format support.                     |
 | ui                  | UI enhancements                          |
 
-
-For example, to install a nightly build that includes VertexAI access, full modality support, and UI enhancements, use:
+For example, to install a nightly build that includes VertexAI access, full
+modality support, and UI enhancements, use:
 ```
 pip install langfun[vertexai,mime,ui] --pre
 ```
 
+### Solving import issue with `libmagic`
+
+Langfun utilizes `libmagic` for automatic MIME type detection to support
+multi-modal functionalities. However, `pip install libmagic` may not work
+out-of-the-box on all operation systems, sometimes leading to an
+`'ImportError: failed to find libmagic.'` error after Langfun installation.
+
+If you encounter this error, you will need to follow the recommendations below
+to fix the installation of `libmagic` library.
+
+#### OSX
+
+```
+conda install conda-forge::libmagic
+```
+
+#### Windows:
+```
+pip install python-magic
+pip uninstall python-magic-bin
+pip install python-magic-bin
+```
+
 *Disclaimer: this is not an officially supported Google product.*

{langfun-0.1.2.dev202504280818 → langfun-0.1.2.dev202504300804}/README.md

@@ -133,7 +133,9 @@ To install a nightly build, include the `--pre` flag, like this:
 pip install langfun[all] --pre
 ```
 
-If you want to customize your installation, you can select specific features using package names like `langfun[X1, X2, ..., Xn]`, where `Xi` corresponds to a tag from the list below:
+If you want to customize your installation, you can select specific features
+using package names like `langfun[X1, X2, ..., Xn]`, where `Xi` corresponds to
+a tag from the list below:
 
 | Tag                 |  Description                             |
 | ------------------- | ---------------------------------------- |
@@ -141,15 +143,36 @@ If you want to customize your installation, you can select specific features usi
 | vertexai            | VertexAI access.                         |
 | mime                | All MIME supports.                       |
 | mime-auto           | Automatic MIME type detection.           |
-| mime-docx           | DocX format support.                     |
 | mime-pil            | Image support for PIL.                   |
-| mime-xlsx           | XlsX format support.                     |
 | ui                  | UI enhancements                          |
 
-
-For example, to install a nightly build that includes VertexAI access, full modality support, and UI enhancements, use:
+For example, to install a nightly build that includes VertexAI access, full
+modality support, and UI enhancements, use:
 ```
 pip install langfun[vertexai,mime,ui] --pre
 ```
 
+### Solving import issue with `libmagic`
+
+Langfun utilizes `libmagic` for automatic MIME type detection to support
+multi-modal functionalities. However, `pip install libmagic` may not work
+out-of-the-box on all operation systems, sometimes leading to an
+`'ImportError: failed to find libmagic.'` error after Langfun installation.
+
+If you encounter this error, you will need to follow the recommendations below
+to fix the installation of `libmagic` library.
+
+#### OSX
+
+```
+conda install conda-forge::libmagic
+```
+
+#### Windows:
+```
+pip install python-magic
+pip uninstall python-magic-bin
+pip install python-magic-bin
+```
+
 *Disclaimer: this is not an officially supported Google product.*

{langfun-0.1.2.dev202504280818 → langfun-0.1.2.dev202504300804}/langfun/__init__.py

@@ -37,6 +37,9 @@ generate_class = structured.generate_class
 
 track_queries = structured.track_queries
 
+# Context manager for setting the query protocol for the scope.
+query_protocol = structured.query_protocol
+
 # Helper function for map-reduce style querying.
 query_and_reduce = structured.query_and_reduce