https://github.com/reactiverse/reactiverse-child-process
Child Process extension for Vert.x
https://github.com/reactiverse/reactiverse-child-process
Last synced: 20 days ago
JSON representation
Child Process extension for Vert.x
- Host: GitHub
- URL: https://github.com/reactiverse/reactiverse-child-process
- Owner: reactiverse
- License: apache-2.0
- Created: 2015-11-01T22:47:13.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2025-06-05T13:08:47.000Z (8 months ago)
- Last Synced: 2025-07-03T01:43:00.836Z (7 months ago)
- Language: Java
- Homepage:
- Size: 1.06 MB
- Stars: 52
- Watchers: 10
- Forks: 11
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE-aslv20.html
Awesome Lists containing this project
README
## Child Process extension for Vert.x
[](https://github.com/reactiverse/reactiverse-child-process/actions/workflows/ci.yml)
Spawn child processes from Vert.x.
Based on https://github.com/brettwooldridge/NuProcess _Low-overhead, non-blocking I/O, external Process implementation for Java_.
## What for ?
[Vert.x 5](http://vertx.io)
## Using Child Process
To use Child Process, add the following dependency to the _dependencies_ section of your build descriptor:
* Maven (in your `pom.xml`):
```xml
io.reactiverse
childprocess-vertx-ext
2.0.0
```
* Gradle (in your `build.gradle` file):
```groovy
dependencies {
compile 'io.reactiverse:childprocess-vertx-ext:2.0.0'
}
```
Spawn child processes from Vert.x:
```java
Process
.create(vertx, "cat")
.startHandler(process -> {
process.exitHandler(code -> {
System.out.println("Process exited: " + code);
});
process.stdout().handler(buf -> {
System.out.println("Process wrote: " + buf);
});
StreamOutput stdin = process.stdin();
stdin.write(Buffer.buffer("hello"));
stdin.close();
}).start();
```
## Web-site docs
* [Java docs](http://www.julienviet.com/childprocess-vertx-ext/guide/java/index.html)
## Snapshots
Use the dependency
```xml
io.reactiverse
childprocess-vertx-ext
2.0.0
```
Snapshots are deployed in Sonatype OSS repository: TBD.
## License
Apache License - Version 2.0
## Documentation
The online and published documentation is in `/docs` and is served by GitHub pages with Jekyll.
You can find the actual guide source in [src/main/docs/index.md](src/main/docs/index.md). At compilation time, this
source generates the `jekyll/guide/java/index.md`.
The current documentation is in `/jekyll` and can be preview using Docker and your browser
* generate the documentation
** `mvn compile` to generate `jekyll/guide/java/index.md`
** `mvn site` to generate the javadoc in `jekyll/apidocs`
* run Jekyll
** `cd jekyll`
** `docker-compose up`
* open your browser at http://localhost:4000