@josevalim josevalim released this Aug 24, 2018 · 283 commits to master since this release

Assets 4

1. Bug fixes

ExUnit

  • [ExUnit.Assertions] Do not attempt to expand try/1 as it is a special form

Mix

  • [mix compile.app] Do not include applications with runtime: false as a runtime dependency for applications coming from Hex

Checksums

  • Precompiled.zip SHA1: 9bfe816aaedeb9c5d40095b4eb4f5cb07eb33c2b
  • Precompiled.zip SHA512: f8b0ac405531d46f4b65f459970c4b82892f8db51028f172072748269a922db65cb58e36239cd26dc39e5bdebd08a0e630ecbc267b6ff55a15d188483d78a0e5
  • Docs.zip SHA1: 3ef076afc86a10fb422ec340f57079bb2480863c
  • Docs.zip SHA512: a3cf7bb9bf31ce4bdbaa44470c2be82f9482f3b8ff3eb7fec86ba89debcf639a27c0a045ea65ce8e80aa86c2e9e4bbb8fa98f6389a6093191518f2180833aa2d

@josevalim josevalim released this Aug 5, 2018 · 283 commits to master since this release

Assets 4

v1.7.2 (2018-08-05)

1. Bug fixes

Elixir

  • [Kernel] Do not emit warnings for repeated docs over different clauses due to false positives

Mix

  • [mix compile] Properly mark top-level dependencies as optional and as runtime. This fixes a bug where Mix attempted to start optional dependencies of a package when those optional dependencies were not available
  • [mix compile] Avoid deadlock when a config has a timestamp later than current time
  • [mix test] Do not fail suite if there are no test files

2. Enhancements

Elixir

  • [DateTime] Take negative years into account in DateTime.from_iso8601/1

Mix

  • [mix help] Show task and alias help when both are available

Checksums

  • Precompiled.zip SHA1: 97051389559547248d7e7f497ed3866ef11e3072
  • Precompiled.zip SHA512: e7ebdfcd301737967d0c04df50d3ba5b5a0663d2a2e2ac771cf61b9aa8d73a8f64dd9a408890ff0e2db4e48df8f94ff4d5fb7060f25592411e54910cdfc567a0
  • Docs.zip SHA1: 7fbcff81b1032570c1f9a0dfa232e8b1bdd0490a
  • Docs.zip SHA512: 8625522139f6a961fedb18b00cc78cad5e344f17b5a8a72746ceb284aab3f712db4b7ad57a4cfb86cdfa799a6c0f0b0b6c417117865321bbb70b6bbe0d8f0dd6

@josevalim josevalim released this Jul 26, 2018 · 283 commits to master since this release

Assets 4

v1.7.1 (2018-07-26)

1. Bug fixes

Elixir

  • [Calendar] Work-around a Dialyzer bug that causes it to loop for a long time, potentially indefinitely

Checksums

  • Precompiled.zip SHA1: fb06a3d238b65705a0e36fe9c308eef3d8bb5d46
  • Precompiled.zip SHA512: 75c1601d985988ecdfcd48892cde4058dd36e52a3aa1c2007290ce587d7fa131d066afc6c34ca9138cf66431de80369681c82cf6290c214853335471c1851deb
  • Docs.zip SHA1: e1008908b0fb4e692893dcc5c745f1c219fced1e
  • Docs.zip SHA512: d05d1df7d9dab315a96fd7c0a49214e743b6bbe66fbbc6a3d8933c37f9baa5995b061396254b55d8c6ce8d337ed1ae3fcc3f97e65dd1cd8be9d091ce3412e27a

@josevalim josevalim released this Jul 25, 2018 · 283 commits to master since this release

Assets 4

Elixir v1.7 is the last release to support Erlang/OTP 19. We recommend everyone to migrate to Erlang/OTP 20+.

Documentation metadata

Elixir v1.7 implements EEP 48. EEP 48 aims to bring documentation interoperability across all languages running on the Erlang VM. The documentation format proposed by EEP 48 also supports metadata, which is now fully exposed to Elixir developers:

@moduledoc "A brand new module"
@moduledoc authors: ["Jane", "Mary"], since: "1.4.0"

Passing metadata is supported on @doc, @moduledoc and @typedoc.

To access the new documentation format, developers should use Code.fetch_docs/1. The old documentation format is no longer available and the old Code.get_docs/2 function will return nil accordingly.

Tools like IEx and ExDoc have been updated to leverage the new format and show relevant metadata to users. While Elixir allows any metadata to be given, those tools currently exhibit only :deprecated and :since. Other keys may be shown in the future.

The __STACKTRACE__ construct

Erlang/OTP 21.0 introduces a new way to retrieve the stacktrace that is lexically scoped and no longer relies on side-effects like System.stacktrace/0 does. Before one would write:

try do
  ... something that may fail ...
rescue
  e ->
    log(e, System.stacktrace())
    reraise(e, System.stacktrace())
end

In Elixir v1.7, this can be written as:

try do
  ... something that may fail ...
rescue
  e ->
    log(e, __STACKTRACE__)
    reraise(e, __STACKTRACE__)
end

This change may also yield performance improvements in the future, since the lexical scope allows us to track precisely when a stacktrace is used and we no longer need to keep references to stacktrace entries after the try construct finishes.

Other parts of the exception system have been improved. For example, more information is provided in certain occurrences of ArgumentError, ArithmeticError and KeyError messages.

Erlang/OTP logger integration

Erlang/OTP 21 includes a new :logger module. Elixir v1.7 fully integrates with the new :logger and leverages its metadata system. The Logger.Translator mechanism has also been improved to export metadata, allowing custom Logger backends to leverage information such as:

  • :crash_reason - a two-element tuple with the throw/error/exit reason as first argument and the stacktrace as second

  • :initial_call - the initial call that started the process

  • :registered_name - the process registered name as an atom

We recommend Elixir libraries that previously hooked into Erlang's :error_logger to hook into Logger instead, in order to support all current and future Erlang/OTP versions.

Other Logger improvements

Previously, Logger macros such as debug, info, and so on would always evaluate their arguments, even when nothing would be logged. From Elixir v1.7, the arguments are only evaluated when the message is logged.

The Logger configuration system also accepts a new option called :compile_time_purge_matching that allows you to remove log calls with specific compile-time metadata. For example, to remove all logger calls from application :foo with level lower than :info, as well as remove all logger calls from Bar.foo/3, you can use the following configuration:

config :logger,
  compile_time_purge_matching: [
    [application: :foo, level_lower_than: :info],
    [module: Bar, function: "foo/3"]
  ]

ExUnit improvements

ExUnit has also seen its own share of improvements. Assertions such as assert some_fun(arg1, arg2, arg3) will now include the value of each argument in the failure report:

  1) test function call arguments (TestOneOfEach)
     lib/ex_unit/examples/one_of_each.exs:157
     Expected truthy, got false
     code: assert some_vars(1 + 2, 3 + 4)
     arguments:

         # 1
         3

         # 2
         7

     stacktrace:
       lib/ex_unit/examples/one_of_each.exs:158: (test)

Furthermore, failures in doctests are now colored and diffed.

On the mix test side of things, there is a new --failed flag that runs all tests that failed the last time they ran. Finally, coverage reports generated with mix test --cover include a summary out of the box:

Generating cover results ...

Percentage | Module
-----------|--------------------------
   100.00% | Plug.Exception.Any
   100.00% | Plug.Adapters.Cowboy2.Stream
   100.00% | Collectable.Plug.Conn
   100.00% | Plug.Crypto.KeyGenerator
   100.00% | Plug.Parsers
   100.00% | Plug.Head
   100.00% | Plug.Router.Utils
   100.00% | Plug.RequestId
       ... | ...
-----------|--------------------------
    77.19% | Total

1. Enhancements

Elixir

  • [Calendar.ISO] Support negative dates in Calendar.ISO
  • [Calendar] Add Calendar.months_in_year/1 callback
  • [Code] Add Code.compile_file/2 that compiles files without leaving footprints on the system
  • [Code] Add Code.purge_compiler_modules/0 that purges any compiler module left behind. This is useful for live systems dynamically compiling code
  • [Code] Add Code.fetch_docs/1 that returns docs in the EEP 48 format
  • [Date] Add Date.months_in_year/1 function
  • [DynamicSupervisor] Use the name of the DynamicSupervisor as the ID whenever possible
  • [Exception] Provide "did you mean" suggestions on KeyError
  • [Exception] Provide more information on ArithmeticError on Erlang/OTP 21+
  • [Function] Add Function module with capture/3, info/1 and info/2 functions
  • [GenServer] Support the new handle_continue/2 callback on Erlang/OTP 21+
  • [IO.ANSI] Add cursor movement to IO.ANSI
  • [Kernel] Support adding arbitrary documentation metadata by passing a keyword list to @doc, @moduledoc and @typedoc
  • [Kernel] Introduce __STACKTRACE__ to retrieve the current stacktrace inside catch/rescue (this will be a requirement for Erlang/OTP 21+)
  • [Kernel] Raise on unsafe variables in order to allow us to better track unused variables (also known as imperative assignment / variable leakage)
  • [Kernel] Warn when using length to check if a list is not empty on guards
  • [Kernel] Add hints on mismatched do/end and others pairs
  • [Kernel] Warn when comparing structs using the >, <, >= and <= operators
  • [Kernel] Warn on unsupported nested comparisons such as x < y < z
  • [Kernel] Warn if redefining documentation across clauses of the same definition
  • [Kernel] Warn on unnecessary quotes around atoms, keywords and calls
  • [Macro] Add Macro.special_form?/2 and Macro.operator?/2 that returns true if the given name/arity is a special form or operator respectively
  • [Macro.Env] Add Macro.Env.vars/1 and Macro.Env.has_var?/2 that gives access to environment data without accessing private fields
  • [Regex] Include endianness in the regex version. This allows regexes to be recompiled when an archive is installed in a system with a different endianness
  • [Registry] Add Registry.count/1 and Registry.count_match/4
  • [String] Update to Unicode 11
  • [StringIO] Add StringIO.open/3
  • [System] Use ISO 8601 in System.build_info/0

ExUnit

  • [ExUnit.Assertion] Print the arguments in error reports when asserting on a function call. For example, if assert is_list(arg) fails, the argument will be shown in the report
  • [ExUnit.Diff] Improve diffing of lists when one list is a subset of the other
  • [ExUnit.DocTest] Show colored diffs on failed doctests
  • [ExUnit.Formatter] Excluded tests, via the --exclude and --only flags, are now shown as "Excluded" in reports. Tests skipped via @tag :skip are now exclusively shown as "Skipped" and in yellow

IEx

  • [IEx.Helpers] Add use_if_available/2
  • [IEx.Helpers] Allow force: true option in recompile/1
  • [IEx.Helpers] Add :allocators pane to runtime_info/1
  • [IEx.Helpers] Show documentation metadata in h/1 helpers

Logger

  • [Logger] Ensure nil metadata is always pruned
  • [Logger] Only evaluate Logger macro arguments when the message will be logged
  • [Logger] Add :compile_time_purge_matching to purge logger calls that match certain compile time metadata, such as module names and application names
  • [Logger] Log to :stderr if a backend fails and there are no other backends
  • [Logger] Allow translators to return custom metadata
  • [Logger] Return :crash_reason, :initial_call and :registered_name as metadata in crash reports coming from Erlang/OTP

Mix

  • [mix archive.install] Add support for the Hex organization via --organization
  • [mix archive.uninstall] Support --force flag
  • [mix compile] Improve support for external build tools such as rebar
  • [mix deps] Include override: true in rebar dependencies to make the behaviour closer to how rebar3 works (although diverged deps are still marked as diverged)
  • [mix escript.install] Add support for the Hex organization via --organization
  • [mix escript.uninstall] Support --force flag
  • [mix help] Also list aliases
  • [mix local] Use ipv6 with auto fallback to ipv4 when downloading data
  • [mix profile] Allow all profiling tasks to run programatically
  • [mix test] Add --failed option that only runs previously failed tests
  • [mix test] Print coverage summary by default when the --cover flag is given
  • [Mix.Project] Add Mix.Project.clear_deps_cache/0
  • [Mix.Project] Add Mix.Project.config_mtime/0 that caches the config mtime values to avoid filesystem access

2. Bug fixes

Elixir

  • [IO.ANSI.Docs] Fix table column alignment when converting docs to ANSI escapes
  • [Code] Ensure string_to_quoted returns error tuples instead of raising in certain constructs
  • [Code.Formatter] Consistently format keyword lists in function calls with and without parens
  • [Code.Formatter] Do not break after -> when there are only comments and one-line clauses
  • [File] Allow the :trim_bom option to be used with :encoding
  • [Kernel] Raise on unsafe variables as some of the code emitted with unsafe variables would not correctly propagate variables or would disable tail call optimization semantics
  • [Kernel] Do not crash on dynamic sizes in binary generators with collectable into in comprehensions
  • [Kernel] Do not crash on literals with non-unary size in binary generators with collectable into in comprehensions
  • [Task] Improve error reports and exit reasons for failed tasks on Erlang/OTP 20+

ExUnit

  • [ExUnit.Case] Raise proper error if @tag and @moduletag are used before use ExUnit.Case
  • [ExUnit.Case] Raise proper error if @describetag is used outside of describe/2 blocks
  • [ExUnit.DocTest] Emit proper assertion error on doctests with invalid UTF-8

Mix

  • [mix archive.install] Fetch optional dependencies when installing an archive from Git/Hex
  • [mix compile] Properly track config files in umbrella projects and recompile when any relevant umbrella configuration changes
  • [mix deps] Ensure the same dependency from different SCMs are tagged as diverged when those SCMs are remote and non-remote
  • [mix deps] Ensure we re-run dependency resolution when overriding a skipped dep in umbrella
  • [mix deps.compile] Perform clean builds for dependencies on outdated locks to avoid old modules from affecting future compilation
  • [mix escript.install] Fetch optional dependencies when installing an escript from Git/Hex

3. Soft-deprecations (no warnings emitted)

Elixir

  • [Code] Deprecate Code.load_file/2 in favor of Code.compile_file/2
  • [Code] Deprecate Code.loaded_files/0 in favor of Code.required_files/0
  • [Code] Deprecate Code.unload_files/1 in favor of Code.unrequire_files/1

Logger

  • [Logger] compile_time_purge_level is deprecated in favor of compile_time_purge_matching

4. Hard-deprecations

Elixir

  • [Code] Code.get_docs/2 is deprecated in favor of Code.fetch_docs/1
  • [Enum] Enum.chunk/2/3/4 is deprecated in favor of Enum.chunk_every/2/3/4 - notice chunk_every does not discard incomplete chunks by default
  • [GenServer] Warn if super is used in any of the GenServer callbacks
  • [Kernel] not left in right is ambiguous and is deprecated in favor of left not in right
  • [Kernel] Warn on confusing operator sequences, such as 1+++1 meaning 1 ++ +1 or ........ meaning ... .. ...
  • [OptionParser] Deprecate dynamic option parser mode that depended on atoms to be previously loaded and therefore behaved inconsistently
  • [Stream] Stream.chunk/2/3/4 is deprecated in favor of Stream.chunk_every/2/3/4 - notice chunk_every does not discard incomplete chunks by default

Checksums

  • Precompiled.zip SHA1: 5be4b5d4f96d0269debe1cab0055401ae3c18bdd
  • Precompiled.zip SHA512: 56e6ee97fe8bc526e49a2ccdc80d9504777e656d8552ad9c7291ed105bec41ad2d5bf4c1beed59fed6a2b38784d3a01647dd034534944a93c7c707e86e565c1e
  • Docs.zip SHA1: 3a36ecc99f6ee85126a80aea501eee28883eea5a
  • Docs.zip SHA512: fc6641af55d3bf78e6dbb45433b9761ef403bab7a83597a984d229a34e79ff717d14e88a8978a7a7f7fdfdf8d9eb16c200275320ee395d5d7271d0a85988fdfb
Pre-release

@josevalim josevalim released this Jul 19, 2018 · 283 commits to master since this release

Assets 4
Release v1.7.0-rc.1
Pre-release

@josevalim josevalim released this Jul 13, 2018 · 283 commits to master since this release

Assets 4
Release v1.7.0-rc.0

@josevalim josevalim released this Jun 19, 2018 · 980 commits to master since this release

Assets 4

This release supports Erlang/OTP 21.0 by removing all warnings and by properly supporting the new Erlang logger module.

Important! the Precompiled.zip attachment below is precompiled on the lowest supported Erlang/OTP version, which is Erlang/OTP 19.0. Therefore, if you want to run Elixir v1.6 with Erlang/OTP 21, we recommend you to compile Elixir from source.

1. Bug fixes

Elixir

  • [Base] Do not raise when finding bad digits in Base.decode32! with case: :mixed
  • [Code] Preserve the user's choice when fn is followed by a newline and it has only a single clause
  • [DynamicSupervisor] Properly account for restarting children in the :max_children configuration
  • [String] Add performant impl for string upcase/downcase :ascii mode
  • [Task.Supervisor] Fix type spec for start_child/4

Logger

  • [Logger] Do not crash truncation when truncate is set to infinity

Mix

  • [mix format] Match files starting with dot

@josevalim josevalim released this May 7, 2018 · 980 commits to master since this release

Assets 4

This release supports Erlang/OTP 21.0-rc by removing all warnings and by properly redirecting logger output. Note it is not guaranteed it will support Erlang/OTP 21.0 final.

1. Bug fixes

  • [Code] Preserve the user's choice in the formatter on parens call with next break fits
  • [Code] Preserve the user's choice in the formatter on calls without parens when we have one argument per line
  • [Code] Fix formatting when there is a tilde in the first element of a bitstring
  • [Kernel] Support specsdiff flag on __info__ spec clauses
  • [Kernel] Do not exclude hygienic vars in defguard
  • [Kernel.SpecialForms] Mark for comprehensions as generated to avoid dialyzer warnings
  • [Macro] Make sure Macro.to_string/2 emits valid quoted expressions
  • [Task] Support :infinity timeout on Task.yield_many/2
  • [Task.Supervisor] Do not crash spawning supervised tasks when the parent process is dead
  • [URI] Fix parsing of URIs with trailing ?

@josevalim josevalim released this Mar 16, 2018 · 980 commits to master since this release

Assets 4

1. Bug fixes

Elixir

  • [Code.Formatter] Do not double escape quoted keyword list identifiers
  • [Kernel] Properly support into: binary in Erlang/OTP 20.3

@josevalim josevalim released this Mar 9, 2018 · 980 commits to master since this release

Assets 4

1. Enhancements

Elixir

  • [Code.Formatter] Support comments in the middle of pipelines, when and | expressions

2. Bug fixes

Elixir

  • [Code.Formatter] Consider commas when breaking groups
  • [Code.Formatter] Ensure proper precedence between & and operators
  • [Code.Formatter] Consider .formatter.exs when formatting stdin

Logger

  • [Logger.Translator] Ensure logger doesn't crash when reporting named DynamicSupervisor