Release v1.0.6

- Add URL validation: warn if path doesn't contain /solr
- Prepare for Solr 10.0+ root URL restriction

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: search5

README.md

@@ -102,6 +102,10 @@ poetry run pytest tests/
 
 ## Changelog
 
+### 1.0.6
+
+- URL validation: warns if URL path doesn't contain `/solr` (Solr 10.0+ preparation)
+
 ### 1.0.5
 
 - **Breaking**: Removed `SolrConnection` class. Use `Solr` instead

docs/changelog.rst

@@ -1,6 +1,16 @@
 Changelog
 =========
 
+1.0.6 (2026-03-27)
+-------------------
+
+**New features:**
+
+- ``Solr`` constructor now validates the URL path. A ``UserWarning`` is issued
+  if the path does not contain ``/solr``, preparing for Solr 10.0+ which
+  requires the URL to end with ``/solr``.
+
+
 1.0.5 (2026-03-27)
 -------------------
 

docs/conf.py

@@ -9,8 +9,8 @@
 copyright = '2010-2026, solrpy developers'
 author = 'solrpy developers'
 
-version = '1.0.5'
-release = '1.0.5'
+version = '1.0.6'
+release = '1.0.6'
 
 # -- General configuration ---------------------------------------------------
 

docs/quickstart.rst

@@ -26,6 +26,11 @@ The connected Solr version is auto-detected::
 
     print(conn.server_version)  # e.g. (9, 4, 1)
 
+.. note::
+
+   If the URL does not contain ``/solr`` in its path, a ``UserWarning``
+   is issued. Solr 10.0+ requires the URL to end with ``/solr``.
+
 
 Health check
 ------------

docs/reference.rst

@@ -61,7 +61,8 @@ Solr class
       * - Parameter
         - Description
       * - ``url``
-        - URI pointing to the Solr instance (e.g. ``http://localhost:8983/solr/mycore``)
+        - URI pointing to the Solr instance (e.g. ``http://localhost:8983/solr/mycore``).
+          A ``UserWarning`` is issued if the path does not contain ``/solr``.
       * - ``persistent``
         - Keep a persistent HTTP connection open. Defaults to ``True``.
       * - ``timeout``

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "solrpy"
-version = "1.0.5"
+version = "1.0.6"
 description = "Client for the Solr search service"
 license = "Apache-2.0"
 readme = "README.md"

solr/core.py

@@ -5,6 +5,7 @@
 import socket
 import datetime
 import logging
+import warnings
 import base64
 import http.client as httplib
 import urllib.parse as urlparse
@@ -21,7 +22,7 @@
 from .response import Response, Results
 from .parsers import parse_json_response, parse_query_response
 
-__version__ = "1.0.5"
+__version__ = "1.0.6"
 
 __all__ = ['SolrException', 'SolrVersionError', 'Solr',
            'Response', 'SearchHandler']
@@ -51,6 +52,19 @@ def __init__(self, url: str,
 
         assert self.scheme in ('http', 'https')
 
+        # Validate URL path contains /solr
+        path_parts = self.path.rstrip('/').split('/')
+        if 'solr' not in path_parts:
+            warnings.warn(
+                "solrpy: URL '%s' does not contain '/solr' in its path. "
+                "Expected format: http://host:port/solr or "
+                "http://host:port/solr/<core>. "
+                "Solr 10.0+ requires the URL to end with '/solr'."
+                % url,
+                UserWarning,
+                stacklevel=2,
+            )
+
         self.persistent = persistent
         self.reconnects = 0
         self.timeout = timeout

tests/test_all.py

@@ -2155,5 +2155,59 @@ def test_json_query_has_header(self):
         conn.close()
 
 
+# ===================================================================
+# 1.0.6 tests — URL validation
+# ===================================================================
+
+class TestURLValidation(unittest.TestCase):
+    """Solr constructor should warn on suspicious URLs."""
+
+    def test_valid_url_no_warning(self):
+        import warnings
+        with warnings.catch_warnings(record=True) as w:
+            warnings.simplefilter("always")
+            conn = solr.Solr(SOLR_HTTP, response_format='xml')
+            solr_warnings = [x for x in w if 'solrpy' in str(x.message)]
+            self.assertEqual(len(solr_warnings), 0)
+            conn.close()
+
+    def test_url_ending_with_solr_no_warning(self):
+        import warnings
+        with warnings.catch_warnings(record=True) as w:
+            warnings.simplefilter("always")
+            conn = solr.Solr('http://localhost:8983/solr', response_format='xml')
+            solr_warnings = [x for x in w if 'solrpy' in str(x.message)]
+            self.assertEqual(len(solr_warnings), 0)
+            conn.close()
+
+    def test_suspicious_url_warns(self):
+        import warnings
+        with warnings.catch_warnings(record=True) as w:
+            warnings.simplefilter("always")
+            conn = solr.Solr('http://localhost:8983/search', response_format='xml')
+            solr_warnings = [x for x in w if 'solrpy' in str(x.message)]
+            self.assertEqual(len(solr_warnings), 1)
+            self.assertIn('/solr', str(solr_warnings[0].message))
+            conn.close()
+
+    def test_root_url_warns(self):
+        import warnings
+        with warnings.catch_warnings(record=True) as w:
+            warnings.simplefilter("always")
+            conn = solr.Solr('http://localhost:8983/', response_format='xml')
+            solr_warnings = [x for x in w if 'solrpy' in str(x.message)]
+            self.assertEqual(len(solr_warnings), 1)
+            conn.close()
+
+    def test_url_with_solr_in_path_no_warning(self):
+        import warnings
+        with warnings.catch_warnings(record=True) as w:
+            warnings.simplefilter("always")
+            conn = solr.Solr('http://localhost:8983/solr/mycore', response_format='xml')
+            solr_warnings = [x for x in w if 'solrpy' in str(x.message)]
+            self.assertEqual(len(solr_warnings), 0)
+            conn.close()
+
+
 if __name__ == "__main__":
     unittest.main()