Go to file
Godfrey Chan 33df62d90e
[RIP] Add deprecation message
2020-10-23 15:27:47 -07:00
crates allow private constructor. also add docopt example 2018-06-14 00:09:09 -07:00
examples Update dependencies 2019-07-30 11:25:43 -07:00
ruby Update dependencies 2019-07-30 11:25:43 -07:00
scripts Improve Vagrant release tests 2017-10-10 20:02:36 -07:00
src Revert "Allow calling init seperately" 2019-07-29 13:12:56 -07:00
.appveyor.yml Allow arbitrary attributes for methods 2018-06-16 09:23:54 -04:00
.gitignore Don't lock Gemfiles 2017-10-10 16:16:48 -07:00
.travis.yml Bump Bundler version 2019-07-30 10:52:19 -07:00
CHANGELOG.md v0.7.5 2018-06-04 16:15:00 -04:00
Cargo.toml Allow arbitrary attributes for methods 2018-06-16 09:23:54 -04:00
LICENSE Add LICENSE 2017-02-16 14:42:06 -08:00
README.md [RIP] Add deprecation message 2020-10-23 15:27:47 -07:00
RELEASE.md Fix numbering in RELEASE.md 2017-04-24 10:09:48 -07:00
Rakefile Allow arbitrary attributes for methods 2018-06-16 09:23:54 -04:00
Vagrantfile Add scripts dir, renable Vagrant provisioning 2017-03-03 12:21:57 -08:00

README.md

Travis Build Status AppVeyor Build Status

Helix

⚠️ Deprecated ⚠️

Sadly, we have made the decision to deprecate this project. While we had hoped to bootstrap the project to a point where it could flourish as a community project, unfortunately we ran into a number of roadblocks along the way, along with the need for significant architectural overhaul. While these issues are solvable on a technical level, doing so correctly requires more resources than we have been able to provide and progress has stalled.

One of our goals was also to integrate our own Skylight agent with Helix, aligning the company's priorities with the project. While the Skylight agent is still written in Rust with a thin layer of C bindings (which is the part Helix would replace), we were not able to get the project to the point where we felt comfortable running it on our customer's servers. We did not identify any specific blockers that would prevent us from doing this, but ultimate, we did not have the necessary time and resources to realize this.

Since we are a small team, it is unlikely that we will be able to provide the necessary investment in the foreseeable future to achieve our ambitions for the project. At this point, we believe it is in everyone's best interest to formally deprecate the project, accurately reflecting its effective state. Meanwhile, others in the Ruby and Rust communities have continued to explore in the adjacent research areas. Some of them have made great progress and brought new ideas and innovations to the table. We look forward to seeing these new ideas come to fruition and fill the void we are leaving.

Helix allows you to write Ruby classes in Rust without having to write the glue code yourself.

ruby! {
    class Console {
        def log(string: String) {
            println!("LOG: {}", string);
        }
    }
}
$ rake build
$ bundle exec irb
>> require "console"
>> Console.log("I'm in your Rust")
LOG: I'm in your Rust
 => nil

Why Helix?

Read the Introducing Helix blog post for a quick introduction to the project!

Getting Started

https://usehelix.com/getting_started

Demos

https://usehelix.com/demos

Roadmap

https://usehelix.com/roadmap

Compatibility

Helix has been tested with the following, though other combinations may also work.

  • cargo 0.18.0 (fe7b0cdcf 2017-04-24)
  • rustc 1.17.0 (56124baa9 2017-04-24)
  • ruby 2.4.1p111 (2017-03-22 revision 58053) [x86_64-darwin16]
  • Bundler version 1.14.6

Contributing

If you'd like to experiment with Helix, you can start with some of the examples in this repository.

Clone and download the Helix repository:

$ git clone https://github.com/tildeio/helix
$ cd helix

Navigate to the console example folder and bundle your Gemfile:

$ cd examples/console
$ bundle install

Run rake irb to build and start irb:

$ bundle exec rake irb

Try running some of the methods defined in examples/console/src/lib.rs:

> c = Console.new
Console { helix: VALUE(0x7fdacc19a6a0) }
 =>
> c.hello
hello
 => nil
> c.loglog('hello', 'world')
hello world
 => nil