Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/apache/commons-rng

Apache Commons RNG (Pseudo-random number generators)
https://github.com/apache/commons-rng

distribution easy fast generator java random reference rng sampling shuffling

Last synced: 4 days ago
JSON representation

Apache Commons RNG (Pseudo-random number generators)

Awesome Lists containing this project

README 

        



Apache Commons RNG

===================



[![Java CI](https://github.com/apache/commons-rng/actions/workflows/maven.yml/badge.svg)](https://github.com/apache/commons-rng/actions/workflows/maven.yml)

[![Coverage Status](https://codecov.io/gh/apache/commons-rng/branch/master/graph/badge.svg)](https://app.codecov.io/gh/apache/commons-rng)

[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=commons-rng&metric=alert_status)](https://sonarcloud.io/dashboard?id=commons-rng)

[![Maven Central](https://maven-badges.herokuapp.com/maven-central/org.apache.commons/commons-rng-simple/badge.svg)](https://maven-badges.herokuapp.com/maven-central/org.apache.commons/commons-rng-simple/)

[![Javadocs](https://javadoc.io/badge/org.apache.commons/commons-rng-simple/1.6.svg)](https://javadoc.io/doc/org.apache.commons/commons-rng-simple/1.6)



The Apache Commons RNG project provides pure-Java implementation of pseudo-random generators.



Documentation

-------------



More information can be found on the [Apache Commons RNG homepage](https://commons.apache.org/proper/commons-rng). The Javadoc for each of the modules can be browsed:



- [Commons RNG Client API](https://commons.apache.org/proper/commons-rng/commons-rng-client-api/apidocs/)

- [Commons RNG Core](https://commons.apache.org/proper/commons-rng/commons-rng-core/apidocs/)

- [Commons RNG Simple](https://commons.apache.org/proper/commons-rng/commons-rng-simple/apidocs/)

- [Commons RNG Sampling](https://commons.apache.org/proper/commons-rng/commons-rng-sampling/apidocs/)



Questions related to the usage of Apache Commons RNG should be posted to the [user mailing list](https://commons.apache.org/mail-lists.html).



Getting the latest release

--------------------------

You can download source and binaries from our [download page](https://commons.apache.org/proper/commons-rng/download_rng.cgi).



Alternatively, you can pull it from the central Maven repositories:



```xml



  org.apache.commons

  commons-rng-simple

  1.6



  org.apache.commons

  commons-rng-sampling

  1.6



```



Building

--------



Building requires a Java JDK and [Apache Maven](https://maven.apache.org/).

The required Java version is found in the `pom.xml` as the `maven.compiler.source` property.



From a command shell, run `mvn` without arguments to invoke the default Maven goal to run all tests and checks.



Contributing

------------



We accept Pull Requests via GitHub. The [developer mailing list](https://commons.apache.org/mail-lists.html) is the main channel of communication for contributors.

There are some guidelines which will make applying PRs easier for us:

+ No tabs! Please use spaces for indentation.

+ Respect the existing code style for each file.

+ Create minimal diffs - disable on save actions like reformat source code or organize imports. If you feel the source code should be reformatted create a separate PR for this change.

+ Provide JUnit tests for your changes and make sure your changes don't break any existing tests by running ```mvn```.



If you plan to contribute on a regular basis, please consider filing a [contributor license agreement](https://www.apache.org/licenses/#clas).

You can learn more about contributing via GitHub in our [contribution guidelines](CONTRIBUTING.md).



License

-------

This code is licensed under the [Apache License v2](https://www.apache.org/licenses/LICENSE-2.0).



See the `NOTICE` file for required notices and attributions.



Donating

--------

You like Apache Commons RNG? Then [donate back to the ASF](https://www.apache.org/foundation/contributing.html) to support development.



Additional Resources

--------------------



+ [Apache Commons Homepage](https://commons.apache.org/)

+ [Apache Issue Tracker (JIRA)](https://issues.apache.org/jira/browse/RNG)

+ [Apache Commons Slack Channel](https://the-asf.slack.com/archives/C60NVB8AD)

+ [Apache Commons Twitter Account](https://twitter.com/ApacheCommons)



Apache Commons Components

-------------------------



Please see the [list of components](https://commons.apache.org/components.html)