Skip to content

generate

cl_forge.verify.generate 

generate(
    n: int, min: int, max: int, seed: int | None = None
) -> list[dict[str, int | str]]

Generates a list of unique Chilean RUT/RUN numbers with their verifier digits.

Parameters:

Name Type Description Default
n int

The number of RUT/RUNs to generate.

 required
min int

The minimum value for the numeric part of the RUT/RUN.

 required
max int

The maximum value for the numeric part of the RUT/RUN.

 required
seed int | None

An optional seed for the random number generator to ensure reproducibility. If None, a random seed is used.

 None

Returns:

Type Description
list[dict[str, int | str]]

A list of dictionaries, each containing 'correlative' and 'verifier' keys representing the generated RUT/RUN numbers.

Raises:

Type Description
InvalidInput
  • If n is less than or equal to 0.
  • If min and/or max are negative.
  • If seed is given and is negative.
InvalidRange

If min is greater than or equal to max.
InsufficientRange

If the range between min and max is too small to generate n unique RUT/RUNs.
Source code in src/cl_forge/core/impl/rs_cl_forge/rs_verify.pyi 
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
def generate(
        n: int,
        min: int,  # noqa: A002
        max: int,  # noqa: A002
        seed: int | None = None
) -> list[dict[str, int | str]]:
    """
    Generates a list of unique Chilean RUT/RUN numbers with their verifier
    digits.

    Parameters
    ----------
    n : int
        The number of RUT/RUNs to generate.
    min : int
        The minimum value for the numeric part of the RUT/RUN.
    max : int
        The maximum value for the numeric part of the RUT/RUN.
    seed : int | None
        An optional seed for the random number generator to ensure
        reproducibility. If `None`, a random seed is used.

    Returns
    -------
    list[dict[str, int | str]]
        A list of dictionaries, each containing 'correlative' and 'verifier'
        keys representing the generated RUT/RUN numbers.

    Raises
    ------
    InvalidInput
        - If `n` is less than or equal to 0.
        - If `min` and/or `max` are negative.
        - If `seed` is given and is negative.
    InvalidRange
        If `min` is greater than or equal to `max`.
    InsufficientRange
        If the range between `min` and `max` is too small to generate `n`
        unique RUT/RUNs.
    """