JustDummies

JustDummies

Just dummies — but seriously powerful ones.

Release notes

This page tracks what's new and changing in JustDummies, including new features, improvements, bug fixes, and deprecations. Use it to see what shipped in the most recent release, confirm when a capability became available, or review changes before upgrading.

Versions

JustDummies · Version 1

Snapshot taken at cli-v1.1.0-beta.4 · Read the technical changelog

1.0.0-preview.6

preview

A license change every consumer should read, a nullable-widening generator, and a fairer draw for Half.

⚠️ Breaking changes

  • JustDummies is now licensed under PolyForm Internal Use 1.0.0, not Apache 2.0 — source-available, not open source. You may read, build, modify and run the library (and its bundled analyzers) for your own or your company's internal business operations; you may not distribute the software. Versions already published on NuGet are untouched and keep the license they shipped with. Contributions are now governed by a Contributor Agreement.

✨ New

  • New generator.AsNullable() — widens a generator's type to nullable without ever drawing an absent value, the opposite of .OrNull(). It keeps the wrapped generator's known value count, so Any.SetOf(Any.Enum<T>().AsNullable()) sizes correctly against the enum's members (ADR-0094).

🙌 Improvements

  • Any.Half() now draws uniformly over the values a half can actually represent, instead of over the reals and rounding — which produced almost nothing below 1. A seeded test drawing a Half will replay a different value than before (ADR-0091).

🐛 Bug Fixes

  • Any.Half() now states how many distinct values it holds, so Any.SetOf(Any.Half()) beyond that count is refused instead of exhausting a redraw budget.
  • JD016 now proves several more small element domains exactly (Char, Byte/SByte, Int16/UInt16, Half, and an enum's distinct values), and counts a caller-supplied Any.Char().OneOf(...) pool exactly.
  • JD015 now weighs a value set against every declared constraint together, so a chain refused only by the intersection of several constraints is reported.
  • An element generator that admits nothing now names its own emptying constraint, even inside a distinct collection like Any.SetOf(...).
View on GitHub

1.0.0-preview.5

preview

A guard against blank strings, and four chain-ordering fixes so a specification reads the same regardless of the order it was written in.

✨ New

  • New NotBlank() on Any.String() — requires at least one non-whitespace character, the guard NonEmpty() alone never covered since an entirely-whitespace string is not empty (ADR-0088).

🐛 Bug Fixes

  • JD015 now measures a string's length budget the way the generator actually lays it out, so a re-declared prefix or a NotBlank() filler position is no longer double-counted or missed.
  • An Any.Enum<T>() pool emptied by Except(...) now honours AllowingCombinations() regardless of which call was written first.
  • A flag combination named in OneOf is now accepted wherever it is written, with no need for AllowingCombinations() at all.
  • A distinct collection (Any.SetOf(...) and similar) is now judged on the whole finished chain, so Containing, ContainingAny and a finer Distinct(comparer) are honoured regardless of where WithCount sits in the chain.
  • JD030 now counts every anchored literal (StartingWith, EndingWith, Containing) when it reports the interval a chain draws.
View on GitHub

1.0.0-preview.4

preview

A rename that reads better, and a size ceiling analyzer and library now agree on.

⚠️ Breaking changes

  • AnyChar and AnyString rename LowerCase()/UpperCase() to InLowerCase()/InUpperCase() — the bare names read like a state change, not a quality of the drawn value. No behaviour changes; only the two names do.

🐛 Bug Fixes

  • JD014 now reports a size ceiling above the producible cap: WithMaxLength and WithMaxCount were declared uncapped while the library caps them, so a call the analyzer blessed could be refused at run time with nothing between the two to say so.
View on GitHub

1.0.0-preview.3

preview

A fixed-prefix, restricted-alphabet format — ORD- followed by alphanumerics — is finally one chain instead of a workaround.

✨ New

  • A character family, a subtraction or a casing now governs only the characters the generator draws — never a prefix, suffix or contained value you wrote. Any.String().StartingWith("ORD-").AlphaNumeric() no longer throws at declaration, and yields ORD- followed by alphanumerics only (ADR-0079). No chain that worked before stops working, and no generated value changes shape.
  • New rule JD033 — names an anchored literal the declared characters cannot draw, at the call site, without refusing the chain. Information only, on by default.
  • New rule JD031 — points a chain declaring both inclusive bounds separately (WithMinLength(8).WithMaxLength(20)) at the range form the same generator exposes (WithLengthBetween(8, 20)). Information only.
  • New rule JD032 — warns when a bound is declared twice and the looser call silently loses, whichever order the two were written in.

🙌 Improvements

  • JD015 now reports, as a warning, a value set every declared constraint empties — until now this surfaced only as two information-level JD029 notes.
  • JD024 and JD015 narrow to stay in step with the changes above: JD024 no longer reports a bound JD032 now owns, and JD015 keeps only its length-budget check, so neither refuses at build time what the library now honours at run time.
View on GitHub

1.0.0-preview.2

preview

Two breaking defaults, both in service of the same idea: an unconstrained dummy should certify something, not just look harmless.

⚠️ Breaking changes

  • Any.String() and Any.Char() now draw from the whole of ASCII, control characters included, and an unconstrained string spans 0 to 1024 characters — narrow it with NonEmpty(), WithMaxLength(n) or Printable() (ADR-0075).
  • A declared maximum — WithMaxLength, WithLengthBetween, WithMaxCount — now steers the draw instead of composing with the old narrow spread, and a maximum above 1,000,000 is refused (ADR-0076).

✨ New

  • Five new character families — Punctuation(), Printable(), NonPrintable(), Whitespaces() and Hexadecimal() — plus WithoutAlpha()/WithoutNumeric() to subtract rather than pin, on both Any.String() and Any.Char().
  • IPoolInspection<T> reports what your own constraints left of a pool you supplied — GetSurvivors(), GetRejections() — on every generator that takes a value set (ADR-0067, ADR-0068).
  • JD029 flags, at build time, a value written into a pool that your own constraints can never draw.
  • JD030 flags an Any.String() chain that settles no length, as information.

🙌 Improvements

  • The packaged readme now documents how to draw a NaN on purpose, since Any.Double(), Any.Single() and Any.Half() refuse one as an argument too.
  • JD015 now validates against the new character families, and every value the library prints is escaped against control characters.

🐛 Bug Fixes

  • A decimal exclusion declared twice no longer empties a satisfiable grid.
  • A conflict on Any.Enum<T>() or Any.Guid() now names the exclusion that caused it.
  • A DateTimeOffset pool holding two clocks for the same instant now reaches one verdict regardless of declaration order.
  • JD023 and JD024 now read UInt16/UInt32/UInt64 constants regardless of the literal's suffix.
  • JD015, JD023, JD024 and JD029 now recognise a seeded chain written in one expression.
View on GitHub

1.0.0-preview.1

preview

Not a bigger surface than 0.1.0 — the same one, offered to an outside consumer for the first time, with one new promise attached: your seed.

✨ New

  • A seed now replays across patch and minor versions. Pin one in a test, and it keeps drawing the same values through every upgrade within 1.x (ADR-0049).

🙌 Improvements

  • The package now carries an icon, shared across every package this repository publishes.
  • The packaged readme's links point at this repository instead of the one JustDummies was extracted from.
View on GitHub