Hybrid visual and textual functional programming.
Go to file
Paweł Grabarz 8bc3ebd70a
Implement nested widget overrides (#6878)
Implements #6792
Fixes #6715
Fixes #6052
Fixes #5689

The dynamic dropdown widgets entries now can specify additional widget configuration as a list of `parameters` of the inner method call. That allows for creating smarter widgets within nested constructors, taking the outer widget's context into account.

<img width="772" alt="image" src="https://github.com/enso-org/enso/assets/919491/97c70654-9170-4cf0-ae4d-2c25c74caa96">

With the changes to the serialization logic, I have also adressed issues related to automatic label generation for both static and dynamic dropdown entries. For access chains (e.g. `Foo.Bar.Baz_Qux`), the label will now always contain only the last segment, and all underscores will be removed (e.g. `Baz Qux`). This also applies to dynamic entries where the label is not explicitly specified in method annotation.

<img width="265" alt="image" src="https://github.com/enso-org/enso/assets/919491/1abe6c77-010b-4622-b252-97cd1543cb48">

Additionaly, now the dynamic entries containing constructors will also be resolved within suggestion database, allowing us to automatically insert relevant import, shorten the actually used expression and wrap it with parentheses if required. That was required for nested widgets to show up, as we depend on properly resolved argument names to show them. The widget definitions in annotations no longer need to wrap the expressions manually. Instead, the constructors used in dropdown entries should be specified using fully qualified names, similarly to how we do it in tag values.

CC @jdunkerley - The dropdown entries containing just a constructor will no longer need added parentheses around them. Instead, the constructors should be specified using fully qualified names, similarly to how we do it in tag values.

<img width="389" alt="image" src="https://github.com/enso-org/enso/assets/919491/19944b5b-d0c7-43ac-bf17-ca1556e0b3f0">

Note that currently the import resolution is attempted even if the used constructor is is not specified using a fully qualified name. To accomplish that, the IDE is performing a more expensive search through whole suggestion database for matching type and module (e.g. in example above, we are searching for a match for `Aggregate_Column.First`). If there are multiple potential matches due to a name collision, it is undefined which one would be preferred. Effectively one will be picked at random. To avoid that, the libraries should over time transition to using fully qualified names wherever possible.

# Important Notes
I have removed the `payload` field from the span tree, and with it the generic argument on its nodes. This was already partially done on the branch with new design, on which I also had a few changes that turned out to be useful for this PR. So I pulled it in as well. It is a nice simplification that will ease our further work on removing the span-tree altogether. The biggest impact it had was on the node output port, where I had to store the port data outside of the span tree. This is the approach we would be taking when transitioning to AST anyway.
2023-05-30 17:45:31 +00:00
.cargo Bump rustc to nightly-2023-01-12 (#4053) 2023-02-02 23:05:25 +00:00
.github Add logs section to the bug template (#6798) 2023-05-22 15:35:06 +00:00
.idea/runConfigurations New documentation parser (#5917) 2023-03-15 15:43:51 +00:00
actions/setup-build misc: bump wasm-pack (#3983) 2022-12-14 18:45:39 +01:00
app Implement nested widget overrides (#6878) 2023-05-30 17:45:31 +00:00
build Update GraalVM to 22.3.1 JDK17 (#6750) 2023-05-24 10:39:08 +02:00
distribution Runtime check of ascribed types (#6790) 2023-05-30 11:07:26 +02:00
docs Add project creation time to project metadata (#6780) 2023-05-22 13:40:10 +00:00
engine Runtime check of ascribed types (#6790) 2023-05-30 11:07:26 +02:00
integration-test Show spinner when opening/creating a project, take #2 (#6827) 2023-05-26 18:20:07 +02:00
lib Implement nested widget overrides (#6878) 2023-05-30 17:45:31 +00:00
project sbt runEngineDistribution --debug to ease debuggging (#6745) 2023-05-18 15:00:52 +02:00
std-bits Allow casting a Mixed column into a concrete type (#6777) 2023-05-26 13:25:53 +00:00
test Runtime check of ascribed types (#6790) 2023-05-30 11:07:26 +02:00
tools Update GraalVM to 22.3.1 JDK17 (#6750) 2023-05-24 10:39:08 +02:00
.eslintignore Shaders precompilation (#4003) 2023-01-27 01:09:09 +01:00
.git-blame-ignore-revs Layer/Rectangle improvements (#6247) 2023-04-19 09:06:20 -07:00
.gitignore remove package-lock.json from gitignore; add unitl-now ignored files (#5954) 2023-03-15 16:54:38 +01:00
.ignore Refactoring: merge utils into prelude; merge workspaces. (#3151) 2021-11-10 14:36:08 +01:00
.jvmopts Bump scalac to 2.13.5 (#1531) 2021-03-01 16:35:57 +00:00
.node-version Use .node-version for pinning Node.js version (#6057) 2023-03-23 12:00:08 +00:00
.prettierignore Review File/Data read and read_text warnings (#5799) 2023-03-06 03:43:38 +00:00
.prettierrc.yaml Fix prettier config; run prettier (#6132) 2023-03-31 14:49:34 +02:00
.scalafmt.conf Bump SBT and Scalafmt (#1203) 2020-10-22 16:12:28 +02:00
build-config.yaml Show spinner when opening/creating a project, take #2 (#6827) 2023-05-26 18:20:07 +02:00
build.sbt Update GraalVM to 22.3.1 JDK17 (#6750) 2023-05-24 10:39:08 +02:00
Cargo.lock Add dashboard button (#6474) 2023-05-23 14:23:23 +00:00
Cargo.toml Fix list editor panics during insertion (#6540) 2023-05-17 18:53:51 +00:00
CHANGELOG.md Runtime check of ascribed types (#6790) 2023-05-30 11:07:26 +02:00
clippy.toml Build script merge (#3743) 2022-10-10 23:38:48 +02:00
LICENSE Set up the repository (#1) 2019-06-11 17:07:54 +01:00
package-lock.json Enable require-jsdoc lint and add two lints related to React (#6403) 2023-05-19 19:55:29 +00:00
package.json Run prettier on CHANGELOG.md; bump prettier (#6571) 2023-05-05 06:52:22 +02:00
README.md Link to new 101 tutorial and not deprecated one. (#6793) 2023-05-23 02:14:37 +02:00
RELEASES.md Add API for component groups (#3286) 2022-02-24 15:41:14 +03:00
run feat(183557950): Add ProjectsGrid View for Cloud Dashboard (#3857) 2022-12-04 05:41:56 +01:00
run.cmd Cloud dispatch & fixes (#3843) 2022-11-09 00:15:26 +01:00
run.ps1 Release process (#3909) 2022-12-02 02:56:22 +01:00
rust-toolchain.toml Bump rustc to nightly-2023-01-12 (#4053) 2023-02-02 23:05:25 +00:00
rustfmt.toml Build script merge (#3743) 2022-10-10 23:38:48 +02: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 visualisation 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.