Merge: doc: fixed some typos and other misc. corrections

This PR is fairly basic and only contains the following changes:
- Corrected various sentence structures, typos and text formatting across several markdown pages (language doc, README, etc.)

Note: There are a few sections I would rewrite differently to sound more professional/neutral and to include more details about how the language behaves in certain cases, but I felt like it was outside of this PR's scope.

Pull-Request: #2833
Reviewed-by: Jean Privat <jean@pryen.org>

doc: misc proofread

Merge pull request #2831 from Delja/contract_fix_error

Contract: Fix null argument error

tests: Add contract test

Add contract test when the `null` parameter is omitted.

Signed-off-by: Delja <deljarry.florian@gmail.com>

src/contracts: Fix `null` omit argument error

Resolve contract error when the null parameter is omitted.

Signed-off-by: Delja <deljarry.florian@gmail.com>

Merge: phase: Introduction of new hook method

This pr introduces a new hook method in the execution of the `process_nmodule_after_phases` phases. This method makes it possible to analyze each module again after the execution of all phases in order to benefit from the information of the whole program.

This method is useful in the context of contracts. Example:

```nit
module b

redef class A
redef fun foo
is
ensure(result > 2)
do
return 2
end
end

var a = new A
a.bar
```
```nit
module a

class A
fun foo: Int do
return 1
end

fun bar do
self.foo
end
end
```

Actually, when you call the foo property in the bar method, no contract is called, while a postcondition was added by refinement in the `b` module. In fact it was not possible to call the contract face because it was not yet introduced during the analysis of module `a`. It is now possible to re-analyze all the modules to make the redirection once all the information are known.

Pull-Request: #2828

tests: Update nit test args

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

nit: Add `run_global_phases` call

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

erasure_compiler: Add contract phase dependency

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

separate_compiler: Add contract phase dependency

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

global_compiler: Add contract phase dependency

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

abstract_compiler: Add import contract

Add import contracts to manage phases dependency.

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

src/contracts: Modification of contract weaving

Add the implementation of `process_nmodule_after_phases` in order to do the weaving of contracts

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

Merge: Contract refactoring

This pr do the following changes:

* Authorize the declaration of identical contracts on the same method in order to facilitate the reading of contracts. Example
```nit
fun foo(x, y: Int)
is
expect(x > 0)
expect(y > 0)
do end
```

* Modification of the generation of contracts. In the default mode, the contracts are now generated even if they are not used, only the public facet is generated only if it is necessary. The objective is to provide the contracts verification when you are in a redefinition in a module where contracts must be applied. This solution is a compromise to try to keep acceptable performance in the default mode. Example

```nit
module one
import two
[...]

module two
import three

redef class C
# Now all calls to foo of c (only in module one or two) check the `expect` property defined in module three (as defined by the default contract rule).
redef foo ...
end

module three

class C
fun foo is expect(true), ensure(true)
end
```

* When a contract is not fulfilled the messages displayed to the user are now more explicit. Example:

```nit\
class A
fun foo(i: Int) is expect(i > 0) do end
end

var a = new A
a.foo(0)
```
This is the output of the program
```
Runtime error: Assert 'expect(i > 0)' failed
```

* Cosmetic modifications have been made to remove useless methods, modify the names and comments of certain methods to be more explicit.

Pull-Request: #2827

tests/sav: Update tests results

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

contracts: Improvement contract implementation

- Remove useless methods
- Change some properties names and comments to be more explicit
- Update contract message to get more explicit message when it fail

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

contracts: Modification contracts creation

Change generation policy to make default mode more relevant

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

contracts: Remove `contract_name` property

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

contracts: Update contracts declaration

Add the possibility to use contracts annotation many time

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

contracts: Remove useless return parameter

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

Merge: Contract refactoring

This pr:
* Move the contract model representation to detach the representation and the processing of contracts.
* Improvement of  `CallSiteVisitor` to ignore `MContract` and `MFacet` methods in the callsite redriving. Add the usage of `create_callsite` method.

Pull-Request: #2826

contracts: Improvement CallSiteVisitor

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

model/model_contract: Move contract model representation

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

Merge: Astbuilder improvement

This pr :
- move `do_all` method into ASTBuilder.
- generalize `create_callsite` to take into consideration AAttrPropdef

Pull-Request: #2825

src/astbuilder: generalize `create_callsite`

Generalize `create_callsite` to take into consideration AAttrPropdef

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

src/astbuilder: move `do_all` method in ASTBuilder

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

Merge: Contract refactoring

This pr integrate:

- Minor documentation changes
- Addition of the `in_contract` attribute to disable verification of contracts when we are already in verification.
- Improved signature management

This pr depends of #2815 #2816 #2817 #2820

Pull-Request: #2822

contracts: Add `in_contract` attribute

This attribute is used to disable contract verification when you are already in a contract verification.

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

contracts: Signatures improvement (ASignature and MSignature)

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

contract: Documentation improvement

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

Merge: astbuilder: Introduction of new construction services

Add two new services in the astbuilder module:
- Add a way in ModelBuilder to create AST and module entity at same time (`create_method`, `create_class`, `create_attribute`).

- Add a new property in MEntity `create_ast_representation` to return a ast representation of `self`.

Pull-Request: #2815
Reviewed-by: Jean Privat <jean@pryen.org>

astbuilder: Add new AST creation services

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

Merge: modelize_property: Define a new API to modify AAttrPropdef

Define a small fluent API in order to modify easily AAttrPropdef.

Pull-Request: #2820
Reviewed-by: Jean Privat <jean@pryen.org>

Merge: typing: Add a mechanism to disable warnings

Add a mechanism to suppress warnings during the typing phase. I also took the opportunity to modify a bad indentation in the file :smile: .

Pull-Request: #2818
Reviewed-by: Jean Privat <jean@pryen.org>

Merge: typing: Add `do_typing` on AExpr

Add a way to type an `AExpr` individually.

In my case this method is used in order to type expressions provided for the `old()` in ensures contract.

Pull-Request: #2819
Reviewed-by: Jean Privat <jean@pryen.org>

modelize_property: Define a new API to modify AAttrPropdef

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

typing: Add `do_typing` on AExpr

Add a way to type `AExpr`.

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

typing: text formatting

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

typing: Add a way to disable warnings

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

Merge: modelbuilder_base: Define ANode as nullable

Definition of ANode as nullable. When you create entities manually there is not necessarily a current attachment point (in the ast). It is therefore more practical to provide a service with the ANode which can be null.

In addition, the `fun error (n: nullable ANode, text: String)` method that will be called already handles this case.

Pull-Request: #2816

Merge: modelize_property: Add `unsafe_add_mclassdef2nclassdef`

Add a way to associate a `nclassdef` with its `mclassdef` without verification.

Currently, to attach an AClass with an MClass, you must use the `build_property` method which performs all the checks and builds the representation in the model. Thanks to the Nitbuilder which facilitates the construction of entities, we find ourselves in a case where we can build the representation of a class in the model and then build the corresponding ast. It is therefore necessary to provide a service to associate the both elements.

Pull-Request: #2817

modelbuilder_base: Define ANode as nullable

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

modelize_property: Add `unsafe_add_mclassdef2nclassdef`

Add a way to associate a `nclassdef` with its `mclassdef` without verification.

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

Merge: modelize_property: Split the build_property method of AAttrPropdef

This pr split the `build property` method into several methods. The objective is to be able to build the entities of the model (read, write...) more independently according to the current state. The construction of the signature was also split for the same purpose.

Pull-Request: #2813
Reviewed-by: Jean Privat <jean@pryen.org>

Merge: src/astbuilder: Add new nodes makers

Add new make method for three kind of nodes (AAttrPropdef, ACallAssignExpr)

Pull-Request: #2810
Reviewed-by: Jean Privat <jean@pryen.org>

Merge: neo: Move neo node creation

Move neo node creation in her respective class.

Pull-Request: #2812

Merge: gitlabci: no auth for postgress in tests

This should fix recent CICD issues

Pull-Request: #2814

gitlabci: no auth for postgress in tests

This should fix recent CICD issues

Signed-off-by: Jean Privat <jean@pryen.org>

modelize_property: Split model build of AAttrPropdef

Split the build method of AAttrPropdef

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

neo: Move neo node creation

Move neo node creation in her respective class.

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

Merge: separate_compiler: Refactored class compilation

## Before
Before this update, the method `compile_class_to_c` handled every part
of the class compilation process even special case (universal class).
By doing so, we can't refined this method efficiently without
reimplementing the entire method. This is a pain since each time we
need to add universal class we have to modify the original code instead
of refining the compiler.

## After

The method `compile_class_to_c` has been divided in three main parts:

1. the class's vft compilation (same for every type of class)
2. the compilation of universal class specifics (change alot through
time). This part must managed every part of a universal type, except its
vft compilation which already handled by the 1st step.
3. the compilation of the default `NEW` allocator (apply only for
non-universal type).

Moreover, the state of a class compilation is stored in a new class
called `ClassCompilationInfo`, which has different flag to specify if
the class is dead/alive or need_corpse. This choice was made to prevent
dataclump in each method involved with the class compilation.

With this new way of managing class compilation, we can add new
universal class via refinement instead of code rewriting.

Signed-off-by: Louis-Vincent Boudreault <lv.boudreault95@gmail.com>

Pull-Request: #2808
Reviewed-by: Jean Privat <jean@pryen.org>

src/astbuilder: Add new nodes makers

Add new node marker for AVarExpr, AStdClassdef, ACallAssignExpr, AAttrPropdef

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

separate_compiler: Refactored class compilation

Before this update, the method `compile_class_to_c` handled every part
of the class compilation process even special case (universal class).
By doing so, we can't refined this method efficiently without
reimplementing the entire method. This is a pain, since each time we
need to add universal class we have to modify the original code instead
of refining the compiler.

The method `compile_class_to_c` has been divided in three main parts:

1. the class's vft compilation (same for every type of class)
2. the compilation of universal class specifics (change alot through
time). This part must managed every part of a universal type, except its
vft compilation which already handled by the 1st step.
3. the compilation of the default `NEW` allocator (apply only for
non-universal type).

Moreover, the state of a class compilation is stored in a new class
called `ClassCompilationInfo`, which has different flag to specify if
the class is dead/alive or need_corpse. This choice was made to prevent
dataclump in each method involved with the class compilation.

With this new way of managing class compilation, we can add new
universal class via refinement instead of code rewriting.

Signed-off-by: Louis-Vincent Boudreault <lv.boudreault95@gmail.com>

Merge: Fixed quick_sort when array is length 0 or 1

Fixed a bug where quick_sort could access out of bound element when `to` argument smaller or
equal to 0.

# Before

var xs = [1]
default_comparator.quick_sort(xs) # assertion failed

# After

var xs = [1]
default_comparator.quick_sort(xs)
assert xs == [1] # true

Signed-off-by: Louis-Vincent Boudreault <lv.boudreault95@gmail.com>

Pull-Request: #2811

Merge: Simplify constructors: next episode

The current constructors are quite complex, that is why Jean Privat had proposed to simplify them with the pr #1966.

The current init has a double facet, internal with a signature and an empty body and an external one with a signature and initializer represent the attributes to initialize.

This pr replace the external facet by introducing a new constructor defaultinit specific to each class. This default property includes the orchestration of initializers (non-default attributes, autoinit methods, and autoinit annotation in the class). In addition, this property is now the one exposed when a new A is executed.

The current init used to manually set the default constructor it's used to perform a processing after initialization. Note this one must have an empty signature. If this is not the case, an error will be generated.

To use the init in a similar way, we now have to use the old_style_init annotation.

This pr resolve minor bugs and test issues of the Jean's pr .

Pull-Request: #2803
Reviewed-by: Jean Privat <jean@pryen.org>

Fixed quick_sort when array is length 0 or 1

Signed-off-by: Louis-Vincent Boudreault <lv.boudreault95@gmail.com>

Model: Add get_direct_supermtype

Add method to return the direct parents mtype of the mclassdef.

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

bucketed_game: Old_style_init

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

test_neo: Fix error when mparameter is duplicated

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

modelize: Get most specific init from mclass hierarchy

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

typing: Add error when init is not found

More explicit error when a potential duplication of root object class.

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

src: Update init

Remove useless init and add old_style_init if it's necessary

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

tests: Fix tests

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

Merge: Fixed safe-call missed cast when reference primitive data types

This patch fixed the issue #2804 where the compiler didn't add the cast from primitive data to
`val *` when accessed by safe-call syntax.

Signed-off-by: Louis-Vincent Boudreault <lv.boudreault95@gmail.com>

Pull-Request: #2806
Reviewed-by: Jean Privat <jean@pryen.org>

Merge: Remove useless empty line

I was reading that file recently and noticed this empty line :p

Pull-Request: #2807

Fixed safe-call miss cast when reference primitive data types

Signed-off-by: Louis-Vincent Boudreault <lv.boudreault95@gmail.com>

Remove useless empty line

Signed-off-by: Alexandre Terrasa <alexandre.terrasa@shopify.com>

pep8analysis: Fix no init call

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

html_model: Remove new_msignature

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

Merge remote-tracking branch 'upstream/master' into init_auto

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

modelize_property: Remove root_init in MClass

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

Merge: tests: Test result update for `curl_http`

The site example.org was modified on October 18th, so that the tests no longer work. This pr fix this problem.

Pull-Request: #2801

Merge: Callref compilers

Pull-Request: #2793
Reviewed-by: Jean Privat <jean@pryen.org>

tests: Test result update for `curl_http`

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

Merge: Contract: Change mpropdef driving

This pr change the driving strategy to resolve the problem when the static type has no contract and the dynamic has one.

Note: now when a mpropdef has a contract after the introduction a facet is added in the intro class. Indeed, as there is no way to know the dynamic type we are going to meet, we must always direct to the facet of contract even if it only redirects to the method and executes no contract.

I change at the same time the syntax of the keywords `ensures` by `ensure` and `expects` by `expect`. The doc will arrive in the next pr.

Pull-Request: #2799

Callref bugfix in interpreter and compilers + autosav

~~~~nitish
class A[E]
fun foo: A[E] do return self
fun bar: Fun0[A[E]] do return &foo # it didn't work before
end
~~~~

- Fixed a bug when `self` was a generic class with unsolved type. It was
impossible to return a callref, since the typing rule were not properly
executed.
- Added a test case in `test_callref.res`

Signed-off-by: Louis-Vincent Boudreault <lv.boudreault95@gmail.com>

removed `nitvm` engine from tests

Signed-off-by: Louis-Vincent Boudreault <lv.boudreault95@gmail.com>

Updated `tests/syntax_callref.nit`

Signed-off-by: Louis-Vincent Boudreault <lv.boudreault95@gmail.com>

Callref expressions support for Erasure Compiler

Signed-off-by: Louis-Vincent Boudreault <lv.boudreault95@gmail.com>

Callref expressions support for Global Compiler

Signed-off-by: Louis-Vincent Boudreault <lv.boudreault95@gmail.com>

Callref expression support for Separate Compiler.

- Added test case in `src/compiler/test_callref.nit`
- Updated the API of `AbstractCompiler` to support routine reference
call and instantiation services.
- Implemented routine reference (callrefs) handling for separate
compiler

Signed-off-by: Louis-Vincent Boudreault <lv.boudreault95@gmail.com>

Callref expression support for the interpreter

Signed-off-by: Louis-Vincent Boudreault <lv.boudreault95@gmail.com>

contracts: change the contract syntax

Replace `ensures` by `ensure` and `expects` `expect`

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

contracts: Change mpropdef driving

The driving strategy was changed to resolve the problem when the static type has no contract and the dynamic has one.

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

tests: Add contract test with static

Test when the static type has no contract and the dynamic has one.

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

Merge: nitunit the manual

Since the manual is now back in the repository, just use niunit to check the example.

Some examples needed to be updated

* renaming things to avoid conflicts
* using real expression and statements (and not placeholders)
* add `nitish` for example with explicit static or dynamic errors

Pull-Request: #2795

Merge: contracts: fix usage of contract with `--erasure`

Moving the check if a contract is needed in the visitor to avoid the property creation without definition.

Pull-Request: #2798

contracts: fix usage of contract with `--erasure`

Moving the check if a contract is needed in the visitor to avoid the property creation without definition.

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

manual: add nitish and avoid name conflicts

Signed-off-by: Jean Privat <jean@pryen.org>

manual: fix float comparaison and print

Signed-off-by: Jean Privat <jean@pryen.org>

manual: fix examples to be nitunitables

Signed-off-by: Jean Privat <jean@pryen.org>

Merge: Contract: bug fix

This pr fix the bug when the contract is apply with generic or virtual type.

Pull-Request: #2794

tests: Add tests for generic and virtual types

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

src/contracts: Fix contracts on virtual and generic type

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

Merge: Contract implementation

# Contract.

This pr is a copy of #2747 with some modifications. It has a dependency with the #2779 and #2788.

Adding programming by contract (Design by contract) in Nit language. Contracts works with nit annotations. I decided to cut the contract pr in a smaller part to facilitate reviewing (some feature are not available on it, see section futur feature).

## Annotations

To define a new contract you need to use the corresponding annotation. For example it's possible to define a contract that x parameter must be strictly greater than 5. To do it would be necessary to define the contract in the following way `expects(x > 5)`. All expressions returning a boolean (comparison...) can be used as a condition.

Three annotations were added:

- `expects` to indicate the conditions need to the execution of the methods
- `ensures` to indicate the conditions of guarantee at the end of the execution of the methods
- `no_contract` to remove the inherited contract

This syntaxe is choose because in the next version of c++ (20) (see [P1369](http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2018/p1369r0.pdf) for a overview) the contract will be define with the keywords expects and ensures. So I think it would be interesting to keep the same principle. But if all nit developper prefer to use `require` and `ensure` it's fine to change it.

## Method contract (ensures, expects)

For each method it's possible to define preconditions (`expects`) and  post-conditions (`ensures`). If the call of the method satisfies the prerequisites (`expects`) of the method, the caller may assume that the return conditions (`ensures`) will be satisfied.

The method contracts can access all the parameters of the method as well as the set of attributes/methods visible in the context of the method. i.e the set of parameters and the set of methods and attributes of the current class can be used (attributes declare locally in the method can not be used). For post-conditions (ensures) the `result` attribute has been added to perform a check on the return value of the method. Currently it's not possible to refer an old value in a ensures (exemple old(length) == length + 1).

## Process

### Building contract phase

A phase is executed to check all the methods. This check is done to know if:

- The method is annotated (redefined or not)

- The method is a redefinition of a method already having a contract (i.e a method that does not add any new conditions to the existing contract).

When a contract is detected the code is `extended` to add the verification features. Two methods are created. The first method is the contract face. Its goal is to provide the call of the contract verification and the call of the original method. With this strategy, the original code of the method is preserved. The second created method is for the contract verification.

#### Exemple

##### Expect:
```nit
class MyClass
fun foo(x: Int)
is
expects(x > 0)
do
[...]
end
end
```
Representation of the compiled class
```nit
class MyClass
fun foo(x: Int)
is
expects(x > 0)
do
[...]
end

fun _contract_foo(x: Int)
do
_expects_foo(x)
foo(x)
end

fun _expects_foo(x: Int)
do
assert x > 0
end
end
```
##### Ensure:
```nit
class MyClass
fun foo(x: Int): Bool
is
ensures(result == true)
do
[...]
return true
end
end
```
Representation of the compiled class

```nit
class MyClass
fun foo(x: Int): Bool
is
ensures(result == true)
do
[...]
return result
end

fun _contract_foo(x: Intl): Bool
do
var result = foo(x)
_ensures_foo(x, result)
return result
end

fun _ensures_foo(x: Int, result: Bool)
do
assert result == true
end
end
```

## Inheritance

Contracts support redefinition and adding condition. Note that when a contract is define in a parent class, it's no longer possible to remove this contract on all the classes that inherit or redefine them. They only need to be increased according to different subtyping rules.

All preconditions (expects) can be weakened. i.e it's possible to provide a new alternative to validate the contract. This corresponds to the use of a logical OR between the old and the new conditions.

All post-conditions (ensure) can be consolidate. i.e the new condition of the contract will provide a new guarantee to the user of the method. This rule can be translates into a logical AND between the old and the new conditions.

### Exemple

#### Expect

```nit
class SubMyClass
super MyClass

redef fun foo(x: Int)
is
expects(x > 0, x == 0)
do
[...]
end

redef fun _expects_foo(x: Int)
do
if x == 0 then return
super(x)
end

redef fun _contract_foo(x: Int)
do
_expects_foo
super(x)
end

end
```

#### Ensure
```nit
class SubMyClass
super MyClass

redef fun foo(x: Int): Bool
is
ensures(result == true, x > 0)
do
[...]
end

redef fun _ensures_foo(x: Int, result: Bool)
do
super
assert super(x, result)
end

redef fun _contract_foo(x: Int, result: Bool): Bool
do
var result = super
_ensures_foo(x, result)
return result
end
end
```

Summary

| Annotation    |  Inheritance condition type  |
| ------------- | -------------|
| expects       |        and  |
| ensures       |        or  |

## Invocation

All calls to contract methods are intercepted to call the contract version. For the moment the contracts are systematically called, whether it's an internal or external call. Only calls to super do not execute the contracts.

This part is subject to evolution with a parameter to activate or not the internal call verification.

## Building

Since contracts are expensive in resource, several levels of use have been defined based on the needed verification:

- No contract: all contracts are disable (option `--no-contract`).

- Default: By  default  the  contracts  can  be  defined as "semi-global". I.E. All contracts (ensures, expects)used in the main package are enabled, the expects contracts are enabled (ensures contracts are disable) in direct imported package. Other indirected imported package doesn't have active contract.

- Full contract: Contracts are enable (ensures, expects) on all classes (option `--full-contract`).

## Future work

This pr has been simplified to facilitate the reviewing.

Future features:

- Support class invariant contracts
- Ability to put contracts on auto-getters and setter
- Detection of query or command to avoid the contract to change the object state (this functionality will probably be an advice because it's difficult to define if a method has no side effect.)
- `Old` support for the ensures contract  to refer at the same value during the expects condition

Some pr will follow to use the contacts directly in the lib (collection...).

### Note

Currently the syntax of contracts is strict, only comparisons and method calls returning bouleans can be used. Indeed the arguments passed to the annotation of contract are directly used for assert. A solution would be given a more open syntax for more complex contracts instead of using a method. But this would cause problems in the syntax of annotations. If you have any suggestion don't hesitate. An issue is available to talk about the potential syntax. (#1340)

Pull-Request: #2790
Reviewed-by: Jean Privat <jean@pryen.org>

manual: CI check with nitunit

Signed-off-by: Jean Privat <jean@pryen.org>

src/toolcontext: Provide contract options

`--no-contract` option to disable the contracts usage
`--full-contract` option to enable the contracts usage in all classes

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

share/man/nitc: Adding the man explication to disable contracts

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

contracts: Adding all contract generation mechanism

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>

tests: adding contract testing files

Signed-off-by: Florian Deljarry <deljarry.florian@gmail.com>