/*
***** BEGIN LICENSE BLOCK *****
* Version: EPL 2.0/GPL 2.0/LGPL 2.1
*
* The contents of this file are subject to the Eclipse Public
* 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.eclipse.org/legal/epl-v20.html
*
* Software distributed under the License is distributed on an "AS
* IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
* implied. See the License for the specific language governing
* rights and limitations under the License.
*
* Copyright (C) 2002 Jan Arne Petersen <jpetersen@uni-bonn.de>
* Copyright (C) 2004 Thomas E Enebo <enebo@acm.org>
* Copyright (C) 2004 Anders Bengtsson <ndrsbngtssn@yahoo.se>
*
* Alternatively, the contents of this file may be used under the terms of
* either of the GNU General Public License Version 2 or later (the "GPL"),
* or the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
* in which case the provisions of the GPL or the LGPL are applicable instead
* of those above. If you wish to allow use of your version of this file only
* under the terms of either the GPL or the LGPL, and not to allow others to
* use your version of this file under the terms of the EPL, indicate your
* decision by deleting the provisions above and replace them with the notice
* and other provisions required by the GPL or the LGPL. If you do not delete
* the provisions above, a recipient may use your version of this file under
* the terms of any one of the EPL, the GPL or the LGPL.
***** END LICENSE BLOCK *****/
package org.jruby.parser;
import org.jcodings.Encoding;
import org.jcodings.specific.UTF8Encoding;
import org.jruby.Ruby;
import org.jruby.RubyInstanceConfig;
import org.jruby.ext.coverage.CoverageData;
import org.jruby.runtime.DynamicScope;
import org.jruby.runtime.encoding.EncodingService;
import org.jruby.runtime.scope.ManyVarsDynamicScope;
import org.jruby.util.KCode;
import java.util.Arrays;
public class ParserConfiguration {
private DynamicScope existingScope = null;
private boolean asBlock = false;
// What linenumber will the source think it starts from?
private int lineNumber = 0;
// Is this inline source (aka -e "...source...")
private boolean inlineSource = false;
// We parse evals more often in source so assume an eval parse.
private boolean isEvalParse = true;
// Should we display extra debug information while parsing?
private boolean isDebug = false;
// whether we should save the end-of-file data as DATA
private boolean saveData = false;
private boolean frozenStringLiteral = false;
private Encoding defaultEncoding;
private Ruby runtime;
private int[] coverage = EMPTY_COVERAGE;
private static final int[] EMPTY_COVERAGE = new int[0];
public ParserConfiguration(Ruby runtime, int lineNumber, boolean inlineSource, boolean isFileParse, boolean saveData) {
this.runtime = runtime;
this.inlineSource = inlineSource;
this.lineNumber = lineNumber;
this.isEvalParse = !isFileParse;
this.saveData = saveData;
}
public ParserConfiguration(Ruby runtime, int lineNumber,
boolean inlineSource, boolean isFileParse, RubyInstanceConfig config) {
this(runtime, lineNumber, inlineSource, isFileParse, false, config);
}
public ParserConfiguration(Ruby runtime, int lineNumber,
boolean inlineSource, boolean isFileParse, boolean saveData, RubyInstanceConfig config) {
this(runtime, lineNumber, inlineSource, isFileParse, saveData);
this.isDebug = config.isParserDebug();
this.frozenStringLiteral = config.isFrozenStringLiteral();
}
public void setFrozenStringLiteral(boolean frozenStringLiteral) {
this.frozenStringLiteral = frozenStringLiteral;
}
public boolean isFrozenStringLiteral() {
return frozenStringLiteral;
}
public void setDefaultEncoding(Encoding encoding) {
this.defaultEncoding = encoding;
}
public Encoding getDefaultEncoding() {
if (defaultEncoding == null) {
defaultEncoding = UTF8Encoding.INSTANCE;
}
return defaultEncoding;
}
public EncodingService getEncodingService() {
return runtime.getEncodingService();
}
public boolean isDebug() {
return isDebug;
}
Is the requested parse for an eval()?
Returns: true if for eval
/**
* Is the requested parse for an eval()?
*
* @return true if for eval
*/
public boolean isEvalParse() {
return isEvalParse;
}
public KCode getKCode() {
return runtime.getKCode();
}
public int getLineNumber() {
return lineNumber;
}
If we are performing an eval we should pass existing scope in.
Calling this lets the parser know we need to do this.
Params: - existingScope – is the scope that captures new vars, etc...
/**
* If we are performing an eval we should pass existing scope in.
* Calling this lets the parser know we need to do this.
*
* @param existingScope is the scope that captures new vars, etc...
*/
public void parseAsBlock(DynamicScope existingScope) {
this.asBlock = true;
this.existingScope = existingScope;
}
public Ruby getRuntime() {
return runtime;
}
This method returns the appropriate first scope for the parser.
Returns: correct top scope for source to be parsed
/**
* This method returns the appropriate first scope for the parser.
*
* @return correct top scope for source to be parsed
*/
public DynamicScope getScope(String file) {
if (asBlock) return existingScope;
// FIXME: We should really not be creating the dynamic scope for the root
// of the AST before parsing. This makes us end up needing to readjust
// this dynamic scope coming out of parse (and for local static scopes it
// will always happen because of $~ and $_).
// FIXME: Because we end up adjusting this after-the-fact, we can't use
// any of the specific-size scopes.
return new ManyVarsDynamicScope(runtime.getStaticScopeFactory().newLocalScope(null, file), existingScope);
}
public boolean isCoverageEnabled() {
return !isEvalParse() && runtime.getCoverageData().isCoverageEnabled();
}
Get whether we are saving the DATA contents of the file.
/**
* Get whether we are saving the DATA contents of the file.
*/
public boolean isSaveData() {
return saveData;
}
Are we parsing source provided as part of the '-e' option to Ruby.
Returns: true if source is from -e option
/**
* Are we parsing source provided as part of the '-e' option to Ruby.
*
* @return true if source is from -e option
*/
public boolean isInlineSource() {
return inlineSource;
}
Zero out coverable lines as they're encountered
/**
* Zero out coverable lines as they're encountered
*/
public void coverLine(int i) {
if (isCoverageEnabled()) {
growCoverageLines(i);
coverage[i] = 0;
}
}
Called by coverLine to grow it large enough to add new covered line.
Also called at end up parse to pick up any extra non-code lines which
should be marked -1 for not valid code lines.
/**
* Called by coverLine to grow it large enough to add new covered line.
* Also called at end up parse to pick up any extra non-code lines which
* should be marked -1 for not valid code lines.
*/
public void growCoverageLines(int i) {
if (coverage == null) {
coverage = new int[i + 1];
} else if (coverage.length <= i) {
int[] newCoverage = new int[i + 1];
Arrays.fill(newCoverage, -1);
System.arraycopy(coverage, 0, newCoverage, 0, coverage.length);
coverage = newCoverage;
}
}
At end of a parse if coverage is enabled we will do final processing
of the primitive coverage array and make sure runtimes coverage data
has been updated with this new data.
/**
* At end of a parse if coverage is enabled we will do final processing
* of the primitive coverage array and make sure runtimes coverage data
* has been updated with this new data.
*/
public CoverageData finishCoverage(String file, int lines) {
if (!isCoverageEnabled()) return null;
growCoverageLines(lines);
CoverageData data = runtime.getCoverageData();
data.prepareCoverage(file, coverage);
return data;
}
Get the coverage array, indicating all coverable lines
/**
* Get the coverage array, indicating all coverable lines
*/
@Deprecated
public int[] getCoverage() {
return coverage;
}
}