# Changelog
## Unreleased changes
## 4.2.0
- Add changelog to docs and hex info. Thanks @epinault!
- Add `Moar.Term.blank?/2` and `Moar.Term.present?/2` which can override what values are considered blank & present.
## 4.1.0
- `Moar.String.quote/2` surrounds the given string with quotation marks.
## 4.0.0
- Test with Elixir 1.19 and Erlang 28.1; drop support for Elixir 1.16 and Erlang 25.
- Update deps.
## 3.2.0
- Added `Moar.Map.deep_from_struct/1` which is like `Map.from_struct` but goes deep. Thanks HT!
## 3.1.0
- Added `Moar.IO` which contains functions to more easily format strings with colors and other ANSI codes.
## 3.0.0
- `Moar.URI.valid?` will now return `true` when given a `mailto:` URI, as long as its path is not blank.
- **Breaking changes:** in previous versions, `Moar.URI.valid?` would return `false` when given a `mailto:` URI. To ensure
that a URI is a valid *web* URI, use `Moar.URI.web_url?`
## 2.7.0
- Add `:to_string` shortcut for `assert_eq` which converts both terms to strings before comparing.
## 2.6.0
- Add `Moar.DateTime.at/2` for creating a `DateTime` that is today, at a certain time, optionally shifted by a duration.
- Add `Moar.Sugar.then_if/3` for piping into a function only if a condition is truthy.
## 2.5.0
- Add `Moar.Sugar.reply/2` to pipe a socket or genserver state into a reply message.
## 2.4.2
- Updated sponsorship info.
## 2.4.1
- Fix spec of `Moar.String.pluralize`.
## 2.4.0
- `Moar.String.pluralize` can now optionally include the number along with the pluaralized text.
## 2.3.0
- When either or both of the last two arguments to `Moar.Term.when_present/3` are functions, they are called with the
given term as an argument.
## 2.2.0
- Add `Moar.Map.compact_blank/1`.
## 2.1.0
- `Moar.List.fill` expands (or shrinks) a list to a given size by repeating its elements.
## 2.0.1
- Require at least Elixir 1.16.
## 2.0.0
- Test with Elixir 1.18; drop support for Elixir 1.15.
## 1.65.0
- `Moar.String.join` joins multiple items, as a shortcut to `Enum.map_join([item1, item2, ...], "-", &to_string/1)`
## 1.64.0
- `Moar.String.underscore/1` is soft-deprecated in favor of `to_case(s, :snake_case)`.
- Add `Moar.String.to_case(s, :kebab_case)`
## 1.63.1
- `Moar.Term.blank?/1` handles non-UTF binaries.
## 1.63.0
- Add `Moar.Sugar.cont`, `Moar.Sugar.cont!`, `Moar.Sugar.halt`, `Moar.Sugar.halt!`, and `Moar.Sugar.noreply!`
## 1.62.0
- Add `Moar.Enum.compact_blank/1` which removes values considered blank by `Moar.Term.blank?/1`.
## 1.61.2
- `Moar.Map.deep_atomize_keys/1` handles struct values without raising.
## 1.61.1
- `Moar.Map.deep_stringify_keys/1` skips stringifying structs.
## 1.61.0
- Add `Moar.Map.deep_stringify_keys/1`.
## 1.60.0
- Add `Moar.String.lorem/1` which generates a "lorem ipsum" string of the given length.
## 1.59.2
- `Moar.UUID.valid?/1` requires the first segment to be 8 hexadecimal characters.
## 1.59.1
- `Moar.UUID.valid?/1` now fails if the input is too long
## 1.59.0
- add `Moar.Random.dom_id/1`
## 1.58.0
- require Elixir 1.15 or greater
## 1.57.0
- test against the latest version of Erlang and Elixir
## 1.56.2
- more doc fixes
## 1.56.1
- doc updates
## 1.56.0
- add `Moar.Code.fetch_docs_as_markdown` to fetch a module's or function's docs as markdown.
## 1.55.0
- add `Moar.Random.fuzz/2` which increases or decreases a number by a random percent.
## 1.54.0
- add `Moar.UUID.regex/0` which returns a regex that matches valid UUIDs
- add `Moar.UUID.valid?/1` which returns true if the given string is a valid UUID
## 1.53.0
- add `Moar.File.checksum/1` which returns a sha256 checksum of a file.
- add `Moar.File.stream!` which delegates to `File.stream!` in a way that's compatible with older Elixir versions.
## 1.52.1
- fix typespecs for `Moar.Assertions.assert_eq/3`
## 1.52.0
- `assert_eq` now raises when an invalid option is provided.
- Add `:apply` and `:map` options to `assert_eq/3` to run one or more functions on `left` or `right` (`:apply`) or run one
or more functions on each value in `left` or `right` (`:map`).
- The following `assert_eq` transformations are now supported: `:downcase`, `:sort`, `:squish`, `:trim`
- The following `assert_eq` are soft-deprecated: `ignore_order: <boolean>`, `ignore_whitespace: :leading_and_trailing`,
`whitespace: :squish`, `whitespace: :trim`.
- `Moar.Opts.get/3` and `Moar.Opts.take/2` accept keyword lists with a mix of "valueless" keys and regular keys, like
`[:a, b: 2]`, where the default value for a "valueless" key is `true`.
- Add `Moar.Opts.pop/3` which pops an opt out of an opts enum.
- Add `Moar.Opts.delete/2` and `Moar.Opts.delete/3` which deletes values from opts.
- Add `Moar.Opts.replace/3` which replaces values in opts.
## 1.51.0
- Add `Moar.Term.when_present` which returns one value when the term is present, and another value when missing
## 1.50.0
- Deprecated `is_map_or_keyword` in favor of `map_or_keyword?`.
- Deprecated `is_map_or_nonempty_keyword` in favor of `map_or_nonempty_keyword?`.
## 1.49.0
- Add `Moar.List.unwrap!` which returns the argument if it's not a list, or returns the only item in the list, or raises
if the list has 0 or more than 1 item.
- Add `Moar.Random.float` which returns a random float.
- Add `Moar.String.remove_marked_whitespace` which - `remove_marked_whitespace` removes whitespacing following a special
`\v` marker.
- Add `Moar.URI.format` with `scheme_host_port`, `scheme_host_port_path`, and `simple_string` formats.
- Deprecate `Moar.URI.to_simple_string` in favor of `Moar.URI.format(uri, :simple_string)`.
## 1.48.0
- Add `Moar.Enum.test_ids` which is just like `Moar.Enum.tids` but with a slightly different name.
## 1.47.0
- Add `Moar.Enum.lists_to_maps` which converts a list of lists to a list of maps using the provided list of keys.
## 1.46.0
- `Moar.Enum.tids` accepts a `:sorted` option
## 1.45.1
- `Moar.Version.compare/2` truncates `1.2.3.4` to `1.2.3`.
## 1.45.0
- `Moar.String.count_leading_spaces/1` returns the number of leading spaces in a string.
- `Moar.String.unindent/1` un-indents a multiline string by the smallest indentation size
- `Moar.String.unindent/2` un-indents a multiline string by the given amount
## 1.44.0
- `Moar.List.to_sentence` takes a mapper function, which defaults to `Kernel.to_string/1`.
## 1.43.0
- Add `Moar.List.to_sentence` converts a list into a string, with items separated by commas, and an "and" before the last
item.
## 1.42.0
- Add `Moar.Integer.compare/2`.
## 1.41.0
- Created `Moar.List` and added `to_keyword` which converts a list to a keyword list, allowing a default value.
## 1.40.0
- `assert_contains` returns consistently-ordered map keys when using OTP 26.0 or greater.
## 1.39.0
- Add `Moar.String.compare` and `Moar.String.compare?` which can transform strings before comparing.
## 1.38.0
- Fix `Moar.DateTime.recent?` to return false when the given datetime is in the future.
- Add `Moar.DateTime.within?` which returns `true` if the given datetime is within the given duration.
## 1.37.0
- Add `Moar.Enum.find_indices!` which raises when a member of the expected elements is not found in the given enumerable.
## 1.36.0
- Add `Moar.Regex` with `named_capture/3` and `named_captures/3` functions.
- Add `Moar.Version` with `compare/2` and `normalize/1` functions.
## 1.35.0
- Add `Moar.Map.compact/1`.
## 1.34.0
- Add `Moar.Map.merge_if_blank/2`.
## 1.33.0
- Add `Moar.Enum.index_by/2` and `Moar.Map.index_by/2` which return a new map indexed by a function or key. Inspired by
code in: http://johnelmlabs.com/posts/anti-patterns-in-liveview/
- Add `Moar.Map.put_new!/3` which is like `Map.put_new/3` but raises if the key already exists.
## 1.32.0
- Add `Moar.Assertions.assert_contains/2`
- Soft-deprecate `Moar.Assertions.assert_eq`'s `ignore_whitespace: :leading_and_trailing` option in favor of `whitespace:
:squish` and `whitespace: :trim`
## 1.31.0
- Add `Moar.URI`
## 1.30.0
- Fixed a bug in `Moar.Map.deep_merge/3`, which would incorrectly convert empty lists to maps when they were map or
keyword list values.
- Add `Moar.Enum.is_map_or_nonempty_keyword/1` which is like `Moar.Enum.is_map_or_keyword/1` but returns false if given an
empty list.
## 1.29.0
- Add `Moar.Enum.find_indices/3` which returns the indices of elements in an enum.
## 1.28.0
- Add `Moar.Atom.ensure_existing_atoms/1` to check for a list of previously defined atoms.
- Add `Moar.Atom.existing_atom?/1` to check if a string has previously been defined as an atom.
- Add `Moar.Enum.into!/2` which is like `Enum.into/2` but accepts `nil` as its first argument.
- `Moar.Map.merge/2` now accepts `nil` values.
- Add `Moar.Map.validate_keys!/2` which raises if the given map has keys that are not in the given list.
## 1.27.0
- Add `Moar.Map.deep_take/2` to take from nested maps.
## 1.26.0
- Add `Moar.Enum.take_at/2` which returns a list of elements at the given indices.
## 1.25.0
- Add `Moar.Atom.to_existing_atom/1` which acts like `String.to_existing_atom` but can take an atom (or string) as an
argument.
## 1.24.1
- Bug fix: `Moar.Map.deep_merge/3` used to try to convert any enumerable into a map before merging, but this caused
problems when a value was some other kind of enumerable that wasn't meant to be a nested map-like structure. Now, it
only automatically converts keyword lists to maps.
- Add `Moar.Enum.is_map_or_keyword` (which unforuntately cannot be used as a guard).
## 1.24.0
- `Moar.Map.deep_merge/3` accepts a function to resolve merge conflicts.
## 1.23.0
- Add `between?/2` and `recent?/2` to `Moar.DateTime`
## 1.22.0
- `assert_that` and `refute_that` return the result of the action
- Add `:only` and `:except` to documentation for `assert_eq`.
## 1.21.0
- Add `Moar.Atom.atomize/1`
## 1.20.0
- Add `Moar.Map.put_if_blank/3`
## 1.19.3
- Add link to related library "siiibo/assert_match"
## 1.19.2
- `Moar.String.to_integer/1` will return the argument without complaint when it is already an integer.
## 1.19.1
- Add `:crypto` to declared extra applications.
- Clarify documentation for `Moar.String.append_unless_blank/2`.
## 1.19.0
- Add `Moar.String.append_unless_blank/2`.
## 1.18.1
- Fix `Moar.Assertions.refute_that` to work with checks that do not implement `String.Chars`.
## 1.18.0
- Add `Moar.Tuple.reduce/1`.
## 1.17.0
- Add `ignore_whitespace: :leading_and_trailing` option to `Moar.Assertions.assert_eq`.
## 1.16.0
- Add `Moar.Duration.shift_down/1` and `Moar.Duration.shift_up/1`.
## 1.15.0
- Add `Moar.DateTime.subtract/2` and `Moar.NaiveDateTime.subtract/2`.
- Add `Moar.DateTime.utc_now/1` and `Moar.NaiveDateTime.utc_now/1` which allow adding and subtracting from "now".
- Add `Moar.Duration.from_now/1` and a `:from_now` transformer to `Moar.Duration.format/4`.
## 1.14.0
- Add `Moar.Assertions.assert_that/2` without the `:from` assertion.
- Add `Moar.String.to_case/2`.
## 1.13.1
- Doc updates
## 1.13.0
- Add `Moar.String.pluralize/3` to pluralize strings.
## 1.12.0
- Add `Moar.Duration.humanize/1` which can turn `{120, :second}` into `{2, :minute}`, and `Moar.Duration.shift/2` which is
like `Moar.Duration.convert/2` but returns a duration tuple.
- Add `Moar.Duration.ago/1` which returns the duration between a given datetime and now.
- Add `Moar.Duration.between/2` which returns the duration between two datetimes.
- Add `Moar.Duration.approx/1` which shifts a duration to a simpler approximate value.
- `Moar.Duration` supports more time units: `:approx_month` (30 days), and `approx_year` (12 approx_months).
- Add `Moar.Duration.format/2` which formats a duration in either long (`"3 seconds"`) or short (`"3s"`) format, with
optional transformers and suffix.
## 1.11.0
- `Moar.Assertions.refute_that/2` macro.
- Add exports to formatter.
## 1.10.0
- `Moar.Map.atomize_key/3` converts dashes in keys to underscores before atomizing. Because the other "atomize" functions
in this module use this function, they have the same behavior.
- `Moar.String.slug/2` retains any leading or trailing joiners (so `slug("_foo-bar", "_")` now returns `"_foo_bar"`
instead of `"foo_bar"`).
## 1.9.0
- Add `Moar.String.slug/2` and `Moar.String.underscore/1`.
## 1.8.0
- Add `atomize_key` to `Moar.Map`, which atomizes a map key and raises if atomizing a key would conflict with an exsiting
atom key. `atomize_keys` and `deep_atomize_keys` now use this function so they can also raise in the same situation.
- Add "!" versions of some functions in `Moar.Map` that raise when a key is not found.
- Add an overview of the library to the readme.
## 1.7.0
- Add `assert_recent` to `Moar.Assertions`
## 1.6.0
- Add `Moar.NaiveDateTime`
## 1.5.0
- Add `Moar.Opts`
## 1.4.0
- Add `Moar.Protocol.implements?/2`
- Add `Moar.Map.deep_merge/2`
## 1.3.0
- `Moar.DateTime.add` can add a `Moar.Duration` to a `DateTime`
- `Moar.Retry.rescue_for!/2` can take a `Moar.Duration`
- Add `Moar.Retry.retry_for` and `Moar.Retry.retry_until`
## 1.2.0
- `Moar.Retry.rescue_for!/2` and `.rescue_until!/2`
## 1.1.0
- Add `Moar.Tuple.from_list!/1`
## 1.0.0
- Update documentation
- Minor formatting fixes
- Remove "Moar.Term.or_default/2" since it is the same as `Moar.Term.presence/2`.
## 0.1.0
- Initial release
