#
#  Random/__init__.py : PyCrypto random number generation
#
# ===================================================================
# The contents of this file are dedicated to the public domain.  To
# the extent that dedication to the public domain is not available,
# everyone is granted a worldwide, perpetual, royalty-free,
# non-exclusive license to exercise all rights associated with the
# contents of this file for any purpose whatsoever.
# No rights are reserved.
#
# 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.
# ===================================================================

from __future__ import annotations

from typing import Any

__all__ = ["new", "get_random_bytes"]

from os import urandom


class _UrandomRNG:
    def read(self, n: int) -> bytes:
        """Return a random byte string of the desired size."""
        return urandom(n)

    def flush(self) -> None:
        """Method provided for backward compatibility only."""

    def reinit(self) -> None:
        """Method provided for backward compatibility only."""

    def close(self) -> None:
        """Method provided for backward compatibility only."""


def new(*args: Any, **kwargs: Any) -> _UrandomRNG:
    """Return a file-like object that outputs cryptographically random bytes."""
    return _UrandomRNG()


def atfork() -> None:
    pass


#: Function that returns a random byte string of the desired size.
get_random_bytes = urandom