mirror of
https://github.com/apache/zeppelin
synced 2026-05-24 09:38:26 +00:00
This is the initial PR for an R Interpreter for Zeppelin. There's still some work to be done (e.g., tests), but its useable, it brings to Zeppelin features from R like its library of statistics and machine learning packages, as well as advanced interactive visualizations. So I'd like to open it up for others to comment and/or become involved. Summary: - There are two interpreters, one emulates a REPL, the other uses knitr to weave markdown and formatted R output. The two interpreters share a single execution environment. - Visualisations: Besides R's own graphics, this also supports interactive visualizations with googleVis and rCharts. I am working on htmlwidgets (almost done) with the author of that package, and a next-step project is to get Shiny/ggvis working. Sometimes, a visualization won't load until the page is reloaded. I'm not sure why this is. - Licensing: To talk to R, this integrates code forked from rScala. rScala was released with a BSD-license option, and the author's permission was obtained. - Spark: Getting R to share a single spark context with the Spark interpreter group is going to be a project. For right now, the R interpreters live in their own "r" interpreter group, and new spark contexts are created on startup. - Zeppelin Context: Not yet integrated, in significant part because there's no ZeppelinContext to talk to until it lives in the Spark interpreter group. - Documentation: A notebook is included that demonstrates what the interpreter does and how to use it. - Tests: Working on it... P.S.: This is my first PR on a project of this size; let me know what I messed up and I'll try to fix it ASAP. Author: Amos Elb <amos.elberg@me.com> Author: Amos B. Elberg <amos.elberg@me.com> Closes #208 from elbamos/rinterpreter and squashes the following commits:ffc1a25[Amos Elb] Fix rat issuea08ec5b[Amos B. Elberg] R Interpreter
282 lines
11 KiB
XML
282 lines
11 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!--
|
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
|
contributor license agreements. See the NOTICE file distributed with
|
|
this work for additional information regarding copyright ownership.
|
|
The ASF licenses this file to You under the Apache License, Version 2.0
|
|
(the "License"); you may not use this file except in compliance with
|
|
the License. You may obtain a copy of the License at
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
-->
|
|
|
|
<!DOCTYPE module PUBLIC
|
|
"-//Puppy Crawl//DTD Check Configuration 1.3//EN"
|
|
"http://www.puppycrawl.com/dtds/configuration_1_3.dtd">
|
|
|
|
<!-- This is a checkstyle configuration file. For descriptions of what the
|
|
following rules do, please see the checkstyle configuration page at http://checkstyle.sourceforge.net/config.html -->
|
|
|
|
<module name="Checker">
|
|
|
|
<module name="FileTabCharacter">
|
|
<!-- Checks that there are no tab characters in the file. -->
|
|
</module>
|
|
|
|
<module name="NewlineAtEndOfFile">
|
|
<property name="lineSeparator" value="lf" />
|
|
</module>
|
|
|
|
<module name="RegexpSingleline">
|
|
<!-- Checks that FIXME is not used in comments. TODO is preferred. -->
|
|
<property name="format" value="((//.*)|(\*.*))FIXME" />
|
|
<property name="message"
|
|
value='TODO is preferred to FIXME. e.g. "TODO(johndoe): Refactor when v2 is released."' />
|
|
</module>
|
|
|
|
<module name="RegexpSingleline">
|
|
<!-- Checks that TODOs are named. (Actually, just that they are followed
|
|
by an open paren.) -->
|
|
<property name="format" value="((//.*)|(\*.*))TODO[^(]" />
|
|
<property name="message"
|
|
value='All TODOs should be named. e.g. "TODO(johndoe): Refactor when v2 is released."' />
|
|
</module>
|
|
|
|
<!-- <module name="JavadocPackage"> - Checks that each Java package has
|
|
a Javadoc file used for commenting. Only allows a package-info.java, not
|
|
package.html. </module> -->
|
|
<!-- All Java AST specific tests live under TreeWalker module. -->
|
|
<module name="TreeWalker">
|
|
|
|
<!-- IMPORT CHECKS -->
|
|
|
|
<module name="RedundantImport">
|
|
<!-- Checks for redundant import statements. -->
|
|
<property name="severity" value="error" />
|
|
</module>
|
|
<!-- <module name="ImportOrder"> Checks for out of order import statements
|
|
<property name="severity" value="warning"/> <property name="groups" value="com.google,android,junit,net,org,java,javax"/>
|
|
This ensures that static imports go first <property name="option" value="top"/>
|
|
<property name="tokens" value="STATIC_IMPORT, IMPORT"/> </module> -->
|
|
<!-- JAVADOC CHECKS -->
|
|
|
|
<!-- Checks for Javadoc comments. -->
|
|
<!-- See http://checkstyle.sf.net/config_javadoc.html -->
|
|
<module name="JavadocMethod">
|
|
<property name="scope" value="protected" />
|
|
<property name="severity" value="warning" />
|
|
<property name="allowMissingJavadoc" value="true" />
|
|
<property name="allowMissingParamTags" value="true" />
|
|
<property name="allowMissingReturnTag" value="true" />
|
|
<property name="allowMissingThrowsTags" value="true" />
|
|
<property name="allowThrowsTagsForSubclasses" value="true" />
|
|
<property name="allowUndeclaredRTE" value="true" />
|
|
</module>
|
|
|
|
<module name="JavadocType">
|
|
<property name="scope" value="protected" />
|
|
<property name="severity" value="error" />
|
|
</module>
|
|
|
|
<module name="JavadocStyle">
|
|
<property name="severity" value="warning" />
|
|
</module>
|
|
|
|
<!-- NAMING CHECKS -->
|
|
|
|
<!-- Item 38 - Adhere to generally accepted naming conventions -->
|
|
|
|
<module name="PackageName">
|
|
<!-- Validates identifiers for package names against the supplied expression. -->
|
|
<!-- Here the default checkstyle rule restricts package name parts to
|
|
seven characters, this is not in line with common practice at Google. -->
|
|
<property name="format" value="^[a-z]+(\.[a-z][a-z0-9]{1,})*$" />
|
|
<property name="severity" value="warning" />
|
|
</module>
|
|
|
|
<module name="TypeNameCheck">
|
|
<!-- Validates static, final fields against the expression "^[A-Z][a-zA-Z0-9]*$". -->
|
|
<metadata name="altname" value="TypeName" />
|
|
<property name="severity" value="warning" />
|
|
</module>
|
|
|
|
<module name="ConstantNameCheck">
|
|
<!-- Validates non-private, static, final fields against the supplied
|
|
public/package final fields "^[A-Z][A-Z0-9]*(_[A-Z0-9]+)*$". -->
|
|
<metadata name="altname" value="ConstantName" />
|
|
<property name="applyToPublic" value="true" />
|
|
<property name="applyToProtected" value="true" />
|
|
<property name="applyToPackage" value="true" />
|
|
<property name="applyToPrivate" value="false" />
|
|
<property name="format" value="^([A-Z][A-Z0-9]*(_[A-Z0-9]+)*|FLAG_.*)$" />
|
|
<message key="name.invalidPattern"
|
|
value="Variable ''{0}'' should be in ALL_CAPS (if it is a constant) or be private (otherwise)." />
|
|
<property name="severity" value="warning" />
|
|
</module>
|
|
|
|
<module name="StaticVariableNameCheck">
|
|
<!-- Validates static, non-final fields against the supplied expression
|
|
"^[a-z][a-zA-Z0-9]*_?$". -->
|
|
<metadata name="altname" value="StaticVariableName" />
|
|
<property name="applyToPublic" value="true" />
|
|
<property name="applyToProtected" value="true" />
|
|
<property name="applyToPackage" value="true" />
|
|
<property name="applyToPrivate" value="true" />
|
|
<property name="format" value="^[a-z][a-zA-Z0-9]*_?$" />
|
|
<property name="severity" value="warning" />
|
|
</module>
|
|
|
|
<module name="MemberNameCheck">
|
|
<!-- Validates non-static members against the supplied expression. -->
|
|
<metadata name="altname" value="MemberName" />
|
|
<property name="applyToPublic" value="true" />
|
|
<property name="applyToProtected" value="true" />
|
|
<property name="applyToPackage" value="true" />
|
|
<property name="applyToPrivate" value="true" />
|
|
<property name="format" value="^[a-z][a-zA-Z0-9]*$" />
|
|
<property name="severity" value="warning" />
|
|
</module>
|
|
|
|
<module name="MethodNameCheck">
|
|
<!-- Validates identifiers for method names. -->
|
|
<metadata name="altname" value="MethodName" />
|
|
<property name="format" value="^[a-z][a-zA-Z0-9]*(_[a-zA-Z0-9]+)*$" />
|
|
<property name="severity" value="warning" />
|
|
</module>
|
|
|
|
<module name="ParameterName">
|
|
<!-- Validates identifiers for method parameters against the expression
|
|
"^[a-z][a-zA-Z0-9]*$". -->
|
|
<property name="severity" value="warning" />
|
|
</module>
|
|
|
|
<module name="LocalFinalVariableName">
|
|
<!-- Validates identifiers for local final variables against the expression
|
|
"^[a-z][a-zA-Z0-9]*$". -->
|
|
<property name="severity" value="warning" />
|
|
</module>
|
|
|
|
<module name="LocalVariableName">
|
|
<!-- Validates identifiers for local variables against the expression
|
|
"^[a-z][a-zA-Z0-9]*$". -->
|
|
<property name="severity" value="warning" />
|
|
</module>
|
|
|
|
|
|
<!-- LENGTH and CODING CHECKS -->
|
|
|
|
<module name="LineLength">
|
|
<!-- Checks if a line is too long. -->
|
|
<property name="max"
|
|
value="${com.puppycrawl.tools.checkstyle.checks.sizes.LineLength.max}"
|
|
default="100" />
|
|
<property name="severity" value="error" />
|
|
|
|
<!-- The default ignore pattern exempts the following elements: - import
|
|
statements - long URLs inside comments -->
|
|
|
|
<property name="ignorePattern"
|
|
value="${com.puppycrawl.tools.checkstyle.checks.sizes.LineLength.ignorePattern}"
|
|
default="^(package .*;\s*)|(import .*;\s*)|( *\* *https?://.*)$" />
|
|
</module>
|
|
|
|
<module name="LeftCurly">
|
|
<!-- Checks for placement of the left curly brace ('{'). -->
|
|
<property name="severity" value="warning" />
|
|
</module>
|
|
|
|
<module name="RightCurly">
|
|
<!-- Checks right curlies on CATCH, ELSE, and TRY blocks are on the same
|
|
line. e.g., the following example is fine: <pre> if { ... } else </pre> -->
|
|
<!-- This next example is not fine: <pre> if { ... } else </pre> -->
|
|
<property name="option" value="same" />
|
|
<property name="severity" value="warning" />
|
|
</module>
|
|
|
|
<!-- Checks for braces around if and else blocks -->
|
|
<module name="NeedBraces">
|
|
<property name="severity" value="warning" />
|
|
<property name="tokens"
|
|
value="LITERAL_IF, LITERAL_ELSE, LITERAL_FOR, LITERAL_WHILE, LITERAL_DO" />
|
|
</module>
|
|
|
|
<module name="UpperEll">
|
|
<!-- Checks that long constants are defined with an upper ell. -->
|
|
<property name="severity" value="error" />
|
|
</module>
|
|
|
|
<module name="FallThrough">
|
|
<!-- Warn about falling through to the next case statement. Similar to
|
|
javac -Xlint:fallthrough, but the check is suppressed if a single-line comment
|
|
on the last non-blank line preceding the fallen-into case contains 'fall
|
|
through' (or some other variants which we don't publicized to promote consistency). -->
|
|
<property name="reliefPattern"
|
|
value="fall through|Fall through|fallthru|Fallthru|falls through|Falls through|fallthrough|Fallthrough|No break|NO break|no break|continue on" />
|
|
<property name="severity" value="error" />
|
|
</module>
|
|
|
|
|
|
<!-- MODIFIERS CHECKS -->
|
|
|
|
<module name="ModifierOrder">
|
|
<!-- Warn if modifier order is inconsistent with JLS3 8.1.1, 8.3.1, and
|
|
8.4.3. The prescribed order is: public, protected, private, abstract, static,
|
|
final, transient, volatile, synchronized, native, strictfp -->
|
|
</module>
|
|
|
|
|
|
<!-- WHITESPACE CHECKS -->
|
|
|
|
<module name="WhitespaceAround">
|
|
<!-- Checks that various tokens are surrounded by whitespace. This includes
|
|
most binary operators and keywords followed by regular or curly braces. -->
|
|
<property name="tokens"
|
|
value="ASSIGN, BAND, BAND_ASSIGN, BOR,
|
|
BOR_ASSIGN, BSR, BSR_ASSIGN, BXOR, BXOR_ASSIGN, COLON, DIV, DIV_ASSIGN,
|
|
EQUAL, GE, GT, LAND, LE, LITERAL_CATCH, LITERAL_DO, LITERAL_ELSE,
|
|
LITERAL_FINALLY, LITERAL_FOR, LITERAL_IF, LITERAL_RETURN,
|
|
LITERAL_SYNCHRONIZED, LITERAL_TRY, LITERAL_WHILE, LOR, LT, MINUS,
|
|
MINUS_ASSIGN, MOD, MOD_ASSIGN, NOT_EQUAL, PLUS, PLUS_ASSIGN, QUESTION,
|
|
SL, SL_ASSIGN, SR_ASSIGN, STAR, STAR_ASSIGN" />
|
|
<property name="severity" value="error" />
|
|
</module>
|
|
|
|
<module name="WhitespaceAfter">
|
|
<!-- Checks that commas, semicolons and typecasts are followed by whitespace. -->
|
|
<property name="tokens" value="COMMA, SEMI, TYPECAST" />
|
|
</module>
|
|
|
|
<module name="NoWhitespaceAfter">
|
|
<!-- Checks that there is no whitespace after various unary operators.
|
|
Linebreaks are allowed. -->
|
|
<property name="tokens"
|
|
value="BNOT, DEC, DOT, INC, LNOT, UNARY_MINUS,
|
|
UNARY_PLUS" />
|
|
<property name="allowLineBreaks" value="true" />
|
|
<property name="severity" value="error" />
|
|
</module>
|
|
|
|
<module name="NoWhitespaceBefore">
|
|
<!-- Checks that there is no whitespace before various unary operators.
|
|
Linebreaks are allowed. -->
|
|
<property name="tokens" value="SEMI, DOT, POST_DEC, POST_INC" />
|
|
<property name="allowLineBreaks" value="true" />
|
|
<property name="severity" value="error" />
|
|
</module>
|
|
|
|
<module name="ParenPad">
|
|
<!-- Checks that there is no whitespace before close parens or after open
|
|
parens. -->
|
|
<property name="severity" value="warning" />
|
|
</module>
|
|
|
|
<module name="Indentation">
|
|
<!-- Checks code indentation -->
|
|
<property name="basicOffset" value="2" />
|
|
</module>
|
|
</module>
|
|
</module>
|