# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Break Versioning](https://www.taoensso.com/break-versioning).

## [Unreleased]

### Added

### Changed

### Deprecated

### Removed

### Fixed

### Security

[Unreleased]: https://github.com/dry-rb/dry-core/compare/v1.2.0...main

## [1.2.0] - 2025-12-28

### Changed

- Support Ruby 4.0 in `Dry::Core::BasicObject#inspect` and `#pretty_print` (by returning false from its default `#respond_to_missing?`). (@timriley in #87)
- Set minimum Ruby version to 3.2. (@timriley)

[1.2.0]: https://github.com/dry-rb/dry-core/compare/v1.1.0...v1.2.0

## [1.1.0] - 2025-01-04

### Changed

- Minimal Ruby version is 3.1 (@flash-gordon)
- Fixed clash with `dry-logger` (see #80) (@flash-gordon)

[1.1.0]: https://github.com/dry-rb/dry-core/compare/v1.0.1...v1.1.0

## [1.0.1] - 2023-08-06

### Fixed

- [equalizer] Add `Dry::Core.Equalizer` method to make `include Dry::Core.Equalizer(...)` work as documented (via #79) (@timriley)

  Users of Equalizer should now only need to `require "dry/core"` first.

### Changed

- Minimal Ruby version is 3.0 (@flash-gordon)

[1.0.1]: https://github.com/dry-rb/dry-core/compare/v1.0.0...v1.0.1

## [1.0.0] - 2022-11-04

### Added

- Import dry-container as `Dry::Core::Container` (via #77) (@solnic)

[1.0.0]: https://github.com/dry-rb/dry-core/compare/v0.9.1...v1.0.0

## [0.9.1] - 2022-10-18

### Changed

- Correct missing constant for IDENTITY (issue #75 fixed via #76) (@poloka)

[0.9.1]: https://github.com/dry-rb/dry-core/compare/v0.9.0...v0.9.1

## [0.9.0] - 2022-10-15

### Changed

- dry-core now uses zeitwerk for autoloading (@solnic)

[0.9.0]: https://github.com/dry-rb/dry-core/compare/v0.8.1...v0.9.0

## [0.8.1] - 2022-07-27

### Fixed

- [memoizable] plays better with inheritance.
There were cases when cached values from base claesses were used, see #70 (@flash-gordon)

[0.8.1]: https://github.com/dry-rb/dry-core/compare/v0.8.0...v0.8.1

## [0.8.0] - 2022-07-15

### Added

- `Dry::Core::BasicObject` ported from hanami-utils (@jodosha)

### Changed

- [BREAKING] [descendants tracker] switch to using `Class#subclasses` on Ruby 3.1+.
This changes the order of returned subclasses (immediate subclasses now go first) (@flash-gordon)

[0.8.0]: https://github.com/dry-rb/dry-core/compare/v0.7.1...v0.8.0

## [0.7.1] - 2021-07-10

### Fixed

- [memoizable] memoizable correctly handles cases where a method
has unnamed params (e.g. happens when the new `...` syntax is used) (@flash-gordon)

[0.7.1]: https://github.com/dry-rb/dry-core/compare/v0.7.0...v0.7.1

## [0.7.0] - 2021-07-08

### Fixed

- [memoizable] warnings when using keyword arguments (@flash-gordon)
- [deprecations] warnings show more relevant information about caller by default (@timriley)

### Changed

- Minimal Ruby version is 2.6
- [memoizable] memoization of block-accepting methods is deprecated (@flash-gordon)

[0.7.0]: https://github.com/dry-rb/dry-core/compare/v0.6.0...v0.7.0

## [0.6.0] - 2021-06-03

### Added

- [memoizable] support for `BasicObject` (@oleander)
- [memoizable] support for methods that accept blocks (@oleander)
- [deprecations] allow printing frame info on warn when setting up Deprecation module (via #52) (@waiting-for-dev)

### Fixed

- [memoizable] works with MRI 2.7+ keyword arguments now (@oleander)

[0.6.0]: https://github.com/dry-rb/dry-core/compare/v0.5.0...v0.6.0

## [0.5.0] - 2020-12-12

### Added

- dry-equalizer has been imported into dry-core as `Dry::Core::Equalizer` but the interface remains the same, which is `include Dry.Equalizer(...)` - we'll be porting all other gems that depend on dry-equalizer to the latest dry-core with equalizer included *gradually*. Eventually dry-equalizer usage will be gone completely in rom-rb/dry-rb/hanami projects (@solnic)

[0.5.0]: https://github.com/dry-rb/dry-core/compare/v0.4.10...v0.5.0

## [0.4.10] - 2020-11-19

### Added

- `ClassAttributes.defines` gets a new option for coercing values (tallica)
```ruby
class Builder
  extend Dry::Core::ClassAttributes

  defines :nodes, coerce: -> value { Integer(value) }
end
```
`:coerce` works with any callable as well as types from dry-types
```ruby
defines :nodes, coerce: Dry::Types['coercible.integer']
```
- `Constants::IDENTITY` which is the identity function (flash-gordon)

[0.4.10]: https://github.com/dry-rb/dry-core/compare/v0.4.9...v0.4.10

## [0.4.9] - 2019-08-09

### Added

- `Undefined.coalesce` takes a variable number of arguments and returns the first non-`Undefined` value (flash-gordon)

  ```ruby
  Undefined.coalesce(Undefined, Undefined, :foo) # => :foo
  ```

### Fixed

- `Undefined.{dup,clone}` returns `Undefined` back, `Undefined` is a singleton (flash-gordon)

[0.4.9]: https://github.com/dry-rb/dry-core/compare/v0.4.8...v0.4.9

## [0.4.8] - 2019-06-23

### Added

- `Undefined.map` for mapping non-undefined values (flash-gordon)

  ```ruby
  something = 1
  Undefined.map(something) { |v| v + 1 } # => 2

  something = Undefined
  Undefined.map(something) { |v| v + 1 } # => Undefined
  ```

[0.4.8]: https://github.com/dry-rb/dry-core/compare/v0.4.7...v0.4.8

## [0.4.7] - 2018-06-25

### Fixed

- Fix default logger for deprecations, it now uses `$stderr` by default, as it should (flash-gordon)

[0.4.7]: https://github.com/dry-rb/dry-core/compare/v0.4.6...v0.4.7

## [0.4.6] - 2018-05-15

### Changed

- Trigger constant autoloading in the class builder (radar)

[0.4.6]: https://github.com/dry-rb/dry-core/compare/v0.4.5...v0.4.6

## [0.4.5] - 2018-03-14

### Added

- `Dry::Core::Memoizable`, which provides a `memoize` macro for memoizing results of instance methods (timriley)

[0.4.5]: https://github.com/dry-rb/dry-core/compare/v0.4.4...v0.4.5

## [0.4.4] - 2018-02-10

### Added

- `deprecate_constant` overrides `Module#deprecate_constant` and issues a labeled message on accessing a deprecated constant (flash-gordon)
- `Undefined.default` which accepts two arguments and returns the first if it's not `Undefined`; otherwise, returns the second one or yields a block (flash-gordon)

[0.4.4]: https://github.com/dry-rb/dry-core/compare/v0.4.3...v0.4.4

## [0.4.3] - 2018-02-03

### Added

- `Dry::Core::DescendantsTracker` which is a maintained version of the [`descendants_tracker`](https://github.com/dkubb/descendants_tracker) gem (flash-gordon)

[0.4.3]: https://github.com/dry-rb/dry-core/compare/v0.4.2...v0.4.3

## [0.4.2] - 2017-12-16

### Fixed

- Class attributes now support private setters/getters (flash-gordon)

[0.4.2]: https://github.com/dry-rb/dry-core/compare/v0.4.1...v0.4.2

## [0.4.1] - 2017-11-04

### Changed

- Improved error message on invalid attribute value (GustavoCaso)

[0.4.1]: https://github.com/dry-rb/dry-core/compare/v0.4.0...v0.4.1

## [0.4.0] - 2017-11-02

### Added

- Added the `:type` option to class attributes, you can now restrict attribute values with a type. You can either use plain ruby types (`Integer`, `String`, etc) or `dry-types` (GustavoCaso)

  ```ruby
  class Foo
    extend Dry::Core::ClassAttributes

    defines :ruby_attr, type: Integer
    defines :dry_attr, type: Dry::Types['strict.int']
  end
  ```

[0.4.0]: https://github.com/dry-rb/dry-core/compare/v0.3.4...v0.4.0

## [0.3.4] - 2017-09-29

### Fixed

- `Deprecations` output is set to `$stderr` by default now (solnic)

[0.3.4]: https://github.com/dry-rb/dry-core/compare/v0.3.3...v0.3.4

## [0.3.3] - 2017-08-31

### Fixed

- The Deprecations module now shows the right caller line (flash-gordon)

[0.3.3]: https://github.com/dry-rb/dry-core/compare/v0.3.2...v0.3.3

## [0.3.2] - 2017-08-31

### Added

- Accept an existing logger object in `Dry::Core::Deprecations.set_logger!` (flash-gordon)

[0.3.2]: https://github.com/dry-rb/dry-core/compare/v0.3.1...v0.3.2

## [0.3.1] - 2017-05-27

### Added

- Support for building classes within an existing namespace (flash-gordon)

[0.3.1]: https://github.com/dry-rb/dry-core/compare/v0.3.0...v0.3.1

## [0.3.0] - 2017-05-05

### Changed

- Class attributes are initialized _before_ running the `inherited` hook. It's slightly more convenient behavior and it's very unlikely anyone will be affected by this, but technically this is a breaking change (flash-gordon)

[0.3.0]: https://github.com/dry-rb/dry-core/compare/v0.2.4...v0.3.0

## [0.2.4] - 2017-01-26

### Fixed

- Do not require deprecated method to be defined (flash-gordon)

[0.2.4]: https://github.com/dry-rb/dry-core/compare/v0.2.3...v0.2.4

## [0.2.3] - 2016-12-30

### Fixed

- Fix warnings on using uninitialized class attributes (flash-gordon)

[0.2.3]: https://github.com/dry-rb/dry-core/compare/v0.2.2...v0.2.3

## [0.2.2] - 2016-12-30

### Added

- `ClassAttributes` which provides `defines` method for defining get-or-set methods (flash-gordon)

[0.2.2]: https://github.com/dry-rb/dry-core/compare/v0.2.1...v0.2.2

## [0.2.1] - 2016-11-18

### Added

- `Constants` are now available in nested scopes (flash-gordon)

[0.2.1]: https://github.com/dry-rb/dry-core/compare/v0.2.0...v0.2.1

## [0.2.0] - 2016-11-01

[0.2.0]: https://github.com/dry-rb/dry-core/compare/v0.1.0...v0.2.0

## 0.1.0 - 2016-09-17

Initial release