docs: update docstrings to reflect bytes-only input

- 'string data' -> 'bytes-like data' in update() docstrings
- 'strings passed' -> 'data passed' in digest() docstrings
- Add docstring tests to verify no 'string' references

Author: ifduyue

src/_xxhash.c

@@ -572,7 +572,7 @@ static int PYXXH32_init(PYXXH32Object *self, PyObject *args, PyObject *kwargs)
 PyDoc_STRVAR(
     PYXXH32_update_doc,
     "update (data)\n\n"
-    "Update the xxh32 object with the string data. Repeated calls are\n"
+    "Update the xxh32 object with bytes-like data. Repeated calls are\n"
     "equivalent to a single call with the concatenation of all the arguments.");
 
 static PyObject *PYXXH32_update(PYXXH32Object *self, PyObject *arg)
@@ -593,7 +593,7 @@ static PyObject *PYXXH32_update(PYXXH32Object *self, PyObject *arg)
 PyDoc_STRVAR(
     PYXXH32_digest_doc,
     "digest() -> string\n\n"
-    "Return the digest of the strings passed to the update() method so\n"
+    "Return the digest of the data passed to the update() method so\n"
     "far. This is a 4-byte string which may contain non-ASCII characters,\n"
     "including null bytes.");
 
@@ -927,7 +927,7 @@ static int PYXXH64_init(PYXXH64Object *self, PyObject *args, PyObject *kwargs)
 PyDoc_STRVAR(
     PYXXH64_update_doc,
     "update (data)\n\n"
-    "Update the xxh64 object with the string data. Repeated calls are\n"
+    "Update the xxh64 object with bytes-like data. Repeated calls are\n"
     "equivalent to a single call with the concatenation of all the arguments.");
 
 static PyObject *PYXXH64_update(PYXXH64Object *self, PyObject *arg)
@@ -947,7 +947,7 @@ static PyObject *PYXXH64_update(PYXXH64Object *self, PyObject *arg)
 PyDoc_STRVAR(
     PYXXH64_digest_doc,
     "digest() -> string\n\n"
-    "Return the digest of the strings passed to the update() method so\n"
+    "Return the digest of the data passed to the update() method so\n"
     "far. This is a 8-byte string which may contain non-ASCII characters,\n"
     "including null bytes.");
 
@@ -1281,7 +1281,7 @@ static int PYXXH3_64_init(PYXXH3_64Object *self, PyObject *args, PyObject *kwarg
 PyDoc_STRVAR(
     PYXXH3_64_update_doc,
     "update (data)\n\n"
-    "Update the xxh3_64 object with the string data. Repeated calls are\n"
+    "Update the xxh3_64 object with bytes-like data. Repeated calls are\n"
     "equivalent to a single call with the concatenation of all the arguments.");
 
 static PyObject *PYXXH3_64_update(PYXXH3_64Object *self, PyObject *arg)
@@ -1301,7 +1301,7 @@ static PyObject *PYXXH3_64_update(PYXXH3_64Object *self, PyObject *arg)
 PyDoc_STRVAR(
     PYXXH3_64_digest_doc,
     "digest() -> string\n\n"
-    "Return the digest of the strings passed to the update() method so\n"
+    "Return the digest of the data passed to the update() method so\n"
     "far. This is a 8-byte string which may contain non-ASCII characters,\n"
     "including null bytes.");
 
@@ -1644,7 +1644,7 @@ static int PYXXH3_128_init(PYXXH3_128Object *self, PyObject *args, PyObject *kwa
 PyDoc_STRVAR(
     PYXXH3_128_update_doc,
     "update (data)\n\n"
-    "Update the xxh3_128 object with the string data. Repeated calls are\n"
+    "Update the xxh3_128 object with bytes-like data. Repeated calls are\n"
     "equivalent to a single call with the concatenation of all the arguments.");
 
 static PyObject *PYXXH3_128_update(PYXXH3_128Object *self, PyObject *arg)
@@ -1664,7 +1664,7 @@ static PyObject *PYXXH3_128_update(PYXXH3_128Object *self, PyObject *arg)
 PyDoc_STRVAR(
     PYXXH3_128_digest_doc,
     "digest() -> string\n\n"
-    "Return the digest of the strings passed to the update() method so\n"
+    "Return the digest of the data passed to the update() method so\n"
     "far. This is a 16-byte string which may contain non-ASCII characters,\n"
     "including null bytes.");
 

tests/test_hashlib_compat.py

@@ -39,6 +39,21 @@ def test_str_rejected_update(self):
                     'Strings must be encoded before hashing'):
                 obj.update('hello')
 
+    # ── docstrings reflect bytes-only input ─────────────────────────
+
+    def test_update_docstring(self):
+        for algo in ('xxh32', 'xxh64', 'xxh3_64', 'xxh3_128'):
+            obj = getattr(xxhash, algo)()
+            doc = obj.update.__doc__
+            self.assertIn('bytes-like', doc)
+            self.assertNotIn('string', doc)
+
+    def test_digest_docstring(self):
+        for algo in ('xxh32', 'xxh64', 'xxh3_64', 'xxh3_128'):
+            obj = getattr(xxhash, algo)()
+            doc = obj.digest.__doc__
+            self.assertNotIn('strings passed', doc)
+
     # ── data keyword ───────────────────────────────────────────────
 
     def test_data_keyword(self):