1.7.1

Highlights

Quick fix for a bug related to our migration to Zeitwerk.

What's Changed

• Fix Rails loading bug by @joeldrapper in #313

Full Changelog: 1.7.0...1.7.1

1.7.0

Highlights

New _Predicate type

We added a new _Predicate type which essentially combines a proc with a description. You can use it like this:

_Predicate("Starts with 'Hello'") { it.start_with?("Hello") }

after_initialize can now be privately scoped

private def after_initialize
  # do stuff here
end

[Experimental] Literal::Value and Literal::Delegator classes

Literal::Value and Literal::Delegator are new abstractions for single-value objects. Here’s an example of Literal::Value.

class EmailAddress < Literal::Value(String)
  delegate :length

  def domain
    value.split("@").last
  end
end

Literal::Delegator is similar except it delegates all missing methods to the underlying value. We’ll post more documentation soon.

PRs

• The prop method should return its name so it can be chained with other macros by @joeldrapper in #292
• Add _Predicate type by @joeldrapper in #290
• feat: Allow private-scoped after_initialize hooks by @ixti in #301
• Switch to Zeitwerk for code loading by @joeldrapper in #305
• Value objects by @joeldrapper in #293
• Literal branded types by @joeldrapper in #303
• Simplify the subtype method by @joeldrapper in #307
• Make JRuby builds experimental by @joeldrapper in #310
• Improve interface type compaisons by @joeldrapper in #308

New Contributors

• @ixti made their first contribution in #301

Full Changelog: 1.6.0...1.7.0

1.6.0

What’s new

• Fix data structure == equality by @joeldrapper in #278
• Optimise primitive unions by @joeldrapper in #280
• fix enum type error by @Vagab in #285
• add type by @Vagab in #286
• Flatten constraints by @joeldrapper in #287

Full Changelog: 1.5.0...1.6.0

1.5.0

What’s changed

• Make Rails EnumType handle serializing pre-serialized values by @joeldrapper in #256
• Literal::Enum#to_s by @joeldrapper in #257
• Update README.md by @danielmyasnikov in #258
• Remove the option to disable checks by @joeldrapper in #259
• Switch to assert-style tests by @joeldrapper in #260
• Fix typo by @visini in #262
• Allow enum coercion from symbol by @joeldrapper in #261
• Literal::Array(Literal::Tuple)#transpose by @joeldrapper in #263
• Literal array transpose with array by @joeldrapper in #264
• Literal::Array(T) coercion by @joeldrapper in #267
• Literal::Array#zip by @joeldrapper in #268
• Make enums ordered by @joeldrapper in #269
• Literal Array #sort_by! by @hslzr in #272
• Literal Array #each_index by @hslzr in #270
• Literal Array #take_while by @hslzr in #271
• Fix issue with constraint allocations by @joeldrapper in #273
• Fix error when using non-ActiveRecord::Base on ActiveRecord::Relation by @stephannv in #274
• Fixing Rubocop and JRuby CI by @stephannv in #275
• Adding _Date, _Date?, _Time, and _Time? to Literal::Types by @albertico in #277

New Contributors

• @danielmyasnikov made their first contribution in #258
• @visini made their first contribution in #262
• @stephannv made their first contribution in #274
• @albertico made their first contribution in #277

Full Changelog: 1.4.0...1.5.0

1.4.0

What’s Changed

• Fixed an issue that meant you couldn’t have a property named property.
• Fixed an issue when subclassing Literal::Data classes. Previously if you defined a property in the subclass, you would lose all the properties in the parent class.
• Literal::Enum#to_h now yields the member when passed a block. When called without a block, it now returns a Hash from member to value.
• Literal::Enum objects must be unique by value.
• Literal::Data no longer duplicates and freezes its properties — this caused compatibility issues with certain objects. We cannot consider Literal::Data to be deeply frozen going forward.
• Various improvements to Literal::Array, which is still experimental and incomplete.
• Introduced Literal::Tuple, which is still experimental and incomplete. Literal::Array#product now returns a Literal::Tuple in some situations.

Full Changelog: 1.3.0...1.4.0

1.3.0

We’ve tagged this as a minor update, which means it could include breaking changes. However, in this case, these changes are very unlikely to be breaking for you. Some error messages and inspect output will be different, if you depended on that.

What’s Changed

• Fixed an issue that occurred when creating a property called property with prop.
• Improved error output for the _Map type.
• New _Deferred type now makes it possible to define recursive self-referencing types.
• Simplified some equivalent types — for example _Callable now returns _Interface(:call), _Not(_Not(true)) is now just true.
• All built in types are now comparable via Literal.subtype?(a, of: b). For now, consider this method private — however it will be used to make the upcoming Literal::Array, Literal::Hash and Literal::Set objects faster.
• Various improvements to Literal::Array, which is still experimental
• Various improvements to Literal::Flags, which is still experimental

New Contributors

• @alvitovitch made their first contribution in #231

Full Changelog: 1.2.0...1.3.0

1.2.0

What's Changed

• [BREAKING] Literal::Data no longer supports #[] to be consistent with Ruby’s Data
• [FIX] Fixed an issue with _Hash?(K, V) and _Integer?(T)
• Various changes to experimental features: Literal::Flags, Literal::Array, Literal::Set, Literal::Hash
• Improved error messages for _JSONData, _Map(T), _Set(T), and _Union(*T)

New Contributors

• @phillipspc made their first contribution in #141
• @hslzr made their first contribution in #219
• @christopher-b made their first contribution in #143
• @f-mer made their first contribution in #227

Full Changelog: 1.1.0...1.2.0

1.1.0

What's Changed

• Better nested type errors — @segiddins in #132
• Experimental bit flags object — @joeldrapper in #99

Full Changelog: 1.0.0...1.1.0

1.0.0

First stable release of Literal. See documentation.

1.0.0.rc1

Literal 1.0 is almost here. Please try out this release candidate and let us know if you run into any issues.