/*
* The MIT License (MIT)
*
* Copyright (c) 2007-2015 Broad Institute
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
package org.broad.igv.ui;
import org.broad.igv.util.FileUtils;
import java.io.*;
import java.util.regex.Pattern;
/**
* Class used for examining our readme file, and presenting documentation to the user
* either at the command line or elsewhere.
* User: jacob
* Date: 2012/02/27
*/
public class ReadmeParser {
/**
* When packaged in a jar, this is where the readme goes.
*/
private static final String DEFAULT_README_PATH = "/docs/igvtools_readme.txt";
public static final String END_STR = "See http://www.broadinstitute.org/software/igv/igvtools_commandline, or igvtools_readme.txt, for more help" + FileUtils.LINE_SEPARATOR;
private String path = DEFAULT_README_PATH;
public ReadmeParser(){}
public ReadmeParser(String path){
this.path = path;
}
Pattern getCmdPattern(String command){
return Pattern.compile("command.{1,4}\"" + command, Pattern.CASE_INSENSITIVE);
}
Pattern getStartEndPattern(){
return Pattern.compile("[-,=,_]{8}");
}
/**
* Get reader for the given path. To get compliance
* in both source and jar form, first we try
* getResourceAsStream, then normal file handling.
* @return
*/
BufferedReader getReader() throws FileNotFoundException{
InputStream is = ReadmeParser.class.getResourceAsStream(path);
if(is != null){
return new BufferedReader(new InputStreamReader(is));
}else{
return new BufferedReader(new FileReader(this.path));
}
}
public String getDocForCommand(String cmd){
String out = "Command " + cmd + " not found" + FileUtils.LINE_SEPARATOR;
BufferedReader reader = null;
try{
reader = getReader();
String line = null;
Pattern cmdPattern = getCmdPattern(cmd);
Pattern stEndPattern = getStartEndPattern();
int startEndLinesRem = -1;
while((line = reader.readLine()) != null){
//Command found, set counter
if(startEndLinesRem < 0 && cmdPattern.matcher(line).find()){
startEndLinesRem = 2;
out = "";
}else if(startEndLinesRem < 0){
//No match for command, not within section
continue;
}
//Start/end line found, decrement number
if(stEndPattern.matcher(line).find()){
startEndLinesRem--;
}
if(startEndLinesRem >= 0){
out += line + FileUtils.LINE_SEPARATOR;
}
if(startEndLinesRem == 0){
break;
}
}
}catch(FileNotFoundException e){
out = "Could not find readme file " + this.path + FileUtils.LINE_SEPARATOR;
}catch (IOException e){
out = "Error reading readme file " + this.path + FileUtils.LINE_SEPARATOR;
}finally{
if(reader != null){
try{
reader.close();
}catch(Exception e){
return null;
}
}
}
out += END_STR;
return out;
}
}