eastwood

# Eastwood linter and language server Eastwood is a linter and language server for the functional programming language [Clean][]. Neovim and VS Code are the currently supported IDEs. Other IDEs will need to be configured manually. ## The project configuration file (Eastwood.yml) Eastwood requires a project configuration file `Eastwood.yml` in the current working directory. This is a YAML file with the following fields: - `compiler`: compiler executable (usually `cocl`) - `paths`: Relative or absolute paths in which included modules are located An example Eastwood.yml file: ``` compiler: cocl paths: [] ``` It is required to specify a compiler. It is required to specify a YAML list for the paths key (use "paths: []" for an empty list). Paths to libraries managed by Nitrile do not need to be listed in `paths`: they will be read from the lock file `nitrile-lock.json`. ## Usage in Neovim The configuration below assumes you have neovim 0.5 or greater with lsp-config installed. Simply add the following to your vimrc: ```lua lua << EOF local lspconfig = require'lspconfig' local util = require'lspconfig/util' local configs = require'lspconfig/configs' if not lspconfig.eastwood then configs.eastwood = { default_config = { cmd = {'eastwood-cls'}; filetypes = {'clean'}; root_dir = util.root_pattern 'Eastwood.yml', settings = {}; }; } end lspconfig.eastwood.setup{} EOF ``` ## Usage in VS Code Use the [Eastwood extension for VS Code](https://gitlab.com/top-software/eastwood-vs-code). ## Installation Binaries are available at the [Clean package registry](https://clean-lang.org/pkg/eastwood/). Eastwood should be installed using [Nitrile][]: ``` nitrile global install eastwood ``` Run `eastwood-cls --version` to print the installed version. If Eastwood is used as linter within a Nitrile project, it should be added as [dependency with `Test` scope](https://clean-and-itasks.gitlab.io/nitrile/nitrile-yml/reference/#dependenciesscope). ## Building Eastwood can be built and tested using [Nitrile][]. The sources can be compiled as follows: ```bash nitrile build ``` ## Running tests The tests can be run as follows: ```bash nitrile test ``` ## Documentation Further documentation can be found [here](https://gitlab.com/top-software/eastwood/-/tree/main/docs). ## Copyright &amp; License Eastwood is copyright &copy; 2021-2025 TOP Software Technology B.V. This software is licensed under the AGPL v3 license. For details, see the [LICENSE](/LICENSE) file. [Clean]: https://clean-lang.org [Nitrile]: https://clean-lang.org/about.html#install

#### 2.9.1 - Chore: allow compiler v5.1. ### 2.9.0 - Enhancement: improve speed of goto definition/declaration and simplify its implementation. - Feature: print the version of Eastwood when running `eastwood-cls --version`. - Feature: show progress information when (re)computing the index. ### 2.8.0 - Feature: re-compute diagnostics on save. - Fix: ensure diagnostics are shown for related documents. ### 2.7.0 - Enhancement: improve speed of diagnostics by switching to pull diagnostics. If you are using VSCode, this requires version 0.1.9 of [`TOPSoftware.clean-vs-code`](https://marketplace.visualstudio.com/items?itemName=TOPSoftware.clean-vs-code). - Feature: add support for completions based on the existing symbol map. - Feature: add code lens that shows inferred signature if no signature is provided by the user. - Feature: add `eastwood.addTypeSignature` command to insert inferred type signature. - Feature: add `eastwood.noop` command to perform a no-op for invalid signatures. - Fix: define proper use-constraint on the compiler. ### 2.6.0 - Feature: support syntax introduced with `base-compiler` `4.2`. - Fix: update `system` to fix stack overflow with `scanDirectory`. #### 2.5.1 - Fix: increase size of heap to support hovers for large projects. ### 2.5.0 - Feature: Show documentation and type when hovering over certain symbols. #### 2.4.2 - Fix: include fix of LSP that fixes error that used to occur when shutting down the language server. #### 2.4.1 - Fix: Give precedence to paths in Eastwood.yml above the library paths. This makes it possible to temporarily add a path to a local dependency. ### 2.4.0 - Feature: The lock file is now also used to load libraries managed by Nitrile. Eastwood.yml is still needed for anything in src/ and test/ ### 2.3.0 - Feature: support syntax introduced with `base-compiler` `4.1`. #### 2.2.1 - Fix: do no longer abort when module could not be parsed when checking dcl documentation as this causes the language server to crash. ### 2.2.0 - Feature: the validity of .dcl documentation syntax (see: https://gitlab.com/clean-and-itasks/clean-platform/-/blob/master/doc/DOCUMENTATION.md) is now automatically checked when using the Eastwood language server or linter. #### 2.1.3 - Fix: prevent `bad file descriptor` crashes when using `eastwood-cls` for some time. #### 2.1.2 - Fix: prevent linter crashes for expressions with types. #### 2.1.1 - Fix: prevent deadlocks while reading large compiler outputs. ## 2.1.0 - Feature: support syntax introduced with `base-compiler` `4.0`. #### 2.0.0 - Remove: Removed root directory from default search paths to improve performance for finding definitions/declarations in case there are subdirectories which do not contain relevant source files. (e.g when including repositories in repositories to build with local dependency). #### 1.1.3 - Fix: Add timeout for grep in case it takes too long to return all results. Do no longer allow to go to the declaration or definition of import as grep would not return. #### 1.1.2 - Fix: show stdout of compiler if compiler crashes, compiler sometimes prints errors to stdout instead of stderr. Therefore, the errors would not end up being shown to the user by Eastwood. #### 1.1.1 - Fix: incorrect character range for the CAF linter warnings. ### 1.1.0 - Feature: the language server now includes linter output. #### 1.0.2 - Fix: make compiler option in Eastwood.yml work again. #### 1.0.1 - Fix: include fixes of the YAML parser (see yaml v1.1.2). ## 1.0.0 - Initial version using nitrile semantic versioning.