search

bazelbuild / starlark

Starlark Language
Apache License 2.0
2.42k stars 160 forks source link

improve starlark-in-java installation documentation #24

Open josharian opened 5 years ago

josharian commented 5 years ago

Both the Go and the Rust implementation of starlark have installation instructions. The Java implementation does not. It'd be nice to fill out the Java installation docs. It's not obvious to me where those docs belong (here? in a readme in https://github.com/bazelbuild/bazel/tree/master/src/main/java/com/google/devtools/skylark? in a separate/new repo just for java starlark?), but it'd be nice to have them somewhere.

laurentlb commented 5 years ago

Java implementation is not easy to reuse due to dependencies on Bazel. Tracking bug: https://github.com/bazelbuild/bazel/issues/2367

As part of the cleanup, the interface might change. Once we have a clear separation, we'll provide documentation for it.

laurentlb commented 5 years ago

Instructions if you want to experiment with it:

$ git clone https://github.com/bazelbuild/bazel.git
$ cd bazel
$ bazel build src/main/java/com/google/devtools/starlark:Starlark
$ bazel-bin/src/main/java/com/google/devtools/starlark/Starlark

Edit. updated the last commands (thanks to Josh)

alandonovan commented 3 years ago

The Java implementation now has no dependencies on Bazel proper, and now uses the java.starlark.net domain for package names, though it still lives in the Bazel repository and will do continue to do so at least until the interface has been truly stable for months.

$ git clone https://github.com/bazelbuild/bazel.git
$ cd bazel
$ bazel run src/main/java/net/starlark/java/cmd/starlark
gl-yziquel commented 11 months ago

Any update, in 2023, on this issue ?