Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bowbahdoe/run-java-code
https://github.com/bowbahdoe/run-java-code
Last synced: 7 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/bowbahdoe/run-java-code
- Owner: bowbahdoe
- License: apache-2.0
- Created: 2023-06-06T20:14:12.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-08-08T20:08:41.000Z (3 months ago)
- Last Synced: 2024-08-08T22:36:13.969Z (3 months ago)
- Language: TypeScript
- Size: 28.4 MB
- Stars: 19
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
- Security: SECURITY.md
Awesome Lists containing this project
README
# Run Java Code (in your browser)
This is now hosted at [https://run.mccue.dev](https://run.mccue.dev)
## What's it do?
This allows you to experiment with Java before you install
it locally, or in any other case where you might not have the compiler
available.
It has a number of features, including:
1. A nice, unobtrusive editor with syntax highlighting.
1. The ability to run against the latest stable, early access, and valhalla prototype JDKs.
1. A selection of libraries from Maven Central.
1. The ability to quickly load and save your code to a
GitHub [Gist][gist] and share it with your friends.
[gist]: https://gist.github.com/
## Architecture
A [React][react] frontend communicates with an [Axum][axum]
backend. [Docker][docker] containers are used to provide the various
compilers and tools as well as to help isolate them.
We hope that this frontend and backend stack is comfortable to
potential contributors! If you are interested in contributing, please
feel free to ask a question and we might even be able to point out
some useful resources.
[react]: https://reactjs.org/
[axum]: https://github.com/tokio-rs/axum
[docker]: https://www.docker.com/
## Resource Limits
### Network
There is no network connection between the compiler container and the
outside world.
### Memory
The amount of memory the compiler and resulting executable use is
limited by the container.
### Execution Time
The total compilation and execution time is limited by the container.
### Disk
This sandbox **does not** provide any disk space limits. It is
suggested to run the server such that the temp directory is a
space-limited. One bad actor may fill up this shared space, but it
should be cleaned when that request ends.
## Security Hall of Fame
A large set of thanks go to those individuals who have helped by
reporting security holes or other attack vectors against the
site. Each report helps us make the site better!
* Preliminary sandbox testing (PID limit) by Stefan O'Rear.
If you'd like to perform tests that you think might disrupt service of
the site, get in touch and we can create an isolated clone to
perform tests on! Once fixed, you can choose to be credited here.
## Development
### Build the UI
```
cd ui/frontend
yarn
yarn run watch # Will rebuild and watch for changes
```
If you don't need the backend running because you are only making
basic HTML/CSS/JS changes, directly open in your browser the built
`ui/frontend/build/index.html`.
### Build and run the server
```
cd ui
cargo run
```
There are some optional configuration parameters described in the
[ui README](./ui/README.md) which you may set in a `.env` file. The server will
run with no configuration, but in order to load and save gists a GitHub token
must be configured.
### Build or download the containers
```
cd compiler
./build.sh # If you want to test changes to the containers
./fetch.sh # If you just want the current site
```
## Deployment
* [Amazon EC2 (Ubuntu)](deployment/ubuntu.md)
## License
Licensed under either of
* Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
* MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)
at your option.