<commit_before># Visual Studio Code Language Support for Ceylon

This extension provides support for editing and compiling Ceylon projects in Visual Studio
Code. Currently, the Dart backend is supported. Non-cross platform Ceylon modules for the
Java and JavaScript backends are ignored by this extension.

## Features

- Zero-configuration: open any Ceylon project folder and start editing (`.ceylon/config`
will be used for configuration if present)
- Multithreaded compiles: the module you are editing is immediately recompiled after each
edit while dependent modules are compiled in the background
- Syntax highlighting
- As you type warning and error reporting
![errors](images/screeshot-errors.png)
- Auto completion
![errors](images/screeshot-autocomplete.png)
- Documentation on hover
![hover](images/screeshot-hover.png)

## Requirements

- [Ceylon 1.3.0](https://ceylon-lang.org) ([download](https://ceylon-lang.org/download/))
- [Dart backend for Ceylon DP3](https://github.com/jvasileff/ceylon-dart).
  Simple two step commandline installation:
  `ceylon plugin install --force com.vasileff.ceylon.dart.cli/1.3.0-DP3`
  then `ceylon install-dart --out +USER`
- [Visual Studio Code](https://code.visualstudio.com/Download)

To run programs on the Dart VM (optional and not currently supported on Microsoft
Windows), either
[download](https://www.dartlang.org/downloads/) Dart or install it using Homebrew
as described in the Dart backend for Ceylon
[readme](https://github.com/jvasileff/ceylon-dart).

## Installation

After satisfying the requirements, simply download the preview version of the extension
([vscode-ceylon-0.0.1.vsix](https://jvasileff.github.io/vscode-ceylon/vscode-ceylon-0.0.1.vsix))
and open it in Visual Studio Code.

The extension must be able to find the `ceylon` 1.3.0 executable using one of
the following methods:

- Using `ceylon.home` configured within the Visual Studio Code settings (`⌘,`
  on macOS)
- Using the `CEYLON_HOME` environment variable
- Using the system `PATH`

Additionally, Microsoft Windows users must create a `JAVA_HOME` environment variable
pointing to the path of the Java installation to use, if one doesn't already exists. The
path may be something like `c:\Program Files\Java\jdk1.8.0_102`. To do this, search for
"advanced system settings", click the "Environment Variables" button, and then click
"New".

## Extension Settings

This extension contributes the following settings:

* `ceylon.home`: The directory of the Ceylon installation to use.
* `ceylon.generateOutput`: Write compiled binaries to the output repository.
  Note that output is produced regardless of whether or not the source files
  have been saved.
* `ceylon.serverLogPriority`: The logging level for the language server.
* `ceylon.config.compiler.suppresswarning`: Override the suppresswarning
  setting.
* `ceylon.config.compiler.dartsuppresswarning`: Override the
  dartsuppresswarning setting.
* `ceylon.config.compiler.source`: Override the source repositories. Note that
  this will not take effect without restart.
* `ceylon.config.compiler.resource`: Override the resource repositories. Note<commit_msg>adjust installation instructions for 'vsix' file<commit_after># Visual Studio Code Language Support for Ceylon

This extension provides support for editing and compiling Ceylon projects in Visual Studio
Code. Currently, the Dart backend is supported. Non-cross platform Ceylon modules for the
Java and JavaScript backends are ignored by this extension.

## Features

- Zero-configuration: open any Ceylon project folder and start editing (`.ceylon/config`
will be used for configuration if present)
- Multithreaded compiles: the module you are editing is immediately recompiled after each
edit while dependent modules are compiled in the background
- Syntax highlighting
- As you type warning and error reporting
![errors](images/screeshot-errors.png)
- Auto completion
![errors](images/screeshot-autocomplete.png)
- Documentation on hover
![hover](images/screeshot-hover.png)

## Requirements

- [Ceylon 1.3.0](https://ceylon-lang.org) ([download](https://ceylon-lang.org/download/))
- [Dart backend for Ceylon DP3](https://github.com/jvasileff/ceylon-dart).
  Simple two step commandline installation:
  `ceylon plugin install --force com.vasileff.ceylon.dart.cli/1.3.0-DP3`
  then `ceylon install-dart --out +USER`
- [Visual Studio Code](https://code.visualstudio.com/Download)

To run programs on the Dart VM (optional and not currently supported on Microsoft
Windows), either
[download](https://www.dartlang.org/downloads/) Dart or install it using Homebrew
as described in the Dart backend for Ceylon
[readme](https://github.com/jvasileff/ceylon-dart).

## Installation

After satisfying the requirements, download and install the extension:

1. Download the current preview version of the extension
([vscode-ceylon-0.0.1.vsix](https://jvasileff.github.io/vscode-ceylon/vscode-ceylon-0.0.1.vsix))
2. Launch Visual Studio Code
3. Open the Extensions View by clicking on the last icon on the left hand side of the
Visual Studio Code interface, or by choosing `View`->`Extensions`
4. Choose `Install from VSIX...` in the Extensions View command dropdown (to activate the
dropdown, click on the three horizontal dots in the top right of the Extensions View)
5. Select the file downloaded in step 1.

The extension must be able to locate the `ceylon` 1.3.0 executable (see Requirements
above). If not already configured as part of your Ceylon 1.3.0 installation, perform one
of the following steps:

- Configure the `ceylon.home` in the Visual Studio Code User Settings (`⌘,`
  on macOS). For example, `"ceylon.home": "/opt/ceylon-1.3.0"`
- Set the `CEYLON_HOME` environment variable
- Adjust the system `PATH` to include the directory containing the `ceylon` executable

Note that if the Ceylon installation can be found using more than one of the above
methods, the first will be used. That is, the order of precedence is the `ceylon.home`
setting, the `CEYLON_HOME` environment variable, and finally, the system `PATH`.

Additionally, Microsoft Windows users must create a `JAVA_HOME` environment variable
pointing to the path of the Java installation to use if one does not already exists. The
path may be something like `c:\Program Files\Java\jdk1.8.0_102`. To do this, search for
"advanced system settings", click the "Environment Variables" button, and then click
"New".

## Extension Settings

This extension contributes the following settings:

* `ceylon.home`: The directory of the Ceylon installation to use.
* `ceylon.generateOutput`: Write compiled binaries to the output repository.
  Note that output is produced regardless of whether or not the source files
  have been saved.
* `ceylon.serverLogPriority`: The logging level for the language server.
* `ceylon.config.compiler.suppresswarning`: Override the suppresswarning
  setting.
* `ceylon.config.compiler.dartsuppresswarning`: Override the
  dartsuppresswarning setting.
* `ceylon.config.compiler.source`: Override the source repositories. Note that
  this will not take effect without restart.
* `ceylon.config.compiler.resource`: Override the resource repositories. Note
{'fraction_non_alphanumeric': 0.08453837597330367, 'fraction_numerical': 0.008064516129032258, 'mean_word_length': 4.857491856677524, 'pattern_counts': {'":': 1, '<': 3, '<?xml version=': 0, '>': 4, 'https://': 14, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 14, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3969067', 'n_tokens_mistral': 2049, 'n_tokens_neox': 1945, 'n_words': 832}