chore(deps): update dependency elixir to v1.18.1 #27
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR contains the following updates:
1.16.2
->1.18.1
Release Notes
elixir-lang/elixir (elixir)
v1.18.1
Compare Source
1. Enhancements
2. Bug fixes
Elixir
Code.Fragment.container_cursor_to_quoted/2
with:trailing_fragment
parses expressions that were supported in previous versions@file
annotation@file
annotation:no_parens
metadata when using capture with arity on all casesExUnit
--repeat-until-failure
can be combined with groupsMix
--warnings-as-errors
v1.18.0
Compare Source
https://elixir-lang.org/blog/2024/12/19/elixir-v1-18-0-released/
Elixir v1.18 is an impressive release with improvements across the two main efforts happening within the Elixir ecosystem right now: set-theoretic types and language servers. It also comes with built-in JSON support and adds new capabilities to its unit testing library. Here is a quick break down.
Type system improvements
The most exciting change in Elixir v1.18 is type checking of function calls, alongside gradual inference of patterns and return types. To understand how this will impact your programs, consider the following code in "lib/user.ex":
Elixir's type system will infer that the
drive/2
function expects a%User{}
struct and returns either{:ok, dynamic()}
,{:error, :no_choice}
, or{:error, :not_allowed}
.Therefore, the following code in a separate module (either in a separate or the same file), should emit a violation, due to an invalid argument:
Here is the warning:
And the next snippet will warn because the
:error
clause will never match, as that's not a valid return type of theUser.drive/2
call:And here is the warning:
For more details on typing inference and the trade-offs made by the Elixir team, see our official documentation.
There are many other improvements to the type system, which we will go in detail within the official release. Meanwhile, here is a list summary of the overall improvements done to the type system:
Type inference of patterns (typing inference of guards will be part of an upcoming release)
Type checking of all language constructs, including local and remote calls, except
for
,with
, and closuresType checking of all functions inlined by the compiler found in
Kernel
Type checking of all conversion functions inlined by the compiler
Support for tuples and lists as composite types as well as type checking of their basic operations
Detection of clauses and patterns that will never match from
case
,cond
, and=
Detection of unused clauses in private functions
ExUnit improvements
ExUnit now supports parameterized tests to run the same test module multiple times under different parameters.
For example, Elixir ships a local, decentralized and scalable key-value process storage called
Registry
. The registry can be partitioned and its implementation differs depending if partitioning is enabled or not. Therefore, during tests, we want to ensure both modes are exercised. With Elixir v1.18, we can achieve this by writing:ExUnit parameterizes whole test modules. If your modules are configured to run concurrently, as above, so will the parameterized ones.
ExUnit also comes with the ability of specifying test groups. While ExUnit supports running tests concurrently, those tests must not have shared state between them. However, in large applications, it may be common for some tests to depend on some shared state, and other tests to depend on a completely separate state. For example, part of your tests may depend on Cassandra, while others depend on Redis. Prior to Elixir v1.18, these tests could not run concurrently, but in v1.18 they might as long as they are assigned to different groups. Tests modules within the same group do not run concurrently, but across groups, they might.
With features like async tests, suite partitioning, and now grouping, Elixir developers have plenty of flexibility to make the most use of their machine resources, both in development and in CI.
mix format --migrate
The
mix format
command now supports an explicit--migrate
flag, which will convert constructs that have been deprecated in Elixir to their latest version. Because this flag rewrites the AST, it is not guaranteed the migrated format will always be valid when used in combination with macros that also perform AST rewriting.As of this release, the following migrations are executed:
Normalize parens in bitstring modifiers - it removes unnecessary parentheses in known bitstring modifiers, for example
<<foo::binary()>>
becomes<<foo::binary>>
, or adds parentheses for custom modifiers, where<<foo::custom_type>>
becomes<<foo::custom_type()>>
.Charlists as sigils - formats charlists as
~c
sigils, for example'foo'
becomes~c"foo"
.unless
as negatedif
s - rewritesunless
expressions usingif
with a negated condition, for exampleunless foo do
becomesif !foo do
.More migrations may be added in future releases.
JSON support
This release includes official support for JSON encoding and decoding.
Both encoder and decoder fully conform to RFC 8259 and ECMA 404 standards.
Encoding
Encoding can be done via
JSON.encode!/1
andJSON.encode_to_iodata!/1
functions. The default encoding rules are applied as follows:integer() | float()
true | false
nil
binary()
atom()
list()
%{binary() => _}
%{atom() => _}
%{integer() => _}
You may also implement the
JSON.Encoder
protocol for custom data structures. Elixir already implements the protocol for all Calendar types.If you have a struct, you can derive the implementation of the
JSON.Encoder
by specifying which fields should be encoded to JSON:Decoding
Decoding can be done via
JSON.decode/2
andJSON.decode!/2
functions. The default decoding rules are applied as follows:integer() | float()
true | false
nil
binary()
%{binary() => _}
Language server listeners
4 months ago, we welcomed the Official Language Server team, with the goal of unifying the efforts behind code intelligence, tools, and editors in Elixir. Elixir v1.18 brings new features on this front by introducing locks and listeners to its compilation. Let's understand what it means.
At the moment, all language server implementations have their own compilation environment. This means that your project and dependencies during development are compiled once, for your own use, and then again for the language server. This duplicate effort could cause the language server experience to lag, when it could be relying on the already compiled artifacts of your project.
This release address by introducing a compiler lock, ensuring that only a single operating system process running Elixir compiles your project at a given moment, and by providing the ability for one operating system process to listen to the compilation results of others. In other words, different Elixir instances can now communicate over the same compilation build, instead of racing each other.
These enhancements do not only improve editor tooling, but they also directly benefit projects like IEx and Phoenix. For example, you can invoke
IEx.configure(auto_reload: true)
and IEx will automatically reload modules changed elsewhere, either by a separate terminal or your IDE.Potential incompatibilities
This release no longer supports WERL (a graphical user interface on Windows used by Erlang 25 and earlier). For a better user experience on Windows terminals, use Erlang/OTP 26 (this is also the last Elixir release to support Erlang/OTP 25).
Furthermore, in order to support inference of patterns, Elixir will raise if it finds recursive variable definitions. This means patterns that never match, such as this one, will no longer compile:
However, recursion of root variables (where variables directly point to each other), will also fail to compile:
While the definition above could succeed (as long as all three arguments are equal), the cycle is not necessary and could be removed, as below:
You may also prefer to write using guards:
1. Enhancements
Elixir
elixir
,elixirc
, andmix
on Windows. Those provide a safer entry point for running Elixir from other platformsDuration.to_string/1
Code.format_string!/2
--
and---
inCode.format_string!/2
to make precedence clearerCode.string_to_quoted/2
whentoken_metadata: true
to help compute ranges from the AST:capture_arg
as its own entry inCode.Fragment.surround_context/2
Config.read_config/1
Enum.product_by/2
andEnum.sum_by/2
MissingApplicationsError
exception to denote missing applicationsJSON
module with encoding and decoding functionalityJSON.Encoder
for all Calendar types_
), such ashttp_сервер
. Previously allowed highly restrictive identifiers, which mixed Latin and other scripts, such as the japanese word for t-shirt,Tシャツ
, now require the underscore as wellelem/2
unquote
andunquote_splicing
to catch bugs earlierERL_COMPILER_OPTIONS=deterministic
. Keep in mind deterministic builds strip source and other compile time information, which may be relevant for programsList.ends_with?/2
dbg
handling ofif/2
,with/1
and of code blocksMacro.struct_info!/2
to return struct information mirroringmod.__info__(:struct)
Registry.lock/3
for local lockingPartitionSupervisor.resize!/2
to resize the number of partitions in a supervisor (up to the limit it was started with)Process.sleep/1
@undefined_impl_description
to customize error message when an implementation is undefined__deriving__/1
as optional macro callback toProtocol
, no longer requiring empty implementationsExUnit
ExUnit.Case
test_pid
as a tagIEx
IEx.configure(auto_reload: true)
to automatically pick up modules recompiled from other operating system processes:dot_iex
support toIEx.configure/1
Mix
mix format --migrate
to migrate from deprecated functionality:listeners
configuration to listen to compilation events from the current and other operating system processes2. Bug fixes
Elixir
Code.string_to_quoted/2
next_break_fits
respectsline_length
unquote
andunquote_splicing
to provide better error reports instead of failing too late inside the compilerStream.transform/5
URI.merge/2
ExUnit
assert/1
with=
IEx
IEx.Helpers.recompile/0
will reload modules changed by other operating system processesMix
--all-warnings
when files do not changerebar3
in some casespriv
directories.app
files deterministic in releasesMix.Shell
on Windows when outputting non UTF-8 characters3. Soft deprecations (no warnings emitted)
Elixir
color/3
is deprecated in favor ofcolor_doc/3
fold_doc/2
is deprecated in favor offold/2
unless
in favor ofif
. Usemix format --migrate
to automate the migrationMacro.struct!/2
is deprecated in favor ofMacro.struct_info!/2
__deriving__/3
inside theAny
implementation is deprecated, derive it inside the protocol definition itself4. Hard deprecations
EEx
<%#
is deprecated in favor of<%!--
or<% #
c:EEx.handle_text/2
is deprecated in favor ofc:EEx.handle_text/3
Elixir
:warnings_as_errors
is deprecated viaCode.put_compiler_option/2
. This must not affect developers, as the:warnings_as_errors
option is managed by Mix tasks, and not directly used via theCode
moduleEnumerable.slice/1
List.zip/1
is deprecated in favor ofEnum.zip/1
Module.eval_quoted/3
in favor ofCode.eval_quoted/3
Range.new/2
Tuple.append/2
is deprecated, useTuple.insert_at/3
insteadMix
mix cmd --app APP
in favor ofmix do --app APP
:warnings_as_errors
configuration in:elixirc_options
is deprecated. Instead pass the--warnings-as-errors
flag tomix compile
. Alternatively, you might alias the task:aliases: [compile: "compile --warnings-as-errors"]
:warnings_as_errors
configuration in:test_elixirc_options
is deprecated. Instead pass the--warnings-as-errors
flag tomix test
. Alternatively, you might alias the task:aliases: [test: "test --warnings-as-errors"]
compilers/0
in favor ofMix.Task.Compiler.compilers/0
v1.17
The CHANGELOG for v1.17 releases can be found in the v1.17 branch.
v1.17.3
Compare Source
1. Bug fixes
Elixir
IEx
recompile
Mix
--label
option on stats and cyclesv1.17.2
Compare Source
1. Bug fixes
Logger
:gen_statem
'sformat_status/2
returns non-tupleMix
:ref
RELEASE_MODE
and set ERRORLEVEL on.bat
scriptsv1.17.1
Compare Source
1. Enhancements
Mix
2. Bug fixes
EEx
Elixir
with
'selse
patternsno_return
functionExUnit
--repeat-until-failure
v1.17.0
Compare Source
https://elixir-lang.org/blog/2024/06/12/elixir-v1-17-0-released/
This release includes type inference of patterns to provide warnings for an initial set of constructs (binaries, maps, and atoms) within the same function. It also includes a new Duration data type to interact with Calendar types, support for Erlang/OTP 27, and many other improvements.
Warnings from gradual set-theoretic types
This release introduces gradual set-theoretic types to infer types from patterns and use them to type check programs, enabling the Elixir compiler to find faults and bugs in codebases without requiring changes to existing software. The underlying principles, theory, and roadmap of our work have been outlined in "The Design Principles of the Elixir Type System" by Giuseppe Castagna, Guillaume Duboc, José Valim.
At the moment, Elixir developers will interact with set-theoretic types only through warnings found by the type system. The current implementation models all data types in the language:
binary()
,integer()
,float()
,pid()
,port()
,reference()
- these types are indivisible. This means both1
and13
get the sameinteger()
type.atom()
- it represents all atoms and it is divisible. For instance, the atom:foo
and:hello_world
are also valid (distinct) types.map()
and structs - maps can be "closed" or "open". Closed maps only allow the specified keys, such as%{key: atom(), value: integer()}
. Open maps support any other keys in addition to the ones listed and their definition starts with...
, such as%{..., key: atom(), value: integer()}
. Structs are closed maps with the__struct__
key.tuple()
,list()
, andfunction()
- currently they are modelled as indivisible types. The next Elixir versions will also introduce fine-grained support to them.We focused on atoms and maps on this initial release as they are respectively the simplest and the most complex types representations, so we can stress the performance of the type system and quality of error messages. Modelling these types will also provide the most immediate benefits to Elixir developers. Assuming there is a variable named
user
, holding a%User{}
struct with anaddress
field, Elixir v1.17 will emit the following warnings at compile-time:Pattern matching against a map or a struct that does not have the given key, such as
%{adress: ...} = user
(noticeaddress
vsadress
)Accessing a key on a map or a struct that does not have the given key, such as
user.adress
Updating a struct or a map that does not define the given key, such as
%{user | adress: ...}
Invoking a function on non-modules, such as
user.address()
Capturing a function on non-modules, such as
&user.address/0
Attempting to invoke to call an anonymous function without an actual function, such as
user.()
Performing structural comparisons with structs, such as
my_date < ~D[2010-04-17]
Performing structural comparisons between non-overlapping types, such as
integer >= string
Building and pattern matching on binaries without the relevant specifiers, such as
<<name>>
(this warns because by default it expects an integer, it should have been<<name::binary>>
instead)Attempting to rescue an undefined exception or a struct that is not an exception
Accessing a field that is not defined in a rescued exception
These new warnings help Elixir developers find bugs earlier and give more confidence when refactoring code, especially around maps and structs. While some of these warnings were emitted in the past, they were discovered using syntax analysis. The new warnings are more reliable, precise, and with better error messages. Keep in mind, however, that the Elixir typechecker only infers types from patterns within the same function at the moment. Analysis from guards and across function boundaries will be added in future relases. For more details, see our new reference document on gradual set-theoretic types.
The type system was made possible thanks to a partnership between CNRS and Remote. The development work is currently sponsored by Fresha, Starfish*, and Dashbit.
Erlang/OTP support
This release adds support for Erlang/OTP 27 and drops support for Erlang/OTP 24. We recommend Elixir developers to migrate to Erlang/OTP 26 or later, especially on Windows. Support for WERL (a graphical user interface for the Erlang terminal on Windows) will be removed in Elixir v1.18.
Adding
Duration
andshift/2
functionsElixir introduces the
Duration
data type and APIs to shift dates, times, and date times by a given duration, considering different calendars and time zones.Note the operation is called
shift
(instead ofadd
) since working with durations does not obey properties such as associativity. For instance, adding one month and then one month does not give the same result as adding two months:Still, durations are essential for building intervals, recurring events, and modelling scheduling complexities found in the world around us. For
DateTime
s, Elixir will correctly deal with time zone changes (such as Daylight Saving Time), but provisions are also available in case you want to surface conflicts (for example, you shifted to a wall clock that does not exist, because the clock has been moved forward by one hour). SeeDateTime.shift/2
for examples.Finally, a new
Kernel.to_timeout/1
function has been added, which helps developers normalize durations and integers to a timeout used by Process APIs. For example, to send a message after one hour, one can now write:v1.17.0 (2024-06-12)
1. Enhancements
Elixir
Access.find/1
that mirrorsEnum.find/2
Code.Fragment.container_cursor_to_quoted/2
Date.shift/2
to shift dates with duration and calendar-specific semanticsDate
to accept years outside of-9999..9999
rangeDateTime.shift/2
to shift datetimes with duration and calendar-specific semanticsDuration
data typec:GenServer.format_status/1
callbackKernel.get_in/1
with safe nil-handling for access and structsKernel.is_non_struct_map/1
guardKernel.to_timeout/1
Keyword.intersect/2-3
to mirror theMap
APIMacro.Env.define_alias/4
,Macro.Env.define_import/4
,Macro.Env.define_require/4
,Macro.Env.expand_alias/4
,Macro.Env.expand_import/5
, andMacro.Env.expand_require/6
to aid the implementation of language servers and embedded languagesNaiveDateTime.shift/2
to shift naive datetimes with duration and calendar-specific semanticsProcess.set_label/1
String.byte_slice/3
to slice a string to a maximum number of bytes while keeping it UTF-8 encodeduse_stdio: false
inSystem.cmd/3
andSystem.shell/2
Time.shift/2
to shift times with duration and calendar-specific semanticsExUnit
start_supervised
IEx
recompile
was called and the current working directory changedc/0
as an alias tocontinue/0
IEx.Pry.annotate_quoted/3
to annotate a quoted expression with pry breakpointsLogger
:gen_statem
reports using Elixir data structuresMix
:depth
option toMix.SCM.Git
, thus supporting shallow clones of Git dependencies:optional
is used in combination with:in_umbrella
--umbrella-only
tomix deps.tree
mix test --breakpoints
that sets up a breakpoint before each test that will runmix test --repeat-until-failure
to rerun tests until a failure occursmix test --slowest-modules
to print slowest modules based on all of the tests they hold2. Bug fixes
Elixir
(a -> b)
were not wrapped as part of the literal encoder..
and...
are handled at the AST levelquote bind_quoted: ...
twice:line
property when:file
is given as option toquote
Macro.escape/2
when passing a quote triplet without valid metaModule.get_attribute/3
for persisted attributes which have not yet been written toIEx
Mix
3. Soft deprecations (no warnings emitted)
Elixir
c:GenServer.format_status/2
callback to align with Erlang/OTP 25Mix
mix profile.tprof
mix profile.tprof
4. Hard deprecations
Elixir
:all
toIO.read/2
andIO.binread/2
is deprecated, pass:eof
instead~c
insteadleft..right
without explicit steps inside patterns and guards is deprecated, writeleft..right//step
instead10..1
without an explicit step is deprecated, write10..1//-1
insteadExUnit
register_test/4
is deprecated in favor ofregister_test/6
for performance reasonsv1.16.3
Compare Source
1. Bug fixes
Elixir
--dbg
flag in Elixir's CLIwhen
System.cmd/3
:undefined
fields are properly converted tonil
when invoking Erlang's APILogger
Mix
Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR was generated by Mend Renovate. View the repository job log.