PaulHowarth/Blog/2022-09-23

Friday 23rd September 2022

Local Packages

• Updated perl-Type-Tiny to 2.000000:

• Back Compat

  • If none of a multisig's alternative sigs match the parameter list, ${^TYPE_PARAMS_MULTISIG} will explicitly be set to undef, instead of being left as-is

  • The Eval::TypeTiny::HAS_LEXICAL_VARS constant no longer exists; it was deprecated in Type-Tiny-1.004000 (2018-07-27)

  • More sensible error message trying to import a type constraint using -declare outside a type library

• Bug Fixes

  • Types::Common was not correctly handling the -sigs export tag

  • Setting a default for a slurpy parameter in Type::Params now warns and ignores the default instead of failing to compile because of a syntax error

  • What was supposed to be a warning for slurpy+default in Type::Params was throwing an exception: corrected to be a warning

• Documentation

  • Document usage with Class::Plain

  • Updated Type::Tiny::Manual to cover new features

  • Fix misspelling of 'GitHub' in documentation

  • Updated the SYNOPSIS for Types::Standard and Type::Tiny

  • Improvements to Type::Params documentation

  • Update NEWS

  • Minor documentation clarifications around new constructor methods for Type::Tiny subclasses

  • Document in Type::Tie that Type::Tie is implicitly loaded when you tie a variable to a Type::Tiny type constraint (it was already documented in the manual)

  • Document the Type::Tie::BASE 'type' method

  • Removed stub pod from a bunch of internal modules; they're internal, so nobody should be expecting pod

• Packaging

  • Add Class::XSAccessor to Type::Tiny's recommendations

• Other

  • %Error::TypeTiny::CarpInternal is now an alias for %Carp::CarpInternal

  • Added: Type::Tiny 'type_default' method

  • Added: Type::Tiny overloads '/'

  • Added: Types::Common module

  • The Type::Params API has had a major overhaul, introducing 'signature' and 'signature_for' functions; the 'compile', 'compile_named', 'compile_named_oo', 'validate', 'validate_named', 'wrap_subs', and 'wrap_methods' functions are now considered the legacy API (there are no plans to drop support for the legacy API in the foreseeable future)

  • Updated: dropping support for Perl 5.6.1 (which was released in April 2001), 5.6.2 (November 2003), and Perl 5.8.0 (July 2002); Type::Tiny now requires at least Perl 5.8.1

  • Major simplifications of Type::Library internals

  • Updated: Require Exporter::Tiny 1.004001+ (previously required Exporter::Tiny 1.000000)

  • Types::Common now also extends Types::TypeTiny

  • Minor bugfixes and improvements to slurpy handling in Type::Params

  • Added: move two helper subs (set_subname and type_to_coderef) out of Type::Library and into Eval::TypeTiny, clean them up, and document them as part of the API

  • Added: Type::Tiny now has an 'exportables' method that provides a list of functions that the type can export; type libraries now defer to this when deciding what they can export

  • Added: Type::Tiny::Class is now an exporter

  • Added: Type::Tiny::Duck is now an exporter

  • Added: Type::Tiny::Enum is now an exporter

  • Added: Type::Tiny::Role is now an exporter

  • Type::Tiny::{Class,Duck,Enum,Role} subclass Exporter::Tiny instead of handling exports manually

  • Added: Type::Tiny::Enum has an is_word_safe method that indicates whether all values in the enumeration are 'words' (i.e. contain only word characters)

  • Added: Word-safe enumerations export constants for each value

  • The NICE_PROTOTYPES constant has been moved from Type::Library to Eval::TypeTiny, though a copy of it is still available in Type::Library for backwards compatibility

  • The intersection of two Type::Tiny::Enum objects is now a Type::Tiny::Enum instead of a Type::Tiny::Intersection

  • The union of two Type::Tiny::Enum objects is now a Type::Tiny::Enum instead of a Type::Tiny::Union

  • Type::Params will call default coderefs as a method for signatures where method => 1

  • The functionality provided by Type::Params::multisig() is now provided in the Type::Params v2 API (and is slightly more functional!)

  • Get the 'multiple' option working with the 'signature_for' function from Type::Params

  • Improved test cases and miscellaneous small bugfixes for slurpy parameters in Type::Params

  • Minor refactoring, mostly to make things more easily testable

  • Added: Type::Tiny now has an exportables_by_tag method

  • Added: Type::Tiny::_DeclaredType is now a separate module (it was previously defined inline in Type/Library.pm)

  • Eval::TypeTiny::type_to_coderef() can now handle being passed undef as a type constraint and will create a Type::Tiny::_DeclaredType object to wrap instead

  • If a type library has been made immutable, you can no longer add new types and coercions to it

  • Type::Params 'signature_for' will now delay most of the signature compilation until the function is called for the first time, like 'wrap_subs'/'wrap_methods' used to do; it still does enough up-front to detect some common errors in signatures

  • Various Type::Library clean-ups

  • Added: Types::Common::String now has a DelimitedStr type

  • Improve cache key generation for parameterized types
  • Minor improvements to the default name generator, used to generate the display_name for parameterized type constraints

  • Eval::TypeTiny::CodeAccumulator now supports $coderef->compile(alias => 1)

  • If the 'ws' parameter is set to true in parameterized DelimitedStr type constraints, leading and trailing whitespace will now be permitted

  • Non-parameterized DelimitedStr now has a coercion from ArrayRef[Str]

  • The ${^TYPE_PARAMS_MULTISIG} magic global variable is now called ${^_TYPE_PARAMS_MULTISIG}; the old name will still be supported for at least six months after the next stable release

  • Added: Bundle Type::Tie, which was previously in a separate distribution on the CPAN

  • Adding a type constraint to a type library will now also add it to the library's type registry (even though this registry is unlikely to be used)

  • Rewrite much of Type::Tie to no longer use inside-out objects and avoid a dependency on Hash::Util::FieldHash or alternative implementations of fieldhashes

  • Type::Parser's internal packages now have version numbers

  • Type::Tie now supports variables being cloned with Clone::clone(); it already supported Storable::dclone()

  • Type::Tie will now try to load Class::XSAccessor::Array for a speed-up

  • Using Type::Utils to declare a named type will now automatically add the type to the caller's type registry

  • Type::Params signature_for will respect inheritance when looking for methods to wrap, when the 'method' option is true

• Test Suite

  • More tests

  • Tests for the 'type_default' of all built-in types

  • Better tests for 'strictness' option in Type::Params

  • Improved tests for slurpy handling in Type::Params

  • The internal module Type::Params::Signature now has some tests of its own

  • Add versions of tests for the new Type::Params v2 API that don't rely on Perl 5.20 features

  • More tests for Type::Tiny::{Class,Duck,Enum,Role} exporting

  • Improved test cases; now 100% coverage on coveralls.io

  • Another test for '-base'

  • Bundle a (renamed) copy of Type::Nano in the test suite for some tests, combining Type::Nano and Type::Tiny type constraints, and converting Type::Nano to Type::Tiny

  • Improved test cases for Type::Tie with an aim at 100% coverage

  • Test usage with Class::Plain

`