idris-lang/Idris2
1
1
Fork 0
mirror of https://github.com/idris-lang/Idris2.git synced 2024-12-21 02:31:50 +03:00
Code Issues Projects Releases Wiki Activity
0b3e04aef0
Idris2/CHANGELOG.md

1075 lines
46 KiB
Markdown
Raw Blame History

# Changelog
## [Next version]
### Language changes
* New magic constants `__LOC__`, `__FILE__`, `__LINE__`, `__COL__`
substituted at parsing time with a string corresponding to the
location, filename, line or column number associated to the
magic constant's position.
* The termination checker is now a faithful implementation of the 2001 paper on
size-change termination by Lee, Jones and Ben-Amram.
* New function option `%unsafe` to mark definitions that are escape hatches
similar to the builtins `believe_me`, `assert_total`, etc.
* Elaborator scripts were made be able to record warnings.
* Rudimentary support for defining lazy functions (addressing issue
[#1066](https://github.com/idris-lang/idris2/issues/1066)).
* `%hide` directives can now hide conflicting fixities from other modules.
* Fixity declarations can now be kept private with export modifiers.
* New fromTTImp, fromName, and fromDecls names for custom TTImp, Name, and Decls
literals.
### REPL changes
* Adds documentation for unquotes `~( )`.
* Adds documentation for laziness and codata primitives: `Lazy`, `Inf`, `Delay`,
and `Force`.
### Backend changes
#### RefC
* Adds support for `CFLAGS`, `CPPFLAGS`, and `LDFLAGS` to facilitate building on
systems with non-standard installation locations of libraries (e.g. GMP).
Versions of the flags with the `IDRIS2_` prefix can also be used and take
precedence.
#### Chez
* Non-recursive top-level constants are compiled to eagerly evaluated
constants in Chez Scheme.
#### Node.js/Browser
* Generated JavaScript files now include a shebang when using the Node.js backend
* NodeJS now supports `popen`/`pclose` for the `Read` mode.
* `getChar` is now supported on Node.js and `putChar` is supported on both
JavaScript backends.
* Integer-indexed arrays are now supported.
### Compiler changes
* If `IAlternative` expression with `FirstSuccess` rule fails to typecheck,
compiler now prints all tried alternatives, not only the last one.
* The elaboration of records has been changed so that the unbound implicits in
the parameters' types become additional parameters e.g.
```idris2
record HasLength (xs : List a) (n : Nat) where
constructor MkHasLength
0 prf : length xs === n
```
is now correctly elaborated to
```idris2
record HasLength {0 a : Type} (xs : List a) (n : Nat) where
constructor MkHasLength
0 prf : length xs === n
```
instead of failing with a strange error about (a) vs (a .rec).
* Elaboration of datatypes now respects the totality annotations:
defining a `covering` or `partial` datatype in a `%default total`
file will not lead to a positivity error anymore.
* Fixed a bug in the positivity checker that meant `Lazy` could be used
to hide negative occurrences.
* Made sure that the positivity checker now respects `assert_total` annotations.
* We now raise a warning for conflicting fixity declarations. They are
dangerous as Idris will pick an arbitrary one and so the meaning of an
expression can depend e.g. on the order in which modules are imported.
* Additionally some conflicting fixity declarations in the Idris 2 compiler
and libraries have been removed.
* Constructors mentioned on the left hand side of functions/case alternatives
are now included in the `Refers to (runtime)` section of functions debug info.
* The Lifted IR Representation now has a `HasNamespaces` implementation
in `Compiler.Separate` so Compilation Units at that stage can be generated.
* Added the `compile.casetree.missing` log topic, along with its use in
`TTImp.ProcessDef.genRunTime`. This allows us to track when incomplete `case`
blocks get the runtime error added.
* Constant folding of trivial let statements and `believe_me`.
* Fixed a bug that caused holes to appear unexpectedly during quotation of
dependent pairs.
* Fixed a bug that caused `f` to sometimes be replaced by `fx` after matching `fx = f x`.
* Fixed a bug in the totality checker that missed indirect references to
partial data.
### Library changes
#### Prelude
* Improved performance of functions `isNL`, `isSpace`, and `isHexDigit`.
* Implements `Foldable` and `Traversable` for pairs, right-biased as `Functor`.
* Added a constructor (`MkInterpolation`) to `Interpolation`.
* Added an `Interpolation` implementation for `Void`.
* Added `Compose` instances for `Bifunctor`, `Bifoldable` and `Bitraversable`.
#### Base
* Deprecates `setByte` and `getByte` from `Data.Buffer` for removal in a future
release. Use `setBits8` and `getBits8` instead (with `cast` if you need to
convert a `Bits8` to an `Int`), as their values are limited, as opposed to the
assumption in `setByte` that the value is between 0 and 255.
* Adds RefC support for 16- and 32-bit access in `Data.Buffer`.
* Add `Show` instance to `Data.Vect.Quantifiers.All` and add a few helpers for listy
computations on the `All` type.
* Add an alias for `HVect` to `All id` in `Data.Vect.Quantifiers.All`. This is the
approach to getting a heterogeneous `Vect` of elements that is general
preferred by the community vs. a standalone type as seen in `contrib`.
* Add `Data.List.HasLength` from the compiler codebase slash contrib library but
adopt the type signature from the compiler codebase and some of the naming
from the contrib library. The type ended up being `HasLength n xs` rather than
`HasLength xs n`.
* `System`'s `die` now prints the error message on stderr rather than stdout
* Moved `Data.SortedMap` and `Data.SortedSet` from contrib to base.
* Added missing buffer primitives (chezscheme only):
`setInt8`, `getInt8`, `getInt16`, `setInt64`, `getInt64`
* Added new buffer (set/get) functions for built-in types `Bool`, `Nat`, `Integer`.
* Tightened the types of:
`setInt16` (now takes an `Int16` instead of an `Int`),
`setInt32` (now takes an `Int32` instead of an `Int`),
`getInt32` (now returns an `Int32` instead of an `Int`)
* Adds left- and right-rotation for `FiniteBits`.
* Adds `Vect.permute` for applying permutations to `Vect`s.
* Adds `Vect.kSplits` and `Vect.nSplits` for splitting a `Vect` whose length is
a known multiple of two `Nat`s (k * n) into k vectors of length n (and
vice-versa).
* Adds `Vect.allFins` for generating all the `Fin` elements as a `Vect` with
matching length to the number of elements.
* Add `withRawMode`, `enableRawMode`, `resetRawMode` for character at a time
input on stdin.
* Adds extraction functions to `Data.Singleton`.
* `TTImp` reflection functions are now `public export`, enabling use at the
type-level.
* Implemented `Eq`, `Ord`, `Semigroup`, and `Monoid` for `Data.List.Quantifiers.All.All`
and `Data.Vect.Quantifiers.All.All`.
* Generalized `imapProperty` in `Data.List.Quantifiers.All.All`
and `Data.Vect.Quantifiers.All.All`.
* Add `zipPropertyWith` to `Data.Vect.Quantifiers.All.All`.
* Implemented `Ord` for `Language.Reflection.TT.Name`, `Language.Reflection.TT.Namespace`
and `Language.Reflection.TT.UserName`.
* Adds `leftmost` and `rightmost` to `Control.Order`, a generalisation of `min` and `max`.
* Adds `even` and `odd` to `Data.Integral`.
* `Eq` and `Ord` implementations for `Fin n` now run in constant time.
* Adds `getTermCols` and `getTermLines` to the base library. They return the
size of the terminal if either stdin or stdout is a tty.
#### System
* Changes `getNProcessors` to return the number of online processors rather than
the number of configured processors.
* Adds `popen2` to run a subprocess with bi-directional pipes.
### Contrib
* Adds `Data.List.Sufficient`, a small library defining a structurally inductive
view of lists.
* Remove `Data.List.HasLength` from `contrib` library but add it to the `base`
library with the type signature from the compiler codebase and some of the
naming from the `contrib` library. The type ended up being `HasLength n xs`
rather than `HasLength xs n`.
* Adds an implementation for `Functor Text.Lexer.Tokenizer.Tokenizer`.
* Adds `modFin` and `strengthenMod` to `Data.Fin.Extra`. These functions reason
about the modulo operator's upper bound, which can be useful when working with
indices (for example).
#### Papers
* In `Control.DivideAndConquer`: a port of the paper
"A Type-Based Approach to Divide-And-Conquer Recursion in Coq"
by Pedro Abreu, Benjamin Delaware, Alex Hubers, Christa Jenkins,
J. Garret Morris, and Aaron Stump.
[https://doi.org/10.1145/3571196](https://doi.org/10.1145/3571196)
* Ports the first half of "Deferring the Details and Deriving Programs" by Liam
O'Connor as `Data.ProofDelay`.
[https://doi.org/10.1145/3331554.3342605](https://doi.org/10.1145/3331554.3342605)
[http://liamoc.net/images/deferring.pdf](http://liamoc.net/images/deferring.pdf)
### Other Changes
* The `data` subfolder of an installed or local dependency package is now automatically
recognized as a "data" directory by Idris 2. See the
[documentation on Packages](https://idris2.readthedocs.io/en/latest/reference/packages.html)
for details.
* The compiler no longer installs its own C support library into
`${PREFIX}/lib`. This folder's contents were always duplicates of files
installed into `${PREFIX}/idris2-${IDRIS2_VERSION}/lib`. If you need to adjust
any tooling or scripts, point them to the latter location which still contains
these installed library files.
* Renamed `support-clean` Makefile target to `clean-support`. This is in line
with most of the `install-<something>` and `clean-<something>` naming.
* Fixes an error in the `Makefile` where setting `IDRIS2_PREFIX` caused
bootstrapping to fail.
* Updates the docs for `envvars` to match the changes introduced in #2649.
## v0.6.0
### REPL changes
* New experimental Scheme based evaluator (only available if compiled via
Chez scheme or Racket). To access this at the REPL, set the evaluator mode to
the scheme based evaluator with `:set eval scheme`.
* New option `evaltiming` to time how long an evaluation takes at the REPL,
set with `:set evaltiming`.
* Renames `:lp/loadpackage` to `:package`.
* Adds `:import`, with the same functionality as `:module`.
* Adds the ability to request detailed help via `:help <replCmd>`, e.g.
`:help :help` or `:help :let`. This also works with the `:?` and `:h` aliases.
### Language changes
* There were two versions of record syntax used when updating records:
```idris
record { field = value } r
```
and
```idris
{ field := value } r
```
The former is now deprecated in favour of the latter syntax.
The compiler will issue a warning when using the `record` keyword.
* Interpolated strings now make use of `concat` which is compiled into
`fastConcat`.
The interpolated slices now make use of the `Interpolation` interface
available in the prelude. It has only one method `interpolate` which is called
for every expression that appears within an interpolation slice.
```idris
"hello \{world}"
```
is desugared into
```idris
concat [interpolate "hello ", interpolate world]
```
This allows you to write expressions within slices without having to call
`show` but for this you need to implement the `Interpolation` interface for
each type that you intend to use within an interpolation slice. The reason for
not reusing `Show` is that `Interpolation` and `Show` have conflicting
semantics, typically this is the case for `String` which adds double quotes
around the string.
* Adds a `failing` block that requires its body to fail with a compile error.
Optionally this block may contain a string which is checked to be contained in
the error message.
* Bodies of `mutual`, `failing`, `using` and `parameters` blocks are required to
be indented comparing to the position of the keyword.
* `%nomangle` has been deprecated in favour of `%export`.
* Records now support DataOpts, i.e. we can write things like
```idris
record Wrap (phantom : Type) (a : Type) where
[search a] -- this was previously not supported
constructor MkWrap
unWrap : a
```
* Adds ability to forward-declare interface implementations, e.g.:
```idris
implementation IsOdd Nat -- forward declare for use in `IsEven`
implementation IsEven Nat where
isEven 0 = True
isEven (S k) = not $ isOdd k
implementation IsOdd Nat where
isOdd 0 = False
isOdd (S k) = not $ isEven k
```
* Adds ability to forward-declare records, e.g.:
```idris
record B
record A where
b : B
record B where
a : A
```
### Compiler changes
* Removes deprecated support for `void` primitive. Now `void` is supported via
`prim__void`.
* Adds `%deprecate` pragma that can be used to warn when deprecated functions
are used.
* Package files now support a `langversion` field that can be used to specify
what versions of Idris a package supports. As with dependency versions, `>`,
`<`, `>=`, and `<=` can all be used.
+ For example, `langversion >= 0.5.1`.
* Alternatives for primitive types of the `Core.TT.Constant` are moved out to a
separate data type `PrimTypes`. Signatures of functions that were working with
`Constant` are changed to use `PrimTypes` when appropriate.
* Codegens now take an additional `Ref Syn SyntaxInfo` argument. This empowers
compiler writers to pretty print core terms e.g. to add comments with the
original type annotations in the generated code.
* `Refc.showcCleanStringChar` forgot some symbols which have now been added,
ensuring the string is properly cleaned.
* Constant-folds all casts and integral expressions (with the exception of type
`Int`), leading to improved performance.
* Increases accuracy of error reporting for keywords.
* Adds the `eval.stuck.outofscope` log topic in order to be able to spot when we
get stuck due to a function being out of scope.
* Improves the error reporting for syntactically incorrect records.
* `IPragma` now carries an `FC` with it for better error reporting.
* Adds the number of enum constructors to enum types during codegen, to allow
for trivial conversion to, e.g., `Bits32`.
* Adds constant-folding for `Nat` literals.
* Fixes `CyclicMeta` in `TTImp.ProcessDef` being considered a recoverable error.
### IDE protocol changes
* The IDE protocol and its serialisation to S-Expressions are factored
into a separate module hierarchy Protocol.{Hex, SExp, IDE}.
* File context ranges sent in the IDE protocol follow the same
convention as Bounds values in the parser:
+ all offsets (line and column) are 0-based.
+ Lines: start and end are within the bounds
+ Column:
+ start column is within the bounds;
+ end column is after the bounds.
This changes behaviour from previous versions of the protocol.
Matching PRs in the emacs modes:
+ idris2-mode [PR#11](https://github.com/idris-community/idris2-mode/pull/11)
+ idris-mode [PR#547](https://github.com/idris-hackers/idris-mode/pull/547)
* The IDE protocol now supports specifying a socket and hostname via the
`--ide-mode-socket` flag, allowing multiple IDE server instances to run on
the same machine.
### Interactive Editing changes
* Case-split no longer generates syntactically invalid Idris when splitting on
auto-implicits.
* Case-split no longer shadows the function name when an internal named argument
has the same name as the function.
* Case-split now avoids using upper-case names for pattern variables.
### Library changes
#### Prelude
* `elemBy` and `elem` are now defined for any `Foldable` structure. The
specialised versions defined in `Data.(List/SnocList/Vect)` have been removed.
* `filter` and `mapMaybe` functions for `List` were moved to `prelude` from
`base`.
* Basic functions of `SnocList` (`(++)`, `length`, `filter`, `mapMaybe`) and
implementations of `Eq` and `Ord` were moved to `prelude` from `base`.
This may lead to a need to qualifying functions (e.g. `List.filter`) due to
possible ambiguity.
* "Fish" and "chips" operators of `SnocList` were moved to `Prelude.Types` from
`Prelude.Basics`.
* Adds `contra` for returning the opposite of a given `Ordering`.
* Fix `pow`, using backend implementations.
* Add `subtract` alias for `(-)`
#### Base
* Adds `System.run`, which runs a shell command, and returns the stdout and
return code of that run.
* Adds escaped versions of `System.system`, `Systen.File.popen`, and
`System.run`, which take a list of arguments, and escapes them.
* Adds the `Injective` interface in module `Control.Function`.
* Changes `System.pclose` to return the return code of the closed process.
* Deprecates `base`'s `Data.Nat.Order.decideLTE` in favor of `Data.Nat.isLTE`.
* Removes `base`'s deprecated `System.Directory.dirEntry`. Use `nextDirEntry`
instead.
* Removes `base`'s deprecated `Data.String.fastAppend`. Use `fastConcat`
instead.
* `System.File.Buffer.writeBufferData` now returns the number of bytes that have
been written when there is a write error.
* `System.File.Buffer.readBufferData` now returns the number of bytes that have
been read into the buffer.
* Adds the `Data.List.Quantifiers.Interleaving` and
`Data.List.Quantifiers.Split` datatypes, used for provably splitting a list
into a list of proofs and a list of counter-proofs for a given property.
* Properties of the `List1` type were moved from `Data.List1` to
`Data.List1.Properties`.
* `Syntax.PreorderReasoning` was moved to `base` from `contrib`.
* Move the types and functions in `Data.Vect.Quantifiers` to their respective
namespaces (`All` for all-related things, and `Any` for any-related things) to
make the code consistent with the other quantifiers (`List` and `SnocList`).
* Set the `all` and `any` functions for proof-quantifiers to `public export`
instead of `export`, allowing them to be used with auto-implicit `IsYes`.
* Legacy duplicating type `Given` (with constructor `Always`) is removed from
the `Decidable.Decidable`. Use the type `IsYes` (with constructor `ItIsYes`)
from the same module instead.
* Adds `Data.List1.Elem`, ported from `Data.List.Elem`.
* Adds `Data.List1.Quantifiers`, ported from `Data.List.Quantifiers`.
* Changes the order of arguments in `RWST` transformer's runners functions
(`runRWST`. `evalRWST`, `execRWST`), now transformer argument is the last, as
in the other standard transformers, like `ReaderT` and `StateT`.
* Adds `Data.Fin.finToNatEqualityAsPointwise`,
which takes a witness of `finToNat k = finToNat l` and proves `k ~~~ l`.
* Drop first argument (path to the `node` executable) from `System.getArgs` on
the Node.js backend to make it consistent with other backends.
* Adds `Uninhabited` instances for `FZ ~~~ FS k` and `FS k ~~~ FZ`.
* Change behavior of `channelPut` on the Racket backend to match the behavior
on the Chez backend.
* `fGetLine` has been marked as `covering` instead of `total`.
* Adds the ability to derive `Functor` and `Traversable` using `%runElab derive`
in the implementation definition.
* Fixes memory leaks in `currentDir`, `fGetLine`, and `fGetChars`.
* Fixes `natToFinLT` being O(n) by proving that `So (x < n)` implies `LT x n`,
allowing the compiler to optimise `natToFinLT` away.
* Fixes `SnocList.foldr` and `SnocList.foldMap` to be performant and stack-safe.
* Add `insertAt`, `deleteAt` and `replaceAt` for `List`
* Add `scanr`, `scanr1` and `unsnoc` for `Vect`
* Implement `DecEq` for `SnocList`
#### Test
* Refactors `Test.Golden.runTest` to use `System.Concurrency` from the base
libraries instead of `System.Future` from `contrib`. In addition to reducing
the dependency on `contrib` in the core of Idris2, this also seems to provide
a small performance improvement for `make test`.
* Splits `runner` into `runnerWith` for processing the options and configuring
the test pools, and a new `runner` function for reading options from the
command-line.
#### Contrib
* `System.Random` support for `Int` changed to `Int32`; it already limited
itself to 32 bits but now that is codified. JavaScript backends are now
supported.
* Removes `contrib`'s deprecated `Data.Num.Implementations` module. See
`Prelude.Interfaces` instead.
* Implements `Show tok => Show (ParsingError tok)` for `Text.Parser.Core`.
* `Control.Linear.LIO` has been moved from `contribs` to `linear` to guarantee
that idris2 does not need to rely on contribs anymore.
#### Network
* `Control.Linear.Network` now supports `connect` in the linear environment, and
can also access the `sendBytes`, `recvBytes` and `recvAllBytes` functions of
the underlying `Socket` module.
#### Papers, Linear
* Creates the `papers` and `linear` libraries to remove bits of type theory and
pl propaganda from `contrib` and instead clearly have them as implementations
of their respective papers.
* Creates `Data.Linear.{Notation,LEither,LMaybe,LVect,Pow}`.
* Moves `Data.Container`, based on the papers "Categories of Containers" by
Michael Abbott, Thorsten Altenkirch, and Neil Ghani, and "Derivatives of
Containers" by Michael Abbott, Thorsten Altenkirch, Neil Ghani, and Conor
McBride, to `papers`.
[https://doi.org/10.1007/3-540-36576-1_2](https://doi.org/10.1007/3-540-36576-1_2)
[https://doi.org/10.1007/3-540-44904-3_2](https://doi.org/10.1007/3-540-44904-3_2)
* Moves the implementation of "Indexed induction-recursion" by Dybjer and Setzer
to `papers`.
[https://doi.org/10.1016/j.jlap.2005.07.001](https://doi.org/10.1016/j.jlap.2005.07.001)
* Ports "How to Take the Inverse of a Type" by Daniel Marshall and Dominic
Orchard as `Data.Linear.{Communications,Diff,Inverse}`.
[https://doi.org/10.4230/LIPIcs.ECOOP.2022.5](https://doi.org/10.4230/LIPIcs.ECOOP.2022.5)
* Moves `Data.OpenUnion`, inspired by the paper "Freer monads, more extensible
effects" by Oleg Kiselyov and Hiromi Ishii, to `papers`.
[https://doi.org/10.1145/2887747.2804319](https://doi.org/10.1145/2887747.2804319)
* Moves `Data.Recursion.Free`, partially based on "Turing-Completeness Totally
Free" by Conor McBride, to `papers`.
[https://doi.org/10.1007/978-3-319-19797-5_13](https://doi.org/10.1007/978-3-319-19797-5_13)
* Moves `Data.Tree.Perfect` to `papers`.
* Moves `Data.Vect.Binary`, taken from the paper "Heterogeneous Binary
Random-access Lists" by Wouter Swierstra, to `papers`.
[https://doi.org/10.1017/S0956796820000064](https://doi.org/10.1017/S0956796820000064)
* Ports "Applications of Applicative Proof Search" by Liam O'Connor as
`Search.{Generator,HDecidable,Negation,Properties,CTL,GCL}`.
[https://doi.org/10.1145/2976022.2976030](https://doi.org/10.1145/2976022.2976030)
* Implements "Dependent Tagless Final" by Nicolas Biri as `Language.Tagless`.
[https://doi.org/10.1145/3498886.3502201](https://doi.org/10.1145/3498886.3502201)
* Ports Todd Waugh Ambridge's Agda blog post series "Search over uniformly
continuous decidable predicates on infinite collections of types" as
`Search.Tychonoff`.
[https://www.cs.bham.ac.uk/~txw467/tychonoff/InfiniteSearch1.html](https://www.cs.bham.ac.uk/~txw467/tychonoff/InfiniteSearch1.html)
* Ports "Auto in Agda - Programming proof search using reflection" by Wen Kokke
and Wouter Swierstra as `Search.Auto`.
[https://doi.org/10.1007/978-3-319-19797-5_14](https://doi.org/10.1007/978-3-319-19797-5_14)
* Ports "Computing with Generic Trees in Agda" by Stephen Dolan as `Data.W`.
[https://doi.org/10.1145/3546196.3550165](https://doi.org/10.1145/3546196.3550165)
### Other changes
* Adds docstrings for the lambda-lifted IR.
* Package files are now installed along-side build artifacts for installed
packages. This means all transitive dependencies of packages you specify with
the `depends` field are added automatically.
* No longer builds `contrib` and `papers` during bootstrap, as these may rely on
new features not yet present in the bootstrap version of Idris2.
## v0.5.0/0.5.1
### Language changes
* Missing methods in implementations now give a compile time error. This was
always the intended behaviour, but until now had not been implemented!
* Records now work in `parameters` blocks and `where` clauses.
* Implementations of interfaces now work in `parameters` blocks and
`where` clauses
* The syntax for Name reflection has changed, and now requires a single brace
instead of a double brace, e.g. `` `{x} ``
* Raw string literals allows writing string while customising the escape
sequence. Start a string with `#"` in order to change the escape characters
to `\#`, close the string with `"#`. Remains compatible with multiline
string literals.
* Interpolated strings allows inserting expressions within string literals
and avoid writing concatenation explicitly. Escape a left curly brace `\{`
to start an interpolation slice and close it with a right curly brace `}` to
resume writing the string literal. The enclosed expression must be of type
`String`. Interpolated strings are compatible with raw strings (the slices
need to be escaped with `\#{` instead) and multiline strings.
* We now support ellipses (written `_`) on the left hand side of a `with`
clause. Ellipses are substituted for by the left hand side of the parent
clause i.e.
```idris
filter : (p : a -> Bool) -> List a -> List a
filter p [] = []
filter p (x :: xs) with (p x)
_ | True = x :: filter p xs
_ | False = filter p xs
```
means
```idris
filter : (p : a -> Bool) -> List a -> List a
filter p [] = []
filter p (x :: xs) with (p x)
filter p (x :: xs) | True = x :: filter p xs
filter p (x :: xs) | False = filter p xs
```
### Compiler changes
* Added incremental compilation, using either the `--inc` flag or the
`IDRIS2_INC_CGS` environment variable, which compiles modules incrementally.
In incremental mode, the final build step is much faster than in whole
program mode (the default), at the cost of runtime performance being about
half as good. The `--whole-program` flag overrides incremental compilation,
and reverts to whole program compilation. Incremental compilation is currently
supported only by the Chez Scheme back end.
This is currently supported only on Unix-like platforms (not yet Windows)
- Note that you must set `IDRIS2_INC_CGS` when building and installing
all libraries you plan to link with an incremental build.
- Note also that this is experimental and not yet well tested!
* The type checker now tries a lot harder to avoid reducing expressions where
it is not needed. This can give a huge performance improvement in programs
that potentially do a lot of compile time evaluation. However, sometimes
reducing expressions can help in totality and quantity checking, so this may
cause some programs not to type check which previously did - in these cases,
you will need to give the reduced expressions explicitly.
### REPL/CLI/IDE mode changes
* Added `--list-packages` CLI option.
* Added `--total` CLI option.
### Library changes
#### Prelude
Changed
- Removed `Data.Strings`. Use `Data.String` instead.
#### System.Concurrency
* Reimplement the `Channels` primitive in the Chez-Scheme backend since it had
some non-deterministic properties (see issue
[#1552](https://github.com/idris-lang/idris2/issues/1552)).
NOTE: Due to complications with race-conditions, Chez not having channels
built-in, etc, the reimplementation changes the semantics slightly:
`channelPut` no longer blocks until the value has been received under the
`chez` backend, but instead only blocks if there is already a value in the
channel that has not been received.
With thanks to Alain Zscheile (@zseri) for help with understanding condition
variables, and figuring out where the problems were and how to solve them.
#### Control.Relation, Control.Order
* The old system of interfaces for defining order relations (to say,
for instance, that LTE is a partial order) is replaced with a new
system of interfaces. These interfaces defines properties of binary
relations (functions of type `ty -> ty -> Type`), and orders are
defined simply as bundles of these properties.
### Installation changes
* Added a new makefile target to install Idris 2 library documentation. After `make install`, type
`make install-libdocs` to install it. After that, the index file can be found here: ``idris2
--libdir`/docs/index.html`.``
## v0.4.0
### Syntax changes
* Desugar non-binding sequencing in do blocks to (`>>`)
([#1095](https://github.com/idris-lang/idris2/pull/1095))
* Multiline Strings with `"""` as delimiters
([#1097](https://github.com/idris-lang/idris2/pull/1097))
* Force strict indentation after usage of `with` keyword
([#1107](https://github.com/idris-lang/idris2/pull/1107))
* The syntax for parameter blocks has been updated. It now allows to declare
implicit parameters and give multiplicities for parameters. The old syntax is
still available for compatibility purposes but will be removed in the future.
* Add support for SnocList syntax: `[< 1, 2, 3]` desugars into `Lin :< 1 :< 2 :<
3` and their semantic highlighting.
* Underscores can be used as visual separators for digit grouping purposes in
integer literals: `10_000_000` is equivalent to `10000000` and
`0b1111_0101_0000` is equivalent to `0b111101010000`. This can aid readability
of long literals, or literals whose value should clearly separate into parts,
such as bytes or words in hexadecimal notation.
### Compiler changes
* Added more optimisations and transformations, particularly on case blocks,
list-shaped types, and enumerations, so generated code will often be slightly
faster.
* Added `--profile` flag, which generates profile data if supported by a back
end. Currently supported by the Chez and Racket backends.
* New `%builtin` pragma for compiling user defined natural numbers to primitive
`Integer`s (see the
[docs](https://idris2.readthedocs.io/en/latest/reference/builtins.html))
* The `version` field in `.ipkg` files is now used. Packages are installed into
a directory which includes its version number, and dependencies can have
version number ranges using `<=`, `<`, `>=`, `>`, `==` to express version
constraints. Version numbers must be in the form of integers, separated by
dots (e.g. `1.0`, `0.3.0`, `3.1.4.1.5` etc)
* Idris now looks in the current working directory, under a subdirectory
`depends` for local installations of packages before looking globally.
* Added an environment variable `IDRIS2_PACKAGE_PATH` for extending where to
look for packages.
* Added compiler warnings flags (`-W` prefix):
- `-Wno-shadowing`: disable shadowing warnings.
- `-Werror`: treat warnings as errors.
* Experimental flag (`-Xcheck-hashes`) to check hashes instead of filesystem
times to determine if files should be recompiled. Should help with CI/CD
caching.
### REPL/IDE mode changes
* Added `:search` command, which searches for functions by type
* `:load`/`:l` and `:cd` commands now only accept paths surrounded by double
quotes
* Added a timeout to "generate definition" and "proof search" commands,
defaulting to 1 second (1000 milliseconds) and configurable with
`%search_timeout <time in milliseconds>`
### Library Changes
#### Prelude
Added
- `Bifoldable` and `Bitraversable` interfaces.
- `Foldable` add `foldlM`, `foldMap`, and `toList`.
- `Monad` interface `>=>`, `<=<` (Kleisli Arrows), and flipped bind (`=<<`).
- `Pair` Applicative and Monad implementations.
- `SnocList` datatype (fliped cons of a linked list).
- `(.:)` function "blackbird operator" (Composition of a two-argument function
with a single-argument one.)
- `on` function (Eg, ```((+) `on` f) x y = f x + f y```)
Changed
- `===`, `~=~`, and `<+>` operator precedence
- Exctracted `Cast` interface and implementations from `Prelude.Types` to
`Prelude.Cast`
- Renamed `Data.Strings` to `Data.String`
Hidden
- `countFrom`
#### Base
Added
- `Control.Applicative.Const`.
- New `Control.Monad` Monad Transformers types.
- `Data.Bits`, an interface for bitwise operations.
- `Data.Colist` and `Data.Colist1`.
- `Data.Contravariant` interface for contravariant functors.
- `Data.List` `unzip` function.
- `Data.List1` `zip*` and `unzip*` functions.
- `Data.SnocList`.
- `Data.Stream` `unzipWith` and `unzipWith3` fuctions.
- `Data.Vect` `unzipWith` and `unzipWith3` functions.
- `System.File` `withFile` and total read functions.
Changed:
- Restructured Monad Transformers in `Control.Monad`
- `zip` precedence
#### Contrib
Added
- `Control.Validation`, a library for dependent types input validation.
- `System.Console.GetOpt`, a library for specifying and parsing command line
options.
#### New test package
- Moved `tests/Lib.idr` to package as `Test/Golden.idr`.
- Removed `contrib/Test/Golden.idr` which duplicated the test framework now in
the `test` package.
### Codegen changes
#### Racket
* Now always uses `blodwen-sleep` instead of `idris2_sleep` in order to not
block the Racket runtime when `sleep` is called.
* Redid condition variables in the Racket codegen based on page 5 of the
Microsoft [Implementing CVs paper](https://www.microsoft.com/en-us/research/wp-content/uploads/2004/12/ImplementingCVs.pdf).
Previously, they were based on an implementation using semaphores and
asynchronous channels, which worked apart from `broadcast`. The rework fixes
`broadcast` at the cost of losing `wait-timeout` due to increased complexity
of their internals and interactions between their associated functions.
#### JavaScript
* Now use `Number` to represent up to 32 bit precision signed and unsigned
integers. `Int32` still goes via `BigInt` for multiplication to avoid
precision issues when getting results larger than `Number.MAX_SAFE_INTEGER`.
`Bits32` goes via `BigInt` for multiplication for the same reason as well as
for all bitops, since `Number` uses signed 32 bit integers for those.
* Now use `Number` instead of `BigInt` to represent up to 32 bit fixed precision
signed and unsigned integers. This should make interop with the FFI more
straight forward, and might also improve performance.
#### New chez-sep
* This code generator produces many Chez Scheme files and compiles them
separately instead of producing one huge Scheme program. This significantly
reduces the amount of memory needed to build large programs. Since this
backend will skip calling the Chez compiler on modules that haven't changed,
it also leads to shorter compilation times in large codebases where only some
files have changed -- for example when developing Idris2 code generators. The
codegen has a large parallelisation potential but at the moment, it is
significantly slower for a full rebuild of a large codebase (the code
generation stage takes about 3x longer).
### API changes
* The API now exposes `Compiler.Separate.getCompilationUnits`, which
can be used for separate code generation by any backend.
* New fixed precision signed integer types `Int8`, `Int16`, `Int32`,
and `Int64` where added. In addition, all integral types now properly support
all arithmetic and bitwise operations.
* The compiler now provides primitive cast operations for all combinations
of primitives with the exception of going from `Double` to `Char` and
back, and going from `String` to `Char`.
* A new pragma `%doubleLit` to support overloaded floating point literals
was added.
### Other changes
* Lots of small performance improvements, some of which may be especially
noticeable in programs that do a lot of type level evaluation.
* Added HTML documentation generation, using the `--mkdoc` flag
* Support for auto-completion in bash-like shells was added.
* Fixed case-splitting to respect any indentation there may be in the term being
case-split and the surrounding symbols, instead of filtering out the
whitespace and putting it back as indentation.
## v0.3.0
Library changes:
* Overhaul of the concurrency primitives:
- Renamed `System.Concurrency.Raw` to `System.Concurrency`.
- Modified the implementation of `Prelude.IO.fork` in the Chez Scheme RTS, which
now returns a semaphore instead of a thread object. This allows the main
thread to wait for the child thread to finish (see next bullet). The Racket
implementation already returned a thread descriptor, which could be used to
wait for the thread to finish.
- Added `Prelude.IO.threadWait` which waits for a thread, identified by a
`ThreadID`, to finish. This operation is supported by both the Chez Scheme and
the Racket RTS'es.
- Added semaphores to `System.Concurrency`, supported by both the Chez Scheme
and Racket RTS'es.
- Added barriers to `System.Concurrency`, supported by both the Chez Scheme
and Racket RTS'es.
- Added synchronous channels to `System.Concurrency`, supported by both the Chez
Scheme and Racket RTS'es.
- Fixed the support for mutexes in the Racket RTS. Formerly, they were
implemented with semaphores, and calling`mutexRelease` multiple times would
increment the internal counter multiple times, allowing multiple concurrent
`mutexAcquire` operations to succeed simultaneously. Currently, `mutexRelease`
fails when called on a mutex which isn't owned. (However, `mutexRelease` does
not check whether the mutex is in fact owned by the current thread, which may
be a bug.)
- Modified the support for condition variables in the Racket RTS. Formerly,
they were implemented using synchronous channels, meaning that:
+ `conditionSignal` was a blocking operation; and
+ calling `conditionSignal` on a condition variable on which no thread
was waiting would wake the next thread to call `conditionWait`,
whereas condition variables are supposed to be stateless, and only
wake threads already in the queue.
The implementation was replaced with an implementation based on asynchronous
channels and mutexes, based on the following paper:
[Implementing Condition Variables with Semaphores](https://www.microsoft.com/en-us/research/wp-content/uploads/2004/12/ImplementingCVs.pdf) by Andrew Birrell
- Removed `threadID` and `blodwen-thisthread`. Formerly, in the Chez Scheme
backend, this function returned "the thread ID of the current thread" as a
value of type `ThreadID`. However, `fork` returned a "thread object" as a
value of type `ThreadID`. These are *different kinds of values* in Chez
Scheme. As there was nothing one could do with a value of type `ThreadID`, I
chose to remove `threadID`, as it allowed me to implement `threadWait` more
easily.
- Renamed `blodwen-lock` and `blodwen-unlock` to `blodwen-mutex-acquire` and
`blodwen-mutex-release` for consistency, as these functions are referred to
with acquire and release both in Chez Scheme and in the Idris2 concurrency
module.
* Added `Data.HVect` in `contrib`, for heterogeneous vectors.
* Various other library functions added throughout `base` and `contrib`
Command-line options changes:
* Added `--color` and `--no-color` options for colored terminal output.
Color is enabled by default.
* Added `--console-width <auto|n>` option for printing margins. By default the
`auto` option is selected, the result is that the compiler detects the current
terminal width and sets it as the option value, otherwise a user value can be
provided. An explicit `0` has the effect of simulating a terminal with
unbounded width.
Language and compiler changes:
* Removed multiplicity subtyping, as this is unsound and unfortunately causes
more problems than it solves. This means you sometimes now need to write
linear versions of functions as special cases. (Though note that the 1
multiplicity is still considered experimental, so hopefully this will change
for the better in the future!)
* Added new syntax for named applications of explicit arguments:
`f {x [= t], x [= t], ...}`
`f {x [= t], x [= t], ..., _}`
* Added syntax for binding all explicit arguments (in the left hand side);
`f {}`
* Added new syntax for record updates (without the need for the `record`
keyword):
`{x := t, x $= t, ...}`
* Local implementations of interfaces (in `let` or `where` blocks) now work,
along with `%hint` annotations on local definitions, meaning that local
definitions can be searched in auto implicit search.
+ Note, though, that there are still some known limitations (with both local
hints and local implementations) which will be resolved in the next version.
* New experimental ``refc`` code generator, which generates C with reference
counting.
* Added primitives to the parsing library used in the compiler to get more precise
boundaries to the AST nodes `FC`.
REPL/IDE mode changes:
* Added `:color (on|off)` option for colored terminal output.
* Added `:consolewidth (auto|n)` option for printing margins. Mirrors the
command-line option.
## v0.2.1
Language changes:
* `Bits8`, `Bits16`, `Bits32` and `Bits64` primitive types added, with:
+ `Num`, `Eq`, `Ord` and `Show` implementations.
+ Casts from `Integer`, for literals
+ Casts to `Int` (except for `Bits64` which might not fit),
`Integer` and `String`
+ Passed to C FFI as `unsigned`
+ Primitives added in `Data.Buffer`
* Elaborator reflection and quoting terms
+ Requires extension `%language ElabReflection`
+ API defined in `Language.Reflection`, including functions for getting
types of global names, constructors of data types, and adding new top
level declarations
+ Implemented `%macro` function flag, to remove the syntactic noise of
invoking elaborator scripts. This means the function must always
be fully applied, and is run under `%runElab`
* Add `import X as Y`
+ This imports the module `X`, adding aliases for the definitions in
namespace `Y`, so they can be referred to as `Y`.
* `do` notation can now be qualified with a namespace
+ `MyDo.do` opens a `do` block where the `>>=` operator used is `MyDo.(>>=)`
Library changes:
* `IO` operations in the `prelude` and `base` libraries now use the
`HasIO` interface, rather than using `IO` directly.
* Experimental `Data.Linear.Array` added to `contrib`, supporting mutable
linear arrays with constant time read/write, convertible to immutable arrays
with constant time read.
+ Anything in `Data.Linear` in `contrib`, just like the rest of `contrib`,
should be considered experimental with the API able to change at any time!
Further experiments in `Data.Linear` are welcome :).
* Experimental `Control.Linear.LIO` added to `contrib`, supporting computations
which track the multiplicities of their return values, which allows linear
resources to be tracked.
* Added `Control.Monad.ST`, for update in-place via `STRef` (which is like
`IORef`, but can escape from `IO`). Also added `Data.Ref` which provides an
interface to both `IORef` and `STRef`.
* Added `Control.ANSI` in `contrib`, for usage of ANSI escape codes for text
styling and cursor/screen control in terminals.
Command-line options changes:
* Removed `--ide-mode-socket-with` option. `--ide-mode-socket` now accepts an
optional `host:port` argument.
* Added options to override source directory, build directory and output
directory: `--source-dir`, `--build-dir`, `--output-dir`.
+ These options are also available as fields in the package description:
`sourcedir`, `builddir`, `outputdir`.
Compiler changes:
* It is now possible to create new backends with minimal overhead.
`Idris.Driver` exposes the function `mainWithCodegens` that takes
a list of codegens. The feature in documented [here](https://idris2.readthedocs.io/en/latest/backends/custom.html).
* New code generators `node` and `javascript`.
REPL/IDE mode changes:
* Implemented `:module` command, to load a module during a REPL session.
* Implemented `:doc`, which displays documentation for a name.
* Implemented `:browse`, which lists the names exported by a namespace.
* Added `:psnext`, which continues the previous proof search, looking for the
next type correct expression
+ Correspondingly, added the IDE mode command `proof-search-next` (which takes
no arguments)
* Added `:gdnext`, which continues the previous program search, looking for the
next type correct implementation
+ Correspondingly, added the IDE mode command `generate-def-next` (which takes
no arguments)
* Improved program search to allow deconstructing intermediate values, and in
simple cases, the result of recursive calls.
## v0.2.0
The implementation is now self-hosted. To initialise the build, either use
the [bootstrapping version of Idris2](https://github.com/edwinb/Idris2-boot)
or build from the generated Scheme, using `make bootstrap`.
Language changes:
* `total`, `covering` and `partial` flags on functions now have an effect.
* `%default <totality status>` has been implemented. By default, functions must
be at least `covering`
+ That is, `%default covering` is the default status.
* Fields of records can be accessed (and updated) using the dot syntax,
such as `r.field1.field2` or `record { field1.field2 = 42 }`.
For details, see [the "records" entry in the user manual](https://idris2.readthedocs.io/en/latest/reference/records.html)
* New function flag `%tcinline` which means that the function should be
inlined for the purposes of totality checking (but otherwise not inlined).
This can be used as a hint for totality checking, to make the checker look
inside functions that it otherwise might not.
* %transform directive, for declaring transformation rules on runtime
expressions. Transformation rules are automatically added for top level
implementations of interfaces.
* A %spec flag on functions which allows arguments to be marked for partial
evaluation, following the rules from "Scrapping Your Inefficient Engine"
(ICFP 2010, Brady & Hammond)
* To improve error messages, one can use `with NS.name <term>`
or `with [NS.name1, NS.name2, ...] <term>` to disable disambiguation
for the given names in `<term>`. Example: `with MyNS.(>>=) do ...`.
Library additions:
* Additional file management operations in `base`
* New module in `base` for time (`System.Clock`)
* New modules in `contrib` for JSON (`Language.JSON.*`); random numbers
(`System.Random`)
Compiler updates:
* Data types with a single constructor, with a single unerased arguments,
are translated to just that argument, to save repeated packing and unpacking.
(c.f. `newtype` in Haskell)
+ A data type can opt out of this behaviour by specifying `noNewtype` in its
options list. `noNewtype` allows code generators to apply special handling
to the generated constructor/deconstructor, for a newtype-like data type,
that would otherwise be optimised away.
* 0-multiplicity constructor arguments are now properly erased, not just
given a placeholder null value.
Other improvements:
* Various performance improvements in the typechecker:
+ Noting which metavariables are blocking unification constraints, so that
they only get retried if those metavariables make progress.
+ Evaluating `fromInteger` at compile time.
* Extend Idris2's literate mode to support reading Markdown and OrgMode files.
For more details see: ["literate" in the user manual](https://idris2.readthedocs.io/en/latest/reference/literate.html).
## Changes since Idris 1
Everything :). For full details, see:
[updates](https://idris2.readthedocs.io/en/latest/updates/updates.html)
Reference in New Issue View Git Blame Copy Permalink