JustDummies

Juste des dummies, mais redoutablement efficaces.

API v1.0.0-preview.6

Sections de l'API

Exceptions

La famille que la bibliothèque lève elle-même, et quel membre apparaît pour quelle nature de refus.

Les signatures et les commentaires de documentation ci-dessous restent en anglais sur toutes les pages, dans toutes les locales : ils sont lus directement dans les paquets publiés, et non écrits pour ce site.

sealed class

AnyGenerationException

Thrown when a generation cannot be completed even though every declared constraint was accepted — most commonly when a factory passed to As or a composer passed to Combine rejects a generated value. Whenever the failing generator draws from one of the library's random contexts, the message names the seed that replays the run and Seed carries it.

public sealed class AnyGenerationException
Hérite de
DummyException
Implémente
ISerializable

Constructeurs

AnyGenerationException(string message)Initializes a new instance of the AnyGenerationException class.
AnyGenerationException(string message, Exception innerException)Initializes a new instance of the AnyGenerationException class wrapping an underlying failure.

Propriétés

int? Seed { get; }The seed of the random context the failing generation drew from, when it is known. Under the ambient context (Any.Reproducibly(...)) pass it to Any.Reproducibly(seed, ...) to replay the run; a value drawn from an Any.WithSeed(seed) context already replays deterministically on its own. The failure message states which of the two applies. null when the failing generator does not draw from one of the library's random contexts.

sealed class

ConflictingAnyConstraintException

Thrown at the moment a constraint is declared when it cannot be satisfied together with the constraints already declared on the same generator — for example Any.String().WithLength(3).StartingWith("ORD-"), where the prefix alone already requires 4 characters. Failing at declaration time, with a message that names both constraints, is a deliberate part of the library's contract: a contradiction in a test's Arrange is a defect of the test, and it should read as one — not surface later as a puzzling generation failure.

public sealed class ConflictingAnyConstraintException
Hérite de
DummyException
Implémente
ISerializable

Constructeurs

ConflictingAnyConstraintException(string message)Initializes a new instance of the ConflictingAnyConstraintException class.

abstract class

DummyException

Base class of every exception the library throws on its own behalf, so a caller can catch "anything JustDummies rejected" with a single clause. Concrete cases: ConflictingAnyConstraintException when two declared constraints cannot be satisfied together, and AnyGenerationException when a generation fails even though the constraints were accepted.

public abstract class DummyException
Hérite de
Exception
Implémente
ISerializable

sealed class

UnsupportedRegexException

Thrown when a pattern passed to StringMatching is well-formed but uses a construct outside the regular subset the library generates from — a lookahead or lookbehind, a backreference, a balancing group, a Unicode category, a word boundary. These constructs are either not regular (so no finite generator can honour them) or deliberately out of scope; the library refuses to guess rather than silently emit a value that does not actually match. A syntactically malformed pattern is a caller mistake and surfaces as an ArgumentException instead.

public sealed class UnsupportedRegexException
Hérite de
DummyException
Implémente
ISerializable

Constructeurs

UnsupportedRegexException(string message)Initializes a new instance of the UnsupportedRegexException class.