The Enso Distribution

This document provides a specification of how the Enso distribution should be structured and how it should behave.

Enso Home Layout
Universal Launcher Script
Layout of an Enso Version Package
- Package Sets

Enso Home Layout

All of Enso's binaries, packages, etc. are installed into a directory in the user's home directory. For macOS and linux distributions that's ~/.enso, by default. The distribution is fully portable, so it never makes any assumptions about actually being placed in any particular directory.

The directory structure is as follows:

~/.enso
├── bin
│   └── enso                  # The universal launcher script, responsible for choosing the appropriate compiler version.
├── dist                      # Per-compiler-version distribution directories.
│   ├── default -> enso-1.2.0 # A symlink to the version that should be used when no version is explicitely specified.
│   ├── enso-1.0.0            # A full distribution of given Enso version, described below.
│   │   └── <truncated>
│   └── enso-1.2.0            # A full distribution of given Enso version, described below.
│       └── <truncated>
├── jvm                       # A directory storing (optional) distributions of the JVM used by the Enso distributions.
│   └── graalvm-ce-27.1.1
└── cache                     # A directory storing downloaded libraries and resolvers. Can be removed safely.
    ├── libraries             # Contains downloaded libraries.
    │   └── Dataframe         # Each library may be stored in multiple version.
    │       └── 1.7.0         # Each version contains a standard Enso package.
    │           ├── package.yaml
    │           └── src
    │               ├── List.enso
    │               ├── Number.enso
    │               └── Text.enso
    └── resolvers           # Contains resolver specifications, described below.
        ├── lts-1.56.7.yaml
        └── lts-2.0.8.yaml

The actionables for this section are:

Determine the appropriate method for per-user installation on windows.

Universal Launcher Script

The universal launcher script should be able to launch the proper version of Enso executable based on the version specified in the project being run, or use the default version if none specified.

The actionables for this section are:

Determine the proper technology to implement the script (i.e. Java/Bash).

Determine the features needed in the launcher script.

Layout of an Enso Version Package

This section describes the structure of a single version distribution. This system is intended to be implemented first and used e.g. for the Enso nightly builds / releases.

Such a distribution can be used as a standalone version, assuming the required version of the JVM is installed and used.

The layout of such a distribution is as follows:

enso-1.0.0
├── component     # Contains all the executable tools and their dependencies.
│   └── enso.jar  # The main executable of the distribution. CLI entry point.
└── std-lib       # Contains all the pre-installed libraries compiler version.
    ├── Http      # Every version sub-directory is just an Enso package containing the library.
    │     ├── package.yaml
    │     ├── polyglot
    │     └── src
    │         ├── Http.enso
    │         └── Socket.enso
    └── Base
          ├── package.yaml
          └── src
              ├── List.enso
              ├── Number.enso
              └── Text.enso

Implementation Note: This structure makes use of deep nesting, which may give some with knowledge of Windows' path-name limits pause (windows paths are historically limited to 256 characters). However, there is no special action required to handle this limit as long as we are building on top of the JVM. The JVM automatically inserts the \\?\ prefix required to bypass the windows path length limit.

Standard Library

The standard library is a set of libraries shipped with the compiler. Whether a given package belongs to standard library can be a bit of an arbitrary choice, but the following are some guidelines:

Fundamental packages – basic collections and utilities should be a part of standard library.
Packages relying on the compiler internals (e.g. the internal object representation). An example of such a package would be Generic, exposing reflective access to Enso objects.
Packages that the compiler relies on, e.g. compile error definitions, stack traces etc.

Resolvers

Note This system is not implemented yet.

A resolver is a manifest containing library versions that are automatically available for import in any project using the resolver.

Example contents of a resolver file are as follows:

enso-version: 1.0.7
libraries:
  - name: Base
    version: 1.0.0
  - name: Http
    version: 5.3.5

5.3 KiB Raw Blame History Unescape Escape