torque-http 0.5.0__tar.gz → 0.7.0__tar.gz

torque_http-0.7.0/LICENSE

@@ -0,0 +1,230 @@
+This package is dual-licensed: you may use it under either the MIT license or the Apache
+License 2.0, at your option. Both texts follow.
+
+-------------------------------------------------------------------------------
+
+MIT License
+
+Copyright (c) 2025-2026 The Intelligence Company AB (publ)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+-------------------------------------------------------------------------------
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2025-2026 The Intelligence Company AB (publ)
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

{torque_http-0.5.0 → torque_http-0.7.0}/PKG-INFO

@@ -1,16 +1,16 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: torque-http
-Version: 0.5.0
+Version: 0.7.0
 Summary: Official Python client for Torque — Truespar's in-memory search engine with a Typesense v30.1 compatible API. Zero external dependencies.
 Project-URL: Homepage, https://truespar.com/torque/docs
 Project-URL: Documentation, https://truespar.com/torque/docs
+Project-URL: Repository, https://github.com/truespar/torque
 Author: Truespar
-License-Expression: MIT
+License-Expression: MIT OR Apache-2.0
 License-File: LICENSE
 Keywords: search,torque,truespar,typesense,vector-search
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -22,15 +22,15 @@ Description-Content-Type: text/markdown
 
 # torque-http
 
-Official Python client for [Torque](https://truespar.com/torque/docs) — Truespar's in-memory search engine with a Typesense v30.1 compatible API.
+The Python client for [Torque](https://truespar.com/torque/docs), an in-memory search engine with a Typesense-compatible API.
 
-- **Zero external dependencies** — uses only the Python standard library
-- **HTTP API** for search, collection management, and document CRUD
-- **TCP binary ingest** for high-throughput streaming from databases
-- **TQBF file upload** for bulk import
-- Multi-node failover with automatic retry
+- Standard library only, no dependencies
+- **HTTP API**: search, collections, documents, keys, aliases
+- **TCP ingest** (`TorqueIngestClient`) for streaming documents
+- **Binary import files** (`TorqueBinaryFileWriter`) for bulk loads
+- Several nodes, with failover and retries
 - Typed search parameters and response models
-- Python 3.10+, MIT licensed
+- Python 3.10+
 
 ## Installation
 
@@ -38,7 +38,7 @@ Official Python client for [Torque](https://truespar.com/torque/docs) — Truesp
 pip install torque-http
 ```
 
-## Quick Start
+## Quick start
 
 ```python
 from torque_http import TorqueHttpClient, SearchParameters
@@ -60,7 +60,7 @@ params = SearchParameters(
 results = client.search("products", params)
 ```
 
-## Multi-node with failover
+## Several nodes
 
 ```python
 client = TorqueHttpClient(
@@ -70,7 +70,7 @@ client = TorqueHttpClient(
 )
 ```
 
-## Collection management
+## Collections and documents
 
 ```python
 schema = {
@@ -88,9 +88,9 @@ client.create_document("products", {
 })
 ```
 
-## High-throughput TCP ingest
+## TCP ingest
 
-For streaming 100K+ documents, use the binary TCP protocol:
+For large loads, stream over the TCP ingest protocol:
 
 ```python
 from torque_http import TorqueIngestClient, DocumentEncoder
@@ -108,9 +108,9 @@ with TorqueIngestClient() as tcp:
     tcp.commit()
 ```
 
-## TQBF bulk file import
+## Binary import file
 
-Pre-encode a compressed binary file for maximum throughput:
+Write the documents to a compressed file, then upload it in one request:
 
 ```python
 from torque_http import TorqueBinaryFileWriter, DocumentEncoder
@@ -129,4 +129,4 @@ client.import_binary("products", "data.tqbf")
 
 ## License
 
-MIT — see [LICENSE](LICENSE).
+MIT OR Apache-2.0, at your option. See [LICENSE](LICENSE). Copyright 2025-2026 The Intelligence Company AB (publ).

{torque_http-0.5.0 → torque_http-0.7.0}/README.md

@@ -1,110 +1,110 @@
-# torque-http
-
-Official Python client for [Torque](https://truespar.com/torque/docs) — Truespar's in-memory search engine with a Typesense v30.1 compatible API.
-
-- **Zero external dependencies** — uses only the Python standard library
-- **HTTP API** for search, collection management, and document CRUD
-- **TCP binary ingest** for high-throughput streaming from databases
-- **TQBF file upload** for bulk import
-- Multi-node failover with automatic retry
-- Typed search parameters and response models
-- Python 3.10+, MIT licensed
-
-## Installation
-
-```bash
-pip install torque-http
-```
-
-## Quick Start
-
-```python
-from torque_http import TorqueHttpClient, SearchParameters
-
-client = TorqueHttpClient("http://localhost:8108", api_key="your-key")
-
-# Search
-results = client.search("products", q="laptop", query_by="title")
-for hit in results.hits:
-    print(hit.document["title"])
-
-# Typed parameters
-params = SearchParameters(
-    q="laptop",
-    query_by="title,description",
-    filter_by="price:>100",
-    per_page=20,
-)
-results = client.search("products", params)
-```
-
-## Multi-node with failover
-
-```python
-client = TorqueHttpClient(
-    ["http://node1:8108", "http://node2:8108"],
-    api_key="your-key",
-    num_retries=5,
-)
-```
-
-## Collection management
-
-```python
-schema = {
-    "name": "products",
-    "fields": [
-        {"name": "title", "type": "string"},
-        {"name": "price", "type": "float", "sort": True},
-        {"name": "brand", "type": "string", "facet": True},
-    ],
-}
-client.create_collection(schema)
-
-client.create_document("products", {
-    "id": "1", "title": "Laptop Pro", "price": 1299.99, "brand": "Acme",
-})
-```
-
-## High-throughput TCP ingest
-
-For streaming 100K+ documents, use the binary TCP protocol:
-
-```python
-from torque_http import TorqueIngestClient, DocumentEncoder
-
-schema = {"fields": [
-    {"name": "title", "type": "string"},
-    {"name": "price", "type": "float"},
-]}
-encoder = DocumentEncoder(schema)
-
-with TorqueIngestClient() as tcp:
-    tcp.connect("localhost", 8109)
-    tcp.start_ingest("products")
-    tcp.send_batch(documents, encoder)
-    tcp.commit()
-```
-
-## TQBF bulk file import
-
-Pre-encode a compressed binary file for maximum throughput:
-
-```python
-from torque_http import TorqueBinaryFileWriter, DocumentEncoder
-
-encoder = DocumentEncoder(schema)
-with TorqueBinaryFileWriter("data.tqbf", encoder) as writer:
-    for doc in source:
-        writer.write(doc)
-
-client.import_binary("products", "data.tqbf")
-```
-
-## Documentation
-
-- [Torque documentation](https://truespar.com/torque/docs)
-
-## License
-
-MIT — see [LICENSE](LICENSE).
+# torque-http
+
+The Python client for [Torque](https://truespar.com/torque/docs), an in-memory search engine with a Typesense-compatible API.
+
+- Standard library only, no dependencies
+- **HTTP API**: search, collections, documents, keys, aliases
+- **TCP ingest** (`TorqueIngestClient`) for streaming documents
+- **Binary import files** (`TorqueBinaryFileWriter`) for bulk loads
+- Several nodes, with failover and retries
+- Typed search parameters and response models
+- Python 3.10+
+
+## Installation
+
+```bash
+pip install torque-http
+```
+
+## Quick start
+
+```python
+from torque_http import TorqueHttpClient, SearchParameters
+
+client = TorqueHttpClient("http://localhost:8108", api_key="your-key")
+
+# Search
+results = client.search("products", q="laptop", query_by="title")
+for hit in results.hits:
+    print(hit.document["title"])
+
+# Typed parameters
+params = SearchParameters(
+    q="laptop",
+    query_by="title,description",
+    filter_by="price:>100",
+    per_page=20,
+)
+results = client.search("products", params)
+```
+
+## Several nodes
+
+```python
+client = TorqueHttpClient(
+    ["http://node1:8108", "http://node2:8108"],
+    api_key="your-key",
+    num_retries=5,
+)
+```
+
+## Collections and documents
+
+```python
+schema = {
+    "name": "products",
+    "fields": [
+        {"name": "title", "type": "string"},
+        {"name": "price", "type": "float", "sort": True},
+        {"name": "brand", "type": "string", "facet": True},
+    ],
+}
+client.create_collection(schema)
+
+client.create_document("products", {
+    "id": "1", "title": "Laptop Pro", "price": 1299.99, "brand": "Acme",
+})
+```
+
+## TCP ingest
+
+For large loads, stream over the TCP ingest protocol:
+
+```python
+from torque_http import TorqueIngestClient, DocumentEncoder
+
+schema = {"fields": [
+    {"name": "title", "type": "string"},
+    {"name": "price", "type": "float"},
+]}
+encoder = DocumentEncoder(schema)
+
+with TorqueIngestClient() as tcp:
+    tcp.connect("localhost", 8109)
+    tcp.start_ingest("products")
+    tcp.send_batch(documents, encoder)
+    tcp.commit()
+```
+
+## Binary import file
+
+Write the documents to a compressed file, then upload it in one request:
+
+```python
+from torque_http import TorqueBinaryFileWriter, DocumentEncoder
+
+encoder = DocumentEncoder(schema)
+with TorqueBinaryFileWriter("data.tqbf", encoder) as writer:
+    for doc in source:
+        writer.write(doc)
+
+client.import_binary("products", "data.tqbf")
+```
+
+## Documentation
+
+- [Torque documentation](https://truespar.com/torque/docs)
+
+## License
+
+MIT OR Apache-2.0, at your option. See [LICENSE](LICENSE). Copyright 2025-2026 The Intelligence Company AB (publ).

{torque_http-0.5.0 → torque_http-0.7.0}/pyproject.toml

@@ -4,17 +4,17 @@ build-backend = "hatchling.build"
 
 [project]
 name = "torque-http"
-version = "0.5.0"
+version = "0.7.0"
 description = "Official Python client for Torque — Truespar's in-memory search engine with a Typesense v30.1 compatible API. Zero external dependencies."
 readme = "README.md"
-license = "MIT"
+license = "MIT OR Apache-2.0"
+license-files = ["LICENSE"]
 requires-python = ">=3.10"
 authors = [{ name = "Truespar" }]
 keywords = ["search", "torque", "typesense", "truespar", "vector-search"]
 classifiers = [
     "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -26,6 +26,7 @@ classifiers = [
 [project.urls]
 Homepage = "https://truespar.com/torque/docs"
 Documentation = "https://truespar.com/torque/docs"
+Repository = "https://github.com/truespar/torque"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/torque_http"]

{torque_http-0.5.0 → torque_http-0.7.0}/src/torque_http/__init__.py

@@ -118,4 +118,4 @@ __all__ = [
     "TorqueConnectionError",
 ]
 
-__version__ = "0.5.0"
+__version__ = "0.7.0"

{torque_http-0.5.0 → torque_http-0.7.0}/src/torque_http/client.py

@@ -1,6 +1,6 @@
 """Torque Python HTTP client — zero external dependencies.
 
-Uses only Python 3.13+ stdlib: http.client, json, ssl, threading.
+Uses only Python 3.10+ stdlib: http.client, json, ssl, threading.
 Features: connection pooling with keep-alive, multi-node round-robin,
 configurable retry with exponential backoff, typed error hierarchy.
 """
@@ -301,14 +301,12 @@ class TorqueHttpClient:
         """Get server health status.
 
         Returns:
-            HealthResponse with server version and license info.
+            HealthResponse with server version.
         """
         d = self._get("/health")
         return HealthResponse(
             ok=d.get("ok", False),
             version=d.get("version", ""),
-            license=d.get("license", {}),
-            update=d.get("update"),
         )
 
     def stats(self) -> AdminStats:
@@ -813,7 +811,7 @@ class TorqueHttpClient:
         if params is not None:
             merged.update(params)
         merged.update(kwargs)
-        qs = urlencode({k: v for k, v in merged.items() if v is not None})
+        qs = _encode_search_params(merged)
         d = self._get(f"/collections/{_enc(collection)}/documents/search?{qs}")
         return _parse_search(d)
 
@@ -837,7 +835,7 @@ class TorqueHttpClient:
         if params is not None:
             merged.update(params)
         merged.update(kwargs)
-        qs = urlencode({k: v for k, v in merged.items() if v is not None})
+        qs = _encode_search_params(merged)
         d = self._get(f"/collections/{_enc(collection)}/documents/search?{qs}")
         return _parse_grouped_search(d)
 
@@ -866,6 +864,44 @@ class TorqueHttpClient:
         d = self._post("/multi_search", {"searches": searches})
         return [_parse_search(r) for r in d.get("results", [])]
 
+    def multi_search_union(
+        self,
+        searches: list[dict[str, Any]],
+        common_params: dict[str, Any] | None = None,
+        *,
+        page: int | None = None,
+        per_page: int | None = None,
+    ) -> SearchResult:
+        """Execute multiple searches merged into one ranked result set.
+
+        Uses Typesense v30.1 ``union: true`` — hits from all searches are
+        merged and ranked by text_match. Not compatible with ``group_by``
+        searches.
+
+        Args:
+            searches: List of search parameter dicts, each with at least
+                ``collection`` and ``q`` keys.
+            common_params: Optional dict of parameters merged into every
+                search. Per-search values override common values.
+            page: Page number for the merged result set (1-based).
+            per_page: Results per page for the merged result set.
+
+        Returns:
+            A single SearchResult with the merged, ranked hits.
+        """
+        if common_params:
+            searches = [{**common_params, **s} for s in searches]
+        path = "/multi_search"
+        query: list[str] = []
+        if page is not None:
+            query.append(f"page={page}")
+        if per_page is not None:
+            query.append(f"per_page={per_page}")
+        if query:
+            path += "?" + "&".join(query)
+        d = self._post(path, {"searches": searches, "union": True})
+        return _parse_search(d)
+
     # ── Aliases ────────────────────────────────────────────────────────
 
     def upsert_alias(self, name: str, collection_name: str) -> CollectionAlias:
@@ -1413,6 +1449,15 @@ def _enc(s: str) -> str:
     return quote(s, safe="")
 
 
+def _encode_search_params(params: dict[str, Any]) -> str:
+    """URL-encode search params, serializing Python bools as true/false."""
+    return urlencode({
+        k: ("true" if v is True else "false" if v is False else v)
+        for k, v in params.items()
+        if v is not None
+    })
+
+
 def _parse_collection(d: dict) -> CollectionResponse:
     return CollectionResponse(
         name=d.get("name", ""),

{torque_http-0.5.0 → torque_http-0.7.0}/src/torque_http/models.py

@@ -171,10 +171,15 @@ class SearchParameters(TypedDict, total=False):
     facet_by: str
     max_facet_values: int
     facet_query: str
+    facet_strategy: str
+    facet_sample_percent: int
+    facet_sample_threshold: int
+    facet_return_parent: str
 
     # ── Grouping ──────────────────────────────────────────────────────
     group_by: str
     group_limit: int
+    group_missing_values: bool
 
     # ── Pagination ────────────────────────────────────────────────────
     per_page: int
@@ -191,6 +196,7 @@ class SearchParameters(TypedDict, total=False):
     highlight_full_fields: str
     highlight_start_tag: str
     highlight_end_tag: str
+    highlight_affix_num_tokens: int
     snippet_threshold: int
 
     # ── Pinning / hiding ──────────────────────────────────────────────
@@ -200,17 +206,41 @@ class SearchParameters(TypedDict, total=False):
 
     # ── Token dropping ────────────────────────────────────────────────
     drop_tokens_threshold: int
+    drop_tokens_mode: str
     typo_tokens_threshold: int
 
+    # ── Typo tolerance ────────────────────────────────────────────────
+    min_len_1typo: int
+    min_len_2typo: int
+    split_join_tokens: str
+    synonym_num_typos: int
+    enable_typos_for_numerical_tokens: bool
+    enable_typos_for_alpha_numerical_tokens: bool
+
+    # ── Infix search ──────────────────────────────────────────────────
+    infix: str
+    max_extra_prefix: int
+    max_extra_suffix: int
+
     # ── Performance ───────────────────────────────────────────────────
     exhaustive_search: bool
     search_cutoff_ms: int
+    max_candidates: int
+
+    # ── Caching ───────────────────────────────────────────────────────
+    use_cache: bool
+    cache_ttl: int
+
+    # ── Validation & toggles ──────────────────────────────────────────
+    validate_field_names: bool
+    enable_synonyms: bool
 
     # ── Preset ────────────────────────────────────────────────────────
     preset: str
 
-    # ── Stopwords ─────────────────────────────────────────────────────
+    # ── Stopwords & synonyms ──────────────────────────────────────────
     stopwords: str
+    synonym_sets: str
 
     # ── Vector search ─────────────────────────────────────────────────
     vector_query: str
@@ -289,8 +319,6 @@ class HealthResponse:
     """Server health response."""
     ok: bool = False
     version: str = ""
-    license: dict[str, Any] = field(default_factory=dict)
-    update: dict[str, Any] | None = None
 
 
 # ── Admin ────────────────────────────────────────────────────────────────

{torque_http-0.5.0 → torque_http-0.7.0}/src/torque_http/tcp.py

@@ -15,7 +15,6 @@ from io import BytesIO
 from dataclasses import dataclass
 from typing import Any
 
-
 # ── Protocol Constants ──────────────────────────────────────────────────
 
 # Client -> Server message types
@@ -30,7 +29,6 @@ RESP_COMMIT_RESULT = 0x11
 RESP_ERROR = 0x12
 RESP_BACKPRESSURE = 0x13
 
-
 # ── Response Models ─────────────────────────────────────────────────────
 
 @dataclass
@@ -38,14 +36,12 @@ class BatchAck:
     batch_seq: int
     docs_received: int
 
-
 @dataclass
 class CommitResult:
     success: bool
     docs_indexed: int
     build_ms: int
 
-
 # ── Exceptions ──────────────────────────────────────────────────────────
 
 class TorqueProtocolError(Exception):
@@ -53,18 +49,15 @@ class TorqueProtocolError(Exception):
         super().__init__(f"[code={code}] {message}")
         self.code = code
 
-
 class TorqueConnectionError(Exception):
     pass
 
-
 # ── Frame Codec ─────────────────────────────────────────────────────────
 
 def _write_frame(sock: socket.socket, payload: bytes) -> None:
     header = struct.pack("!I", len(payload))
     sock.sendall(header + payload)
 
-
 def _read_exact(sock: socket.socket, n: int) -> bytes:
     buf = bytearray()
     while len(buf) < n:
@@ -74,7 +67,6 @@ def _read_exact(sock: socket.socket, n: int) -> bytes:
         buf.extend(chunk)
     return bytes(buf)
 
-
 def _read_frame(sock: socket.socket) -> bytes:
     header = _read_exact(sock, 4)
     length = struct.unpack("!I", header)[0]
@@ -82,7 +74,6 @@ def _read_frame(sock: socket.socket) -> bytes:
         return b""
     return _read_exact(sock, length)
 
-
 # ── Response Decoder ────────────────────────────────────────────────────
 
 def _decode_response(data: bytes) -> BatchAck | CommitResult:
@@ -126,7 +117,6 @@ def _decode_response(data: bytes) -> BatchAck | CommitResult:
     else:
         raise TorqueProtocolError(0, f"Unknown server message type: 0x{msg_type:02X}")
 
-
 # ── Document Flattener ─────────────────────────────────────────────────
 
 def flatten_document(doc: dict[str, Any]) -> dict[str, Any]:
@@ -140,7 +130,6 @@ def flatten_document(doc: dict[str, Any]) -> dict[str, Any]:
     """
     return _flatten_inner(doc, 0)
 
-
 def _flatten_inner(obj: dict[str, Any], depth: int) -> dict[str, Any]:
 
     result: dict[str, Any] = {}
@@ -178,7 +167,6 @@ def _flatten_inner(obj: dict[str, Any], depth: int) -> dict[str, Any]:
 
     return result
 
-
 # ── Document Encoder ────────────────────────────────────────────────────
 
 # Type name -> encoder key mapping
@@ -195,7 +183,6 @@ _TYPE_MAP = {
     "float[]": "float[]",
 }
 
-
 class DocumentEncoder:
     """Encodes Python dicts into Torque binary wire format.
 
@@ -365,7 +352,6 @@ class DocumentEncoder:
             for item in arr:
                 buf.write(struct.pack("!f", float(item)))
 
-
 # ── TCP Ingest Client ───────────────────────────────────────────────────
 
 class TorqueIngestClient:
@@ -495,7 +481,6 @@ class TorqueIngestClient:
         if self._sock is None:
             raise RuntimeError("Not connected. Call connect() first.")
 
-
 # ── TQBF Binary File Writer ────────────────────────────────────────────
 
 class TorqueBinaryFileWriter:
@@ -512,9 +497,8 @@ class TorqueBinaryFileWriter:
         [8 bytes] uncompressed_size: u64 (LE)  ← v2 only
         [N bytes] payload: ZLib-compressed concatenated binary documents
 
-    The uncompressed_size field lets the server pre-size its decompression
-    Vec exactly, avoiding doubling-realloc fragmentation that breaks the
-    silicon unikernel's contiguous bitmap allocator on large imports.
+    The uncompressed_size field lets the server size its decompression
+    buffer exactly once.
 
     The torque server still accepts v1 files (16-byte header, no size field)
     via the read_to_end fallback, so older clients keep working.

torque_http-0.5.0/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Truespar
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.