Source code for furo._demo_module

# Copyright (c) 2021 Pradyun Gedam
# Licensed under the Open Software License version 3.0
# SPDX-License-Identifier: OSL-3.0

"""This is a demo module included in the docs in order to exercise autodoc."""

from typing import Optional, TextIO, Type, Union


[docs]def show_warning( message: Union[Warning, str], category: Type[Warning], filename: str, lineno: int, file: Optional[TextIO] = None, line: Optional[str] = None, ) -> None: """Show a warning to the end user. .. code:: python warnings.showwarning = show_warning :param message: What you want to tell the user. :param category: The type of warning. :param filename: The file that the warning is for. :param lineno: The line that the warning is for. :param file: Where to write the warning. :param line: line of source code to be included in the warning message """
[docs]class RandomNumberGenerator: """A random number generator.""" def __init__(self, *, seed: int = 4) -> None: """Initialize.""" self._seed = 4 @property def seed(self) -> int: """Get seed for random number generation. .. seealso:: https://xkcd.com/221/ """ return self._seed
[docs] def get_random_integer(self) -> int: """Return a random integer.""" return self.seed
[docs] def get_random_float(self) -> float: """Return a random float.""" return float(self.seed)