Jay Taylor's notes
back to listing indexringo shell no longer starts · Issue #383 · ringo/ringojs
[web search]-
Why GitHub?
- Enterprise
-
Explore
- Marketplace
-
Pricing
Join GitHub today
GitHub is home to over 36 million developers working together to host and review code, manage projects, and build software together.
Sign upREADME.md
RingoJS
Ringo is a JavaScript platform built on the JVM and optimized for server-side applications. It's based on the Mozilla Rhino JavaScript engine.
It adds a number of features to Rhino that make it suitable for real-world, large-scale application development:
- A fast, auto-reloading, and CommonJS-compliant module loader.
- A rich set of modules covering I/O, logging, development tools and much more.
- Support for blocking and non-blocking I/O.
- Scalable HTTP server based on the Jetty project.
- Support for CommonJS packages to install or write additional software components.
For more information, visit the RingoJS web site: https://ringojs.org/
Download and Installation
Download the latest precompiled release from the download page. Extract the archive and add the ringojs/bin
directory to your local PATH
for convinience.
If you use the Homebrew package manager on MacOS, you can use the ringojs formula: brew install ringojs
Verify Releases
Releases of RingoJS will be signed with one of the following GPG keys:
- 1.2.1 and newer: Philipp Naderer-Puiu <philipp@naderer-puiu.at>
DE2A A9A1 B018 6C2F 622F D9EF 3F47 C28B 23EB 3072
- 1.2.0 and older: Philipp Naderer <philipp.naderer@gmail.com>
8FF2 26B7 F268 547B 176F ABAC F312 313B 5CBC 0883
Building from Source
It is recommended but not strictly required to add the ringojs bin directory to your PATH environment variable. If you don't you'll have to type the full path to the bin/ringo command in the examples below.
To start the Ringo shell, just run the ringo command without any arguments:
ringo
To run a script simply pass it to ringo on the command line. For example, to run the Ringo test suite:
ringo test/all.js
Use the basic ringo-admin command to create a new web application or install packages. To create a blank Ringo web app:
ringo-admin create [appdir]
To install a package from a zip URL:
ringo-admin install [packageurl]
Installing a package manager
Ringo does not ship with a built-in package manager.
An easy way to manage packages and their dependencies is the evolving Ringo package manager rp.
The main benefit of rp over ringo-admin
is that rp downloads dependencies defined in the packages descriptors.
rp can install any package available in its online registry.
To install rp itself you can use the ringo-admin tool:
ringo-admin install grob/rp
For more information visit the rp documentation wiki.
Learning more
If you have questions visit https://ringojs.org/ or join the mailing list at https://groups.google.com/group/ringojs.
Supporters
JetBrains
JetBrains sponsored an Open Source license for IntelliJ IDEA to create and maintain Ringo. Thanks for your continuous support!
A huge salute to ORF.at for supporting this projects over the years!