commit | 90a0c979acf61d32283ecce3d6b096c066540cb3 | [log] [tgz] |
---|---|---|
author | Alex Bozarth <ajbozart@us.ibm.com> | Tue Jan 23 12:21:27 2018 -0800 |
committer | Alex Bozarth <ajbozart@us.ibm.com> | Tue Jan 23 12:21:54 2018 -0800 |
tree | 03bca56faa1372e33140450c42a6db0a737d749f | |
parent | 3440857a1f844f607215475d353e749b62819cac [diff] |
[LIVY-141][LIVY-175][DOCS] Update javadocs and scaladocs and include in Docs build [LIVY-141](https://issues.apache.org/jira/browse/LIVY-141) [LIVY-175](https://issues.apache.org/jira/browse/LIVY-175) Adding javadocs to Livy: - Add ability to build Livy javadocs - Update current javadoc comments to address build errors and warnings - Add more javadoc comments to fully describe API - Include public API javadocs and scaladocs in Livy Documentation Noted Remaining Issues: - Since only the public javadocs are build with the Livy Docs not all javadoc warnings in other modules have been addressed. - There are still some warnings in the Scala API scaladocs build due to the docs not linking to an external lib for referenced scala lib classes, this does not break the build in any way. - Scaladocs is not supported for Livy as a whole. With the update to Scala 2.11 many scaladoc warnings were upgraded to error and Livy fundamentally can't fix them. Author: Alex Bozarth <ajbozart@us.ibm.com> Closes #38 from ajbozarth/javadoc. (cherry picked from commit fc22da91948bbf3d0629b4f74722e21a8687288d) Signed-off-by: Alex Bozarth <ajbozart@us.ibm.com>
Apache Livy is an open source REST interface for interacting with Apache Spark from anywhere. It supports executing snippets of code or programs in a Spark context that runs locally or in Apache Hadoop YARN.
Pull requests are welcomed! But before you begin, please check out the Contributing section on the Community page of our website.
Guides and documentation on getting started using Livy, example code snippets, and Livy API documentation can be found at livy.incubator.apache.org.
To build Livy, you will need:
Debian/Ubuntu:
maven
package or maven3 tarball)Redhat/CentOS:
maven
package or maven3 tarball)MacOS:
Required python packages for building Livy:
To run Livy, you will also need a Spark installation. You can get Spark releases at https://spark.apache.org/downloads.html.
Livy requires at least Spark 1.6 and supports both Scala 2.10 and 2.11 builds of Spark, Livy will automatically pick repl dependencies through detecting the Scala version of Spark.
Livy also supports Spark 2.0+ for both interactive and batch submission, you could seamlessly switch to different versions of Spark through SPARK_HOME
configuration, without needing to rebuild Livy.
Livy is built using Apache Maven. To check out and build Livy, run:
git clone https://github.com/apache/incubator-livy.git cd livy mvn package
By default Livy is built against Apache Spark 1.6.2, but the version of Spark used when running Livy does not need to match the version used to build Livy. Livy internally uses reflection to mitigate the gaps between different Spark versions, also Livy package itself does not contain a Spark distribution, so it will work with any supported version of Spark (Spark 1.6+) without needing to rebuild against specific version of Spark.