Deprecate the rand module (#1325)

refs #1321

Author: alex

CHANGELOG.rst

@@ -4,6 +4,21 @@ Changelog
 Versions are year-based with a strict backward-compatibility policy.
 The third digit is only for regressions.
 
+24.3.0 (UNRELEASED)
+-------------------
+
+Backward-incompatible changes:
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Deprecations:
+^^^^^^^^^^^^^
+
+- Deprecated ``OpenSSL.rand`` - callers should use ``os.urandom()`` instead.
+
+Changes:
+^^^^^^^^
+
+
 24.2.1 (2024-07-20)
 -------------------
 

src/OpenSSL/rand.py

@@ -2,8 +2,16 @@
 PRNG management routines, thin wrappers.
 """
 
+import warnings
+
 from OpenSSL._util import lib as _lib
 
+warnings.warn(
+    "OpenSSL.rand is deprecated - you should use os.urandom instead",
+    DeprecationWarning,
+    stacklevel=3,
+)
+
 
 def add(buffer: bytes, entropy: int) -> None:
     """