./lang/nim, The Nim programming language

[ CVSweb ] [ Homepage ] [ RSS ] [ Required by ] [ Add to tracker ]


Branch: CURRENT, Version: 2.0.4, Package name: nim-2.0.4, Maintainer: pkgsrc-users

Nim (formerly known as "Nimrod") is a statically typed, imperative
programming language that tries to give the programmer ultimate power
without compromises on runtime efficiency. This means it focuses on
compile-time mechanisms in all their various forms.

Beneath a nice infix/indentation based syntax with a powerful (AST based,
hygienic) macro system lies a semantic model that supports a soft realtime
GC on thread local heaps. Asynchronous message passing is used between
threads, so no "stop the world" mechanism is necessary. An unsafe shared
memory heap is also provided for the increased efficiency that results from
that model.


Required to run:
[sysutils/coreutils]

Required to build:
[pkgtools/cwrappers]

Master sites:

Filesize: 7441.902 KB

Version history: (Expand)


CVS history: (Expand)


   2024-05-16 11:59:20 by Masatake Daimon | Files touched by this commit (2)
Log message:
lang/nim: Support NetBSD/aarch64
   2024-04-22 15:23:55 by nikita | Files touched by this commit (4) | Package updated
Log message:
nim: update to version 2.0.4

Changelog (from https://nim-lang.org/blog/2024/04/16/versions-1620-204-released.html)

 Versions 2.0.4 and 1.6.20 released
16 April 2024 The Nim Team

The Nim team is happy to announce two releases:

    the latest Nim, version 2.0.4
    LTS release, version 1.6.20

For the majority of our users, v2.0.4 contains 23 commits and brings bugfixes \ 
and improvements to Nim 2.0.2, released four months ago.

For those users who haven’t switched to Nim v2.0 yet, we have released the \ 
ninth patch release for Nim 1.6.x. It is a small release with 13 commits.
Installing Nim 2.0.4
New users

Check out if the package manager of your OS already ships version 2.0.4 or \ 
install it as described here.
Existing users

If you have installed a previous version of Nim using choosenim, getting Nim \ 
2.0.4 is as easy as:

$ choosenim 2.0.4

If you are on OSX ARM, choosenim will not work for you. Please choose an \ 
alternative method of installing or updating.

Alternatively, you can download Nim 2.0.4 from our nightlies builds.
Donating to Nim

We would like to encourage you to donate to Nim. The donated money will be used \ 
to further improve Nim by creating bounties for the most important bugfixes and \ 
features.

You can donate via:

    Open Collective
    Bitcoin: 1BXfuKM2uvoD6mbx4g5xM3eQhLzkCK77tJ

If you are a company, we also offer commercial support.
Bugfixes

These reported issues were fixed:

    Fixed “import sth from mymodule is compiles and trying to see module \ 
sthfrommymodule” (#23148)
    Fixed “Operations on inline toOpenArray len return a wrong result” (#23280)
    Fixed “Nimsuggest segfault with invalid assignment to table” (#22753)

The complete list of changes is available here.

Installing Nim 1.6.20
New users

If you are a new user, we highly recommend that you start with Nim 2.0.x — see \ 
the sections above on how to install it.
Existing users

If you have installed a previous version of Nim using choosenim, getting Nim \ 
1.6.20 is as easy as:

$ choosenim 1.6.20

If you are on OSX ARM, choosenim will not work for you. Please choose an \ 
alternative method of installing or updating.

Alternatively, you can download Nim 1.6.20 from our nightlies builds.
Bugfixes

These reported issues were fixed:

    Fixed “import sth from mymodule is compiles and trying to see module \ 
sthfrommymodule” (#23148)
    Fixed “Operations on inline toOpenArray len return a wrong result” (#23280)
    Fixed “[Backport 2.0] Itanium mangling scheme” (#23301)
    Fixed “Nimsuggest segfault with invalid assignment to table” (#22753)

The complete list of changes is available here.
   2024-01-10 16:46:09 by Ryo ONODERA | Files touched by this commit (3)
Log message:
nim: Update to 2.0.2

Changelog:
2.0.2:
Bugfixes

These reported issues were fixed:

  * Fixed "Undefined behavior when with hash(...) on non-aligned bytes due to
    murmurHash cast[ptr int32]" (#22387)
  * Fixed "async/closure environment does not align local variables" \ 
(#22419)
  * Fixed "Debugging/stepping is broken in 2.0.0 and 2.1.1" (#22366)
  * Fixed "when picks wrong branch with static int" (#22474)
  * Fixed "Regression from 1.6.14 to 2.0.0 - nimble test crashes with a core
    dump" (#22357)
  * Fixed "Long-term arc-closure iterator problem" (#22619)
  * Fixed "-d:useMalloc broken with --mm:none and threads on" (#22262)
  * Fixed "Crash of compiler on array type check" (#5780)
  * Fixed "Undefined behaviorwith set card() on non-aligned pointer from
    cardSetImpl/countBits64cast on ptr uint64" (#22481)
  * Fixed "elementType from std/typetraits doesn't work in generic \ 
procs" (#
    21532)
  * Fixed "peg matchLen can raise an unlisted exception: Exception" \ 
(#22541)
  * Fixed "Piece of code output c compiler error " (#17197)
  * Fixed "Missing type inference in loop + case + if + continue" (#22604)
  * Fixed "Invalid type mismatch in generic" (#17509)
  * Fixed "std/nativesockets getHostByAddr should support IPv6" (#22834)
  * Fixed "std/nre leaks memory on every created Regex due to auto-translated
    finalizers behaving differently under ARC/ORC" (#22868)
  * Fixed "Destructor not called for temp objects passed as arguments" (#
    22866)
  * Fixed "nimsuggest inlay hints for types shown in the wrong place for
    exported vars and consts" (#23067)
  * Fixed "[Regression] static integers in quote do" (#22947)
   2023-11-23 17:41:31 by Ryo ONODERA | Files touched by this commit (4) | Package updated
Log message:
nim: Update to 2.0.0

Changelog:
# v2.0.0 - 2023-08-01

Version 2.0 is a big milestone with too many changes to list them all here.

For a full list see [details](changelog_2_0_0_details.html).

## New features

### Better tuple unpacking

Tuple unpacking for variables is now treated as syntax sugar that directly
expands into multiple assignments. Along with this, tuple unpacking for
variables can now be nested.

```nim
proc returnsNestedTuple(): (int, (int, int), int, int) = (4, (5, 7), 2, 3)

# Now nesting is supported!
let (x, (_, y), _, z) = returnsNestedTuple()

```

### Improved type inference

A new form of type inference called [top-down \ 
inference](https://nim-lang.github.io/Nim/manual_experimental.html#topminusdown-type-inference) \ 
has been implemented for a variety of basic cases.

For example, code like the following now compiles:

```nim
let foo: seq[(float, byte, cstring)] = @[(1, 2, "abc")]
```

### Forbidden Tags

[Tag \ 
tracking](https://nim-lang.github.io/Nim/manual.html#effect-system-tag-tracking) \ 
now supports the definition
of forbidden tags by the `.forbids` pragma which can be used to disable certain \ 
effects in proc types.

For example:

```nim

type IO = object ## input/output effect
proc readLine(): string {.tags: [IO].} = discard
proc echoLine(): void = discard

proc no_IO_please() {.forbids: [IO].} =
  # this is OK because it didn't define any tag:
  echoLine()
  # the compiler prevents this:
  let y = readLine()

```

### New standard library modules

The famous `os` module got an overhaul. Several of its features are available
under a new interface that introduces a `Path` abstraction. A `Path` is
a `distinct string`, which improves the type safety when dealing with paths, files
and directories.

Use:

- `std/oserrors` for OS error reporting.
- `std/envvars` for environment variables handling.
- `std/paths` for path handling.
- `std/dirs` for directory creation/deletion/traversal.
- `std/files` for file existence checking, file deletions and moves.
- `std/symlinks` for symlink handling.
- `std/appdirs` for accessing configuration/home/temp directories.
- `std/cmdline` for reading command line parameters.

### Consistent underscore handling

The underscore identifier (`_`) is now generally not added to scope when
used as the name of a definition. While this was already the case for
variables, it is now also the case for routine parameters, generic
parameters, routine declarations, type declarations, etc. This means that the \ 
following code now does not compile:

```nim
proc foo(_: int): int = _ + 1
echo foo(1)

proc foo[_](t: typedesc[_]): seq[_] = @[default(_)]
echo foo[int]()

proc _() = echo "_"
_()

type _ = int
let x: _ = 3
```

Whereas the following code now compiles:

```nim
proc foo(_, _: int): int = 123
echo foo(1, 2)

proc foo[_, _](): int = 123
echo foo[int, bool]()

proc foo[T, U](_: typedesc[T], _: typedesc[U]): (T, U) = (default(T), default(U))
echo foo(int, bool)

proc _() = echo "one"
proc _() = echo "two"

type _ = int
type _ = float
```

### JavaScript codegen improvement

The JavaScript backend now uses \ 
[BigInt](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt)
for 64-bit integer types (`int64` and `uint64`) by default. As this affects
JS code generation, code using these types to interface with the JS backend
may need to be updated. Note that `int` and `uint` are not affected.

For compatibility with [platforms that do not support \ 
BigInt](https://caniuse.com/bigint)
and in the case of potential bugs with the new implementation, the
old behavior is currently still supported with the command line option
`--jsbigint64:off`.

## Docgen improvements

`Markdown` is now the default markup language of doc comments (instead
of the legacy `RstMarkdown` mode). In this release we begin to separate
RST and Markdown features to better follow specification of each
language, with the focus on Markdown development.
See also [the docs](https://nim-lang.github.io/Nim/markdown_rst.html).

* Added a `{.doctype: Markdown | RST | RstMarkdown.}` pragma allowing to
  select the markup language mode in the doc comments of the current `.nim`
  file for processing by `nim doc`:

    1. `Markdown` (default) is basically CommonMark (standard Markdown) +
        some Pandoc Markdown features + some RST features that are missing
        in our current implementation of CommonMark and Pandoc Markdown.
    2. `RST` closely follows the RST spec with few additional Nim features.
    3. `RstMarkdown` is a maximum mix of RST and Markdown features, which
        is kept for the sake of compatibility and ease of migration.

* Added separate `md2html` and `rst2html` commands for processing
  standalone `.md` and `.rst` files respectively (and also `md2tex`/`rst2tex`).

* Added Pandoc Markdown bracket syntax `[...]` for making anchor-less links.
* Docgen now supports concise syntax for referencing Nim symbols:
  instead of specifying HTML anchors directly one can use original
  Nim symbol declarations (adding the aforementioned link brackets
  `[...]` around them).
  * To use this feature across modules, a new `importdoc` directive was added.
    Using this feature for referencing also helps to ensure that links
    (inside one module or the whole project) are not broken.
* Added support for RST & Markdown quote blocks (blocks starting with `>`).
* Added a popular Markdown definition lists extension.
* Added Markdown indented code blocks (blocks indented by >= 4 spaces).
* Added syntax for additional parameters to Markdown code blocks:

       ```nim test="nim c $1"
       ...
       ```

## C++ interop enhancements

Nim 2.0 takes C++ interop to the next level. With the new \ 
[virtual](https://nim-lang.github.io/Nim/manual_experimental.html#virtual-pragma) \ 
pragma and the extended \ 
[constructor](https://nim-lang.github.io/Nim/manual_experimental.html#constructor-pragma) \ 
pragma.
Now one can define constructors and virtual procs that maps to C++ constructors \ 
and virtual methods, allowing one to further customize
the interoperability. There is also extended support for the \ 
[codeGenDecl](https://nim-lang.org/docs/manual.html#implementation-specific-pragmas-codegendecl-pragma) \ 
pragma, so that it works on types.

It's a common pattern in C++ to use inheritance to extend a library. Some even \ 
use multiple inheritance as a mechanism to make interfaces.

Consider the following example:

```cpp

struct Base {
  int someValue;
  Base(int inValue)  {
    someValue = inValue;
  };
};

class IPrinter {
public:
  virtual void print() = 0;
};
```

```nim

type
  Base* {.importcpp, inheritable.} = object
    someValue*: int32
  IPrinter* {.importcpp.} = object

const objTemplate = """
  struct $1 : public $3, public IPrinter {
    $2
  };
""";

type NimChild {.codegenDecl: objTemplate .} = object of Base

proc makeNimChild(val: int32): NimChild {.constructor: "NimClass('1 #1) : \ 
Base(#1)".} =
  echo "It calls the base constructor passing " & $this.someValue
  this.someValue = val * 2 # Notice how we can access `this` inside the \ 
constructor. It's of the type `ptr NimChild`.

proc print*(self: NimChild) {.virtual.} =
  echo "Some value is " & $self.someValue

let child = makeNimChild(10)
child.print()
```

It outputs:

```
It calls the base constructor passing 10
Some value is 20
```

## ARC/ORC refinements

With the 2.0 release, the ARC/ORC model got refined once again and is now \ 
finally complete:

1. Programmers now have control over the "item was moved from" state \ 
as `=wasMoved` is overridable.
2. There is a new `=dup` hook which is more efficient than the old combination \ 
of `=wasMoved(tmp); =copy(tmp, x)` operations.
3. Destructors now take a parameter of the attached object type `T` directly and \ 
don't have to take a `var T` parameter.

With these important optimizations we improved the runtime of the compiler and \ 
important benchmarks by 0%! Wait ... what?
Yes, unfortunately it turns out that for a modern optimizer like in GCC or LLVM \ 
there is no difference.

But! This refined model is more efficient once separate compilation enters the \ 
picture. In other words, as we think of
providing a stable ABI it is important not to lose any efficiency in the calling \ 
conventions.

## Tool changes

- Nim now ships Nimble version 0.14 which added support for lock-files. \ 
Libraries are stored in `$nimbleDir/pkgs2` (it was `$nimbleDir/pkgs` before). \ 
Use `nimble develop --global` to create an old style link file in the special \ 
links directory documented at https://github.com/nim-lang/nimble#nimble-develop.
- nimgrep now offers the option `--inContext` (and `--notInContext`), which
  allows to filter only matches with the context block containing a given pattern.
- nimgrep: names of options containing "include/exclude" are deprecated,
  e.g. instead of `--includeFile` and `--excludeFile` we have
  `--filename` and `--notFilename` respectively.
  Also, the semantics are now consistent for such positive/negative filters.
- Nim now ships with an alternative package manager called Atlas. More on this \ 
in upcoming versions.

## Porting guide

### Block and Break

Using an unnamed break in a block is deprecated. This warning will become an \ 
error in future versions! Use a named block with a named break instead. In other \ 
words, turn:

```nim

block:
  a()
  if cond:
    break
  b()

```

Into:

```nim

block maybePerformB:
  a()
  if cond:
    break maybePerformB
  b()

```

### Strict funcs

The definition of `"strictFuncs"` was changed.
The old definition was roughly: "A store to a ref/ptr deref is forbidden \ 
unless it's coming from a `var T` parameter".
The new definition is: "A store to a ref/ptr deref is forbidden."

This new definition is much easier to understand, the price is some \ 
expressitivity. The following code used to be
accepted:

```nim

{.experimental: "strictFuncs".}

type Node = ref object
  s: string

func create(s: string): Node =
  result = Node()
  result.s = s # store to result[]

```

Now it has to be rewritten to:

```nim

{.experimental: "strictFuncs".}

type Node = ref object
  s: string

func create(s: string): Node =
  result = Node(s: s)

```

### Standard library

Several standard library modules have been moved to nimble packages, use \ 
`nimble` or `atlas` to install them:

- `std/punycode` => `punycode`
- `std/asyncftpclient` => `asyncftpclient`
- `std/smtp` => `smtp`
- `std/db_common` => `db_connector/db_common`
- `std/db_sqlite` => `db_connector/db_sqlite`
- `std/db_mysql` => `db_connector/db_mysql`
- `std/db_postgres` => `db_connector/db_postgres`
- `std/db_odbc` => `db_connector/db_odbc`
- `std/md5` => `checksums/md5`
- `std/sha1` => `checksums/sha1`
- `std/sums` => `sums`
   2023-05-14 23:13:53 by nikita | Files touched by this commit (3)
Log message:
nim: extend with recommendations from Chavdar Ivanov.
   2023-04-25 17:34:38 by Nikita | Files touched by this commit (2)
Log message:
nim: fix hardcoded /usr/pkg prefix in config/nim.cfg
fix some pkglint warnings in bl3
   2023-04-20 00:35:27 by Nikita | Files touched by this commit (3) | Package updated
Log message:
nim: update to version 1.6.12

Changelog (https://nim-lang.org/blog/2022/11/23/version-1610-released.html,
https://nim-lang.org/blog/2023/03/10/version-1612-released.html):

Version 1.6.12 released

The Nim team is happy to announce version 1.6.12, our sixth patch release for \ 
Nim 1.6.

Version 1.6.12 is a result of almost four months of hard work, and it contains \ 
51 commits, bringing some general improvements over 1.6.10.

Bugfixes

These reported issues were fixed:

    Fixed “sizeof object containing a set is wrong” (#20914)
    Fixed “Missing bounds check for len(toOpenArray..)” (#20954)
    Fixed “Add warning for bare except: clause” (#19580)
    Fixed “Little Copyright notice inconsistency” (#20906)
    Fixed “std/deques: wrong result after calling shrink” (#21278)
    Fixed “io.readLine adds ‘\00’ char to the end” (#21273)
    Fixed “New JS mdoe issue: return + ref ints.” (#21317)
    Fixed “Bad codegen for passed var seq to proc returning array[] converted \ 
to seq with @” (#21333)
    Fixed “Templates allowed to use ambiguous identifier” (#1027)
    Fixed “Mutating a var parameter through a mutable view triggers SIGSEGV” \ 
(#20422)
    Fixed “macOS use SecRandomCopyBytes instead of getentropy” (#20466)
    Fixed “gcc error when constructing an object that has the same name in the \ 
same file name in 2 different directories” (#20139)

Version 1.6.10 released

The Nim team is happy to announce version 1.6.10, our fifth patch release for \ 
Nim 1.6.

Version 1.6.10 is a result of almost four months of hard work, and it contains \ 
29 commits, bringing some general improvements over 1.6.8.

This version brings OpenSSL 3 support to Nim 1.6, and large allocations and \ 
deallocations for ARC/ORC are now faster.

Bugfixes

These reported issues were fixed:

    Fixed “–styleCheck:off does not work (and –styleCheck:hint is now the \ 
default?)” (#20397)
    Fixed “dereferencing pointer to incomplete type error with gcc 9.4 with \ 
statics/cast” (#20141)
    Fixed “strutils.find uses cstring optimization that stops after \0” (#19500)
    Fixed “Nimpretty mangles numeric literal procs” (#20553)
    Fixed “Regression in proc symbol resolution; Error: attempting to call \ 
routine “ (#18990)
    Fixed “of operator doesn’t consider generics under orc/arc” (#20391)
    Fixed ““incompatible type” when mixing float32 and cfloat in \ 
generics” (#19349)
    Fixed “cannot generate code for: mSlice with toOpenArray” (#19969)
    Fixed “-mm flag is ignored on latest Nim 1.7.1 be4bd8” (#20426)
   2023-01-14 08:31:21 by Charlotte Koch | Files touched by this commit (1)
Log message:
nim: Reset MAINTAINER