Deprecate the rand module

refs pyca#1321
alex · Jul 27, 2024 · 825779e · 825779e
1 parent 8dd9457
commit 825779e
Show file tree

Hide file tree

Showing 2 changed files with 23 additions and 0 deletions.
diff --git a/CHANGELOG.rst b/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)
 -------------------
 

diff --git a/src/OpenSSL/rand.py b/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:
     """