NEWS.md

History of phone-number releases

8.13.6-3 (2023-02-26)

• Improvements:

  • Speed optimizations (type hints, referential equality).

8.13.6-2 (2023-02-24)

• Improvements:

  • Memoization support for parsing phone numbers as strings.
  • Improved assertion function phone-number.core/valid-input?.

8.13.6-1 (2023-02-11)

• Improvements:

  • Added phone-number.core/number-optraw.
  • phone-number.core/noraw now creates a copy and strips raw input when a PhoneNumber is given.
  • Inline documentation strings edited.

8.13.6-0 (2023-02-11)

• Improvements:

  • Libphonenumber version bump.
  • Added printing method.

8.13.2-0 (2022-12-13)

• Improvements:

  • Libphonenumber version bump.

8.12.52-0 (2022-07-29)

• Improvements:

  • Improved building and documentation generating code.
  • Separated nREPL from REPL (development mode).
  • Syntactical cleanups.
  • Libphonenumber dependency updated to match version 8.12.52.
  • Geocoder dependency updated to match version 2.188.
  • Prefixmapper dependency updated to match version 2.188.
  • Carrier dependency updated to match version 1.178.
  • Development dependencies updated to match their newest versions.

8.12.28-0, 8.12.28-1 (2021-07-21)

• Improvements:

  • Libphonenumber version bump.

• Bug fixes:

  • Removed development dependencies (orchestra) from spec.clj.
  • Moved development file generator.clj to dev/src.

8.12.21-0 (2021-04-19)

• Improvements:

  • Libphonenumber version bump.
  • Removed reflection warnings.

8.12.16-1 (2021-01-31)

• Improvements:

  • Added some missing validators and databases for argument processing
  • Samplers corrected to use -arg versions of databases
  • Added support for pseudo-region :phone-number.region/world for non-geographic numbers
  • Created phone-number.db with cross-databases:
    • Regions to types
    • Types to regions
    • Regions to calling codes
    • Calling codes to regions
    • Calling codes to types
    • Types to calling codes
  • New functions in core:
    • phone-number.core/calling-code-prefix
    • phone-number.core/regions-for-calling-code
    • phone-number.core/region-for-calling-code
    • phone-number.core/calling-codes-for-region
  • Improved main phone numbers generator
    (random regions and calling codes are picked up from valid sets for randomly generated types)
  • Specs divided into 3 groups:
    • Input data specs
    • Generic specs (outputs, common data structures)
    • Internal specs (arguments, properties)
  • Removed legacy support for accepting region codes as enum type values
  • Shuffling functions from phone-number.util are now short-circuiting on nil values
  • Assertion errors reporting improved
  • Development process now uses Eastwood linter

• Bug fixes:

  • Function for building phone numbers from maps now properly handles invalid data
  • Removed unneeded :phone-number.region/unknown
  • Removed global network calling codes from phone-number.country-code/all and related
  • Documentation corrected in some places

8.12.16-0 (2021-01-23)

• Improvements:

  • Libphonenumber dependency updated to match version 8.12.16
  • Geocoder dependency updated to match version 2.152
  • Carrier dependency updated to match version 1.142
  • Development dependencies updated to match newest versions

• Bug fixes:

  • Some local tests (run from REPL) are now using proper default region

8.12.4-3 (2021-01-23)

• Improvements:

  • More relaxed arities (usually allowing to skip region code)
  • Locale support moved to a separate file (with parsing and validation)
  • Added leniency support (phone-number/leniency, phone-number.core/leniencies)
  • Added leniency and max-tries support to phone-number.core/find-numbers
  • Added tests for phone-number.core/find-numbers
  • Specs updated to reflect changes
  • Documentation updated

• Bug fixes:

  • Fixed typo in spec for phone-number.core/time-zones return value
  • Fixed setting the default value of dialing region in phone-number.core/info when main arity is called by other arities.

8.12.4-2 (2020-06-27)

• Improvements:

  • Type-hinted locale-specification arguments as keywords
  • Improved fetching of the required data from phone numbers expressed as maps:
    • phone-number.core/raw-input
    • phone-number.core/valid-input?
  • Changed from accepting phone numbers only as strings to polymorphic:
    • phone-number.core/short-emergency?
    • phone-number.core/short-to-emergency?
  • Added namespaces and namespace aliases for shorter keywords notation:
    • phone-number
    • phone-number.short
    • phone-number.sample
    • phone-number.dialing-region
    • phone-number.arg (specs only)
    • phone-number.args (specs only)
    • phone-number.prop (specs only)

• Bug fixes:

  • Fixed spec for phone-number.core/raw-input

8.12.4-1 (2020-06-24)

• BREAKING CHANGES:

  • Calling region (code) is now renamed to dialing region (code)
    • :phone-number.calling-region is now :phone-number.dialing-region
    • :phone-number.short/dialing-region property is replaced by :phone-number/dialing-region
    • phone-number.core/valid-for-region? is now deprecated in favor of phone-number.core/valid?

• Improvements:

  • Default dialing region support with phone-number.core/*default-dialing-region*
  • Dialing region derivation support with phone-number.core/*info-dialing-region-derived*
  • Improved support for maps as phone numbers (incl. dialing region retention)
  • Added validation for locale specification (phone-number.util/valid-locale?)
  • Samples generator now uses custom, simpler phone number parser
  • Additional arities in phone-number.format/global? and phone-number.format/regional?
  • Input validation is more relaxed (no strict asserts based on first digits)
  • Added phone-number.core/has-raw-input?
  • Added phone-number.core/numeric
  • Added utility functions in phone-number.util:
    • count-digits
    • char-ranges->set
    • available-locales
  • Specs updated
  • Tests updated
  • Generative testing based on generators and specs

• Bug fixes:

  • Proper handling of corner cases (nil punning) at:
    • phone-number.core/short-info
    • phone-number.core/time-zones-all-formats
    • phone-number.core/all-formats
    • phone-number.core/has-calling-code?
    • phone-number.core/raw-input

8.12.4-0 (2020-06-11)

• Initial release.