Hybrid visual and textual functional programming.
Go to file
Kaz Wesley 2b3bd2cc90
Move documentation into documentable types (#11441)
Move documentation into documentable types (implements #11302).

# Important Notes
GUI:
- Distinguish expression and statement
- `Ast.Ast` is still present, as the base class for AST objects. Most references to `Ast.Ast` are now references to `Ast.Expression`. Operations on blocks use `Ast.Statement`.
- `Ast.parse` has been replaced with: `Ast.parseExpression`, `Ast.parseStatement`, and `Ast.parseBlock`
- `syncToCode` is internally context-aware; it parses the provided code appropriately depending on whether its AST is an expression, a statement, or the top level of a module.
- Remove `wrappingExpression` / `innerExpression` APIs: Wrapper types have been eliminated; modifier lines are now fields inside parent types.
- Simplify AST printing:
- Fully implemented autospacing in `concreteChildren` implementations; the type returned by `concreteChildren` now ensures that spacing has been fully resolved.
- Eliminate `printBlock` / `printDocs`: `concreteChildren` is now aware of indentation context, and responsible for indentation of its child lines.
- The `Pattern` type is now parameterized to identify the AST type it constructs. The `Pattern.parseExpression` function helps create a `Pattern<Expression>`.
- Refactor `performCollape` for testability.
- e2e tests: Improve table viz test: It still doesn't pass on my Mac, but these changes are necessary if not sufficient.

Compiler (TreeToIr):
- An expression in statement context is now found in an `ExpressionStatement` wrapper.
- Documentation for a `Function` is now found inside the function node.
- Deduplicate some polyglot-function logic.
2024-11-04 15:33:53 +00:00
.cargo Custom Windows Installer & Uninstaller (#9815) 2024-05-07 16:22:11 +00:00
.github Saving data links to a DB_Table (#11371) 2024-10-24 13:18:49 +00:00
.vscode Unify Frontend App (#11287) 2024-10-11 18:23:02 +00:00
actions/setup-build misc: bump wasm-pack (#3983) 2022-12-14 18:45:39 +01:00
app Move documentation into documentable types (#11441) 2024-11-04 15:33:53 +00:00
build Execute Base_Internal_Tests with native enso executable (#11403) 2024-10-25 17:58:35 +00:00
distribution Ydoc native image (#10783) 2024-10-31 19:57:50 +00:00
docs Update running tests documentation (#11257) 2024-10-24 09:26:30 +00:00
engine Move documentation into documentable types (#11441) 2024-11-04 15:33:53 +00:00
lib Move documentation into documentable types (#11441) 2024-11-04 15:33:53 +00:00
nix/bin Even more dashboard fixes (#10541) 2024-07-16 09:55:45 +00:00
project Ydoc native image (#10783) 2024-10-31 19:57:50 +00:00
std-bits HTTP response caching, with TTL and LRU logic (#11342) 2024-10-30 12:50:35 +00:00
test Fix Meta.get_qualified_type_name when run as single file (#11401) 2024-10-31 15:25:45 +00:00
tools Ydoc native image (#10783) 2024-10-31 19:57:50 +00:00
.envrc Google Analytics events for opening and closing the app, and opening and closing projects (#9779) 2024-04-25 11:33:59 +00:00
.git-blame-ignore-revs Fix .git-blame-ignore-refs (#10682) 2024-07-26 12:47:01 +00:00
.gitattributes Display error message when viewed graph doesn't exist. (#11452) 2024-10-31 07:48:48 +00:00
.gitignore Fixing Enso projects classpath while updating to IGV 1.20 (#11195) 2024-10-01 13:48:50 +02:00
.ignore Refactoring: merge utils into prelude; merge workspaces. (#3151) 2021-11-10 14:36:08 +01:00
.jvmopts Update java formatter sbt plugin (#8543) 2023-12-15 14:45:23 +00:00
.node-version Vue dependency update, better selection performance, visible quotes in text inputs (#9204) 2024-03-06 15:34:07 +00:00
.pnpmfile.cjs Split ydoc server into separate module (#10735) 2024-08-08 12:12:05 +00:00
.prettierignore Remove download font scripts (#11317) 2024-10-14 16:11:42 +00:00
.prettierrc.yaml Edit prettier config (#10648) 2024-07-26 17:47:59 +10:00
.scalafmt.conf Bump SBT and Scalafmt (#1203) 2020-10-22 16:12:28 +02:00
build-config.yaml [CI] Provide latest FlatBuffers to the Engine build. (#9654) 2024-04-12 10:10:44 +00:00
build.sbt Ydoc native image (#10783) 2024-10-31 19:57:50 +00:00
Cargo.lock Remove download font scripts (#11317) 2024-10-14 16:11:42 +00:00
Cargo.toml Remove all usages of unstable rust features (#10813) 2024-08-22 14:09:17 +00:00
CHANGELOG-2021.md Clear Changelog (#10077) 2024-05-29 11:27:32 +00:00
CHANGELOG.md Consider additional self types (#11451) 2024-11-04 15:08:59 +00:00
clippy.toml Build script merge (#3743) 2022-10-10 23:38:48 +02:00
corepack.tgz Migrate to pnpm (#10422) 2024-07-05 11:13:04 +00:00
eslint.config.mjs Move documentation into documentable types (#11441) 2024-11-04 15:33:53 +00:00
flake.lock Google Analytics events for opening and closing the app, and opening and closing projects (#9779) 2024-04-25 11:33:59 +00:00
flake.nix chore(flake.nix): Add missing macOS-specific dependencies of enso-formatter (#11430) 2024-10-30 11:15:37 +00:00
LICENSE Set up the repository (#1) 2019-06-11 17:07:54 +01:00
package.json Add eslint-react-compiler (#11404) 2024-10-28 15:58:41 +03:00
pnpm-lock.yaml Add React compiler (#11405) 2024-10-31 12:10:22 +00:00
pnpm-workspace.yaml Unify Frontend App (#11287) 2024-10-11 18:23:02 +00:00
README.md Unify Frontend App (#11287) 2024-10-11 18:23:02 +00:00
RELEASES.md Add API for component groups (#3286) 2022-02-24 15:41:14 +03:00
run Build script: git-clean and cwd fixes (#8424) 2023-11-29 20:35:06 +01:00
run.cmd Build script fixes & improvements (#8285) 2023-11-23 21:19:31 +01:00
run.ps1 Build script fixes & improvements (#8285) 2023-11-23 21:19:31 +01:00
rust-toolchain.toml Rust bump, reduce dependencices (#10803) 2024-08-13 23:16:55 +00:00
rustfmt.toml Rust bump, reduce dependencices (#10803) 2024-08-13 23:16:55 +00:00
tsconfig.json Unify Frontend App (#11287) 2024-10-11 18:23:02 +00:00
vitest.workspace.ts Unify Frontend App (#11287) 2024-10-11 18:23:02 +00:00

Chat Actions Status Actions Status License License


Enso.org. Get insights you can rely on. In real time.

Enso is an award-winning interactive programming language with dual visual and textual representations. It is a tool that spans the entire stack, going from high-level visualization and communication to the nitty-gritty of backend services, all in a single language. Watch the following introduction video to learn what Enso is, and how it helps companies build data workflows in minutes instead of weeks.


Screenshot 2021-04-15 at 12 16 32

Enso's Features

Turning your data into knowledge is slow and error-prone. You cant trust tools that dont embrace best practices and provide quality assurance. Enso redefines the way you can work with your data: it is interactive, provides intelligent assistance, and was designed on a strong mathematical foundation, so you can always trust the results you get.

      Intelligent suggestions of possible next steps. Build workflows in minutes instead of weeks.
      Enso analyses the data, suggests possible next steps, and displays related help and examples. It lets you build dashboards, RPA workflows, and apps, with no coding required. Enso ships with a robust set of libraries, allowing you to work with local files, databases, HTTP services, and other applications in a seamless fashion.
      Learn more →
      Reproducible, trustworthy results.
      Versioning and visual data quality management allow you to trust the results that you get.
      Learn more →
      A powerful, purely functional language. Both visual and textual.
      Enso incorporates many recent innovations in data processing and programming language design to allow you to work interactively and trust the results that you get. It is a purely functional programming language with higher-order functions, user-defined algebraic datatypes, pattern-matching, and two equivalent representations that you can switch between on-demand.
      Learn more →
      Mix languages with close-to-zero interop overhead.
      Import any library from Enso, Java, JavaScript, R, or Python, and use functions, callbacks, and data types without any wrappers. Enso uses GraalVM to compile them to the same instruction set with a unified memory model.
      Learn more →
      A cutting-edge visualization engine.
      Enso is equipped with a highly-tailored WebGL visualization engine capable of displaying many millions of data points at 60 frames per second in a web browser. Currently, Enso includes a set of core data visualizations out of the box, and you can easily extend it with libraries such as D3.js, Three.js, Babylon.js, deck.gl, VTK.js, Potree, and many more.
      Learn more →
      Runs everywhere.
      Enso is available on macOS, Windows, and GNU/Linux, and the Enso IDE runs on web-native technologies. In time, you'll be able to run it in the web-browser, giving even your tablet and phone access to your data.
      Learn more →

Getting Started

An example Enso graph



Enso Source Code

If you want to start using Enso, please see the download links in the getting started section above. Alternatively, you can get the IDE here. This section is intended for people interested in contributing to the development of Enso.

Enso is a community-driven open source project which is, and will always be, open and free to use. Join us, help us to build it, and spread the word!


Project Components

Enso consists of several sub projects:

  • Enso Engine: The Enso Engine is the set of tools that implement the Enso language and its associated services. These include the Enso interpreter, a just-in-time compiler and runtime (both powered by GraalVM), and a language server that lets you inspect Enso code as it runs. These components can be used on their own as command line tools.

  • Enso IDE: The Enso IDE is a desktop application that allows working with the visual form of Enso. It consists of an Electron application, a high performance WebGL UI framework, and the searcher which provides contextual search, hints, and documentation for all of Enso's functionality.


License

The Enso Engine is licensed under the Apache 2.0, as specified in the LICENSE file. The Enso IDE is licensed under the AGPL 3.0, as specified in the LICENSE file.

This license set was chosen to provide you with complete freedom to use Enso, create libraries, and release them under any license of your choice, while also allowing us to release commercial products on top of the platform, including Enso Cloud and Enso Enterprise server managers.


Contributing to Enso

Enso is a community-driven open source project which is and will always be open and free to use. We are committed to a fully transparent development process and highly appreciate every contribution. If you love the vision behind Enso and you want to redefine the data processing world, join us and help us track down bugs, implement new features, improve the documentation or spread the word!

If you'd like to help us make this vision a reality, please feel free to join our chat, and take a look at our development and contribution guidelines. The latter describes all the ways in which you can help out with the project, as well as provides detailed instructions for building and hacking on Enso.

If you believe that you have found a security vulnerability in Enso, or that you have a bug report that poses a security risk to Enso's users, please take a look at our security guidelines for a course of action.


Enso's Design

If you would like to gain a better understanding of the principles on which Enso is based, or just delve into the why's and what's of Enso's design, please take a look in the docs/ folder. It is split up into subfolders for each component of Enso. You can view this same documentation in a rendered form at the developer docs website.

This folder also contains a document on Enso's design philosophy, that details the thought process that we use when contemplating changes or additions to the language.

This documentation will evolve as Enso does, both to help newcomers to the project understand the reasoning behind the code, and also to act as a record of the decisions that have been made through Enso's evolution.