diff options
Diffstat (limited to 'support/arara/source/src')
140 files changed, 7086 insertions, 10251 deletions
diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/Arara.java b/support/arara/source/src/main/java/com/github/cereda/arara/Arara.java deleted file mode 100644 index 36405b1b47..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/Arara.java +++ /dev/null @@ -1,205 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara; - -import com.github.cereda.arara.controller.LanguageController; -import com.github.cereda.arara.controller.LoggingController; -import com.github.cereda.arara.model.AraraException; -import com.github.cereda.arara.model.Configuration; -import com.github.cereda.arara.model.Directive; -import com.github.cereda.arara.model.Extractor; -import com.github.cereda.arara.model.Interpreter; -import com.github.cereda.arara.model.Parser; -import com.github.cereda.arara.model.StopWatch; -import com.github.cereda.arara.utils.CommonUtils; -import com.github.cereda.arara.utils.DirectiveUtils; -import com.github.cereda.arara.utils.DisplayUtils; -import java.util.List; - -/** - * Main class. This class wraps all classes from the application model as well - * as utilitary classes in order to provide modularity. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class Arara { - - /** - * Main method. This is the application entry point. - * @param args A string array containing all command line arguments. - */ - public static void main(String[] args) { - - // the first component to be initialized is the - // language controller; note that init() actually - // has no body at all, but it's a dirty maneuver to - // trigger the static class startup - LanguageController.init(); - - // the second component to be initalized is the - // logging controller; note init() actually disables - // the logging, so early exceptions won't generate - // a lot of noise in the terminal - LoggingController.init(); - - // print the arara logo in the terminal; I just - // hope people use this tool in a good terminal with - // fixed-width fonts, otherwise the logo will be messed - DisplayUtils.printLogo(); - - try { - - // first of all, let's try to load a potential - // configuration file located at the current - // user's home directory; if there's a bad - // configuration file, arara will panic and - // end the execution - Configuration.load(); - - // if we are here, either there was no configuration - // file at all or we managed to load the settings; now, - // it's time to properly parse the command line arguments; - // this is done by creating a brand new instance of arara's - // command line parser and providing the string array to it - Parser parser = new Parser(args); - - // now let's see if we are good to go; parse() will return - // a boolean value indicating if the provided arguments - // allow the tool to continue (we might reach some special - // flags as well, like --help or --version, which simply - // do their jobs and return false, since there's no point - // of continuing processing with such flags) - if (parser.parse()) { - - // let's print the current file information; it is a - // basic display, just the file name, the size properly - // formatted as a human readable format, and the last - // modification date; also, in this point, the logging - // feature starts to collect data (of course, if enabled - // either through the configuration file or manually - // in the command line) - DisplayUtils.printFileInformation(); - - // time to read the file and try to extract the directives; - // this class does a pretty good job on finding directives, - // including the multiline ones; it was a long awaited - // feature people were asking me to implement, so here - // it is! - Extractor extractor = new Extractor(); - - // extract() brings us a list of directives properly parsed - // and almost ready to be handled; note that no directives - // in the provided file will raise an exception; this is - // by design and I opted to not include a default fallback - // (although it wouldn't be so difficult to write one, - // I decided not to take the risk) - List<Directive> directives = extractor.extract(); - - // once we have our nice list of directives, it is time to - // actually validate them (for example, we have a couple of - // keywords that cannot be used as directive parameters); - // another interesting feature of the validate() method is - // to replicate a directive that has the 'files' keyword on - // it, since it's the whole point of having 'files' in the - // first place; if you check the log file, you will see - // that the list of extracted directives might differ from - // the final list of directives to be effectively processed - // by arara - directives = DirectiveUtils.validate(directives); - - // arara features now a cool stopwatch, so we can see how - // much time has passed since everything started; start(), - // for obvious reasons, starts the stopwatch and keeps track - // of time for us; internally, this class makes use of - // nano time, so we might get an interesting precision here - // (although timing is not a serious business in here, it's - // just a cool addition) - StopWatch.start(); - - // this is surely the golden heart of arara; this class - // implements a powerful interpreter that will handle all - // rules and their corresponding tasks - Interpreter interpreter = new Interpreter(); - - // once we have this bad boy ready, let's provide the list - // of directives previously extracted and validated; it is - // like loading a cannon, I guess - interpreter.setDirectives(directives); - - // time to shine, now the interpreter class will interpret - // one directive at a time, get the corresponding rule, - // set the parameters, evaluate it, get the tasks, run them, - // evaluate the result and print the status; note that - // arara, from this version on, will try to evaluate things - // progressively, so in case of an error, the previous tasks - // were already processed and potentially executed - interpreter.execute(); - } - - } catch (AraraException exception) { - - // something bad just happened, so arara will print the proper - // exception and provide details on it, if available; the idea - // here is to propagate an exception throughout the whole - // application and catch it here instead of a local treatment - DisplayUtils.printException(exception); - } - - // we are done here (with or without errors, that makes no difference - // at this point), so let's stop our stopwatch; now it's just an easy - // subtraction to be made (note that the values are internally - // represented as nanoseconds, but the result is printed as seconds) - StopWatch.stop(); - - // this is the last command from arara; once the execution time is - // available, print it; note that this notification is suppressed - // when the command line parsing returns false as result (it makes - // no sense to print the execution time for a help message, I guess) - DisplayUtils.printTime(); - - // gets the application exit status; the rule here is: - // 0 : everything went just fine (note that the dry-run mode always - // makes arara exit with 0, unless it is an error in the directive - // builder itself). - // 1 : one of the tasks failed, so the execution ended abruptly. This - // means the error relies on the command line call, not with arara. - // 2 : arara just handled an exception, meaning that something bad - // just happened and might require user intervention. - System.exit(CommonUtils.getExitStatus()); - - // I owe David Carlisle $100 - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/controller/ConfigurationController.java b/support/arara/source/src/main/java/com/github/cereda/arara/controller/ConfigurationController.java deleted file mode 100644 index 2dbc3a2bff..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/controller/ConfigurationController.java +++ /dev/null @@ -1,106 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.controller; - -import java.util.HashMap; -import java.util.Map; - -/** - * Implements the configuration controller. The idea here is to provide a map - * that holds all configuration settings used by model and utilitary classes - * throughout the execution. This controller is implemented as a singleton. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class ConfigurationController { - - // the controller itself, since we have a singleton; - // this is the reference instance, instantiated once - private static final ConfigurationController instance = - new ConfigurationController(); - - // the configuration settings are stored in a map; - // pretty much everything can be stored in this map, - // as long as you know what to retrieve later on - private final Map<String, Object> map; - - /** - * Private constructor. Called once for creating the proper singleton. - */ - private ConfigurationController() { - map = new HashMap<String, Object>(); - } - - /** - * Gets the current configuration controller. Since this class is - * implemented as a singleton, you will get the same controller every - * single time, and that's good. - * @return The configuration controller, which hold the settings map. - */ - public static ConfigurationController getInstance() { - return instance; - } - - /** - * Returns the object indexed by the provided key. This method provides an - * easy access to the underlying map. - * @param key A string representing the key. - * @return An object indexed by the provided key. - */ - public Object get(String key) { - return map.get(key); - } - - /** - * Puts the object in the map and indexes it in the provided key. This - * method provides an easy access to the underlying map. - * @param key A string representing the key. - * @param value The object to be indexed by the provided key. - */ - public void put(String key, Object value) { - map.put(key, value); - } - - /** - * Checks if the map contains the provided key. This is actually a wrapper - * to the private map's method of the same name. - * @param key The key to be checked. - * @return A boolean value indicating if the map contains the provided key. - */ - public boolean contains(String key) { - return map.containsKey(key); - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/controller/LanguageController.java b/support/arara/source/src/main/java/com/github/cereda/arara/controller/LanguageController.java deleted file mode 100644 index 85bfc3a43d..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/controller/LanguageController.java +++ /dev/null @@ -1,120 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.controller; - -import ch.qos.cal10n.IMessageConveyor; -import ch.qos.cal10n.MessageConveyor; -import java.util.Locale; - -/** - * Implements the language controller. This controller provides a singleton - * object that holds the application messages, easily available to all model - * and utilitary classes. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class LanguageController { - - // the controller itself, since we have a singleton; - // this is the reference instance, instantiated once - private static final LanguageController instance = - new LanguageController(); - - // the message conveyor helps us to get localized messages - // according to the provided locale - private IMessageConveyor conveyor; - - /** - * Private constructor. The fallback language is set to English for all - * messages in arara. - */ - private LanguageController() { - conveyor = new MessageConveyor(new Locale("en")); - } - - /** - * Initializes the class. This method actually does nothing, it just - * triggers the static attributions. Dirty, isn't it? - */ - public static void init() { - // quack, quack, quack! - } - - /** - * Gets the singleton reference. Since this class is implemented as a - * singleton, you will get the same controller every single time. - * @return The language controller which holds the conveyor. - */ - public static LanguageController getInstance() { - return instance; - } - - /** - * Sets the current locale. This method actually resets the language - * conveyor in order to use the new locale. It's quite simple. - * @param locale The new locale for localized messages through the language - * conveyor. - */ - public void setLocale(Locale locale) { - conveyor = new MessageConveyor(locale); - } - - /** - * Gets the localized message indexed by the provided enumeration key, - * applying an array of objects as parameters. This method is a wrapper to - * the conveyor's method of the same name. - * @param <E> Enumeration type that represents the conveyor messages. - * @param key Key set in the provided enumeration type. - * @param parameters Array of objects to be used as parameters. - * @return A string containing a localized message indexed by the provided - * enumeration key and applied the array of objects as parameters. - */ - public <E extends Enum<?>> String getMessage(E key, Object... parameters) { - return conveyor.getMessage(key, parameters); - } - - /** - * Gets the localized message indexed by the provided enumeration key. This - * method is a wrapper to the conveyor's method of the same name. - * @param <E> Enumeration type that represents the conveyor messages. - * @param key Key set in the provided enumeration type. - * @return A string containing a localized message indexed by the provided - * enumeration key. - */ - public <E extends Enum<?>> String getMessage(E key) { - return conveyor.getMessage(key); - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/controller/LoggingController.java b/support/arara/source/src/main/java/com/github/cereda/arara/controller/LoggingController.java deleted file mode 100644 index 958beec291..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/controller/LoggingController.java +++ /dev/null @@ -1,109 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.controller; - -import ch.qos.logback.classic.LoggerContext; -import ch.qos.logback.classic.joran.JoranConfigurator; -import ch.qos.logback.core.joran.spi.JoranException; -import java.io.InputStream; -import org.slf4j.LoggerFactory; - -/** - * Implements the logging controller. This class actually sets the logging - * configuration in order to allow appending results to a file. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class LoggingController { - - /** - * Sets the logging configuration according to the provided boolean value. - * If the value is set to true, the log entries will be appended to a file, - * otherwise the logging feature will keep silent. - * @param enable A boolean value that indicates the logging behaviour - * throughout the application. - */ - public static void enableLogging(boolean enable) { - - // get the logger context from a factory, set a - // new context and reset it - LoggerContext loggerContext = - (LoggerContext) LoggerFactory.getILoggerFactory(); - - try { - - // get a new configuration and set - // the context - JoranConfigurator configurator = new JoranConfigurator(); - configurator.setContext(loggerContext); - loggerContext.reset(); - - // if enabled, the log entries will be - // appended to a file, otherwise it will - // remain silent - if (enable) { - - // set the file name and configure - // the logging controller to append - // entries to the file - String name = (String) ConfigurationController. - getInstance().get("execution.log.name"); - loggerContext.putProperty("name", name); - configurator.doConfigure(getResource()); - } - } catch (JoranException exception) { - // quack, quack, quack! - } - } - - /** - * Get the configuration resource as an input stream. The configuration - * is actually a XML file. - * @return An input stream of the provided configuration XML resource. - */ - private static InputStream getResource() { - String resource = "/com/github/cereda/arara/configuration/logback.xml"; - return LoggingController.class.getResourceAsStream(resource); - } - - /** - * Initializes the logging controller by disabling it. I don't want an odd - * behaviour out of the box. - */ - public static void init() { - enableLogging(false); - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/controller/SessionController.java b/support/arara/source/src/main/java/com/github/cereda/arara/controller/SessionController.java deleted file mode 100644 index 41c627dc98..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/controller/SessionController.java +++ /dev/null @@ -1,124 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.controller; - -import java.util.HashMap; -import java.util.Map; - -/** - * Implements a session controller. This class wraps a map that holds the - * execution session, that is, a dirty maneuver to exchange pretty much any - * data between commands and even rules. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class SessionController { - - // the controller itself, since we have a singleton; - // this is the reference instance, instantiated once - private static final SessionController instance = - new SessionController(); - - // the session map which holds the execution session; - // the idea here is to provide wrappers to the map - // methods, so it could be easily manipulated - private final Map<String, Object> map; - - /** - * Private constructor. Called once when the singleton is created. - */ - private SessionController() { - map = new HashMap<String, Object>(); - } - - /** - * Gets the singleton reference. Since this class is implemented as a - * singleton, you will get the same controller every single time. - * @return The session controller which holds the session map. - */ - public static SessionController getInstance() { - return instance; - } - - /** - * Gets the object indexed by the provided key. This method actually holds - * the map method of the very same name. - * @param key The provided map key. - * @return The object indexed by the provided map key. - */ - public Object get(String key) { - return map.get(key); - } - - /** - * Puts the object in the session map and indexes it under the provided - * key. This method actually holds the map method of the very same name. - * @param key The provided map key. - * @param value The object to be indexed under the provided key. - */ - public void put(String key, Object value) { - map.put(key, value); - } - - /** - * Checks if the session map contains the provided key. This method holds - * the map method of the very same name. - * @param key The key to be checked. - * @return A boolean value indicating if the session map contains the - * provided key. - */ - public boolean contains(String key) { - return map.containsKey(key); - } - - /** - * Remove an entry from the map according to the provided key. This method - * holds the map method of the same name. - * @param key The provided key to indicate which session map entry should - * be removed. - */ - public void remove(String key) { - map.remove(key); - } - - /** - * Clears the session map. This method, as usual, holds the map method of - * the same name. - */ - public void clear() { - map.clear(); - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/controller/SystemCallController.java b/support/arara/source/src/main/java/com/github/cereda/arara/controller/SystemCallController.java deleted file mode 100644 index 4d87adc8a8..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/controller/SystemCallController.java +++ /dev/null @@ -1,153 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.controller; - -import java.util.HashMap; -import java.util.Map; -import org.zeroturnaround.exec.ProcessExecutor; - -/** - * Implements a system call controller. This class wraps a map that holds the - * result of system specific variables not directly available at runtime. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class SystemCallController { - - /** - * Implements a private command interface. - */ - private interface Command { - - /** - * Executes the command body. - * @return An object. - */ - public Object execute(); - } - - // the controller itself, since we have a singleton; - // this is the reference instance, instantiated once - private static final SystemCallController instance = - new SystemCallController(); - - // the system call map which holds the result of - // system specific variables not directly available - // at runtime; the idea here is to provide wrappers - // to the map getter, so it could be easily manipulated - private final Map<String, Object> map; - - // the commands map will allow the system call map being - // populated only on demand, that is, if the key is not - // found, this map will provide the corresponding method - // and update the value - private final Map<String, Command> commands; - - /** - * Private constructor. Called once when the singleton is created. - */ - private SystemCallController() { - - // create the new map instance to be - // populated on demand - map = new HashMap<String, Object>(); - - // create the new map of commands and - // add the corresponding system calls - commands = new HashMap<String, Command>(); - - // add the check for a Cygwin - // environment in here - commands.put("cygwin", new Command() { - - /** - * Implements the body of the command. In this particular - * instance, it checks if we are inside a Cygwin environment. - * @return A boolean value indicating if we are inside a Cygwin - * environment. - */ - public Object execute() { - try { - - // execute a new system call to 'uname -s', read the output - // as an UTF-8 string, lowercase it and check if it starts - // with the 'cygwin' string; if so, we are inside Cygwin - return ( - new ProcessExecutor().command("uname", "-s"). - readOutput(true).execute().outputUTF8() - ).toLowerCase().startsWith("cygwin"); - - } catch (Exception exception) { - - // gracefully fallback in case of any nasty and evil - // exception, e.g, if the command is unavailable - return false; - } - } - }); - } - - /** - * Gets the singleton reference. Since this class is implemented as a - * singleton, you will get the same controller every single time. - * @return The system call controller which holds the system call map. - */ - public static SystemCallController getInstance() { - return instance; - } - - /** - * Gets the object indexed by the provided key. This method actually holds - * the map method of the very same name. - * @param key The provided map key. - * @return The object indexed by the provided map key. - */ - public Object get(String key) { - - // if key is not found, meaning that - // the value wasn't required before - if (!map.containsKey(key)) { - - // perform the system call and - // populate the corresponding value - map.put(key, commands.get(key).execute()); - } - - // simply return the corresponding - // value based on the provided key - return map.get(key); - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/model/AraraException.java b/support/arara/source/src/main/java/com/github/cereda/arara/model/AraraException.java deleted file mode 100644 index 5f5d788e0f..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/model/AraraException.java +++ /dev/null @@ -1,88 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.model; - -/** - * Implements the specific exception model for arara. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class AraraException extends Exception { - - // the underlying exception, - // used to hold more details - // on what really happened - private Exception exception; - - /** - * Constructor. Takes the exception message. - * @param message The exception message. - */ - public AraraException(String message) { - super(message); - } - - /** - * Constructor. Takes the exception message and the underlying exception. - * @param message The exception message. - * @param exception The underlying exception object. - */ - public AraraException(String message, Exception exception) { - super(message); - this.exception = exception; - } - - /** - * Gets the underlying exception. - * @return The underlying message. - */ - public Exception getException() { - return exception; - } - - /** - * Checks if there is an underlying exception defined in the current object. - * @return A boolean value indicating if the current object has an - * underlying exception. - */ - public boolean hasException() { - if (exception != null) { - return (exception.getMessage() != null); - } else { - return false; - } - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/model/Argument.java b/support/arara/source/src/main/java/com/github/cereda/arara/model/Argument.java deleted file mode 100644 index b0e7d2bca6..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/model/Argument.java +++ /dev/null @@ -1,125 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.model; - -import com.github.cereda.arara.utils.CommonUtils; - -/** - * The rule argument model. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class Argument { - - // the argument identifier - private String identifier; - - // a boolean indicating if the - // current argument is required - private boolean required; - - // the flag to hold the argument - // value manipulation - private String flag; - - // the argument fallback if it is - // not defined in the directive - private String fallback; - - /** - * Gets the identifier. - * @return The identifier. - */ - public String getIdentifier() { - return CommonUtils.removeKeyword(identifier); - } - - /** - * Sets the identifier. - * @param identifier The identifier. - */ - public void setIdentifier(String identifier) { - this.identifier = identifier; - } - - /** - * Checks if the argument is required. - * @return A boolean value indicating if the argument is required. - */ - public boolean isRequired() { - return required; - } - - /** - * Sets the argument requirement. - * @param required A boolean value. - */ - public void setRequired(boolean required) { - this.required = required; - } - - /** - * Gets the argument flag. - * @return The flag. - */ - public String getFlag() { - return CommonUtils.removeKeyword(flag); - } - - /** - * Sets the argument flag. - * @param flag The argument flag. - */ - public void setFlag(String flag) { - this.flag = flag; - } - - /** - * Gets the argument fallback. - * @return The argument fallback. - */ - public String getDefault() { - return CommonUtils.removeKeyword(fallback); - } - - /** - * Sets the argument fallback. - * @param fallback The argument fallback. - */ - public void setDefault(String fallback) { - this.fallback = fallback; - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/model/Command.java b/support/arara/source/src/main/java/com/github/cereda/arara/model/Command.java deleted file mode 100644 index 848f3f3010..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/model/Command.java +++ /dev/null @@ -1,127 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.model; - -import com.github.cereda.arara.utils.CommonUtils; -import java.io.File; -import java.util.ArrayList; -import java.util.Arrays; -import java.util.List; - -/** - * Implements a command model, containing a list of strings. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class Command { - - // a list of elements which are components - // of a command and represented as strings - private final List<String> elements; - - // an optional file acting as a reference - // for the default working directory - private File workingDirectory; - - /** - * Constructor. - * @param values An array of objects. - */ - public Command(Object... values) { - elements = new ArrayList<String>(); - List result = CommonUtils.flatten(Arrays.asList(values)); - for (Object value : result) { - String element = String.valueOf(value); - if (!CommonUtils.checkEmptyString(element)) { - elements.add(element); - } - } - } - - /** - * Constructor. - * @param elements A list of strings. - */ - public Command(List<String> elements) { - this.elements = elements; - } - - /** - * Gets the list of strings representing each element of a command. - * @return A list of strings. - */ - public List<String> getElements() { - return elements; - } - - /** - * Sets the working directory. - * @param workingDirectory A file representing the working directory. - */ - public void setWorkingDirectory(File workingDirectory) { - this.workingDirectory = workingDirectory; - } - - /** - * Gets the working directory, if any. - * @return A file representing the working directory. - */ - public File getWorkingDirectory() { - return workingDirectory; - } - - /** - * Checks if a working directory was defined. - * @return A logic value indicating if a working directory was defined. - */ - public boolean hasWorkingDirectory() { - return workingDirectory != null; - } - - /** - * Provides a textual representation of the current command. - * @return A string representing the current command. - */ - @Override - public String toString() { - return CommonUtils.getCollectionElements(elements, "[ ", " ]", ", "). - concat( - hasWorkingDirectory() - ? " @ " + workingDirectory.toString() - : "" - ); - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/model/Conditional.java b/support/arara/source/src/main/java/com/github/cereda/arara/model/Conditional.java deleted file mode 100644 index d8f0543709..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/model/Conditional.java +++ /dev/null @@ -1,139 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.model; - -/** - * The conditional class, it represents the type of conditional available - * for a directive and its corresponding expression to be evaluated. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class Conditional { - - // these are all types of conditionals arara - // is able to recognize; personally, I believe - // they are more than sufficient to cover the - // majority of test cases - public enum ConditionalType { - - // evaluated beforehand, directive is interpreted - // if and only if the result is true - IF, - - // there is no evaluation, directive is interpreted, - // no extra effort is needed - NONE, - - // evaluated beforehand, directive is interpreted - // if and only if the result is false - UNLESS, - - // directive is interpreted the first time, then the - // evaluation is done; while the result is false, - // the directive is interpreted again and again - UNTIL, - - // evaluated beforehand, directive is interpreted if - // and oly if the result is true, and the process is - // repeated while the result still holds true - WHILE - } - - // the conditional type, specified above; the - // default fallback, as seen in the constructor, - // is set to NONE, that is, no conditional at all - private ConditionalType type; - - // the expression to be evaluated according to its - // type; the default fallback, as seen in the - // constructor, is set to an empty string - private String condition; - - /** - * Constructor. - */ - public Conditional() { - type = ConditionalType.NONE; - condition = ""; - } - - /** - * Gets the conditional type. - * @return The conditional type. - */ - public ConditionalType getType() { - return type; - } - - /** - * Sets the conditional type. - * @param type The conditional type. - */ - public void setType(ConditionalType type) { - this.type = type; - } - - /** - * Gets the condition, that is, the expression to be evaluated. - * @return A string representing the condition. - */ - public String getCondition() { - return condition; - } - - /** - * Sets the condition, that is, the expression to be evaluated. - * @param condition A string representing the condition. - */ - public void setCondition(String condition) { - this.condition = condition; - } - - /** - * Provides a textual representation of the conditional object. - * @return A string representation of this object. - */ - @Override - public String toString() { - StringBuilder builder = new StringBuilder(); - builder.append("{ ").append(type); - if (type != ConditionalType.NONE) { - builder.append(", expression: ").append(condition.trim()); - } - builder.append(" }"); - return builder.toString(); - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/model/Configuration.java b/support/arara/source/src/main/java/com/github/cereda/arara/model/Configuration.java deleted file mode 100644 index 70f6382364..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/model/Configuration.java +++ /dev/null @@ -1,246 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.model; - -import com.github.cereda.arara.controller.ConfigurationController; -import com.github.cereda.arara.controller.LanguageController; -import com.github.cereda.arara.utils.CommonUtils; -import com.github.cereda.arara.utils.ConfigurationUtils; -import java.io.File; -import java.nio.charset.Charset; -import java.util.ArrayList; -import java.util.Arrays; -import java.util.HashMap; -import java.util.List; -import java.util.Locale; -import java.util.Map; -import java.util.concurrent.TimeUnit; - -/** - * Implements the configuration model, which holds the default settings and can - * load the configuration file. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class Configuration { - - // the application messages obtained from the - // language controller - private static final LanguageController messages = - LanguageController.getInstance(); - - /** - * Loads the application configuration. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static void load() throws AraraException { - - // initialize both file type and language models, - // since we can track errors from there instead - // of relying on a check on this level - FileType.init(); - Language.init(); - - // reset everything - reset(); - - // get the configuration file, if any - File file = ConfigurationUtils.getConfigFile(); - if (file != null) { - - // set the configuration file name for - // logging purposes - ConfigurationController.getInstance(). - put("execution.configuration.name", - CommonUtils.getCanonicalPath(file) - ); - - // then validate it and update the - // configuration accordingly - Resource resource = ConfigurationUtils.validateConfiguration(file); - update(resource); - } - - // just to be sure, update the - // current locale in order to - // display localized messages - Locale locale = ((Language) ConfigurationController. - getInstance().get("execution.language")).getLocale(); - LanguageController.getInstance().setLocale(locale); - } - - /** - * Resets the configuration to initial settings. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - private static void reset() throws AraraException { - - // put everything in a map to be - // later assigned to the configuration - // controller, which holds the settings - Map<String, Object> mapping = new HashMap<String, Object>(); - - mapping.put("execution.loops", 10L); - mapping.put("directives.charset", Charset.forName("UTF-8")); - mapping.put("execution.errors.halt", true); - mapping.put("execution.timeout", false); - mapping.put("execution.timeout.value", 0L); - mapping.put("execution.timeout.unit", TimeUnit.MILLISECONDS); - mapping.put("application.version", "4.0"); - mapping.put("application.revision", "2"); - mapping.put("directives.linebreak.pattern", "^\\s*-->\\s(.*)$"); - - String directive = "^\\s*(\\w+)\\s*(:\\s*(\\{.*\\})\\s*)?"; - String pattern = "(\\s+(if|while|until|unless)\\s+(\\S.*))?$"; - - mapping.put("directives.pattern", directive.concat(pattern)); - mapping.put("application.pattern", "arara:\\s"); - mapping.put("application.width", 65); - mapping.put("execution.database.name", "arara"); - mapping.put("execution.log.name", "arara"); - mapping.put("execution.verbose", false); - - mapping.put("trigger.halt", false); - mapping.put("execution.language", new Language("en")); - mapping.put("execution.logging", false); - mapping.put("execution.dryrun", false); - mapping.put("execution.status", 0); - mapping.put("application.copyright.year", "2012-2019"); - mapping.put("execution.filetypes", ConfigurationUtils. - getDefaultFileTypes()); - mapping.put("execution.rule.paths", - Arrays.asList( - CommonUtils.buildPath( - ConfigurationUtils.getApplicationPath(), - "rules" - ) - ) - ); - - mapping.put("execution.preambles", new HashMap<String, String>()); - mapping.put("execution.preamble.active", false); - mapping.put("execution.configuration.name", "[none]"); - mapping.put("execution.header", false); - mapping.put("ui.lookandfeel", "none"); - - // get the configuration controller and - // set every map key to it - ConfigurationController controller = - ConfigurationController.getInstance(); - for (String key : mapping.keySet()) { - controller.put(key, mapping.get(key)); - } - } - - /** - * Update the configuration based on the provided map. - * @param data Map containing the new configuration settings. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - private static void update(Resource resource) throws AraraException { - - ConfigurationController controller = - ConfigurationController.getInstance(); - - if (resource.getPaths() != null) { - List<String> paths = resource.getPaths(); - paths = ConfigurationUtils.normalizePaths(paths); - controller.put("execution.rule.paths", paths); - } - - if (resource.getFiletypes() != null) { - List<FileTypeResource> resources = resource.getFiletypes(); - List<FileType> filetypes = new ArrayList<FileType>(); - for (FileTypeResource type : resources) { - if (type.getPattern() != null) { - filetypes.add( - new FileType(type.getExtension(), type.getPattern()) - ); - } else { - filetypes.add(new FileType(type.getExtension())); - } - } - filetypes = ConfigurationUtils.normalizeFileTypes(filetypes); - controller.put("execution.filetypes", filetypes); - } - - controller.put("execution.verbose", resource.isVerbose()); - controller.put("execution.logging", resource.isLogging()); - controller.put("execution.header", resource.isHeader()); - - if (resource.getDbname() != null) { - controller.put("execution.database.name", - ConfigurationUtils.cleanFileName(resource.getDbname())); - } - - if (resource.getLogname() != null) { - controller.put("execution.log.name", - ConfigurationUtils.cleanFileName(resource.getLogname())); - } - - if (resource.getLanguage() != null) { - controller.put("execution.language", - new Language(resource.getLanguage())); - } - - long loops = resource.getLoops(); - if (loops > 0) { - controller.put("execution.loops", loops); - } else { - if (loops < 0) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_CONFIGURATION_LOOPS_INVALID_RANGE - ) - ); - } - } - - if (resource.getPreambles() != null) { - controller.put("execution.preambles", - resource.getPreambles()); - } - - if (resource.getLaf() != null) { - controller.put("ui.lookandfeel", - resource.getLaf()); - } - - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/model/Database.java b/support/arara/source/src/main/java/com/github/cereda/arara/model/Database.java deleted file mode 100644 index 474209e405..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/model/Database.java +++ /dev/null @@ -1,80 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.model; - -import java.util.HashMap; -import org.simpleframework.xml.ElementMap; -import org.simpleframework.xml.Root; - -/** - * The XML database model, which keeps track on file changes. I am using the - * Simple framework to marshall and unmarshall objects and XML files. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -@Root(name = "status") -public class Database { - - // the whole database is implemented as a map, where - // the key is the absolute canonical file and the value - // is its corresponding CRC32 hash; the XML map is done - // inline, so it does not clutter the output a lot - @ElementMap(entry = "hash", key = "file", attribute = true, inline = true) - private HashMap<String, String> map; - - /** - * Constructor. It creates a new map. - */ - public Database() { - map = new HashMap<String, String>(); - } - - /** - * Gets the map. - * @return The map. - */ - public HashMap<String, String> getMap() { - return map; - } - - /** - * Sets the map. - * @param map The map. - */ - public void setMap(HashMap<String, String> map) { - this.map = map; - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/model/Directive.java b/support/arara/source/src/main/java/com/github/cereda/arara/model/Directive.java deleted file mode 100644 index a3831db8b2..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/model/Directive.java +++ /dev/null @@ -1,146 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.model; - -import java.util.List; -import java.util.Map; - -/** - * Implements the directive model. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class Directive { - - // the directive identifier, it is resolved - // to the rule identifier later on - private String identifier; - - // a map containing the parameters; they - // are validated later on in order to - // ensure they are valid - private Map<String, Object> parameters; - - // a conditional containing the type and - // the expression to be evaluated later on - private Conditional conditional; - - // a list contained all line numbers from - // the main file which built the current - // directive - private List<Integer> lineNumbers; - - /** - * Gets the directive identifier. - * @return A string representing the directive identifier. - */ - public String getIdentifier() { - return identifier; - } - - /** - * Sets the directive identifier. - * @param identifier A string representing the directive identifier. - */ - public void setIdentifier(String identifier) { - this.identifier = identifier; - } - - /** - * Gets the directive parameters. - * @return A map containing the directive parameters. - */ - public Map<String, Object> getParameters() { - return parameters; - } - - /** - * Sets the directive parameters. - * @param parameters A map containing the directive parameters. - */ - public void setParameters(Map<String, Object> parameters) { - this.parameters = parameters; - } - - /** - * Gets the conditional object from the current directive. - * @return The conditional object from the current directive. - */ - public Conditional getConditional() { - return conditional; - } - - /** - * Sets the conditional object from the current directive. - * @param conditional The conditional object from the current directive. - */ - public void setConditional(Conditional conditional) { - this.conditional = conditional; - } - - /** - * Gets the list containing all line numbers from the current directive. - * @return A list containing all line numbers from the current directive. - */ - public List<Integer> getLineNumbers() { - return lineNumbers; - } - - /** - * Sets the list containing all line numbers from the current directive. - * @param lineNumbers A list containing all line numbers from the current - * directive. - */ - public void setLineNumbers(List<Integer> lineNumbers) { - this.lineNumbers = lineNumbers; - } - - /** - * Provides a textual representation of the current directive. - * @return A string containing a textual representation of the current - * directive. - */ - @Override - public String toString() { - StringBuilder builder = new StringBuilder(); - builder.append("Directive: { "); - builder.append("identifier: ").append(identifier).append(", "); - builder.append("parameters: ").append(parameters).append(", "); - builder.append("conditional: ").append(conditional).append(", "); - builder.append("lines: ").append(lineNumbers).append(" }"); - return builder.toString(); - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/model/Evaluator.java b/support/arara/source/src/main/java/com/github/cereda/arara/model/Evaluator.java deleted file mode 100644 index 30995ecaf9..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/model/Evaluator.java +++ /dev/null @@ -1,158 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.model; - -import com.github.cereda.arara.controller.ConfigurationController; -import com.github.cereda.arara.controller.LanguageController; -import com.github.cereda.arara.utils.CommonUtils; -import com.github.cereda.arara.utils.Methods; -import java.util.HashMap; -import java.util.Map; -import org.mvel2.templates.TemplateRuntime; - -/** - * Implements the evaluator model, on which a conditional can be analyzed and - * processed. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class Evaluator { - - // this attribute holds the maximum number of - // loops arara will accept; it's like - // reaching infinity - private final long loops; - - // the counter for the current execution, it - // helps us keep track of the number of times - // this evaluation has happened, and also to - // prevent potential infinite loops - private long counter; - - // a flag that indicates the - // evaluation to halt regardless - // of the the result - private boolean halt; - - // the application messages obtained from the - // language controller - private static final LanguageController messages = - LanguageController.getInstance(); - - /** - * Constructor. It gets the application maximum number of loops and reset - * all counters. - */ - public Evaluator() { - loops = (Long) ConfigurationController.getInstance(). - get("execution.loops"); - counter = 0; - halt = false; - } - - /** - * Evaluate the provided conditional. - * @param conditional The conditional object. - * @return A boolean value indicating if the conditional holds. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public boolean evaluate(Conditional conditional) throws AraraException { - - // when in dry-run mode, arara - // always ignore conditional evaluations - if (((Boolean) ConfigurationController. - getInstance().get("execution.dryrun")) == true) { - return false; - } - - switch (conditional.getType()) { - case NONE: - return false; - case IF: - case UNLESS: - if (!halt) { - halt = true; - } else { - return false; - } - break; - } - - // check counters and see if the execution - // has reached our concept of infinity, - // thus breaking the cycles - counter++; - if (((conditional.getType() == Conditional.ConditionalType.WHILE) && - (counter > loops)) || - ((conditional.getType() == Conditional.ConditionalType.UNTIL) && - (counter >= loops))) { - return false; - } else { - - Map<String, Object> context = new HashMap<String, Object>(); - Methods.addConditionalMethods(context); - - try { - Object result = TemplateRuntime.eval("@{ ".concat( - conditional.getCondition()).concat(" }"), context); - if (!CommonUtils.checkClass(Boolean.class, result)) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_EVALUATE_NOT_BOOLEAN_VALUE - ) - ); - } else { - boolean value = (Boolean) result; - switch (conditional.getType()) { - case UNLESS: - case UNTIL: - value = !value; - break; - } - return value; - } - } catch (RuntimeException exception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_EVALUATE_COMPILATION_FAILED - ), - exception - ); - } - } - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/model/Extractor.java b/support/arara/source/src/main/java/com/github/cereda/arara/model/Extractor.java deleted file mode 100644 index b4a248688a..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/model/Extractor.java +++ /dev/null @@ -1,88 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.model; - -import com.github.cereda.arara.controller.ConfigurationController; -import com.github.cereda.arara.controller.LanguageController; -import com.github.cereda.arara.utils.CommonUtils; -import com.github.cereda.arara.utils.DirectiveUtils; -import java.io.File; -import java.io.IOException; -import java.nio.charset.Charset; -import java.util.List; -import org.apache.commons.io.FileUtils; - -/** - * It extracts directives from the provided main file. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class Extractor { - - // the application messages obtained from the - // language controller - private static final LanguageController messages = - LanguageController.getInstance(); - - /** - * Extracts a list of directives from the provided main file, obtained from - * the configuration controller. - * @return A list of directives. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public List<Directive> extract() throws AraraException { - - File file = (File) ConfigurationController. - getInstance().get("execution.reference"); - Charset charset = (Charset) ConfigurationController. - getInstance().get("directives.charset"); - - try { - List<String> content = CommonUtils.getPreambleContent(); - List<String> lines = FileUtils.readLines(file, charset.name()); - content.addAll(lines); - return DirectiveUtils.extractDirectives(content); - } catch (IOException ioexception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_EXTRACTOR_IO_ERROR - ), - ioexception - ); - } - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/model/FileType.java b/support/arara/source/src/main/java/com/github/cereda/arara/model/FileType.java deleted file mode 100644 index e7403bee51..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/model/FileType.java +++ /dev/null @@ -1,170 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.model; - -import com.github.cereda.arara.controller.LanguageController; -import com.github.cereda.arara.utils.CommonUtils; -import java.util.HashMap; -import java.util.Map; -import org.apache.commons.lang.builder.EqualsBuilder; -import org.apache.commons.lang.builder.HashCodeBuilder; - -/** - * Implements the file type model. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class FileType { - - // string representing the - // file extension - private String extension; - - // string representing the - // file pattern to be used - // as directive lookup - private String pattern; - - // the application messages obtained from the - // language controller - private static final LanguageController messages = - LanguageController.getInstance(); - - // a map containing all file - // types that arara accepts - private static final Map<String, String> types = - new HashMap<String, String>(); - - /** - * Initializes the file type class by setting the default file types and - * their corresponding patterns. - */ - public static void init() { - types.put("tex", "^\\s*%\\s+"); - types.put("dtx", "^\\s*%\\s+"); - types.put("ltx", "^\\s*%\\s+"); - types.put("drv", "^\\s*%\\s+"); - types.put("ins", "^\\s*%\\s+"); - } - - /** - * Constructor. It takes both file extension and pattern lookup. - * @param extension The file extension. - * @param pattern The file pattern. - */ - public FileType(String extension, String pattern) { - this.extension = extension; - this.pattern = pattern; - } - - /** - * Constructor. It takes the extension, but it might raise an exception if - * the extension is unknown. This constructor is used when you just want - * to reorganize the file lookup priority without the need of changing the - * default extensions. - * @param extension The file extension. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public FileType(String extension) throws AraraException { - if (types.containsKey(extension)) { - this.extension = extension; - this.pattern = types.get(extension); - } else { - throw new AraraException( - messages.getMessage( - Messages.ERROR_FILETYPE_UNKNOWN_EXTENSION, - extension, - CommonUtils.getFileTypesList() - ) - ); - } - } - - /** - * Implements the file type hash code. Note that only the file extension is - * considered. - * @return An integer representing the file type hash code. - */ - @Override - public int hashCode() { - return new HashCodeBuilder().append(extension).toHashCode(); - } - - /** - * Implements the file type equals method, checking if one file type is - * equal to another. Note that only the file extension is considered. - * @param object The object to be analyzed. - * @return A boolean value indicating if those two objects are equal. - */ - @Override - public boolean equals(Object object) { - if (object == null) { - return false; - } - if (getClass() != object.getClass()) { - return false; - } - final FileType reference = (FileType) object; - return new EqualsBuilder().append(extension, reference.extension).isEquals(); - } - - /** - * Gets the file type extension. - * @return String representing the file type extension. - */ - public String getExtension() { - return extension; - } - - /** - * Gets the file type pattern. - * @return String representing the file type pattern. - */ - public String getPattern() { - return pattern; - } - - /** - * Provides a textual representation of the current file type object. - * @return A string containing a textual representation of the current file - * type object. - */ - @Override - public String toString() { - return ".".concat(extension); - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/model/FileTypeResource.java b/support/arara/source/src/main/java/com/github/cereda/arara/model/FileTypeResource.java deleted file mode 100644 index d23b10f9f5..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/model/FileTypeResource.java +++ /dev/null @@ -1,84 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.model; - -import com.github.cereda.arara.utils.CommonUtils; - -/** - * Implements the file type resource model. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class FileTypeResource { - - // the file extension - private String extension; - - // the file pattern - private String pattern; - - /** - * Gets the extension. - * @return The extension. - */ - public String getExtension() { - return CommonUtils.removeKeyword(extension); - } - - /** - * Sets the extension. - * @param extension The extension. - */ - public void setExtension(String extension) { - this.extension = extension; - } - - /** - * Gets the pattern. - * @return The pattern. - */ - public String getPattern() { - return CommonUtils.removeKeyword(pattern); - } - - /** - * Sets the pattern. - * @param pattern The pattern. - */ - public void setPattern(String pattern) { - this.pattern = pattern; - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/model/Interpreter.java b/support/arara/source/src/main/java/com/github/cereda/arara/model/Interpreter.java deleted file mode 100644 index 30c18a3074..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/model/Interpreter.java +++ /dev/null @@ -1,486 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.model; - -import com.github.cereda.arara.controller.ConfigurationController; -import com.github.cereda.arara.controller.LanguageController; -import com.github.cereda.arara.utils.CommonUtils; -import com.github.cereda.arara.utils.DisplayUtils; -import com.github.cereda.arara.utils.InterpreterUtils; -import com.github.cereda.arara.utils.Methods; -import com.github.cereda.arara.utils.RuleUtils; -import java.io.File; -import java.util.ArrayList; -import java.util.HashMap; -import java.util.List; -import java.util.Map; -import java.util.Set; -import org.mvel2.templates.TemplateRuntime; -import org.slf4j.Logger; -import org.slf4j.LoggerFactory; - -/** - * Interprets the list of directives. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class Interpreter { - - // the application messages obtained from the - // language controller - private static final LanguageController messages - = LanguageController.getInstance(); - - // the class logger obtained from - // the logger factory - private static final Logger logger - = LoggerFactory.getLogger(Interpreter.class); - - // list of directives to be - // interpreted in here - private List<Directive> directives; - - /** - * Sets the list of directives. - * @param directives The list of directives. - */ - public void setDirectives(List<Directive> directives) { - this.directives = directives; - } - - /** - * Executes each directive, throwing an exception if something bad has - * happened. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public void execute() throws AraraException { - - for (Directive directive : directives) { - - logger.info( - messages.getMessage( - Messages.LOG_INFO_INTERPRET_RULE, - directive.getIdentifier() - ) - ); - - ConfigurationController.getInstance(). - put("execution.file", - directive.getParameters().get("reference") - ); - File file = getRule(directive); - - logger.info( - messages.getMessage( - Messages.LOG_INFO_RULE_LOCATION, - file.getParent() - ) - ); - - ConfigurationController.getInstance(). - put("execution.info.rule.id", directive.getIdentifier()); - ConfigurationController.getInstance(). - put("execution.info.rule.path", file.getParent()); - ConfigurationController.getInstance(). - put("execution.directive.lines", - directive.getLineNumbers() - ); - ConfigurationController.getInstance(). - put("execution.directive.reference", - directive.getParameters().get("reference") - ); - - Rule rule = parseRule(file, directive); - Map<String, Object> parameters = parseArguments(rule, directive); - Methods.addRuleMethods(parameters); - - String name = rule.getName(); - List<String> authors = rule.getAuthors() == null - ? new ArrayList<String>() : rule.getAuthors(); - ConfigurationController.getInstance(). - put("execution.rule.arguments", - InterpreterUtils.getRuleArguments(rule) - ); - - Evaluator evaluator = new Evaluator(); - - boolean available = true; - if (InterpreterUtils. - runPriorEvaluation(directive.getConditional())) { - available = evaluator.evaluate(directive.getConditional()); - } - - if (available) { - - do { - - List<RuleCommand> commands = rule.getCommands(); - for (RuleCommand command : commands) { - String closure = command.getCommand(); - Object result = null; - try { - result = TemplateRuntime.eval(closure, parameters); - } catch (RuntimeException exception) { - throw new AraraException( - CommonUtils.getRuleErrorHeader().concat( - messages.getMessage( - Messages.ERROR_INTERPRETER_COMMAND_RUNTIME_ERROR - ) - ), - exception - ); - } - - List<Object> execution = new ArrayList<Object>(); - if (CommonUtils.checkClass(List.class, result)) { - execution = CommonUtils.flatten((List<?>) result); - } else { - execution.add(result); - } - - for (Object current : execution) { - - if (current == null) { - throw new AraraException( - CommonUtils.getRuleErrorHeader().concat( - messages.getMessage( - Messages.ERROR_INTERPRETER_NULL_COMMAND - ) - ) - ); - } else { - - if (!CommonUtils.checkEmptyString( - String.valueOf(current))) { - - DisplayUtils.printEntry(name, - command.getName() == null - ? messages.getMessage( - Messages.INFO_LABEL_UNNAMED_TASK - ) - : command.getName() - ); - boolean success = true; - - if (CommonUtils.checkClass( - Trigger.class, current)) { - if (((Boolean) ConfigurationController. - getInstance(). - get("execution.dryrun")) == false) { - if (((Boolean) ConfigurationController. - getInstance(). - get("execution.verbose")) == true) { - DisplayUtils.wrapText( - messages.getMessage( - Messages.INFO_INTERPRETER_VERBOSE_MODE_TRIGGER_MODE - ) - ); - } - } else { - DisplayUtils.printAuthors(authors); - DisplayUtils.wrapText( - messages.getMessage( - Messages.INFO_INTERPRETER_DRYRUN_MODE_TRIGGER_MODE - ) - ); - DisplayUtils.printConditional( - directive.getConditional() - ); - } - Trigger trigger = (Trigger) current; - trigger.process(); - } else { - if (CommonUtils.checkClass( - Boolean.class, current)) { - success = (Boolean) current; - logger.info( - messages.getMessage( - Messages.LOG_INFO_BOOLEAN_MODE, - String.valueOf(success) - ) - ); - - if (((Boolean) ConfigurationController. - getInstance(). - get("execution.dryrun")) == true) { - - DisplayUtils.printAuthors(authors); - DisplayUtils.wrapText( - messages.getMessage( - Messages.INFO_INTERPRETER_DRYRUN_MODE_BOOLEAN_MODE, - success - ) - ); - DisplayUtils.printConditional( - directive.getConditional() - ); - } - } else { - - Object representation - = CommonUtils.checkClass( - Command.class, - current - ) - ? current - : String.valueOf(current); - logger.info( - messages.getMessage( - Messages.LOG_INFO_SYSTEM_COMMAND, - representation - ) - ); - - if (((Boolean) ConfigurationController. - getInstance(). - get("execution.dryrun")) == false) { - int code = InterpreterUtils. - run(representation); - Object check = null; - try { - Map<String, Object> context - = new HashMap<String, Object>(); - context.put("value", code); - check = TemplateRuntime.eval( - "@{ ".concat( - command.getExit() == null - ? "value == 0" - : command.getExit()).concat(" }"), - context); - } catch (RuntimeException exception) { - throw new AraraException( - CommonUtils.getRuleErrorHeader(). - concat( - messages.getMessage( - Messages.ERROR_INTERPRETER_EXIT_RUNTIME_ERROR - ) - ), - exception - ); - } - if (CommonUtils. - checkClass( - Boolean.class, - check)) { - success = (Boolean) check; - } else { - throw new AraraException( - CommonUtils.getRuleErrorHeader().concat( - messages.getMessage( - Messages.ERROR_INTERPRETER_WRONG_EXIT_CLOSURE_RETURN - ) - ) - ); - } - } else { - DisplayUtils.printAuthors(authors); - DisplayUtils.wrapText( - messages.getMessage( - Messages.INFO_INTERPRETER_DRYRUN_MODE_SYSTEM_COMMAND, - representation - ) - ); - DisplayUtils.printConditional( - directive.getConditional() - ); - } - } - } - - DisplayUtils.printEntryResult(success); - - if (((Boolean) ConfigurationController. - getInstance().get("trigger.halt")) - || (((Boolean) ConfigurationController. - getInstance(). - get("execution.errors.halt") - && !success))) { - return; - } - } - } - } - } - } while (evaluator.evaluate(directive.getConditional())); - } - } - } - - /** - * Gets the rule according to the provided directive. - * @param directive The provided directive. - * @return The absolute canonical path of the rule, given the provided - * directive. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - private File getRule(Directive directive) throws AraraException { - File file = InterpreterUtils.buildRulePath(directive.getIdentifier()); - if (file == null) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_INTERPRETER_RULE_NOT_FOUND, - directive.getIdentifier(), - CommonUtils.getCollectionElements( - CommonUtils.getAllRulePaths(), - "(", - ")", - "; " - ) - ) - ); - } else { - return file; - } - } - - /** - * Parses the rule against the provided directive. - * @param file The file representing the rule. - * @param directive The directive to be analyzed. - * @return A rule object. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - private Rule parseRule(File file, Directive directive) - throws AraraException { - return RuleUtils.parseRule(file, directive.getIdentifier()); - } - - /** - * Parses the rule arguments against the provided directive. - * @param rule The rule object. - * @param directive The directive. - * @return A map containing all arguments resolved according to the - * directive parameters. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - private Map<String, Object> parseArguments(Rule rule, Directive directive) - throws AraraException { - - List<Argument> arguments = rule.getArguments(); - - Set<String> unknown = CommonUtils. - getUnknownKeys(directive.getParameters(), arguments); - unknown.remove("file"); - unknown.remove("reference"); - if (!unknown.isEmpty()) { - throw new AraraException( - CommonUtils.getRuleErrorHeader().concat( - messages.getMessage( - Messages.ERROR_INTERPRETER_UNKNOWN_KEYS, - CommonUtils.getCollectionElements( - unknown, - "(", - ")", - ", " - ) - ) - ) - ); - } - - Map<String, Object> mapping = new HashMap<String, Object>(); - mapping.put("file", directive.getParameters().get("file")); - mapping.put("reference", directive.getParameters().get("reference")); - - Map<String, Object> context = new HashMap<String, Object>(); - context.put("parameters", directive.getParameters()); - context.put("file", directive.getParameters().get("file")); - context.put("reference", directive.getParameters().get("reference")); - Methods.addRuleMethods(context); - - for (Argument argument : arguments) { - if ((argument.isRequired()) - && (!directive.getParameters().containsKey( - argument.getIdentifier()))) { - throw new AraraException( - CommonUtils.getRuleErrorHeader().concat( - messages.getMessage( - Messages.ERROR_INTERPRETER_ARGUMENT_IS_REQUIRED, - argument.getIdentifier() - ) - ) - ); - } - - if (argument.getDefault() != null) { - try { - Object result = TemplateRuntime. - eval(argument.getDefault(), context); - mapping.put(argument.getIdentifier(), result); - } catch (RuntimeException exception) { - throw new AraraException( - CommonUtils.getRuleErrorHeader(). - concat(messages.getMessage( - Messages.ERROR_INTERPRETER_DEFAULT_VALUE_RUNTIME_ERROR - ) - ), - exception - ); - } - } else { - mapping.put(argument.getIdentifier(), ""); - } - - if ((argument.getFlag() != null) - && (directive.getParameters().containsKey( - argument.getIdentifier()))) { - - try { - Object result = TemplateRuntime.eval( - argument.getFlag(), - context - ); - mapping.put(argument.getIdentifier(), result); - } catch (RuntimeException exception) { - throw new AraraException(CommonUtils.getRuleErrorHeader(). - concat( - messages.getMessage( - Messages.ERROR_INTERPRETER_FLAG_RUNTIME_EXCEPTION - ) - ), - exception - ); - } - } - } - - return mapping; - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/model/Language.java b/support/arara/source/src/main/java/com/github/cereda/arara/model/Language.java deleted file mode 100644 index ff1b16a03f..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/model/Language.java +++ /dev/null @@ -1,148 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.model; - -import com.github.cereda.arara.controller.LanguageController; -import com.github.cereda.arara.utils.CommonUtils; -import java.util.ArrayList; -import java.util.HashMap; -import java.util.List; -import java.util.Locale; -import java.util.Map; - -/** - * Implements the language model. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class Language { - - // the language code, based on - // ISO 639-1 and language variants - private final String code; - - // map containing all languages - // supported by nightingale - private static final Map<String, Pair<String, Locale>> languages = - new HashMap<String, Pair<String, Locale>>(); - - // the application messages obtained from the - // language controller - private static final LanguageController messages = - LanguageController.getInstance(); - - /** - * Initialize the language model. All supported languages are added in here. - */ - public static void init() { - languages.put("en", new Pair<String, Locale>( - "English", - new Locale("en") - )); - languages.put("de", new Pair<String, Locale>( - "German", - new Locale("de") - )); - languages.put("nl", new Pair<String, Locale>( - "Dutch", - new Locale("nl") - )); - languages.put("qn", new Pair<String, Locale>( - "Broad Norfolk", - new Locale("en", "QN") - )); - languages.put("ptbr", new Pair<String, Locale>( - "Brazilian Portuguese", - new Locale("pt", "BR") - )); - languages.put("it", new Pair<String, Locale>( - "Italian", - new Locale("it") - )); - } - - /** - * Creates a new language object. It might raise an exception if the - * provided language does not exist in the map. - * @param code The language code, based on ISO 639-1 and language variants. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public Language(String code) throws AraraException { - if (languages.containsKey(code)) { - this.code = code; - } else { - throw new AraraException( - messages.getMessage( - Messages.ERROR_LANGUAGE_INVALID_CODE, - getLanguagesList() - ) - ); - } - } - - /** - * Gets the language name. - * @return A string representing the language name. - */ - public String getName() { - return languages.get(code).getFirstElement(); - } - - /** - * Gets the language locale. - * @return The language locale. - */ - public Locale getLocale() { - return languages.get(code).getSecondElement(); - } - - /** - * Gets a string representing the list of available languages. - * @return String representing the list of available languages. - */ - public static String getLanguagesList() { - List<String> entries = new ArrayList<String>(); - for (String key : languages.keySet()) { - entries.add(languages.get(key). - getFirstElement(). - concat(": "). - concat(key) - ); - } - return CommonUtils.getCollectionElements(entries, "(", ")", ", "); - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/model/Messages.java b/support/arara/source/src/main/java/com/github/cereda/arara/model/Messages.java deleted file mode 100644 index 901e61be6a..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/model/Messages.java +++ /dev/null @@ -1,173 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.model; - -import ch.qos.cal10n.BaseName; -import ch.qos.cal10n.Locale; -import ch.qos.cal10n.LocaleData; - -/** - * This enumeration contains all application messages. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -@BaseName("com.github.cereda.arara.localization.messages") -@LocaleData({ - @Locale(value = "de", charset = "UTF-8"), - @Locale(value = "en", charset = "UTF-8"), - @Locale(value = "en_QN", charset = "UTF-8"), - @Locale(value = "it", charset = "UTF-8"), - @Locale(value = "nl", charset = "UTF-8"), - @Locale(value = "pt_BR", charset = "UTF-8") -}) -public enum Messages { - - ERROR_BASENAME_NOT_A_FILE, - ERROR_CALCULATEHASH_IO_EXCEPTION, - ERROR_CHECKBOOLEAN_NOT_VALID_BOOLEAN, - ERROR_CHECKOS_INVALID_OPERATING_SYSTEM, - ERROR_CHECKREGEX_IO_EXCEPTION, - ERROR_CONFIGURATION_GENERIC_ERROR, - ERROR_CONFIGURATION_INVALID_YAML, - ERROR_CONFIGURATION_LOOPS_INVALID_RANGE, - ERROR_DISCOVERFILE_FILE_NOT_FOUND, - ERROR_EVALUATE_COMPILATION_FAILED, - ERROR_EVALUATE_NOT_BOOLEAN_VALUE, - ERROR_EXTRACTOR_IO_ERROR, - ERROR_FILETYPE_NOT_A_FILE, - ERROR_FILETYPE_UNKNOWN_EXTENSION, - ERROR_GETAPPLICATIONPATH_ENCODING_EXCEPTION, - ERROR_GETCANONICALFILE_IO_EXCEPTION, - ERROR_GETCANONICALPATH_IO_EXCEPTION, - ERROR_GETPARENTCANONICALPATH_IO_EXCEPTION, - ERROR_INTERPRETER_ARGUMENT_IS_REQUIRED, - ERROR_INTERPRETER_COMMAND_RUNTIME_ERROR, - ERROR_INTERPRETER_DEFAULT_VALUE_RUNTIME_ERROR, - ERROR_INTERPRETER_EXIT_RUNTIME_ERROR, - ERROR_INTERPRETER_FLAG_RUNTIME_EXCEPTION, - ERROR_INTERPRETER_NULL_COMMAND, - ERROR_INTERPRETER_RULE_NOT_FOUND, - ERROR_INTERPRETER_UNKNOWN_KEYS, - ERROR_INTERPRETER_WRONG_EXIT_CLOSURE_RETURN, - ERROR_ISSUBDIRECTORY_NOT_A_DIRECTORY, - ERROR_LANGUAGE_INVALID_CODE, - ERROR_LOAD_COULD_NOT_LOAD_XML, - ERROR_PARSER_INVALID_PREAMBLE, - ERROR_PARSER_LOOPS_INVALID_RANGE, - ERROR_PARSER_LOOPS_NAN, - ERROR_PARSER_TIMEOUT_INVALID_RANGE, - ERROR_PARSER_TIMEOUT_NAN, - ERROR_PARSERULE_GENERIC_ERROR, - ERROR_PARSERULE_INVALID_YAML, - ERROR_REPLICATELIST_MISSING_FORMAT_ARGUMENTS_EXCEPTION, - ERROR_RULE_IDENTIFIER_AND_PATH, - ERROR_RUN_GENERIC_EXCEPTION, - ERROR_RUN_INTERRUPTED_EXCEPTION, - ERROR_RUN_INVALID_EXIT_VALUE_EXCEPTION, - ERROR_RUN_IO_EXCEPTION, - ERROR_RUN_TIMEOUT_EXCEPTION, - ERROR_RUN_TIMEOUT_INVALID_RANGE, - ERROR_SAVE_COULD_NOT_SAVE_XML, - ERROR_SESSION_OBTAIN_UNKNOWN_KEY, - ERROR_SESSION_REMOVE_UNKNOWN_KEY, - ERROR_TRIGGER_ACTION_NOT_FOUND, - ERROR_TRIGGER_CALL_EXCEPTION, - ERROR_VALIDATE_EMPTY_FILES_LIST, - ERROR_VALIDATE_FILE_IS_RESERVED, - ERROR_VALIDATE_FILES_IS_NOT_A_LIST, - ERROR_VALIDATE_INVALID_DIRECTIVE_FORMAT, - ERROR_VALIDATE_NO_DIRECTIVES_FOUND, - ERROR_VALIDATE_ORPHAN_LINEBREAK, - ERROR_VALIDATE_REFERENCE_IS_RESERVED, - ERROR_VALIDATE_YAML_EXCEPTION, - ERROR_VALIDATEBODY_ARGUMENT_ID_IS_RESERVED, - ERROR_VALIDATEBODY_ARGUMENTS_LIST, - ERROR_VALIDATEBODY_DUPLICATE_ARGUMENT_IDENTIFIERS, - ERROR_VALIDATEBODY_MISSING_KEYS, - ERROR_VALIDATEBODY_NULL_ARGUMENT_ID, - ERROR_VALIDATEBODY_NULL_COMMAND, - ERROR_VALIDATEBODY_NULL_COMMANDS_LIST, - ERROR_VALIDATEHEADER_NULL_ID, - ERROR_VALIDATEHEADER_NULL_NAME, - ERROR_VALIDATEHEADER_WRONG_IDENTIFIER, - ERROR_VELOCITY_FILE_NOT_FOUND, - ERROR_VELOCITY_PARSE_EXCEPTION, - ERROR_VELOCITY_METHOD_INVOCATION_EXCEPTION, - ERROR_VELOCITY_IO_EXCEPTION, - INFO_DISPLAY_EXCEPTION_MORE_DETAILS, - INFO_DISPLAY_EXECUTION_TIME, - INFO_DISPLAY_FILE_INFORMATION, - INFO_INTERPRETER_DRYRUN_MODE_BOOLEAN_MODE, - INFO_INTERPRETER_DRYRUN_MODE_SYSTEM_COMMAND, - INFO_INTERPRETER_DRYRUN_MODE_TRIGGER_MODE, - INFO_INTERPRETER_VERBOSE_MODE_TRIGGER_MODE, - INFO_LABEL_AUTHOR, - INFO_LABEL_AUTHORS, - INFO_LABEL_CONDITIONAL, - INFO_LABEL_NO_AUTHORS, - INFO_LABEL_ON_DETAILS, - INFO_LABEL_ON_ERROR, - INFO_LABEL_ON_FAILURE, - INFO_LABEL_ON_SUCCESS, - INFO_LABEL_UNNAMED_TASK, - INFO_PARSER_ALL_RIGHTS_RESERVED, - INFO_PARSER_DRYRUN_MODE_DESCRIPTION, - INFO_PARSER_HELP_DESCRIPTION, - INFO_PARSER_LANGUAGE_DESCRIPTION, - INFO_PARSER_LOG_DESCRIPTION, - INFO_PARSER_LOOPS_DESCRIPTION, - INFO_PARSER_NOTES, - INFO_PARSER_ONLY_HEADER, - INFO_PARSER_PREAMBLE_DESCRIPTION, - INFO_PARSER_SILENT_MODE_DESCRIPTION, - INFO_PARSER_TIMEOUT_DESCRIPTION, - INFO_PARSER_VERBOSE_MODE_DESCRIPTION, - INFO_PARSER_VERSION_DESCRIPTION, - LOG_INFO_BEGIN_BUFFER, - LOG_INFO_BOOLEAN_MODE, - LOG_INFO_DIRECTIVES_BLOCK, - LOG_INFO_END_BUFFER, - LOG_INFO_INTERPRET_RULE, - LOG_INFO_INTERPRET_TASK, - LOG_INFO_POTENTIAL_DIRECTIVE_FOUND, - LOG_INFO_POTENTIAL_PATTERN_FOUND, - LOG_INFO_RULE_LOCATION, - LOG_INFO_SYSTEM_COMMAND, - LOG_INFO_TASK_RESULT, - LOG_INFO_VALIDATED_DIRECTIVES, - LOG_INFO_WELCOME_MESSAGE, - ERROR_CONFIGURATION_FILETYPE_MISSING_EXTENSION - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/model/Pair.java b/support/arara/source/src/main/java/com/github/cereda/arara/model/Pair.java deleted file mode 100644 index 427a5fca1d..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/model/Pair.java +++ /dev/null @@ -1,92 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.model; - -/** - * Implements a pair of objects. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class Pair<T, V> { - - // first element of the pair - private final T firstElement; - - // second element of the pair - private final V secondElement; - - /** - * Constructor. - * @param firstElement The first element. - * @param secondElement The second element. - */ - public Pair(T firstElement, V secondElement) { - this.firstElement = firstElement; - this.secondElement = secondElement; - } - - /** - * Gets the first element. - * @return The first element. - */ - public T getFirstElement() { - return firstElement; - } - - /** - * Gets the second element. - * @return The second element. - */ - public V getSecondElement() { - return secondElement; - } - - /** - * A shorter version for getting the first element. - * @return The first element. - */ - public T first() { - return getFirstElement(); - } - - /** - * A shorter version for getting the second element. - * @return The second element. - */ - public V second() { - return getSecondElement(); - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/model/Parser.java b/support/arara/source/src/main/java/com/github/cereda/arara/model/Parser.java deleted file mode 100644 index 681c2f8fef..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/model/Parser.java +++ /dev/null @@ -1,410 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.model; - -import com.github.cereda.arara.controller.ConfigurationController; -import com.github.cereda.arara.controller.LanguageController; -import com.github.cereda.arara.controller.LoggingController; -import com.github.cereda.arara.utils.CommonUtils; -import com.github.cereda.arara.utils.DisplayUtils; -import java.util.Locale; -import java.util.Map; -import org.apache.commons.cli.CommandLine; -import org.apache.commons.cli.CommandLineParser; -import org.apache.commons.cli.DefaultParser; -import org.apache.commons.cli.HelpFormatter; -import org.apache.commons.cli.Option; -import org.apache.commons.cli.Options; -import org.apache.commons.cli.ParseException; - -/** - * Implements the command line parser. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class Parser { - - // command line arguments to be - // processed by this parser - private final String[] arguments; - - // command line options, it will - // group each option available - // in arara - private Options options; - - // each option available in - // arara - private Option version; - private Option help; - private Option log; - private Option verbose; - private Option silent; - private Option dryrun; - private Option timeout; - private Option language; - private Option loops; - private Option preamble; - private Option onlyheader; - - public Parser() { - this.arguments = null; - } - - // the application messages obtained from the - // language controller - private static final LanguageController messages = - LanguageController.getInstance(); - - /** - * Constructor. - * @param arguments Array of strings representing the command line - * arguments. - */ - public Parser(String[] arguments) { - this.arguments = arguments; - } - - /** - * Parses the command line arguments. - * @return A boolean value indicating if the parsing should allow the - * application to look for directives in the provided main file. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public boolean parse() throws AraraException { - - // create new instances of the - // command line options, including - // the ones that require arguments - version = new Option("V", "version", false, ""); - help = new Option("h", "help", false, ""); - log = new Option("l", "log", false, ""); - verbose = new Option("v", "verbose", false, ""); - silent = new Option("s", "silent", false, ""); - dryrun = new Option("n", "dry-run", false, ""); - timeout = new Option("t", "timeout", true, ""); - timeout.setArgName("number"); - language = new Option("L", "language", true, ""); - language.setArgName("code"); - loops = new Option("m", "max-loops", true, ""); - loops.setArgName("number"); - preamble = new Option("p", "preamble", true, ""); - preamble.setArgName("name"); - onlyheader = new Option("H", "header", false, ""); - - // add all options to the options - // group, so they are recognized - // by the command line parser - options = new Options(); - options.addOption(version); - options.addOption(help); - options.addOption(log); - options.addOption(verbose); - options.addOption(silent); - options.addOption(dryrun); - options.addOption(timeout); - options.addOption(language); - options.addOption(loops); - options.addOption(preamble); - options.addOption(onlyheader); - - // update all descriptions based - // on the localized messages - updateDescriptions(); - - // a new default command line - // parser is created and the - // arguments are parsed - CommandLineParser parser = new DefaultParser(); - - try { - - CommandLine line = parser.parse(options, arguments); - - String reference; - if (line.hasOption("language")) { - ConfigurationController.getInstance(). - put("execution.language", - new Language(line.getOptionValue("language")) - ); - Locale locale = ((Language) ConfigurationController. - getInstance().get("execution.language")).getLocale(); - messages.setLocale(locale); - updateDescriptions(); - } - - if (line.hasOption("help")) { - printVersion(); - printUsage(); - return false; - } - - if (line.hasOption("version")) { - printVersion(); - printNotes(); - return false; - } - - if (line.getArgs().length != 1) { - printVersion(); - printUsage(); - return false; - } else { - reference = line.getArgs()[0]; - } - - if (line.hasOption("timeout")) { - try { - long value = Long.parseLong(line.getOptionValue("timeout")); - if (value <= 0) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_PARSER_TIMEOUT_INVALID_RANGE - ) - ); - } else { - ConfigurationController.getInstance(). - put("execution.timeout", true); - ConfigurationController.getInstance(). - put("execution.timeout.value", value); - } - } catch (NumberFormatException nfexception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_PARSER_TIMEOUT_NAN - ) - ); - } - } - - if (line.hasOption("max-loops")) { - try { - long value = Long.parseLong( - line.getOptionValue("max-loops") - ); - if (value <= 0) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_PARSER_LOOPS_INVALID_RANGE - ) - ); - } else { - ConfigurationController.getInstance(). - put("execution.loops", value); - } - } catch (NumberFormatException nfexception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_PARSER_LOOPS_NAN - ) - ); - } - } - - if (line.hasOption("verbose")) { - ConfigurationController.getInstance(). - put("execution.verbose", true); - } - - if (line.hasOption("silent")) { - ConfigurationController.getInstance(). - put("execution.verbose", false); - } - - if (line.hasOption("dry-run")) { - ConfigurationController.getInstance(). - put("execution.dryrun", true); - ConfigurationController.getInstance(). - put("execution.errors.halt", false); - } - - if (line.hasOption("log")) { - ConfigurationController.getInstance(). - put("execution.logging", true); - } - - if (line.hasOption("preamble")) { - @SuppressWarnings("unchecked") - Map<String, String> preambles = (Map<String, String>) - ConfigurationController.getInstance(). - get("execution.preambles"); - if (preambles.containsKey(line.getOptionValue("preamble"))) { - ConfigurationController.getInstance(). - put("execution.preamble.active", true); - ConfigurationController.getInstance(). - put("execution.preamble.content", - preambles.get(line.getOptionValue("preamble")) - ); - } - else { - throw new AraraException( - messages.getMessage( - Messages.ERROR_PARSER_INVALID_PREAMBLE, - line.getOptionValue("preamble") - ) - ); - } - } - - if (line.hasOption("header")) { - ConfigurationController.getInstance(). - put("execution.header", true); - } - - CommonUtils.discoverFile(reference); - LoggingController.enableLogging((Boolean) ConfigurationController. - getInstance().get("execution.logging")); - ConfigurationController.getInstance().put("display.time", true); - - return true; - - } catch (ParseException pexception) { - printVersion(); - printUsage(); - return false; - } - } - - /** - * Prints the application usage. - */ - private void printUsage() { - HelpFormatter formatter = new HelpFormatter(); - StringBuilder builder = new StringBuilder(); - builder.append("arara [file [--dry-run] [--log] "); - builder.append("[--verbose | --silent] [--timeout N] "); - builder.append("[--max-loops N] [--language L] "); - builder.append("[ --preamble P ] [--header] | --help | --version]"); - formatter.printHelp(builder.toString(), options); - } - - /** - * Prints the application version. - */ - private void printVersion() { - String year = (String) ConfigurationController.getInstance(). - get("application.copyright.year"); - String number = (String) ConfigurationController.getInstance(). - get("application.version"); - String revision = (String) ConfigurationController.getInstance(). - get("application.revision"); - StringBuilder builder = new StringBuilder(); - builder.append("arara "); - builder.append(number); - builder.append(" (revision "); - builder.append(revision); - builder.append(")"); - builder.append("\n"); - builder.append("Copyright (c) ").append(year).append(", "); - builder.append("Paulo Roberto Massa Cereda"); - builder.append("\n"); - builder.append(messages.getMessage( - Messages.INFO_PARSER_ALL_RIGHTS_RESERVED) - ); - builder.append("\n"); - System.out.println(builder.toString()); - } - - /** - * Print the application notes. - */ - private void printNotes() { - DisplayUtils.wrapText(messages.getMessage(Messages.INFO_PARSER_NOTES)); - } - - /** - * Updates all the descriptions in order to make them reflect the current - * language setting. - */ - private void updateDescriptions() { - version.setDescription( - messages.getMessage( - Messages.INFO_PARSER_VERSION_DESCRIPTION - ) - ); - help.setDescription( - messages.getMessage( - Messages.INFO_PARSER_HELP_DESCRIPTION - ) - ); - log.setDescription( - messages.getMessage( - Messages.INFO_PARSER_LOG_DESCRIPTION - ) - ); - verbose.setDescription( - messages.getMessage( - Messages.INFO_PARSER_VERBOSE_MODE_DESCRIPTION - ) - ); - silent.setDescription( - messages.getMessage( - Messages.INFO_PARSER_SILENT_MODE_DESCRIPTION - ) - ); - dryrun.setDescription( - messages.getMessage( - Messages.INFO_PARSER_DRYRUN_MODE_DESCRIPTION - ) - ); - timeout.setDescription( - messages.getMessage( - Messages.INFO_PARSER_TIMEOUT_DESCRIPTION - ) - ); - language.setDescription( - messages.getMessage( - Messages.INFO_PARSER_LANGUAGE_DESCRIPTION - ) - ); - loops.setDescription( - messages.getMessage( - Messages.INFO_PARSER_LOOPS_DESCRIPTION - ) - ); - preamble.setDescription( - messages.getMessage( - Messages.INFO_PARSER_PREAMBLE_DESCRIPTION - ) - ); - onlyheader.setDescription( - messages.getMessage( - Messages.INFO_PARSER_ONLY_HEADER - ) - ); - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/model/Resource.java b/support/arara/source/src/main/java/com/github/cereda/arara/model/Resource.java deleted file mode 100644 index 58eaa0dc40..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/model/Resource.java +++ /dev/null @@ -1,291 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.model; - -import com.github.cereda.arara.utils.CommonUtils; -import java.util.ArrayList; -import java.util.Collection; -import java.util.HashMap; -import java.util.List; -import java.util.Map; -import org.apache.commons.collections4.CollectionUtils; -import org.apache.commons.collections4.Transformer; -import org.apache.commons.lang.SystemUtils; -import org.mvel2.templates.TemplateRuntime; - -/** - * Implements the configuration resource model. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class Resource { - - // rule paths - private List<String> paths; - - // file types - private List<FileTypeResource> filetypes; - - // the application language - private String language; - - // maximum number of loops - private long loops; - - // verbose flag - private boolean verbose; - - // logging flag - private boolean logging; - - // database name - private String dbname; - - // log name - private String logname; - - // header flag - private boolean header; - - // map of preambles - private Map<String, String> preambles; - - // look and feel - private String laf; - - /** - * Gets the rule paths. - * @return The rule paths. - */ - public List<String> getPaths() { - if (paths != null) { - - final Map<String, Object> map = new HashMap<String, Object>(); - Map<String, Object> user = new HashMap<String, Object>(); - user.put("home", SystemUtils.USER_HOME); - user.put("dir", SystemUtils.USER_DIR); - user.put("name", SystemUtils.USER_NAME); - map.put("user", user); - - Collection<String> result = CollectionUtils.collect( - paths, new Transformer<String, String>() { - public String transform(String input) { - String path = CommonUtils.removeKeyword(input); - try { - path = (String) TemplateRuntime.eval(path, map); - } - catch (RuntimeException nothandled) { - // do nothing, gracefully fallback to - // the default, unparsed path - } - return path; - } - }); - paths = new ArrayList<String>(result); - } - return paths; - } - - /** - * Sets the rule paths. - * @param paths The rule paths. - */ - public void setPaths(List<String> paths) { - this.paths = paths; - } - - /** - * Gets the list of file types. - * @return The list of file types. - */ - public List<FileTypeResource> getFiletypes() { - return filetypes; - } - - /** - * Sets the list of file types. - * @param filetypes The list of file types. - */ - public void setFiletypes(List<FileTypeResource> filetypes) { - this.filetypes = filetypes; - } - - /** - * Gets the language. - * @return The language. - */ - public String getLanguage() { - return CommonUtils.removeKeyword(language); - } - - /** - * Sets the language. - * @param language The language. - */ - public void setLanguage(String language) { - this.language = language; - } - - /** - * Get the maximum number of loops. - * @return The maximum number of loops. - */ - public long getLoops() { - return loops; - } - - /** - * Sets the maximum number of loops. - * @param loops The maximum number of loops. - */ - public void setLoops(long loops) { - this.loops = loops; - } - - /** - * Checks if verbose mode is active. - * @return A boolean value. - */ - public boolean isVerbose() { - return verbose; - } - - /** - * Sets the verbose mode. - * @param verbose A boolean value. - */ - public void setVerbose(boolean verbose) { - this.verbose = verbose; - } - - /** - * Checks if logging mode is active. - * @return A boolean value. - */ - public boolean isLogging() { - return logging; - } - - /** - * Sets the logging mode. - * @param logging A boolean value. - */ - public void setLogging(boolean logging) { - this.logging = logging; - } - - /** - * Gets the database name. - * @return The database name. - */ - public String getDbname() { - return CommonUtils.removeKeyword(dbname); - } - - /** - * Sets the database name. - * @param dbname The database name. - */ - public void setDbname(String dbname) { - this.dbname = dbname; - } - - /** - * Gets the log name. - * @return The log name. - */ - public String getLogname() { - return CommonUtils.removeKeyword(logname); - } - - /** - * Sets the log name. - * @param logname The log name. - */ - public void setLogname(String logname) { - this.logname = logname; - } - - /** - * Gets the map of preambles. - * @return Map of preambles. - */ - public Map<String, String> getPreambles() { - return preambles; - } - - /** - * Sets the map of preambles. - * @param preambles Map of preambles. - */ - public void setPreambles(Map<String, String> preambles) { - this.preambles = preambles; - } - - /** - * Gets the logical value of the header flag. - * @return Logical value of the header flag. - */ - public boolean isHeader() { - return header; - } - - /** - * Sets the logical value of the header flag. - * @param header The header flag. - */ - public void setHeader(boolean header) { - this.header = header; - } - - /** - * Gets the look and feel reference. - * @return The look and feel reference. - */ - public String getLaf() { - return CommonUtils.removeKeyword(laf); - } - - /** - * Sets the look and feel reference. - * @param laf The look and feel reference. - */ - public void setLaf(String laf) { - this.laf = laf; - } - - - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/model/Rule.java b/support/arara/source/src/main/java/com/github/cereda/arara/model/Rule.java deleted file mode 100644 index acf43cdf58..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/model/Rule.java +++ /dev/null @@ -1,155 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.model; - -import com.github.cereda.arara.utils.CommonUtils; -import java.util.ArrayList; -import java.util.Collection; -import java.util.List; -import org.apache.commons.collections4.CollectionUtils; -import org.apache.commons.collections4.Transformer; - -/** - * Implements the rule model. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class Rule { - - // the rule identifier - private String identifier; - - // the rule name - private String name; - - // the list of authors - private List<String> authors; - - // the list of commands - private List<RuleCommand> commands; - - // the list of arguments - private List<Argument> arguments; - - /** - * Gets the rule identifier. - * @return The rule identifier. - */ - public String getIdentifier() { - return CommonUtils.removeKeyword(identifier); - } - - /** - * Sets the rule identifier. - * @param identifier The rule identifier. - */ - public void setIdentifier(String identifier) { - this.identifier = identifier; - } - - /** - * Gets the rule identifier. - * @return The rule identifier. - */ - public String getName() { - return CommonUtils.removeKeyword(name); - } - - /** - * Sets the rule name. - * @param name The rule name. - */ - public void setName(String name) { - this.name = name; - } - - /** - * Gets the list of authors. - * @return A list of authors. - */ - public List<String> getAuthors() { - if (authors != null) { - Collection<String> result = CollectionUtils.collect( - authors, new Transformer<String, String>() { - public String transform(String input) { - return CommonUtils.removeKeyword(input); - } - }); - authors = new ArrayList<String>(result); - } - return authors; - } - - /** - * Sets the list of authors. - * @param authors The list of authors. - */ - public void setAuthors(List<String> authors) { - this.authors = authors; - } - - /** - * Gets the list of commands. - * @return The list of commands. - */ - public List<RuleCommand> getCommands() { - return commands; - } - - /** - * Sets the list of commands. - * @param commands The list of commands. - */ - public void setCommands(List<RuleCommand> commands) { - this.commands = commands; - } - - /** - * Gets the list of arguments. - * @return The list of arguments. - */ - public List<Argument> getArguments() { - return arguments; - } - - /** - * Sets the list of arguments. - * @param arguments The list of arguments. - */ - public void setArguments(List<Argument> arguments) { - this.arguments = arguments; - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/model/RuleCommand.java b/support/arara/source/src/main/java/com/github/cereda/arara/model/RuleCommand.java deleted file mode 100644 index e63430afeb..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/model/RuleCommand.java +++ /dev/null @@ -1,103 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.model; - -import com.github.cereda.arara.utils.CommonUtils; - -/** - * Implements the rule command model. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class RuleCommand { - - // the command name - private String name; - - // the command instruction - private String command; - - // the exit status expression - private String exit; - - /** - * Gets the command name. - * @return The command name. - */ - public String getName() { - return CommonUtils.removeKeyword(name); - } - - /** - * Sets the command name. - * @param name The command name. - */ - public void setName(String name) { - this.name = name; - } - - /** - * Gets the command instruction. - * @return The command instruction. - */ - public String getCommand() { - return CommonUtils.removeKeyword(command); - } - - /** - * Sets the command instruction. - * @param command The command instruction. - */ - public void setCommand(String command) { - this.command = command; - } - - /** - * Gets the exit status expression. - * @return The exit status expression. - */ - public String getExit() { - return CommonUtils.removeKeyword(exit); - } - - /** - * Sets the exit status expression. - * @param exit The exit status expression. - */ - public void setExit(String exit) { - this.exit = exit; - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/model/Session.java b/support/arara/source/src/main/java/com/github/cereda/arara/model/Session.java deleted file mode 100644 index 4462c5e369..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/model/Session.java +++ /dev/null @@ -1,122 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.model; - -import com.github.cereda.arara.controller.LanguageController; -import com.github.cereda.arara.controller.SessionController; - -/** - * Implements the session model. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class Session { - - // get the current instance from the - // session controller - private static final SessionController session = - SessionController.getInstance(); - - // the application messages obtained from the - // language controller - private static final LanguageController messages = - LanguageController.getInstance(); - - /** - * Inserts the object into the session, indexed by the provided key. - * @param key The provided key. - * @param value The value to be inserted. - */ - public void insert(String key, Object value) { - session.put(key, value); - } - - /** - * Removes the entry indexed by the provided key from the session. - * @param key The provided key. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public void remove(String key) throws AraraException { - if (session.contains(key)) { - session.remove(key); - } else { - throw new AraraException( - messages.getMessage( - Messages.ERROR_SESSION_REMOVE_UNKNOWN_KEY, - key - ) - ); - } - } - - /** - * Checks if the provided key exists in the session. - * @param key The provided key. - * @return A boolean value indicating if the provided key exists in the - * session. - */ - public boolean exists(String key) { - return session.contains(key); - } - - /** - * Clears the session. - */ - public void forget() { - session.clear(); - } - - /** - * Gets the object indexed by the provided key from the session. - * @param key The provided key. - * @return The object indexed by the provided key. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public Object obtain(String key) throws AraraException { - if (session.contains(key)) { - return session.get(key); - } else { - throw new AraraException( - messages.getMessage( - Messages.ERROR_SESSION_OBTAIN_UNKNOWN_KEY, - key - ) - ); - } - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/model/StopWatch.java b/support/arara/source/src/main/java/com/github/cereda/arara/model/StopWatch.java deleted file mode 100644 index da7062cf19..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/model/StopWatch.java +++ /dev/null @@ -1,84 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.model; - -import com.github.cereda.arara.controller.ConfigurationController; - -/** - * Implements a stopwatch. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class StopWatch { - - // two variables indicating the - // times the stopwatch started - // and stopped - private static long beginning = 0; - private static long end = 0; - - // a variable to indicate the - // stopwatch is enabled; so far, - // it hasn't started, then it is - // not enabled - private static boolean enabled = false; - - /** - * Starts the stopwatch. - */ - public static void start() { - beginning = System.nanoTime(); - enabled = true; - } - - /** - * Stops the stopwatch. - */ - public static void stop() { - end = System.nanoTime(); - } - - /** - * Gets the string representation of the elapsed time. - * @return A string representation of the elapsed time. - */ - public static String getTime() { - Language language = (Language) ConfigurationController. - getInstance().get("execution.language"); - double result = enabled ? (double) (end - beginning) / 1000000000 : 0.0; - return String.format(language.getLocale(), "%1.2f", result); - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/model/Trigger.java b/support/arara/source/src/main/java/com/github/cereda/arara/model/Trigger.java deleted file mode 100644 index 7d8ae6ce79..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/model/Trigger.java +++ /dev/null @@ -1,135 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.model; - -import com.github.cereda.arara.controller.ConfigurationController; -import com.github.cereda.arara.controller.LanguageController; -import java.util.HashMap; -import java.util.List; -import java.util.Map; -import java.util.concurrent.Callable; - -/** - * Implements the trigger model. The tool provides triggers, which are a way - * to alter its internal behaviour according to a list of parameters. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class Trigger { - - // the action name and its - // list of parameters - private final String action; - private final List<Object> parameters; - - // the application messages obtained from the - // language controller - private static final LanguageController messages = - LanguageController.getInstance(); - - /** - * Constructor. - * @param action The action name. - * @param parameters The list of parameters. - */ - public Trigger(String action, List<Object> parameters) { - this.action = action; - this.parameters = parameters; - } - - /** - * Gets the action name. - * @return The action name. - */ - public String getAction() { - return action; - } - - /** - * Gets the list of parameters. - * @return The list of parameters. - */ - public List<Object> getParameters() { - return parameters; - } - - /** - * Returns a textual representation of the current trigger. - * @return A string containing a textual representation of the current - * trigger. - */ - @Override - public String toString() { - return "trigger"; - } - - /** - * Processes the current trigger. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public void process() throws AraraException { - - Map<String, Callable<Object>> mapping = - new HashMap<String, Callable<Object>>(); - mapping.put("halt", new Callable<Object>() { - public Object call() { - ConfigurationController.getInstance().put("trigger.halt", true); - return null; - } - }); - if (mapping.containsKey(action)) { - try { - mapping.get(action).call(); - } catch (Exception exception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_TRIGGER_CALL_EXCEPTION, - action - ), - exception - ); - } - } else { - throw new AraraException( - messages.getMessage( - Messages.ERROR_TRIGGER_ACTION_NOT_FOUND, - action - ) - ); - } - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/utils/ClassLoadingUtils.java b/support/arara/source/src/main/java/com/github/cereda/arara/utils/ClassLoadingUtils.java deleted file mode 100644 index fdd642e21d..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/utils/ClassLoadingUtils.java +++ /dev/null @@ -1,166 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.utils; - -import com.github.cereda.arara.model.Pair; -import java.io.File; -import java.net.MalformedURLException; -import java.net.URL; -import java.net.URLClassLoader; - -/** - * Implements utilitary methods for classloading and object instantiation. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class ClassLoadingUtils { - - /** - * Loads a class from the provided file, potentially a Java archive. - * @param file File containing the Java bytecode (namely, a JAR). - * @param name The canonical name of the class. - * @return A pair representing the status and the class. - */ - public static Pair<Integer, Class> loadClass(File file, String name) { - - // status and class to be returned, - // it defaults to an object class - int status = 0; - Class value = Object.class; - - // if file does not exist, nothing - // can be done, status is changed - if (!file.exists()) { - status = 1; - } else { - - // classloading involves defining - // a classloader and fetching the - // desired class from it, based on - // the provided file archive - try { - - // creates a new classloader with - // the provided file (potentially - // a JAR file) - URLClassLoader classloader = new URLClassLoader( - new URL[]{ - file.toURI().toURL() - }, - ClassLoadingUtils.class.getClassLoader() - ); - - // fetches the class from the - // instantiated classloader - value = Class.forName(name, true, classloader); - - } catch (MalformedURLException nothandled1) { - - // the file URL is incorrect, - // update status accordingly - status = 2; - - } catch (ClassNotFoundException nothandled2) { - - // the class was not found, - // update status accordingly - status = 3; - - } - } - - // return a new pair based on the - // current status and class holder - return new Pair<Integer, Class>(status, value); - } - - /** - * Loads a class from the provided file, instantiating it. - * @param file File containing the Java bytecode (namely, a JAR). - * @param name The canonical name of the class. - * @return A pair representing the status and the class object. - */ - public static Pair<Integer, Object> loadObject(File file, String name) { - - // load the corresponding class - // based on the qualified name - Pair<Integer, Class> pair = loadClass(file, name); - - // status and object to be returned, - // it defaults to an object - int status = pair.getFirstElement(); - Object value = new Object(); - - // checks if the class actually - // exists, otherwise simply - // ignore instantiation - if (status == 0) { - - // object instantiation relies - // on the default constructor - // (without arguments), class - // must implement it - - // OBS: constructors with arguments - // must be invoked through reflection - try { - - // get the class reference from - // the pair and instantiate it - // by invoking the default - // constructor (without arguments) - value = pair.getSecondElement().newInstance(); - - } catch (IllegalAccessException nothandled1) { - - // the object instantiation violated - // an access policy, status is updated - status = 4; - - } catch (InstantiationException nothandled2) { - - // an instantiation exception has - // occurred, status is updated - status = 5; - - } - } - - // return a new pair based on the - // current status and object holder - return new Pair<Integer, Object>(status, value); - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/utils/CommonUtils.java b/support/arara/source/src/main/java/com/github/cereda/arara/utils/CommonUtils.java deleted file mode 100644 index 0263f64eac..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/utils/CommonUtils.java +++ /dev/null @@ -1,954 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.utils; - -import com.github.cereda.arara.controller.ConfigurationController; -import com.github.cereda.arara.controller.LanguageController; -import com.github.cereda.arara.controller.SystemCallController; -import com.github.cereda.arara.model.AraraException; -import com.github.cereda.arara.model.Argument; -import com.github.cereda.arara.model.Database; -import com.github.cereda.arara.model.FileType; -import com.github.cereda.arara.model.Messages; -import java.io.File; -import java.io.IOException; -import java.nio.charset.Charset; -import java.text.SimpleDateFormat; -import java.util.ArrayList; -import java.util.Arrays; -import java.util.Collection; -import java.util.HashMap; -import java.util.HashSet; -import java.util.List; -import java.util.Map; -import java.util.MissingFormatArgumentException; -import java.util.Set; -import java.util.StringTokenizer; -import java.util.regex.Matcher; -import java.util.regex.Pattern; -import org.apache.commons.collections4.CollectionUtils; -import org.apache.commons.collections4.Transformer; -import org.apache.commons.io.FileUtils; -import org.apache.commons.io.filefilter.NameFileFilter; -import org.apache.commons.lang.StringUtils; -import org.apache.commons.lang.SystemUtils; - -/** - * Implements common utilitary methods. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class CommonUtils { - - // the application messages obtained from the - // language controller - private static final LanguageController messages = - LanguageController.getInstance(); - - /** - * Checks if the input string is equal to a valid boolean value. - * @param value The input string. - * @return A boolean value represented by the provided string. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean checkBoolean(String value) throws AraraException { - List<String> yes = Arrays.asList( - new String[]{"yes", "true", "1", "on"} - ); - List<String> no = Arrays.asList( - new String[]{"no", "false", "0", "off"} - ); - if (!union(yes, no).contains(value.toLowerCase())) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_CHECKBOOLEAN_NOT_VALID_BOOLEAN, - value - ) - ); - } else { - return yes.contains(value.toLowerCase()); - } - } - - /** - * Provides a union set operation between two lists. - * @param <T> The list type. - * @param list1 The first list. - * @param list2 The second list. - * @return The union of those two lists. - */ - private static <T> List<T> union(List<T> list1, List<T> list2) { - Set<T> elements = new HashSet<T>(); - elements.addAll(list1); - elements.addAll(list2); - return new ArrayList<T>(elements); - } - - /** - * Build a system-dependant path based on the path and the file. - * @param path A string representing the path to be prepended. - * @param file A string representing the file to be appended. - * @return The full path as a string. - */ - public static String buildPath(String path, String file) { - return path.endsWith(File.separator) ? - path.concat(file) : path.concat(File.separator).concat(file); - } - - /** - * Checks if the provided string is empty. It does not handle a null value. - * @param string A string. - * @return A boolean value indicating if the string is empty. - */ - public static boolean checkEmptyString(String string) { - return "".equals(string); - } - - /** - * Removes the keyword from the beginning of the provided string. - * @param line A string to be analyzed. - * @return The provided string without the keyword. - */ - public static String removeKeyword(String line) { - if (line != null) { - Pattern pattern = Pattern.compile("^(\\s)*<arara>\\s"); - Matcher matcher = pattern.matcher(line); - if (matcher.find()) { - line = (line.substring(matcher.end(), line.length())); - } - line = line.trim(); - } - return line; - } - - /** - * Discovers the file through string reference lookup and sets the - * configuration accordingly. - * @param reference The string reference. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static void discoverFile(String reference) throws AraraException { - File file = lookupFile(reference); - if (file == null) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_DISCOVERFILE_FILE_NOT_FOUND, - reference, - getFileTypesList() - ) - ); - } - } - - /** - * Performs a file lookup based on a string reference. - * @param reference The file reference as a string. - * @return The file as result of the lookup operation. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - private static File lookupFile(String reference) throws AraraException { - @SuppressWarnings("unchecked") - List<FileType> types = (List<FileType>) ConfigurationController. - getInstance().get("execution.filetypes"); - File file = new File(reference); - String name = file.getName(); - String parent = getParentCanonicalPath(file); - String path = buildPath(parent, name); - - // direct search, so we are considering - // the reference as a complete name - for (FileType type : types) { - if (path.endsWith(".".concat(type.getExtension()))) { - file = new File(path); - if (file.exists()) { - if (file.isFile()) { - ConfigurationController. - getInstance(). - put("execution.file.pattern", - type.getPattern()); - ConfigurationController. - getInstance(). - put("execution.reference", file); - return file; - } - } - } - } - - // indirect search; in this case, we are considering - // that the file reference has an implict extension, - // so we need to add it and look again - for (FileType type : types) { - path = buildPath(parent, name.concat("."). - concat(type.getExtension())); - file = new File(path); - if (file.exists()) { - if (file.isFile()) { - ConfigurationController.getInstance(). - put("execution.file.pattern", type.getPattern()); - ConfigurationController.getInstance(). - put("execution.reference", file); - return file; - } - } - } - return null; - } - - /** - * Gets the parent canonical path of a file. - * @param file The file. - * @return The parent canonical path of a file. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static String getParentCanonicalPath(File file) - throws AraraException { - try { - String path = file.getCanonicalFile().getParent(); - return path; - } catch (IOException exception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_GETPARENTCANONICALPATH_IO_EXCEPTION - ), - exception - ); - } - } - - /** - * Gets the canonical file from a file. - * @param file The file. - * @return The canonical file. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static File getCanonicalFile(String file) throws AraraException { - try { - return (new File(file)).getCanonicalFile(); - } catch (IOException exception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_GETCANONICALFILE_IO_EXCEPTION - ), - exception - ); - } - } - - /** - * Checks if the provided object is from a certain class. - * @param clazz The class. - * @param object The object. - * @return A boolean value indicating if the provided object is from a - * certain class. - */ - public static boolean checkClass(Class clazz, Object object) { - return clazz.isInstance(object); - } - - /** - * Helper method to flatten a potential list of lists into a list of - * objects. - * @param list First list. - * @param flat Second list. - */ - private static void flatten(List<?> list, List<Object> flat) { - for (Object item : list) { - if (item instanceof List<?>) { - flatten((List<?>) item, flat); - } else { - flat.add(item); - } - } - } - - /** - * Flattens a potential list of lists into a list of objects. - * @param list The list to be flattened. - * @return The flattened list. - */ - public static List<Object> flatten(List<?> list) { - List<Object> result = new ArrayList<Object>(); - flatten(list, result); - return result; - } - - /** - * Gets the list of file types, in order. - * @return A string representation of the list of file types, in order. - */ - public static String getFileTypesList() { - @SuppressWarnings("unchecked") - List<FileType> types = (List<FileType>) ConfigurationController. - getInstance().get("execution.filetypes"); - return getCollectionElements(types, "[ ", " ]", " | "); - } - - /** - * Gets a string representation of a collection. - * @param collection The collection. - * @param open The opening string. - * @param close The closing string. - * @param separator The element separator. - * @return A string representation of the provided collection. - */ - public static String getCollectionElements(Collection collection, - String open, String close, String separator) { - StringBuilder builder = new StringBuilder(); - builder.append(open); - builder.append(StringUtils.join(collection, separator)); - builder.append(close); - return builder.toString(); - } - - /** - * Gets a set of strings containing unknown keys from a map and a list. It - * is a set difference from the keys in the map and the entries in the list. - * @param parameters The map of parameters. - * @param arguments The list of arguments. - * @return A set of strings representing unknown keys from a map and a list. - */ - public static Set<String> getUnknownKeys(Map<String, Object> parameters, - List<Argument> arguments) { - Collection<String> found = parameters.keySet(); - Collection<String> expected = CollectionUtils.collect( - arguments, new Transformer<Argument, String>() { - public String transform(Argument argument) { - return argument.getIdentifier(); - } - }); - Collection<String> difference = CollectionUtils. - subtract(found, expected); - return new HashSet<String>(difference); - } - - /** - * Gets the rule error header, containing the identifier and the path, if - * any. - * @return A string representation of the rule error header, containing the - * identifier and the path, if any. - */ - public static String getRuleErrorHeader() { - if ((ConfigurationController.getInstance(). - contains("execution.info.rule.id")) && - (ConfigurationController.getInstance(). - contains("execution.info.rule.path"))) { - String id = (String) ConfigurationController.getInstance(). - get("execution.info.rule.id"); - String path = (String) ConfigurationController.getInstance(). - get("execution.info.rule.path"); - return messages.getMessage( - Messages.ERROR_RULE_IDENTIFIER_AND_PATH, - id, - path - ).concat(" "); - } else { - return ""; - } - } - - /** - * Trims spaces from every string of a list of strings. - * @param input The list of strings. - * @return A new list of strings, with each element trimmed. - */ - public static List<String> trimSpaces(List<String> input) { - Collection<String> result = CollectionUtils.collect( - input, new Transformer<String, String>() { - public String transform(String input) { - return input.trim(); - } - }); - return new ArrayList<String>(result); - } - - /** - * Gets a human readable representation of a file size. - * @param file The file. - * @return A string representation of the file size. - */ - public static String calculateFileSize(File file) { - return FileUtils.byteCountToDisplaySize(file.length()); - } - - /** - * Gets the date the provided file was last modified. - * @param file The file. - * @return A string representation of the date the provided file was last - * modified. - */ - public static String getLastModifiedInformation(File file) { - SimpleDateFormat format = new SimpleDateFormat("MM/dd/yyyy HH:mm:ss"); - return format.format(file.lastModified()); - } - - /** - * Gets a list of all rule paths. - * @return A list of all rule paths. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static List<String> getAllRulePaths() throws AraraException { - @SuppressWarnings("unchecked") - List<String> paths = (List<String>) ConfigurationController. - getInstance().get("execution.rule.paths"); - List<String> result = new ArrayList<String>(); - for (String path : paths) { - File location = new File(InterpreterUtils.construct(path, "quack")); - result.add(getParentCanonicalPath(location)); - } - return result; - } - - /** - * Gets the reference of the current file in execution. Note that this - * method might return a value different than the main file provided in - * the command line. - * @return A reference of the current file in execution. Might be different - * than the main file provided in the command line. - */ - private static File getCurrentReference() { - return (File) ConfigurationController.getInstance(). - get("execution.file"); - } - - /** - * Calculates the CRC32 checksum of the provided file. - * @param file The file. - * @return A string containing the CRC32 checksum of the provided file. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static String calculateHash(File file) throws AraraException { - try { - long result = FileUtils.checksumCRC32(file); - return String.format("%08x", result); - } catch (IOException exception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_CALCULATEHASH_IO_EXCEPTION - ), - exception - ); - } - } - - /** - * Gets the file type of a file. - * @param file The file. - * @return The corresponding file type. - */ - public static String getFiletype(File file) { - return getFiletype(file.getName()); - } - - /** - * Gets the file type of a string representing the file. - * @param name A string representing the file. - * @return The corresponding file type. - */ - public static String getFiletype(String name) { - name = name.lastIndexOf(".") != -1 ? - name.substring(name.lastIndexOf(".") + 1, name.length()) : ""; - return name; - } - - /** - * Gets the base name of a file. - * @param file The file. - * @return The corresponding base name. - */ - public static String getBasename(File file) { - return getBasename(file.getName()); - } - - /** - * Gets the base name of a string representing the file. - * @param name A string representing the file. - * @return The corresponding base name. - */ - public static String getBasename(String name) { - int index = name.lastIndexOf(".") != -1 ? - name.lastIndexOf(".") : name.length(); - return name.substring(0, index); - } - - /** - * Encloses the provided object in double quotes. - * @param object The object. - * @return A string representation of the provided object enclosed in double - * quotes. - */ - public static String addQuotes(Object object) { - return "\"".concat(String.valueOf(object)).concat("\""); - } - - /** - * Generates a string based on a list of objects, separating each one of - * them by one space. - * @param objects A list of objects. - * @return A string based on the list of objects, separating each one of - * them by one space. Empty values are not considered. - */ - public static String generateString(Object... objects) { - List<String> values = new ArrayList<String>(); - for (Object object : objects) { - if (!CommonUtils.checkEmptyString(String.valueOf(object))) { - values.add(String.valueOf(object)); - } - } - return StringUtils.join(values, " "); - } - - /** - * Checks if a file exists. - * @param file The file. - * @return A boolean value indicating if the file exists. - */ - public static boolean exists(File file) { - return file.exists(); - } - - /** - * Checks if a file exists based on its extension. - * @param extension The extension. - * @return A boolean value indicating if the file exists. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean exists(String extension) throws AraraException { - File file = new File(getPath(extension)); - return file.exists(); - } - - /** - * Checks if a file has changed since the last verification. - * @param file The file. - * @return A boolean value indicating if the file has changed since the last - * verification. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean hasChanged(File file) throws AraraException { - Database database = DatabaseUtils.load(); - HashMap<String, String> map = database.getMap(); - String path = getCanonicalPath(file); - if (!file.exists()) { - if (map.containsKey(path)) { - map.remove(path); - database.setMap(map); - DatabaseUtils.save(database); - return true; - } else { - return false; - } - } else { - String hash = calculateHash(file); - if (map.containsKey(path)) { - String value = map.get(path); - if (hash.equals(value)) { - return false; - } else { - map.put(path, hash); - database.setMap(map); - DatabaseUtils.save(database); - return true; - } - } else { - map.put(path, hash); - database.setMap(map); - DatabaseUtils.save(database); - return true; - } - } - } - - /** - * Checks if the file has changed since the last verification based on the - * provided extension. - * @param extension The provided extension. - * @return A boolean value indicating if the file has changed since the last - * verification. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean hasChanged(String extension) throws AraraException { - File file = new File(getPath(extension)); - return hasChanged(file); - } - - /** - * Gets the full file path based on the provided extension. - * @param extension The extension. - * @return A string containing the full file path. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - private static String getPath(String extension) throws AraraException { - String name = getBasename(getCurrentReference()); - String path = getParentCanonicalPath(getCurrentReference()); - name = name.concat(".").concat(extension); - return buildPath(path, name); - } - - /** - * Gets the canonical path from the provided file. - * @param file The file. - * @return The canonical path from the provided file. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static String getCanonicalPath(File file) throws AraraException { - try { - return file.getCanonicalPath(); - } catch (IOException exception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_GETCANONICALPATH_IO_EXCEPTION - ), - exception - ); - } - } - - /** - * Checks if the file based on the provided extension contains the provided - * regex. - * @param extension The file extension. - * @param regex The regex. - * @return A boolean value indicating if the file contains the provided - * regex. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean checkRegex(String extension, String regex) - throws AraraException { - File file = new File(getPath(extension)); - return checkRegex(file, regex); - } - - /** - * Checks if the file contains the provided regex. - * @param file The file. - * @param regex The regex. - * @return A boolean value indicating if the file contains the provided - * regex. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean checkRegex(File file, String regex) - throws AraraException { - Charset charset = (Charset) ConfigurationController. - getInstance().get("directives.charset"); - try { - String text = FileUtils.readFileToString(file, charset.name()); - Pattern pattern = Pattern.compile(regex); - Matcher matcher = pattern.matcher(text); - return matcher.find(); - } catch (IOException exception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_CHECKREGEX_IO_EXCEPTION, - file.getName() - ), - exception - ); - } - } - - /** - * Replicates a string pattern based on a list of objects, generating a list - * as result. - * @param pattern The string pattern. - * @param values The list of objects to be merged with the pattern. - * @return A list containing the string pattern replicated to each object - * from the list. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static List<Object> replicateList(String pattern, - List<Object> values) throws AraraException { - List<Object> result = new ArrayList<Object>(); - for (Object value : values) { - try { - result.add(String.format(pattern, value)); - } catch (MissingFormatArgumentException exception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_REPLICATELIST_MISSING_FORMAT_ARGUMENTS_EXCEPTION - ), - exception - ); - } - } - return result; - } - - /** - * Checks if the provided operating system string holds according to the - * underlying operating system. - * @param value A string representing an operating system. - * @return A boolean value indicating if the provided string refers to the - * underlying operating system. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean checkOS(String value) throws AraraException { - Map<String, Boolean> values = new HashMap<String, Boolean>(); - values.put("windows", SystemUtils.IS_OS_WINDOWS); - values.put("linux", SystemUtils.IS_OS_LINUX); - values.put("mac", SystemUtils.IS_OS_MAC_OSX); - values.put("unix", SystemUtils.IS_OS_UNIX); - values.put("aix", SystemUtils.IS_OS_AIX); - values.put("irix", SystemUtils.IS_OS_IRIX); - values.put("os2", SystemUtils.IS_OS_OS2); - values.put("solaris", SystemUtils.IS_OS_SOLARIS); - values.put("cygwin", (Boolean) SystemCallController. - getInstance().get("cygwin")); - if (!values.containsKey(value.toLowerCase())) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_CHECKOS_INVALID_OPERATING_SYSTEM, - value - ) - ); - } - return values.get(value.toLowerCase()); - } - - /** - * Returns the exit status of the application. - * @return An integer representing the exit status of the application. - */ - public static int getExitStatus() { - return (Integer) ConfigurationController. - getInstance().get("execution.status"); - } - - /** - * Gets the system property according to the provided key, or resort to the - * fallback value if an exception is thrown or if the key is invalid. - * @param key The system property key. - * @param fallback The fallback value. - * @return A string containing the system property value or the fallback. - */ - public static String getSystemProperty(String key, String fallback) { - try { - String result = System.getProperty(key, fallback); - return result.equals("") ? fallback : result; - } catch (Exception exception) { - return fallback; - } - } - - /** - * Gets the preamble content, converting a single string into a list of - * strings, based on new lines. - * @return A list of strings representing the preamble content. - */ - public static List<String> getPreambleContent() { - if (((Boolean) ConfigurationController. - getInstance().get("execution.preamble.active")) == true) { - return new ArrayList<String>( - Arrays.asList( - ((String) ConfigurationController.getInstance(). - get("execution.preamble.content") - ).split("\n")) - ); - } - else { - return new ArrayList<String>(); - } - } - - /** - * Generates a list of filenames from the provided command based on a list - * of extensions for each underlying operating system. - * @param command A string representing the command. - * @return A list of filenames. - */ - private static List<String> appendExtensions(String command) { - - // the resulting list, to hold the - // filenames generated from the - // provided command - List<String> result = new ArrayList<String>(); - - // list of extensions, specific for - // each operating system (in fact, it - // is more Windows specific) - List<String> extensions; - - // the application is running on - // Windows, so let's look for the - // following extensions in order - if (SystemUtils.IS_OS_WINDOWS) { - - // this list is actually a sublist from - // the original Windows PATHEXT environment - // variable which holds the list of executable - // extensions that Windows supports - extensions = Arrays.asList(".com", ".exe", ".bat", ".cmd"); - } - else { - - // no Windows, so the default - // extension will be just an - // empty string - extensions = Arrays.asList(""); - } - - // for each and every extension in the - // list, let's build the corresponding - // filename and add to the result - for (String extension : extensions) { - result.add(command.concat(extension)); - } - - // return the resulting list - // holding the filenames - return result; - } - - /** - * Checks if the provided command name is reachable from the system path. - * @param command A string representing the command. - * @return A logic value. - */ - public static boolean isOnPath(String command) { - try { - - // first and foremost, let's build the list - // of filenames based on the underlying - // operating system - List<String> filenames = appendExtensions(command); - - // break the path into several parts - // based on the path separator symbol - StringTokenizer tokenizer = new StringTokenizer( - System.getenv("PATH"), - File.pathSeparator - ); - - // iterate through every part of the - // path looking for each filename - while (tokenizer.hasMoreTokens()) { - - // if the search does not return an empty - // list, one of the filenames got a match, - // and the command is available somewhere - // in the system path - if ( - !FileUtils.listFiles( - new File(tokenizer.nextToken()), - new NameFileFilter(filenames), - null - ).isEmpty()) { - - // command is found somewhere, - // so it is on path - return true; - } - } - - // nothing was found, - // command is not on path - return false; - } - catch (Exception exception) { - - // an exception was raised, simply - // return and forget about it - return false; - } - } - - /** - * Gets the full base name of a file. - * @param file The file. - * @return The corresponding full base name. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static String getFullBasename(File file) throws AraraException { - - // if the provided file does not contain a - // file separator, fallback to the usual - // base name lookup - if (!file.toString().contains(File.separator)) { - return getBasename(file); - } - else { - - // we need to get the parent file, get the - // canonical path and build the corresponding - // full base name path - File parent = file.getParentFile(); - String path = getCanonicalPath(parent == null ? file : parent); - return buildPath(path, getBasename(file)); - } - } - - /** - * Checks whether a directory is under a root directory. - * @param f1 Directory to be inspected. - * @param f2 Root directory. - * @return Logical value indicating whether the directoy is under root. - * @throws AraraException There was a problem with path retrieval. - */ - public static boolean isSubDirectory(File f1, File f2) - throws AraraException { - if (f1.isDirectory()) { - return getCanonicalPath(f1). - startsWith( - getParentCanonicalPath(f2).concat(File.separator) - ); - } - else { - throw new AraraException( - messages.getMessage( - Messages.ERROR_ISSUBDIRECTORY_NOT_A_DIRECTORY, - f1.getName() - ) - ); - } - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/utils/ConfigurationUtils.java b/support/arara/source/src/main/java/com/github/cereda/arara/utils/ConfigurationUtils.java deleted file mode 100644 index 7336110ebe..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/utils/ConfigurationUtils.java +++ /dev/null @@ -1,239 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.utils; - -import com.github.cereda.arara.Arara; -import com.github.cereda.arara.controller.LanguageController; -import com.github.cereda.arara.model.AraraException; -import com.github.cereda.arara.model.FileType; -import com.github.cereda.arara.model.FileTypeResource; -import com.github.cereda.arara.model.Messages; -import com.github.cereda.arara.model.Resource; -import java.io.File; -import java.io.FileReader; -import java.io.UnsupportedEncodingException; -import java.net.URLDecoder; -import java.util.ArrayList; -import java.util.Arrays; -import java.util.LinkedHashSet; -import java.util.List; -import java.util.Set; -import org.apache.commons.collections4.CollectionUtils; -import org.apache.commons.collections4.Predicate; -import org.apache.commons.lang.SystemUtils; -import org.yaml.snakeyaml.Yaml; -import org.yaml.snakeyaml.constructor.Constructor; -import org.yaml.snakeyaml.error.MarkedYAMLException; -import org.yaml.snakeyaml.nodes.Tag; -import org.yaml.snakeyaml.representer.Representer; - -/** - * Implements configuration utilitary methods. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class ConfigurationUtils { - - // the application messages obtained from the - // language controller - private static final LanguageController messages = - LanguageController.getInstance(); - - /** - * Gets the list of default file types provided by nightingale, in order. - * @return The list of default file types, in order. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static List<FileType> getDefaultFileTypes() throws AraraException { - return Arrays.asList( - new FileType("tex"), - new FileType("dtx"), - new FileType("ltx"), - new FileType("drv"), - new FileType("ins") - ); - } - - /** - * Gets the configuration file located at the user home directory, if any. - * @return The file reference to the external configuration, if any. - */ - public static File getConfigFile() { - List<String> names = Arrays.asList( - ".araraconfig.yaml", - "araraconfig.yaml", - ".arararc.yaml", - "arararc.yaml" - ); - - // look for configuration files in the user's working directory first - for (String name : names) { - String path = CommonUtils.buildPath(SystemUtils.USER_DIR, name); - File file = new File(path); - if (file.exists()) { - return file; - } - } - - // if no configuration files are found in the user's working directory, - // try to look up in a global directory, that is, the user home - for (String name : names) { - String path = CommonUtils.buildPath(SystemUtils.USER_HOME, name); - File file = new File(path); - if (file.exists()) { - return file; - } - } - return null; - } - - /** - * Validates the configuration file. - * @param file The configuration file. - * @return The configuration file as a resource. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static Resource validateConfiguration(File file) - throws AraraException { - - Representer representer = new Representer(); - representer.addClassTag(Resource.class, new Tag("!config")); - Yaml yaml = new Yaml(new Constructor(Resource.class), representer); - try { - Resource resource = yaml.loadAs(new FileReader(file), - Resource.class); - if (resource.getFiletypes() != null) { - List<FileTypeResource> filetypes = resource.getFiletypes(); - if (CollectionUtils.exists(filetypes, - new Predicate<FileTypeResource>() { - public boolean evaluate(FileTypeResource filetype) { - return (filetype.getExtension() == null); - } - })) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_CONFIGURATION_FILETYPE_MISSING_EXTENSION - ) - ); - } - } - return resource; - } catch (MarkedYAMLException yamlException) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_CONFIGURATION_INVALID_YAML - ), - yamlException - ); - } catch (Exception exception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_CONFIGURATION_GENERIC_ERROR - ) - ); - } - } - - /** - * Normalize a list of rule paths, removing all duplicates. - * @param paths The list of rule paths. - * @return A list of normalized paths, without duplicates. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static List<String> normalizePaths(List<String> paths) - throws AraraException { - paths.add(CommonUtils.buildPath(getApplicationPath(), "rules")); - Set<String> set = new LinkedHashSet<String>(paths); - List<String> result = new ArrayList<String>(set); - return result; - } - - /** - * Normalize a list of file types, removing all duplicates. - * @param types The list of file types. - * @return A list of normalized file types, without duplicates. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static List<FileType> normalizeFileTypes(List<FileType> types) - throws AraraException { - types.addAll(getDefaultFileTypes()); - Set<FileType> set = new LinkedHashSet<FileType>(types); - List<FileType> result = new ArrayList<FileType>(set); - return result; - } - - /** - * Gets the canonical absolute application path. - * @return The string representation of the canonical absolute application - * path. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static String getApplicationPath() throws AraraException { - try { - String path = Arara.class.getProtectionDomain(). - getCodeSource().getLocation().getPath(); - path = URLDecoder.decode(path, "UTF-8"); - path = new File(path).getParentFile().getPath(); - return path; - } catch (UnsupportedEncodingException exception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_GETAPPLICATIONPATH_ENCODING_EXCEPTION - ), - exception - ); - } - } - - /** - * Cleans the file name to avoid invalid entries. - * @param name The file name. - * @return A cleaned file name. - */ - public static String cleanFileName(String name) { - String result = (new File(name)).getName().trim(); - if (CommonUtils.checkEmptyString(result)) { - return "arara"; - } else { - return result.trim(); - } - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/utils/DatabaseUtils.java b/support/arara/source/src/main/java/com/github/cereda/arara/utils/DatabaseUtils.java deleted file mode 100644 index 3a9b4eeea5..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/utils/DatabaseUtils.java +++ /dev/null @@ -1,140 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.utils; - -import com.github.cereda.arara.controller.ConfigurationController; -import com.github.cereda.arara.controller.LanguageController; -import com.github.cereda.arara.model.AraraException; -import com.github.cereda.arara.model.Database; -import com.github.cereda.arara.model.Messages; -import java.io.File; -import org.simpleframework.xml.Serializer; -import org.simpleframework.xml.core.Persister; - -/** - * Implements database utilitary methods. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class DatabaseUtils { - - // the application messages obtained from the - // language controller - private static final LanguageController messages = - LanguageController.getInstance(); - - /** - * Loads the XML file representing the database. - * @return The database object. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static Database load() throws AraraException { - if (!exists()) { - return new Database(); - } else { - File file = new File(getPath()); - try { - Serializer serializer = new Persister(); - Database database = serializer.read(Database.class, file); - return database; - } catch (Exception exception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_LOAD_COULD_NOT_LOAD_XML, - file.getName() - ), - exception - ); - } - } - } - - /** - * Saves the database on a XML file. - * @param database The database object. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static void save(Database database) throws AraraException { - File file = new File(getPath()); - try { - Serializer serializer = new Persister(); - serializer.write(database, file); - } catch (Exception exception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_SAVE_COULD_NOT_SAVE_XML, - file.getName() - ), - exception - ); - } - } - - /** - * Checks if the XML file representing the database exists. - * @return A boolean value indicating if the XML file exists. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - private static boolean exists() throws AraraException { - File file = new File(getPath()); - return file.exists(); - } - - /** - * Gets the path to the XML file representing the database. - * @return A string representing the path to the XML file. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - private static String getPath() throws AraraException { - String name = ((String) ConfigurationController. - getInstance().get("execution.database.name")).concat(".xml"); - String path = CommonUtils.getParentCanonicalPath(getReference()); - return CommonUtils.buildPath(path, name); - } - - /** - * Gets the main file reference. - * @return The main file reference. - */ - private static File getReference() { - return (File) ConfigurationController. - getInstance().get("execution.reference"); - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/utils/DirectiveAssembler.java b/support/arara/source/src/main/java/com/github/cereda/arara/utils/DirectiveAssembler.java deleted file mode 100644 index 6f6f676ab5..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/utils/DirectiveAssembler.java +++ /dev/null @@ -1,106 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.utils; - -import java.util.ArrayList; -import java.util.List; - -/** - * Implements a directive assembler in order to help build a directive from a - * list of strings. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class DirectiveAssembler { - - // this variable holds a list of - // line numbers indicating which - // lines composed the resulting - // potential directive - private final List<Integer> lineNumbers; - - // this variable holds the textual - // representation of the directive - private String text; - - /** - * Constructor. - */ - public DirectiveAssembler() { - lineNumbers = new ArrayList<Integer>(); - text = ""; - } - - /** - * Checks if an append operation is allowed. - * @return A boolean value indicating if an append operation is allowed. - */ - public boolean isAppendAllowed() { - return !lineNumbers.isEmpty(); - } - - /** - * Adds a line number to the assembler. - * @param line An integer representing the line number. - */ - public void addLineNumber(int line) { - lineNumbers.add(line); - } - - /** - * Appends the provided line to the assembler text. - * @param line The provided line. - */ - public void appendLine(String line) { - text = text.concat(" ").concat(line.trim()); - } - - /** - * Gets the list of line numbers. - * @return The list of line numbers. - */ - public List<Integer> getLineNumbers() { - return lineNumbers; - } - - /** - * Gets the text. - * @return The assembler text, properly trimmed. - */ - public String getText() { - return text.trim(); - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/utils/DirectiveResolver.java b/support/arara/source/src/main/java/com/github/cereda/arara/utils/DirectiveResolver.java deleted file mode 100644 index b0a1af850b..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/utils/DirectiveResolver.java +++ /dev/null @@ -1,59 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.utils; - -import org.yaml.snakeyaml.nodes.Tag; -import org.yaml.snakeyaml.resolver.Resolver; - -/** - * This class implements a directive resolver. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class DirectiveResolver extends Resolver { - - /** - * Adds implicit resolvers to the YAML model. For arara, I disabled - * boolean and numeric values to be automatically parsed. They still can - * be used through an explicit conversion in the rule context. - */ - @Override - protected void addImplicitResolvers() { - addImplicitResolver(Tag.MERGE, MERGE, "<"); - addImplicitResolver(Tag.NULL, NULL, "~nN\0"); - addImplicitResolver(Tag.NULL, EMPTY, null); - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/utils/DirectiveUtils.java b/support/arara/source/src/main/java/com/github/cereda/arara/utils/DirectiveUtils.java deleted file mode 100644 index 6ea0404f72..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/utils/DirectiveUtils.java +++ /dev/null @@ -1,438 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.utils; - -import com.github.cereda.arara.controller.ConfigurationController; -import com.github.cereda.arara.controller.LanguageController; -import com.github.cereda.arara.model.AraraException; -import com.github.cereda.arara.model.Conditional; -import com.github.cereda.arara.model.Directive; -import com.github.cereda.arara.model.Messages; -import com.github.cereda.arara.model.Pair; -import java.io.File; -import java.util.ArrayList; -import java.util.HashMap; -import java.util.List; -import java.util.Map; -import java.util.regex.Matcher; -import java.util.regex.Pattern; -import org.slf4j.Logger; -import org.slf4j.LoggerFactory; -import org.yaml.snakeyaml.DumperOptions; -import org.yaml.snakeyaml.Yaml; -import org.yaml.snakeyaml.constructor.Constructor; -import org.yaml.snakeyaml.error.MarkedYAMLException; -import org.yaml.snakeyaml.representer.Representer; - -/** - * Implements directive utilitary methods. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class DirectiveUtils { - - // the application messages obtained from the - // language controller - private static final LanguageController messages = - LanguageController.getInstance(); - - // get the logger context from a factory - private static final Logger logger = - LoggerFactory.getLogger(DirectiveUtils.class); - - /** - * Extracts a list of directives from a list of strings. - * @param lines List of strings. - * @return A list of directives. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static List<Directive> extractDirectives(List<String> lines) - throws AraraException { - - boolean header = (Boolean) ConfigurationController. - getInstance().get("execution.header"); - String regex = (String) ConfigurationController. - getInstance().get("execution.file.pattern"); - Pattern linecheck = Pattern.compile(regex); - regex = regex.concat((String) ConfigurationController. - getInstance().get("application.pattern")); - Pattern pattern = Pattern.compile(regex); - List<Pair<Integer, String>> pairs = - new ArrayList<Pair<Integer, String>>(); - Matcher matcher; - for (int i = 0; i < lines.size(); i++) { - matcher = pattern.matcher(lines.get(i)); - if (matcher.find()) { - String line = lines.get(i).substring( - matcher.end(), - lines.get(i).length() - ); - Pair<Integer, String> pair = - new Pair<Integer, String>(i + 1, line); - pairs.add(pair); - - logger.info( - messages.getMessage( - Messages.LOG_INFO_POTENTIAL_PATTERN_FOUND, - (i + 1), - line.trim() - ) - ); - } - else { - if (header) { - if (!checkLinePattern(linecheck, lines.get(i))) { - break; - } - } - } - } - - if (pairs.isEmpty()) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_VALIDATE_NO_DIRECTIVES_FOUND - ) - ); - } - - List<DirectiveAssembler> assemblers - = new ArrayList<DirectiveAssembler>(); - DirectiveAssembler assembler = new DirectiveAssembler(); - regex = (String) ConfigurationController.getInstance(). - get("directives.linebreak.pattern"); - pattern = Pattern.compile(regex); - for (Pair<Integer, String> pair : pairs) { - matcher = pattern.matcher(pair.getSecondElement()); - if (matcher.find()) { - if (!assembler.isAppendAllowed()) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_VALIDATE_ORPHAN_LINEBREAK, - pair.getFirstElement() - ) - ); - } else { - assembler.addLineNumber(pair.getFirstElement()); - assembler.appendLine(matcher.group(1)); - } - } else { - if (assembler.isAppendAllowed()) { - assemblers.add(assembler); - } - assembler = new DirectiveAssembler(); - assembler.addLineNumber(pair.getFirstElement()); - assembler.appendLine(pair.getSecondElement()); - } - } - if (assembler.isAppendAllowed()) { - assemblers.add(assembler); - } - - List<Directive> directives = new ArrayList<Directive>(); - for (DirectiveAssembler current : assemblers) { - directives.add(generateDirective(current)); - } - return directives; - - } - - /** - * Generates a directive from a directive assembler. - * @param assembler The directive assembler. - * @return The corresponding directive. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static Directive generateDirective(DirectiveAssembler assembler) - throws AraraException { - String regex = (String) ConfigurationController.getInstance(). - get("directives.pattern"); - Pattern pattern = Pattern.compile(regex); - Matcher matcher = pattern.matcher(assembler.getText()); - if (matcher.find()) { - Directive directive = new Directive(); - directive.setIdentifier(matcher.group(1)); - directive.setParameters( - getParameters(matcher.group(3), assembler.getLineNumbers()) - ); - Conditional conditional = new Conditional(); - conditional.setType(getType(matcher.group(5))); - conditional.setCondition(getCondition(matcher.group(6))); - directive.setConditional(conditional); - directive.setLineNumbers(assembler.getLineNumbers()); - - logger.info( - messages.getMessage( - Messages.LOG_INFO_POTENTIAL_DIRECTIVE_FOUND, - directive - ) - ); - - return directive; - } else { - throw new AraraException( - messages.getMessage( - Messages.ERROR_VALIDATE_INVALID_DIRECTIVE_FORMAT, - CommonUtils.getCollectionElements( - assembler.getLineNumbers(), - "(", - ")", - ", " - ) - ) - ); - } - } - - /** - * Gets the conditional type based on the input string. - * @param text The input string. - * @return The conditional type. - */ - private static Conditional.ConditionalType getType(String text) { - if (text == null) { - return Conditional.ConditionalType.NONE; - } else { - if (text.equals("if")) { - return Conditional.ConditionalType.IF; - } else { - if (text.equals("while")) { - return Conditional.ConditionalType.WHILE; - } else { - if (text.equals("until")) { - return Conditional.ConditionalType.UNTIL; - } else { - return Conditional.ConditionalType.UNLESS; - } - } - } - } - } - - /** - * Gets the condition from the input string. - * @param text The input string. - * @return A string representing the condition. - */ - private static String getCondition(String text) { - return text == null ? "" : text; - } - - /** - * Gets the parameters from the input string. - * @param text The input string. - * @param numbers The list of line numbers. - * @return A map containing the directive parameters. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - private static Map<String, Object> getParameters(String text, - List<Integer> numbers) throws AraraException { - - if (text == null) { - return new HashMap<String, Object>(); - } - - Yaml yaml = new Yaml( - new Constructor(), - new Representer(), - new DumperOptions(), - new DirectiveResolver() - ); - try { - @SuppressWarnings("unchecked") - HashMap<String, Object> map = yaml.loadAs(text, HashMap.class); - return map; - } catch (MarkedYAMLException exception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_VALIDATE_YAML_EXCEPTION, - CommonUtils.getCollectionElements( - numbers, - "(", - ")", - ", " - ) - ), - exception - ); - } - } - - /** - * Validates the list of directives, returning a new list. - * @param directives The list of directives. - * @return A new list of directives. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static List<Directive> validate(List<Directive> directives) - throws AraraException { - - ArrayList<Directive> result = new ArrayList<Directive>(); - for (Directive directive : directives) { - Map<String, Object> parameters = directive.getParameters(); - - if (parameters.containsKey("file")) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_VALIDATE_FILE_IS_RESERVED, - CommonUtils.getCollectionElements( - directive.getLineNumbers(), - "(", - ")", - ", " - ) - ) - ); - } - - if (parameters.containsKey("reference")) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_VALIDATE_REFERENCE_IS_RESERVED, - CommonUtils.getCollectionElements( - directive.getLineNumbers(), - "(", - ")", - ", " - ) - ) - ); - } - - if (parameters.containsKey("files")) { - - Object holder = parameters.get("files"); - if (holder instanceof List) { - @SuppressWarnings("unchecked") - List<Object> files = (List<Object>) holder; - parameters.remove("files"); - if (files.isEmpty()) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_VALIDATE_EMPTY_FILES_LIST, - CommonUtils.getCollectionElements( - directive.getLineNumbers(), - "(", - ")", - ", " - ) - ) - ); - } - for (Object file : files) { - Map<String, Object> map = new HashMap<String, Object>(); - for (String key : parameters.keySet()) { - map.put(key, parameters.get(key)); - } - File representation = CommonUtils. - getCanonicalFile(String.valueOf(file)); - - map.put("reference", representation); - map.put("file", representation.getName()); - - Directive addition = new Directive(); - Conditional conditional = new Conditional(); - conditional.setCondition(directive.getConditional(). - getCondition() - ); - conditional.setType(directive.getConditional(). - getType() - ); - addition.setIdentifier(directive.getIdentifier()); - addition.setConditional(conditional); - addition.setParameters(map); - addition.setLineNumbers(directive.getLineNumbers()); - result.add(addition); - } - } else { - throw new AraraException( - messages.getMessage( - Messages.ERROR_VALIDATE_FILES_IS_NOT_A_LIST, - CommonUtils.getCollectionElements( - directive.getLineNumbers(), - "(", - ")", - ", " - ) - ) - ); - } - } else { - File representation = (File) ConfigurationController. - getInstance().get("execution.reference"); - parameters.put("file", representation.getName()); - parameters.put("reference", representation); - directive.setParameters(parameters); - result.add(directive); - } - } - - logger.info( - messages.getMessage( - Messages.LOG_INFO_VALIDATED_DIRECTIVES - ) - ); - logger.info(DisplayUtils.displayOutputSeparator( - messages.getMessage( - Messages.LOG_INFO_DIRECTIVES_BLOCK - ) - )); - for (Directive directive : result) { - logger.info(directive.toString()); - } - - logger.info(DisplayUtils.displaySeparator()); - - return result; - } - - /** - * Checks if the provided line contains the corresponding pattern, based on - * the file type, or an empty line. - * @param pattern Pattern to be matched, based on the file type. - * @param line Provided line. - * @return Logical value indicating if the provided line contains the - * corresponding pattern, based on the file type, or an empty line. - */ - private static boolean checkLinePattern(Pattern pattern, String line) { - return CommonUtils.checkEmptyString(line.trim()) || - pattern.matcher(line).find(); - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/utils/DisplayUtils.java b/support/arara/source/src/main/java/com/github/cereda/arara/utils/DisplayUtils.java deleted file mode 100644 index 75cda6f99a..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/utils/DisplayUtils.java +++ /dev/null @@ -1,502 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.utils; - -import com.github.cereda.arara.controller.ConfigurationController; -import com.github.cereda.arara.controller.LanguageController; -import com.github.cereda.arara.model.AraraException; -import com.github.cereda.arara.model.Conditional; -import com.github.cereda.arara.model.Messages; -import com.github.cereda.arara.model.StopWatch; -import java.io.File; -import java.util.List; -import org.apache.commons.lang.StringUtils; -import org.apache.commons.lang.WordUtils; -import org.slf4j.Logger; -import org.slf4j.LoggerFactory; - -/** - * Implements display utilitary methods. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class DisplayUtils { - - // the application messages obtained from the - // language controller - private static final LanguageController messages = - LanguageController.getInstance(); - - // get the logger context from a factory - private static final Logger logger = - LoggerFactory.getLogger(DisplayUtils.class); - - /** - * Displays the short version of the current entry in the terminal. - * @param name Rule name. - * @param task Task name. - */ - private static void buildShortEntry(String name, String task) { - int width = getWidth(); - int result = getLongestMatch(); - if (result >= width) { - result = 10; - } - int space = width - result - 1; - StringBuilder entry = new StringBuilder(); - entry.append("(").append(name).append(") "); - entry.append(task).append(" "); - String line = StringUtils.abbreviate(entry.toString(), space - 4); - entry = new StringBuilder(); - entry.append(StringUtils.rightPad(line, space, ".")).append(" "); - System.out.print(entry); - } - - /** - * Displays the short version of the current entry result in the terminal. - * @param value The boolean value to be displayed. - */ - private static void buildShortResult(boolean value) { - int result = getLongestMatch(); - System.out.println(StringUtils.leftPad(getResult(value), result)); - } - - /** - * Displays the current entry result in the terminal. - * @param value The boolean value to be displayed. - */ - public static void printEntryResult(boolean value) { - ConfigurationController.getInstance().put("display.line", false); - ConfigurationController.getInstance().put("display.result", true); - ConfigurationController.getInstance() - .put("execution.status", value ? 0 : 1); - logger.info( - messages.getMessage( - Messages.LOG_INFO_TASK_RESULT - ).concat(" ").concat(getResult(value)) - ); - if (!isDryRunMode()) { - if (!isVerboseMode()) { - buildShortResult(value); - } else { - buildLongResult(value); - } - } - } - - /** - * Displays a long version of the current entry result in the terminal. - * @param value The boolean value to be displayed - */ - private static void buildLongResult(boolean value) { - int width = getWidth(); - System.out.println("\n".concat(StringUtils.leftPad( - " ".concat(getResult(value)), width, "-" - ))); - } - - /** - * Displays the current entry in the terminal. - * @param name The rule name. - * @param task The task name. - */ - public static void printEntry(String name, String task) { - logger.info( - messages.getMessage( - Messages.LOG_INFO_INTERPRET_TASK, - task, - name - ) - ); - ConfigurationController.getInstance().put("display.line", true); - ConfigurationController.getInstance().put("display.result", false); - if (!isDryRunMode()) { - if (!isVerboseMode()) { - buildShortEntry(name, task); - } else { - buildLongEntry(name, task); - } - } else { - buildDryRunEntry(name, task); - } - } - - /** - * Gets the length of the longest result match. - * @return An integer value representing the longest result match. - */ - private static int getLongestMatch() { - String[] values = new String[]{ - messages.getMessage(Messages.INFO_LABEL_ON_SUCCESS), - messages.getMessage(Messages.INFO_LABEL_ON_FAILURE), - messages.getMessage(Messages.INFO_LABEL_ON_ERROR) - }; - int max = values[0].length(); - for (String value : values) { - if (max < value.length()) { - max = value.length(); - } - } - return max; - } - - /** - * Displays a long version of the current entry in the terminal. - * @param name Rule name. - * @param task Task name. - */ - private static void buildLongEntry(String name, String task) { - if (ConfigurationController.getInstance().contains("display.rolling")) { - addNewLine(); - } else { - ConfigurationController.getInstance().put("display.rolling", true); - } - StringBuilder line = new StringBuilder(); - line.append("(").append(name).append(") "); - line.append(task); - System.out.println(displaySeparator()); - System.out.println(StringUtils.abbreviate(line.toString(), getWidth())); - System.out.println(displaySeparator()); - } - - /** - * Displays a dry-run version of the current entry in the terminal. - * @param name The rule name. - * @param task The task name. - */ - private static void buildDryRunEntry(String name, String task) { - if (ConfigurationController.getInstance().contains("display.rolling")) { - addNewLine(); - } else { - ConfigurationController.getInstance().put("display.rolling", true); - } - StringBuilder line = new StringBuilder(); - line.append("[DR] (").append(name).append(") "); - line.append(task); - System.out.println(StringUtils.abbreviate(line.toString(), getWidth())); - System.out.println(displaySeparator()); - } - - /** - * Displays the exception in the terminal. - * @param exception The exception object. - */ - public static void printException(AraraException exception) { - ConfigurationController.getInstance().put("display.exception", true); - ConfigurationController.getInstance().put("execution.status", 2); - boolean display = false; - if (ConfigurationController.getInstance().contains("display.line")) { - display = (Boolean) ConfigurationController. - getInstance().get("display.line"); - } - if (ConfigurationController.getInstance().contains("display.result")) { - if (((Boolean) ConfigurationController. - getInstance().get("display.result")) == true) { - addNewLine(); - } - } - if (display) { - if (!isDryRunMode()) { - if (!isVerboseMode()) { - buildShortError(); - } else { - buildLongError(); - } - addNewLine(); - } - } - String text = exception.hasException() ? - exception.getMessage().concat(" ").concat( - messages.getMessage( - Messages.INFO_DISPLAY_EXCEPTION_MORE_DETAILS - ) - ) - : exception.getMessage(); - logger.error(text); - wrapText(text); - if (exception.hasException()) { - addNewLine(); - displayDetailsLine(); - String details = exception.getException().getMessage(); - logger.error(details); - wrapText(details); - } - } - - /** - * Gets the string representation of the provided boolean value. - * @param value The boolean value. - * @return The string representation. - */ - private static String getResult(boolean value) { - return (value == true ? - messages.getMessage( - Messages.INFO_LABEL_ON_SUCCESS - ) - : messages.getMessage(Messages.INFO_LABEL_ON_FAILURE)); - } - - /** - * Displays the short version of an error in the terminal. - */ - private static void buildShortError() { - int result = getLongestMatch(); - System.out.println(StringUtils.leftPad( - messages.getMessage( - Messages.INFO_LABEL_ON_ERROR - ), - result - )); - } - - /** - * Displays the long version of an error in the terminal. - */ - private static void buildLongError() { - String line = StringUtils.leftPad( - " ".concat(messages.getMessage(Messages.INFO_LABEL_ON_ERROR)), - getWidth(), "-"); - System.out.println(line); - } - - /** - * Gets the default terminal width defined in the settings. - * @return An integer representing the terminal width. - */ - private static int getWidth() { - return (Integer) ConfigurationController. - getInstance().get("application.width"); - } - - /** - * Displays the provided text wrapped nicely according to the default - * terminal width. - * @param text The text to be displayed. - */ - public static void wrapText(String text) { - System.out.println(WordUtils.wrap(text, getWidth())); - } - - /** - * Checks if the execution is in dry-run mode. - * @return A boolean value indicating if the execution is in dry-run mode. - */ - private static boolean isDryRunMode() { - return (Boolean) ConfigurationController. - getInstance().get("execution.dryrun"); - } - - /** - * Checks if the execution is in verbose mode. - * @return A boolean value indicating if the execution is in verbose mode. - */ - private static boolean isVerboseMode() { - return (Boolean) ConfigurationController. - getInstance().get("execution.verbose"); - } - - /** - * Displays the rule authors in the terminal. - * @param authors The list of authors. - */ - public static void printAuthors(List<String> authors) { - StringBuilder line = new StringBuilder(); - line.append(authors.size() == 1 ? - messages.getMessage(Messages.INFO_LABEL_AUTHOR) - : messages.getMessage(Messages.INFO_LABEL_AUTHORS)); - String text = authors.isEmpty() ? - messages.getMessage(Messages.INFO_LABEL_NO_AUTHORS) - : CommonUtils.getCollectionElements( - CommonUtils.trimSpaces(authors), "", "", ", "); - line.append(" ").append(text); - wrapText(line.toString()); - } - - /** - * Displays the current conditional in the terminal. - * @param conditional The conditional object. - */ - public static void printConditional(Conditional conditional) { - if (conditional.getType() != Conditional.ConditionalType.NONE) { - StringBuilder line = new StringBuilder(); - line.append(messages.getMessage(Messages.INFO_LABEL_CONDITIONAL)); - line.append(" ("); - line.append(String.valueOf(conditional.getType())); - line.append(") ").append(conditional.getCondition()); - wrapText(line.toString()); - } - } - - /** - * Displays the file information in the terminal. - */ - public static void printFileInformation() { - File file = (File) ConfigurationController. - getInstance().get("execution.reference"); - String version = (String) ConfigurationController. - getInstance().get("application.version"); - String revision = (String) ConfigurationController. - getInstance().get("application.revision"); - String line = messages.getMessage( - Messages.INFO_DISPLAY_FILE_INFORMATION, - file.getName(), - CommonUtils.calculateFileSize(file), - CommonUtils.getLastModifiedInformation(file) - ); - logger.info(messages.getMessage( - Messages.LOG_INFO_WELCOME_MESSAGE, - version, - revision - )); - logger.info(displaySeparator()); - logger.info(String.format("::: arara @ %s", - getApplicationPath() - )); - logger.info(String.format("::: Java %s, %s", - CommonUtils.getSystemProperty("java.version", - "[unknown version]"), - CommonUtils.getSystemProperty("java.vendor", - "[unknown vendor]") - )); - logger.info(String.format("::: %s", - CommonUtils.getSystemProperty("java.home", - "[unknown location]") - )); - logger.info(String.format("::: %s, %s, %s", - CommonUtils.getSystemProperty("os.name", - "[unknown OS name]"), - CommonUtils.getSystemProperty("os.arch", - "[unknown OS arch]"), - CommonUtils.getSystemProperty("os.version", - "[unknown OS version]") - )); - logger.info(String.format("::: user.home @ %s", - CommonUtils.getSystemProperty("user.home", - "[unknown user's home directory]") - )); - logger.info(String.format("::: user.dir @ %s", - CommonUtils.getSystemProperty("user.dir", - "[unknown user's working directory]") - )); - logger.info(String.format("::: CF @ %s", - (String) ConfigurationController. - getInstance().get("execution.configuration.name") - )); - logger.info(displaySeparator()); - logger.info(line); - wrapText(line); - addNewLine(); - } - - /** - * Displays the elapsed time in the terminal. - */ - public static void printTime() { - if (ConfigurationController.getInstance().contains("display.time")) { - if ((ConfigurationController.getInstance().contains("display.line")) - || (ConfigurationController.getInstance(). - contains("display.exception"))) { - addNewLine(); - } - String text = messages.getMessage( - Messages.INFO_DISPLAY_EXECUTION_TIME, StopWatch.getTime()); - logger.info(text); - wrapText(text); - } - } - - /** - * Displays the application logo in the terminal. - */ - public static void printLogo() { - StringBuilder builder = new StringBuilder(); - builder.append(" __ _ _ __ __ _ _ __ __ _ ").append("\n"); - builder.append(" / _` | '__/ _` | '__/ _` |").append("\n"); - builder.append("| (_| | | | (_| | | | (_| |").append("\n"); - builder.append(" \\__,_|_| \\__,_|_| \\__,_|"); - System.out.println(builder.toString()); - addNewLine(); - } - - /** - * Adds a new line in the terminal. - */ - private static void addNewLine() { - System.out.println(); - } - - /** - * Displays a line containing details. - */ - private static void displayDetailsLine() { - String line = messages.getMessage( - Messages.INFO_LABEL_ON_DETAILS).concat(" "); - line = StringUtils.rightPad( - StringUtils.abbreviate(line, getWidth()), getWidth(), "-"); - System.out.println(line); - } - - /** - * Gets the output separator with the provided text. - * @param message The provided text. - * @return A string containing the output separator with the provided text. - */ - public static String displayOutputSeparator(String message) { - return StringUtils.center(" ".concat(message).concat(" "), - getWidth(), "-"); - } - - /** - * Gets the line separator. - * @return A string containing the line separator. - */ - public static String displaySeparator() { - return StringUtils.repeat("-", getWidth()); - } - - /** - * Gets the application path. - * @return A string containing the application path. - */ - private static String getApplicationPath() { - try { - return ConfigurationUtils.getApplicationPath(); - } - catch (AraraException ae) { - return "[unknown application path]"; - } - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/utils/FileHandlingUtils.java b/support/arara/source/src/main/java/com/github/cereda/arara/utils/FileHandlingUtils.java deleted file mode 100644 index fdd1ab36c6..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/utils/FileHandlingUtils.java +++ /dev/null @@ -1,124 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.utils; - -import java.io.File; -import java.io.IOException; -import java.util.ArrayList; -import java.util.List; -import org.apache.commons.io.FileUtils; - -/** - * Implements file handling utilitary methods. - * - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class FileHandlingUtils { - - /** - * Writes the string to a file, using UTF-8 as default encoding. - * @param file The file. - * @param text The string to be written. - * @param append A flag whether to append the content. - * @return A logical value indicating whether it was successful. - */ - public static boolean writeToFile(File file, String text, boolean append) { - try { - - // try to write the provided - // string to the file, with - // UTF-8 as encoding - FileUtils.writeStringToFile(file, text, "UTF-8", append); - return true; - - } catch (IOException nothandled) { - - // if something bad happens, - // gracefully fallback to - // reporting the failure - return false; - } - } - - /** - * Writes the string list to a file, using UTF-8 as default encoding. - * @param file The file. - * @param lines The string list to be written. - * @param append A flag whether to append the content. - * @return A logical value indicating whether it was successful. - */ - public static boolean writeToFile(File file, List<String> lines, - boolean append) { - try { - - // try to write the provided - // string lists to the file, - // with UTF-8 as encoding - FileUtils.writeLines(file, "UTF-8", lines, append); - return true; - - } catch (IOException nothandled) { - - // if something bad happens, - // gracefully fallback to - // reporting the failure - return false; - } - } - - /** - * Reads the provided file into a list of strings. - * @param file The file. - * @return A list of strings. - */ - public static List<String> readFromFile(File file) { - try { - - // returns the contents of - // the provided file as - // a list of strings - return FileUtils.readLines(file, "UTF-8"); - - } catch (IOException nothandled) { - - // if something bad happens, - // gracefully fallback to - // an empty file list - return new ArrayList<String>(); - } - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/utils/FileSearchingUtils.java b/support/arara/source/src/main/java/com/github/cereda/arara/utils/FileSearchingUtils.java deleted file mode 100644 index 9f0c03c143..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/utils/FileSearchingUtils.java +++ /dev/null @@ -1,117 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.utils; - -import java.io.File; -import java.util.ArrayList; -import java.util.List; -import org.apache.commons.io.FileUtils; -import org.apache.commons.io.filefilter.FalseFileFilter; -import org.apache.commons.io.filefilter.TrueFileFilter; -import org.apache.commons.io.filefilter.WildcardFileFilter; - -/** - * Implements file searching utilitary methods. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class FileSearchingUtils { - - /** - * List all files from the provided directory according to the list of - * extensions. The leading dot must be omitted, unless it is part of the - * extension. - * @param directory The provided directory. - * @param extensions The list of extensions. - * @param recursive A flag indicating whether the search is recursive. - * @return A list of files. - */ - public static List<File> listFilesByExtensions(File directory, - List<String> extensions, boolean recursive) { - try { - - // convert the provided extension - // list to an extension array - String[] array = new String[extensions.size()]; - array = extensions.toArray(array); - - // return the result of the - // provided search - return new ArrayList<File>( - FileUtils.listFiles(directory, array, recursive) - ); - } catch (Exception nothandled) { - - // if something bad happens, - // gracefully fallback to - // an empty file list - return new ArrayList<File>(); - } - } - - /** - * List all files from the provided directory matching the list of file - * name patterns. Such list can contain wildcards. - * @param directory The provided directory. - * @param patterns The list of file name patterns. - * @param recursive A flag indicating whether the search is recursive. - * @return A list of files. - */ - public static List<File> listFilesByPatterns(File directory, - List<String> patterns, boolean recursive) { - try { - - // return the result of the provided - // search, with the wildcard filter - // and a potential recursive search - return new ArrayList<File>( - FileUtils.listFiles( - directory, - new WildcardFileFilter(patterns), - recursive - ? TrueFileFilter.INSTANCE - : FalseFileFilter.INSTANCE - ) - ); - } catch (Exception nothandled) { - - // if something bad happens, - // gracefully fallback to - // an empty file list - return new ArrayList<File>(); - } - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/utils/InterpreterUtils.java b/support/arara/source/src/main/java/com/github/cereda/arara/utils/InterpreterUtils.java deleted file mode 100644 index d60de0884b..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/utils/InterpreterUtils.java +++ /dev/null @@ -1,257 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.utils; - -import com.github.cereda.arara.controller.ConfigurationController; -import com.github.cereda.arara.controller.LanguageController; -import com.github.cereda.arara.model.AraraException; -import com.github.cereda.arara.model.Argument; -import com.github.cereda.arara.model.Command; -import com.github.cereda.arara.model.Conditional; -import com.github.cereda.arara.model.Messages; -import com.github.cereda.arara.model.Rule; -import java.io.ByteArrayOutputStream; -import java.io.File; -import java.io.IOException; -import java.util.ArrayList; -import java.util.Collection; -import java.util.List; -import java.util.concurrent.TimeUnit; -import java.util.concurrent.TimeoutException; -import org.apache.commons.collections4.CollectionUtils; -import org.apache.commons.collections4.Transformer; -import org.slf4j.Logger; -import org.slf4j.LoggerFactory; -import org.zeroturnaround.exec.InvalidExitValueException; -import org.zeroturnaround.exec.ProcessExecutor; -import org.zeroturnaround.exec.listener.ShutdownHookProcessDestroyer; - -/** - * Implements interpreter utilitary methods. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class InterpreterUtils { - - // the application messages obtained from the - // language controller - private static final LanguageController messages = - LanguageController.getInstance(); - - // get the logger context from a factory - private static final Logger logger = - LoggerFactory.getLogger(InterpreterUtils.class); - - /** - * Gets a list of all rule arguments. - * @param rule The provided rule. - * @return A list of strings containing all rule arguments. - */ - public static List<String> getRuleArguments(Rule rule) { - Collection<String> result = CollectionUtils.collect( - rule.getArguments(), new Transformer<Argument, String>() { - public String transform(Argument input) { - return input.getIdentifier(); - } - }); - return new ArrayList<String>(result); - } - - /** - * Checks if the current conditional has a prior evaluation. - * @param conditional The current conditional object. - * @return A boolean value indicating if the current conditional has a prior - * evaluation. - */ - public static boolean runPriorEvaluation(Conditional conditional) { - if (((Boolean) ConfigurationController.getInstance(). - get("execution.dryrun")) == true) { - return false; - } - switch (conditional.getType()) { - case IF: - case WHILE: - case UNLESS: - return true; - default: - return false; - } - } - - /** - * Runs the command in the underlying operating system. - * @param command An object representing the command. - * @return An integer value representing the exit code. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static int run(Object command) throws AraraException { - boolean verbose = (Boolean) ConfigurationController. - getInstance().get("execution.verbose"); - boolean timeout = (Boolean) ConfigurationController. - getInstance().get("execution.timeout"); - long value = (Long) ConfigurationController. - getInstance().get("execution.timeout.value"); - TimeUnit unit = (TimeUnit) ConfigurationController. - getInstance().get("execution.timeout.unit"); - ByteArrayOutputStream buffer = new ByteArrayOutputStream(); - ProcessExecutor executor = new ProcessExecutor(); - if (CommonUtils.checkClass(Command.class, command)) { - executor = executor.command(((Command) command).getElements()); - if (((Command) command).hasWorkingDirectory()) { - executor = executor.directory( - ((Command) command).getWorkingDirectory() - ); - } - } else { - executor = executor.commandSplit((String) command); - } - if (timeout) { - if (value == 0) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_RUN_TIMEOUT_INVALID_RANGE - ) - ); - } - executor = executor.timeout(value, unit); - } - TeeOutputStream tee; - if (verbose) { - tee = new TeeOutputStream(System.out, buffer); - executor = executor.redirectInput(System.in); - } else { - tee = new TeeOutputStream(buffer); - } - executor = executor.redirectOutput(tee).redirectError(tee); - ShutdownHookProcessDestroyer hook = new ShutdownHookProcessDestroyer(); - executor = executor.addDestroyer(hook); - try { - int exit = executor.execute().getExitValue(); - logger.info(DisplayUtils.displayOutputSeparator( - messages.getMessage( - Messages.LOG_INFO_BEGIN_BUFFER - ) - )); - logger.info(buffer.toString()); - logger.info(DisplayUtils.displayOutputSeparator( - messages.getMessage( - Messages.LOG_INFO_END_BUFFER - ) - )); - return exit; - } catch (IOException ioexception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_RUN_IO_EXCEPTION - ), - ioexception - ); - } catch (InterruptedException iexception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_RUN_INTERRUPTED_EXCEPTION - ), - iexception - ); - } catch (InvalidExitValueException ievexception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_RUN_INVALID_EXIT_VALUE_EXCEPTION - ), - ievexception - ); - } catch (TimeoutException texception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_RUN_TIMEOUT_EXCEPTION - ), - texception - ); - } catch (Exception exception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_RUN_GENERIC_EXCEPTION - ), - exception - ); - } - } - - /** - * Builds the rule path based on the rule name and returns the corresponding - * file location. - * @param name The rule name. - * @return The rule file. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static File buildRulePath(String name) throws AraraException { - @SuppressWarnings("unchecked") - List<String> paths = (List<String>) ConfigurationController. - getInstance().get("execution.rule.paths"); - for (String path : paths) { - File location = new File(construct(path, name)); - if (location.exists()) { - return location; - } - } - return null; - } - - /** - * Constructs the path given the current path and the rule name. - * @param path The current path. - * @param name The rule name. - * @return The constructed path. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static String construct(String path, String name) - throws AraraException { - name = name.concat(".yaml"); - File location = new File(path); - if (location.isAbsolute()) { - return CommonUtils.buildPath(path, name); - } else { - File reference = (File) ConfigurationController. - getInstance().get("execution.reference"); - String parent = CommonUtils.buildPath( - CommonUtils.getParentCanonicalPath(reference), path); - return CommonUtils.buildPath(parent, name); - } - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/utils/MessageUtils.java b/support/arara/source/src/main/java/com/github/cereda/arara/utils/MessageUtils.java deleted file mode 100644 index b36bda8808..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/utils/MessageUtils.java +++ /dev/null @@ -1,313 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.utils; - -import com.github.cereda.arara.controller.ConfigurationController; -import javax.swing.JOptionPane; -import javax.swing.UIManager; - -/** - * Implements utilitary methods for displaying messages. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class MessageUtils { - - // holds the default width for the - // message body, in pixels - private static final int WIDTH = 250; - - // let's start the UI manager and set - // the default look and feel to be as - // close as possible to the system - static { - - // get the current look and feel - String laf = (String) ConfigurationController. - getInstance().get("ui.lookandfeel"); - - // check if one is actually set - if (!laf.equals("none")) { - - // use a special keyword to indicate - // the use of a system look and feel - if (laf.equals("system")) { - laf = UIManager.getSystemLookAndFeelClassName(); - } - - // let's try it, in case it fails, - // rely to the default look and feel - try { - - // get the system look and feel name - // and try to set it as default - UIManager.setLookAndFeel(laf); - } - catch (Exception exception) { - // quack, quack, quack - } - - } - } - - /** - * Normalizes the icon type to one of the five available icons. - * @param value An integer value. - * @return The normalized integer value. - */ - private static int normalizeIconType(int value) { - - // do the normalization according to the available - // icons in the underlying message implementation - switch (value) { - case 1: - value = JOptionPane.ERROR_MESSAGE; - break; - case 2: - value = JOptionPane.INFORMATION_MESSAGE; - break; - case 3: - value = JOptionPane.WARNING_MESSAGE; - break; - case 4: - value = JOptionPane.QUESTION_MESSAGE; - break; - default: - value = JOptionPane.PLAIN_MESSAGE; - break; - } - return value; - } - - /** - * Normalizes the message width, so only valid nonzero values are accepted. - * @param value An integer value corresponding to the message width. - * @return The normalized width. - */ - private static int normalizeMessageWidth(int value) { - return (value > 0 ? value : WIDTH); - } - - /** - * Shows the message. - * @param width Integer value, in pixels. - * @param type Type of message. - * @param title Title of the message. - * @param text Text of the message. - */ - public static void showMessage(int width, int type, - String title, String text) { - - // effectively shows the message based - // on the provided parameters - JOptionPane.showMessageDialog( - null, - String.format( - "<html><body style=\"width:%dpx\">%s</body></html>", - normalizeMessageWidth(width), - text - ), - title, - normalizeIconType(type) - ); - } - - /** - * Shows the message. It relies on the default width. - * @param type Type of message. - * @param title Title of the message. - * @param text Text of the message. - */ - public static void showMessage(int type, String title, String text) { - showMessage(WIDTH, type, title, text); - } - - /** - * Shows a message with options presented as an array of buttons. - * @param width Integer value, in pixels. - * @param type Type of message. - * @param title Title of the message. - * @param text Text of the message. - * @param buttons An array of objects to be presented as buttons. - * @return The index of the selected button, starting from 1. - */ - public static int showOptions(int width, int type, String title, - String text, Object... buttons) { - - // returns the index of the selected button, - // zero if nothing is selected - return JOptionPane.showOptionDialog( - null, - String.format( - "<html><body style=\"width:%dpx\">%s</body></html>", - normalizeMessageWidth(width), - text - ), - title, - JOptionPane.DEFAULT_OPTION, - normalizeIconType(type), - null, - buttons, - buttons[0] - ) + 1; - } - - /** - * Shows a message with options presented as an array of buttons. It relies - * on the default width. - * @param type Type of message. - * @param title Title of the message. - * @param text Text of the message. - * @param buttons An array of objects to be presented as buttons. - * @return The index of the selected button, starting from 1. - */ - public static int showOptions(int type, String title, - String text, Object... buttons) { - return showOptions(WIDTH, type, title, text, buttons); - } - - /** - * Shows a message with a text input. - * @param width Integer value, in pixels. - * @param type Type of message. - * @param title Title of the message. - * @param text Text of the message. - * @return The string representing the input text. - */ - public static String showInput(int width, int type, - String title, String text) { - - // get the string from the - // input text, if any - String input = JOptionPane.showInputDialog( - null, - String.format( - "<html><body style=\"width:%dpx\">%s</body></html>", - normalizeMessageWidth(width), - text - ), - title, - normalizeIconType(type) - ); - - // if the input is not null, that is, - // the user actually typed something - if (input != null) { - - // return the trimmed string - return input.trim(); - } - - // nothing was typed, so let's - // return an empty string - return ""; - } - - /** - * Shows a message with a text input. It relies on the default width. - * @param type Type of message. - * @param title Title of the message. - * @param text Text of the message. - * @return The string representing the input text. - */ - public static String showInput(int type, String title, String text) { - return showInput(WIDTH, type, title, text); - } - - /** - * Shows a message with options presented as a dropdown list of elements. - * @param width Integer value, in pixels. - * @param type Type of message. - * @param title Title of the message. - * @param text Text of the message. - * @param elements An array of objects representing the elements. - * @return The index of the selected element, starting from 1. - */ - public static int showDropdown(int width, int type, String title, - String text, Object... elements) { - - // show the dropdown list and get - // the selected object, if any - Object index = JOptionPane.showInputDialog( - null, - String.format( - "<html><body style=\"width:%dpx\">%s</body></html>", - normalizeMessageWidth(width), - text - ), - title, - normalizeIconType(type), - null, - elements, - elements[0] - ); - - // if it's not a null object, let's - // find the corresponding index - if (index != null) { - - // iterate through the array of elements - for (int i = 0; i < elements.length; i++) { - - // if the element is found, simply - // return the index plus 1, as zero - // corresponds to no selection at all - if (elements[i].equals(index)) { - return i + 1; - } - - } - } - - // nothing was selected, - // simply return zero - return 0; - } - - /** - * Shows a message with options presented as a dropdown list of elements. It - * relies on the default width. - * @param type Type of message. - * @param title Title of the message. - * @param text Text of the message. - * @param elements An array of objects representing the elements. - * @return The index of the selected element, starting from 1. - */ - public static int showDropdown(int type, String title, - String text, Object... elements) { - return showDropdown(WIDTH, type, title, text, elements); - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/utils/Methods.java b/support/arara/source/src/main/java/com/github/cereda/arara/utils/Methods.java deleted file mode 100644 index 24982dace9..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/utils/Methods.java +++ /dev/null @@ -1,1368 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.utils; - -import com.github.cereda.arara.controller.ConfigurationController; -import com.github.cereda.arara.controller.LanguageController; -import com.github.cereda.arara.model.AraraException; -import com.github.cereda.arara.model.Command; -import com.github.cereda.arara.model.Messages; -import com.github.cereda.arara.model.Pair; -import com.github.cereda.arara.model.Session; -import com.github.cereda.arara.model.Trigger; -import java.io.File; -import java.util.Arrays; -import java.util.List; -import java.util.Map; - -/** - * Implements some auxiliary methods for runtime evaluation. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class Methods { - - // the language controller - private static final LanguageController messages = - LanguageController.getInstance(); - - // the session controller - private static final Session session = new Session(); - - /** - * Adds the rule methods to the provided map. - * @param map The map. - */ - public static void addRuleMethods(Map<String, Object> map) { - addConditionalMethods(map); - try { - map.put("getOriginalFile", Methods.class.getMethod("getOriginalFile")); - map.put("getOriginalReference", Methods.class.getMethod("getOriginalReference")); - map.put("isEmpty", Methods.class.getMethod("isEmpty", String.class)); - map.put("isNotEmpty", Methods.class.getMethod("isNotEmpty", String.class)); - map.put("isEmpty", Methods.class.getMethod("isEmpty", String.class, Object.class)); - map.put("isNotEmpty", Methods.class.getMethod("isNotEmpty", String.class, Object.class)); - map.put("isEmpty", Methods.class.getMethod("isEmpty", String.class, Object.class, Object.class)); - map.put("isNotEmpty", Methods.class.getMethod("isNotEmpty", String.class, Object.class, Object.class)); - map.put("isTrue", Methods.class.getMethod("isTrue", String.class)); - map.put("isFalse", Methods.class.getMethod("isFalse", String.class)); - map.put("isTrue", Methods.class.getMethod("isTrue", String.class, Object.class)); - map.put("isFalse", Methods.class.getMethod("isFalse", String.class, Object.class)); - map.put("isTrue", Methods.class.getMethod("isTrue", String.class, Object.class, Object.class)); - map.put("isFalse", Methods.class.getMethod("isFalse", String.class, Object.class, Object.class)); - map.put("isTrue", Methods.class.getMethod("isTrue", String.class, Object.class, Object.class, Object.class)); - map.put("isFalse", Methods.class.getMethod("isFalse", String.class, Object.class, Object.class, Object.class)); - map.put("trimSpaces", Methods.class.getMethod("trimSpaces", String.class)); - map.put("isTrue", Methods.class.getMethod("isTrue", boolean.class, Object.class)); - map.put("isFalse", Methods.class.getMethod("isFalse", boolean.class, Object.class)); - map.put("isTrue", Methods.class.getMethod("isTrue", boolean.class, Object.class, Object.class)); - map.put("isFalse", Methods.class.getMethod("isFalse", boolean.class, Object.class, Object.class)); - map.put("getBasename", Methods.class.getMethod("getBasename", File.class)); - map.put("getBasename", Methods.class.getMethod("getBasename", String.class)); - map.put("getFullBasename", Methods.class.getMethod("getFullBasename", File.class)); - map.put("getFullBasename", Methods.class.getMethod("getFullBasename", String.class)); - map.put("getFiletype", Methods.class.getMethod("getFiletype", File.class)); - map.put("getFiletype", Methods.class.getMethod("getFiletype", String.class)); - map.put("throwError", Methods.class.getMethod("throwError", String.class)); - map.put("getSession", Methods.class.getMethod("getSession")); - map.put("isWindows", Methods.class.getMethod("isWindows")); - map.put("isLinux", Methods.class.getMethod("isLinux")); - map.put("isMac", Methods.class.getMethod("isMac")); - map.put("isUnix", Methods.class.getMethod("isUnix")); - map.put("isAIX", Methods.class.getMethod("isAIX")); - map.put("isIrix", Methods.class.getMethod("isIrix")); - map.put("isOS2", Methods.class.getMethod("isOS2")); - map.put("isSolaris", Methods.class.getMethod("isSolaris")); - map.put("isCygwin", Methods.class.getMethod("isCygwin")); - map.put("isWindows", Methods.class.getMethod("isWindows", Object.class, Object.class)); - map.put("isLinux", Methods.class.getMethod("isLinux", Object.class, Object.class)); - map.put("isMac", Methods.class.getMethod("isMac", Object.class, Object.class)); - map.put("isUnix", Methods.class.getMethod("isUnix", Object.class, Object.class)); - map.put("isAIX", Methods.class.getMethod("isAIX", Object.class, Object.class)); - map.put("isIrix", Methods.class.getMethod("isIrix", Object.class, Object.class)); - map.put("isOS2", Methods.class.getMethod("isOS2", Object.class, Object.class)); - map.put("isSolaris", Methods.class.getMethod("isSolaris", Object.class, Object.class)); - map.put("isCygwin", Methods.class.getMethod("isCygwin", Object.class, Object.class)); - map.put("replicatePattern", Methods.class.getMethod("replicatePattern", String.class, List.class)); - map.put("buildString", Methods.class.getMethod("buildString", Object[].class)); - map.put("addQuotes", Methods.class.getMethod("addQuotes", Object.class)); - map.put("getCommand", Methods.class.getMethod("getCommand", List.class)); - map.put("getCommand", Methods.class.getMethod("getCommand", Object[].class)); - map.put("getTrigger", Methods.class.getMethod("getTrigger", String.class)); - map.put("getTrigger", Methods.class.getMethod("getTrigger", String.class, Object[].class)); - map.put("checkClass", Methods.class.getMethod("checkClass", Class.class, Object.class)); - map.put("isString", Methods.class.getMethod("isString", Object.class)); - map.put("isList", Methods.class.getMethod("isList", Object.class)); - map.put("isMap", Methods.class.getMethod("isMap", Object.class)); - map.put("isBoolean", Methods.class.getMethod("isBoolean", Object.class)); - map.put("isVerboseMode", Methods.class.getMethod("isVerboseMode")); - map.put("showMessage", Methods.class.getMethod("showMessage", int.class, String.class, String.class)); - map.put("showMessage", Methods.class.getMethod("showMessage", int.class, int.class, String.class, String.class)); - map.put("isOnPath", Methods.class.getMethod("isOnPath", String.class)); - map.put("unsafelyExecuteSystemCommand", Methods.class.getMethod("unsafelyExecuteSystemCommand", Command.class)); - map.put("mergeVelocityTemplate", Methods.class.getMethod("mergeVelocityTemplate", File.class, File.class, Map.class)); - map.put("getCommandWithWorkingDirectory", Methods.class.getMethod("getCommandWithWorkingDirectory", String.class, List.class)); - map.put("getCommandWithWorkingDirectory", Methods.class.getMethod("getCommandWithWorkingDirectory", String.class, Object[].class)); - map.put("getCommandWithWorkingDirectory", Methods.class.getMethod("getCommandWithWorkingDirectory", File.class, List.class)); - map.put("getCommandWithWorkingDirectory", Methods.class.getMethod("getCommandWithWorkingDirectory", File.class, Object[].class)); - map.put("listFilesByExtensions", Methods.class.getMethod("listFilesByExtensions", File.class, List.class, boolean.class)); - map.put("listFilesByExtensions", Methods.class.getMethod("listFilesByExtensions", String.class, List.class, boolean.class)); - map.put("listFilesByPatterns", Methods.class.getMethod("listFilesByPatterns", File.class, List.class, boolean.class)); - map.put("listFilesByPatterns", Methods.class.getMethod("listFilesByPatterns", String.class, List.class, boolean.class)); - map.put("writeToFile", Methods.class.getMethod("writeToFile", File.class, String.class, boolean.class)); - map.put("writeToFile", Methods.class.getMethod("writeToFile", File.class, List.class, boolean.class)); - map.put("writeToFile", Methods.class.getMethod("writeToFile", String.class, String.class, boolean.class)); - map.put("writeToFile", Methods.class.getMethod("writeToFile", String.class, List.class, boolean.class)); - map.put("readFromFile", Methods.class.getMethod("readFromFile", File.class)); - map.put("readFromFile", Methods.class.getMethod("readFromFile", String.class)); - map.put("isSubdirectory", Methods.class.getMethod("isSubdirectory", File.class)); - } catch (Exception exception) { - // quack, quack, quack - } - } - - /** - * Adds conditional methods to the provided map. - * @param map The map. - */ - public static void addConditionalMethods(Map<String, Object> map) { - try { - map.put("exists", Methods.class.getMethod("exists", String.class)); - map.put("exists", Methods.class.getMethod("exists", File.class)); - map.put("missing", Methods.class.getMethod("missing", String.class)); - map.put("missing", Methods.class.getMethod("missing", File.class)); - map.put("changed", Methods.class.getMethod("changed", String.class)); - map.put("changed", Methods.class.getMethod("changed", File.class)); - map.put("unchanged", Methods.class.getMethod("unchanged", String.class)); - map.put("unchanged", Methods.class.getMethod("unchanged", File.class)); - map.put("found", Methods.class.getMethod("found", String.class, String.class)); - map.put("found", Methods.class.getMethod("found", File.class, String.class)); - map.put("toFile", Methods.class.getMethod("toFile", String.class)); - map.put("showDropdown", Methods.class.getMethod("showDropdown", int.class, String.class, String.class, Object[].class)); - map.put("showDropdown", Methods.class.getMethod("showDropdown", int.class, int.class, String.class, String.class, Object[].class)); - map.put("showInput", Methods.class.getMethod("showInput", int.class, String.class, String.class)); - map.put("showInput", Methods.class.getMethod("showInput", int.class, int.class, String.class, String.class)); - map.put("showOptions", Methods.class.getMethod("showOptions", int.class, String.class, String.class, Object[].class)); - map.put("showOptions", Methods.class.getMethod("showOptions", int.class, int.class, String.class, String.class, Object[].class)); - map.put("currentFile", Methods.class.getMethod("currentFile")); - map.put("loadClass", Methods.class.getMethod("loadClass", File.class, String.class)); - map.put("loadClass", Methods.class.getMethod("loadClass", String.class, String.class)); - map.put("loadObject", Methods.class.getMethod("loadObject", File.class, String.class)); - map.put("loadObject", Methods.class.getMethod("loadObject", String.class, String.class)); - } catch (Exception exception) { - // quack, quack, quack - } - } - - /** - * Gets the original file. - * @return The original file. - */ - public static String getOriginalFile() { - File file = (File) ConfigurationController.getInstance().get("execution.reference"); - return file.getName(); - } - - /** - * Gets the original reference. - * @return The original reference. - */ - public static File getOriginalReference() { - return (File) ConfigurationController.getInstance().get("execution.reference"); - } - - /** - * Checks if the string is empty. - * @param string The string. - * @return A boolean value. - */ - public static boolean isEmpty(String string) { - return CommonUtils.checkEmptyString(string); - } - - /** - * Checks if the string is not empty. - * @param string The string. - * @return A boolean value. - */ - public static boolean isNotEmpty(String string) { - return !isEmpty(string); - } - - /** - * Checks if the string is empty. - * @param string The string. - * @param yes Object to return if true. - * @return An object or empty string. - */ - public static Object isEmpty(String string, Object yes) { - return isEmpty(string) ? yes : ""; - } - - /** - * Checks if the string is not empty. - * @param string The string. - * @param yes Object to return if true. - * @return An object or empty string. - */ - public static Object isNotEmpty(String string, Object yes) { - return isNotEmpty(string) ? yes : ""; - } - - /** - * Checks if the string is empty. - * @param string The string. - * @param yes Object to return if true. - * @param no Object to return if false. - * @return One of the two objects. - */ - public static Object isEmpty(String string, Object yes, Object no) { - return isEmpty(string) ? yes : no; - } - - /** - * Checks if the string is not empty. - * @param string The string. - * @param yes Object to return if true. - * @param no Object to return if false. - * @return One of the two objects. - */ - public static Object isNotEmpty(String string, Object yes, Object no) { - return isNotEmpty(string) ? yes : no; - } - - /** - * Checks if the string holds a true value. - * @param string The string. - * @return A boolean value. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean isTrue(String string) throws AraraException { - return isEmpty(string) ? false : CommonUtils.checkBoolean(string); - } - - /** - * Checks if the string holds a false value. - * @param string The string. - * @return A boolean value. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean isFalse(String string) throws AraraException { - return isEmpty(string) ? false : !CommonUtils.checkBoolean(string); - } - - /** - * Checks if the string holds a true value. - * @param string The string. - * @param yes Object to return if true. - * @return An object or an empty string. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static Object isTrue(String string, Object yes) - throws AraraException { - return isTrue(string) ? yes : ""; - } - - /** - * Checks if the string holds a false value. - * @param string The string. - * @param yes Object to return if true. - * @return An object or an empty string. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static Object isFalse(String string, Object yes) - throws AraraException { - return (isFalse(string) ? yes : ""); - } - - /** - * Checks if the string holds a true value. - * @param string The string. - * @param yes Object to return if true. - * @param no Object to return if false. - * @return One of the two objects. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static Object isTrue(String string, Object yes, Object no) - throws AraraException { - return (isTrue(string) ? yes : no); - } - - /** - * Checks if the string holds a false value. - * @param string The string. - * @param yes Object to return if true. - * @param no Object to return if false. - * @return One of the two objects. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static Object isFalse(String string, Object yes, Object no) - throws AraraException { - return (isFalse(string) ? yes : no); - } - - /** - * Checks if the string holds a true value. - * @param string The string. - * @param yes Object to return if true. - * @param no Object to return if false. - * @param fallback Object to return if string is empty. - * @return One of the three options. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static Object isTrue(String string, Object yes, Object no, - Object fallback) throws AraraException { - return isEmpty(string) ? fallback : (isTrue(string) ? yes : no); - } - - /** - * Checks if the string holds a false value. - * @param string The string. - * @param yes Object to return if true. - * @param no Object to return if false. - * @param fallback Object to return if string is empty. - * @return One of the three options. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static Object isFalse(String string, Object yes, Object no, - Object fallback) throws AraraException { - return isEmpty(string) ? fallback : (isFalse(string) ? yes : no); - } - - /** - * Trim spaces from the string. - * @param string The string. - * @return A trimmed string. - */ - public static String trimSpaces(String string) { - return string.trim(); - } - - /** - * Checks if the expression resolves to true. - * @param value The expression. - * @param yes Object to return if true. - * @return An object or an empty string. - */ - public static Object isTrue(boolean value, Object yes) { - return value ? yes : ""; - } - - /** - * Checks if the expression resolves to false. - * @param value The expression. - * @param yes Object to return if true. - * @return An object or an empty string. - */ - public static Object isFalse(boolean value, Object yes) { - return !value ? yes : ""; - } - - /** - * Checks if the expression resolves to true. - * @param value The expression. - * @param yes Object to return if true. - * @param no Object to return if false. - * @return One of the two objects. - */ - public static Object isTrue(boolean value, Object yes, Object no) { - return value ? yes : no; - } - - /** - * Checks if the expression resolves to false. - * @param value The expression. - * @param yes Object to return if true. - * @param no Object to return if false. - * @return One of the two objects. - */ - public static Object isFalse(boolean value, Object yes, Object no) { - return !value ? yes : no; - } - - /** - * Gets the basename. - * @param file The file. - * @return The basename of the provided file. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static String getBasename(File file) throws AraraException { - if (file.isFile()) { - return CommonUtils.getBasename(file); - } else { - throw new AraraException( - CommonUtils.getRuleErrorHeader().concat( - messages.getMessage( - Messages.ERROR_BASENAME_NOT_A_FILE, - file.getName() - ) - ) - ); - } - } - - /** - * Gets the basename. - * @param filename The string. - * @return The basename. - */ - public static String getBasename(String filename) { - return CommonUtils.getBasename(filename); - } - - /** - * Gets the file type. - * @param file The provided file. - * @return The file type. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static String getFiletype(File file) throws AraraException { - if (file.isFile()) { - return CommonUtils.getFiletype(file); - } else { - throw new AraraException( - CommonUtils.getRuleErrorHeader().concat( - messages.getMessage( - Messages.ERROR_FILETYPE_NOT_A_FILE, - file.getName() - ) - ) - ); - } - } - - /** - * Gets the file type. - * @param filename The provided string. - * @return The file type. - */ - public static String getFiletype(String filename) { - return CommonUtils.getFiletype(filename); - } - - /** - * Replicates the pattern to each element of a list. - * @param pattern The pattern. - * @param values The list. - * @return A list of strings containing the pattern applied to the list. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static List<Object> replicatePattern(String pattern, - List<Object> values) throws AraraException { - return CommonUtils.replicateList(pattern, values); - } - - /** - * Throws an exception. - * @param text The text to be thrown as the exception message. - * @throws AraraException The exception to be thrown by this method. - */ - public static void throwError(String text) throws AraraException { - throw new AraraException(text); - } - - /** - * Gets the session. - * @return The session. - */ - public static Session getSession() { - return session; - } - - /** - * Checks if Windows is the underlying operating system. - * @return A boolean value. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean isWindows() throws AraraException { - return CommonUtils.checkOS("windows"); - } - - /** - * Checks if we are inside a Cygwin environment. - * @return A boolean value. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean isCygwin() throws AraraException { - return CommonUtils.checkOS("cygwin"); - } - - /** - * Checks if Linux is the underlying operating system. - * @return A boolean value. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean isLinux() throws AraraException { - return CommonUtils.checkOS("linux"); - } - - /** - * Checks if Mac is the underlying operating system. - * @return A boolean value. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean isMac() throws AraraException { - return CommonUtils.checkOS("mac"); - } - - /** - * Checks if Unix is the underlying operating system. - * @return A boolean value. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean isUnix() throws AraraException { - return CommonUtils.checkOS("unix"); - } - - /** - * Checks if AIX is the underlying operating system. - * @return A boolean value. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean isAIX() throws AraraException { - return CommonUtils.checkOS("aix"); - } - - /** - * Checks if Irix is the underlying operating system. - * @return A boolean value. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean isIrix() throws AraraException { - return CommonUtils.checkOS("irix"); - } - - /** - * Checks if OS2 is the underlying operating system. - * @return A boolean value. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean isOS2() throws AraraException { - return CommonUtils.checkOS("os2"); - } - - /** - * Checks if Solaris is the underlying operating system. - * @return A boolean value. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean isSolaris() throws AraraException { - return CommonUtils.checkOS("solaris"); - } - - /** - * Checks if Windows is the underlying operating system. - * @param yes Object to return if true. - * @param no Object to return if false. - * @return One of the two objects. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static Object isWindows(Object yes, Object no) - throws AraraException { - return CommonUtils.checkOS("windows") ? yes : no; - } - - /** - * Checks if we are inside a Cygwin environment. - * @param yes Object to return if true. - * @param no Object to return if false. - * @return One of the two objects. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static Object isCygwin(Object yes, Object no) throws AraraException { - return CommonUtils.checkOS("cygwin") ? yes : no; - } - - /** - * Checks if Linux is the underlying operating system. - * @param yes Object to return if true. - * @param no Object to return if false. - * @return One of the two objects. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static Object isLinux(Object yes, Object no) throws AraraException { - return CommonUtils.checkOS("linux") ? yes : no; - } - - /** - * Checks if Mac is the underlying operating system. - * @param yes Object to return if true. - * @param no Object to return if false. - * @return One of the two objects. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static Object isMac(Object yes, Object no) throws AraraException { - return CommonUtils.checkOS("mac") ? yes : no; - } - - /** - * Checks if Unix is the underlying operating system. - * @param yes Object to return if true. - * @param no Object to return if false. - * @return One of the two objects. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static Object isUnix(Object yes, Object no) throws AraraException { - return CommonUtils.checkOS("unix") ? yes : no; - } - - /** - * Checks if AIX is the underlying operating system. - * @param yes Object to return if true. - * @param no Object to return if false. - * @return One of the two objects. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static Object isAIX(Object yes, Object no) throws AraraException { - return CommonUtils.checkOS("aix") ? yes : no; - } - - /** - * Checks if Irix is the underlying operating system. - * @param yes Object to return if true. - * @param no Object to return if false. - * @return One of the two objects. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static Object isIrix(Object yes, Object no) throws AraraException { - return CommonUtils.checkOS("irix") ? yes : no; - } - - /** - * Checks if OS2 is the underlying operating system. - * @param yes Object to return if true. - * @param no Object to return if false. - * @return One of the two objects. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static Object isOS2(Object yes, Object no) throws AraraException { - return CommonUtils.checkOS("os2") ? yes : no; - } - - /** - * Checks if Solaris is the underlying operating system. - * @param yes Object to return if true. - * @param no Object to return if false. - * @return One of the two objects. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static Object isSolaris(Object yes, Object no) throws AraraException { - return CommonUtils.checkOS("solaris") ? yes : no; - } - - /** - * Checks if the file exists according to its extension. - * @param extension The extension. - * @return A boolean value. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean exists(String extension) throws AraraException { - return CommonUtils.exists(extension); - } - - /** - * Checks if the file is missing according to its extension. - * @param extension The extension. - * @return A boolean value. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean missing(String extension) throws AraraException { - return !exists(extension); - } - - /** - * Checks if the file has changed, according to its extension. - * @param extension The extension. - * @return A boolean value. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean changed(String extension) throws AraraException { - return CommonUtils.hasChanged(extension); - } - - /** - * Checks if the file is unchanged according to its extension. - * @param extension The extension. - * @return A boolean value. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean unchanged(String extension) throws AraraException { - return !changed(extension); - } - - /** - * Checks if the file exists. - * @param filename The file. - * @return A boolean value. - */ - public static boolean exists(File filename) { - return CommonUtils.exists(filename); - } - - /** - * Checks if the file is missing. - * @param filename The file. - * @return A boolean value. - */ - public static boolean missing(File filename) { - return !exists(filename); - } - - /** - * Checks if the file has changed. - * @param filename The file. - * @return A boolean value. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean changed(File filename) throws AraraException { - return CommonUtils.hasChanged(filename); - } - - /** - * Checks if the file is unchanged. - * @param filename The file. - * @return A boolean value. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean unchanged(File filename) throws AraraException { - return !changed(filename); - } - - /** - * Build a string based on an array of objects. - * @param objects Array of objects. - * @return A string built from the array. - */ - public static String buildString(Object... objects) { - return CommonUtils.generateString(objects); - } - - /** - * Encloses the provided object into double quotes. - * @param object The object. - * @return The object enclosed in double quotes. - */ - public static String addQuotes(Object object) { - return CommonUtils.addQuotes(object); - } - - /** - * Checks if the file contains the regex, based on its extension. - * @param extension The extension. - * @param regex The regex. - * @return A boolean value. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean found(String extension, String regex) - throws AraraException { - return CommonUtils.checkRegex(extension, regex); - } - - /** - * Checks if the file contains the provided regex. - * @param file The file. - * @param regex The regex. - * @return A boolean value. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static boolean found(File file, String regex) - throws AraraException { - return CommonUtils.checkRegex(file, regex); - } - - /** - * Gets the command based on a list of strings. - * @param elements The list of strings. - * @return A command. - */ - public static Command getCommand(List<String> elements) { - return new Command(elements); - } - - /** - * Gets the command based on an array of objects. - * @param elements Array of objects. - * @return A command. - */ - public static Command getCommand(Object... elements) { - return new Command(elements); - } - - /** - * Gets the command based on an array of objects and with the provided - * working directory as string. - * @param path String path representing the working directory. - * @param elements Array of elements. - * @return A command. - */ - public static Command getCommandWithWorkingDirectory(String path, - Object... elements) { - Command command = new Command(elements); - command.setWorkingDirectory(new File(path)); - return command; - } - - /** - * Gets the command based on an array of objects and with the provided - * working directory as file. - * @param file File representing the working directory. - * @param elements Array of elements. - * @return A command. - */ - public static Command getCommandWithWorkingDirectory(File file, - Object... elements) { - Command command = new Command(elements); - command.setWorkingDirectory(file); - return command; - } - - /** - * Gets the command based on a list of strings and with the provided - * working directory as string. - * @param path String path representing the working directory. - * @param elements List of strings. - * @return A command. - */ - public static Command getCommandWithWorkingDirectory(String path, - List<String> elements) { - Command command = new Command(elements); - command.setWorkingDirectory(new File(path)); - return command; - } - - /** - * Gets the command based on a list of strings and with the provided - * working directory as file. - * @param file File representing the working directory. - * @param elements List of strings. - * @return A command. - */ - public static Command getCommandWithWorkingDirectory(File file, - List<String> elements) { - Command command = new Command(elements); - command.setWorkingDirectory(file); - return command; - } - - /** - * Gets the trigger. - * @param action The action name. - * @return The trigger. - */ - public static Trigger getTrigger(String action) { - return new Trigger(action, null); - } - - /** - * Gets the trigger. - * @param action The action name. - * @param parameters The trigger parameters. - * @return A trigger. - */ - public static Trigger getTrigger(String action, Object... parameters) { - return new Trigger(action, Arrays.asList(parameters)); - } - - /** - * Checks if the object is an intance of the provided class. - * @param clazz The class. - * @param object The object. - * @return A boolean value. - */ - public static boolean checkClass(Class clazz, Object object) { - return CommonUtils.checkClass(clazz, object); - } - - /** - * Checks if the object is a string. - * @param object The object. - * @return A boolean value. - */ - public static boolean isString(Object object) { - return checkClass(String.class, object); - } - - /** - * Checks if the object is a list. - * @param object The object. - * @return A boolean value. - */ - public static boolean isList(Object object) { - return checkClass(List.class, object); - } - - /** - * Checks if the object is a map. - * @param object The object. - * @return A boolean value. - */ - public static boolean isMap(Object object) { - return checkClass(Map.class, object); - } - - /** - * Checks if the object is a boolean. - * @param object The object. - * @return A boolean value. - */ - public static boolean isBoolean(Object object) { - return checkClass(Boolean.class, object); - } - - /** - * Checks if the execution is in verbose mode. - * @return A boolean value indicating if the execution is in verbose mode. - */ - public static boolean isVerboseMode() { - return (Boolean) ConfigurationController. - getInstance().get("execution.verbose"); - } - - /** - * Returns a file object based on the provided name. - * @param name The file name. - * @return A file object. - */ - public static File toFile(String name) { - return new File(name); - } - - /** - * Shows the message. - * @param width Integer value, in pixels. - * @param type Type of message. - * @param title Title of the message. - * @param text Text of the message. - */ - public static void showMessage(int width, int type, - String title, String text) { - MessageUtils.showMessage(width, type, title, text); - } - - /** - * Shows the message. It relies on the default width. - * @param type Type of message. - * @param title Title of the message. - * @param text Text of the message. - */ - public static void showMessage(int type, String title, String text) { - MessageUtils.showMessage(type, title, text); - } - - /** - * Shows a message with options presented as an array of buttons. - * @param width Integer value, in pixels. - * @param type Type of message. - * @param title Title of the message. - * @param text Text of the message. - * @param buttons An array of objects to be presented as buttons. - * @return The index of the selected button, starting from 1. - */ - public static int showOptions(int width, int type, String title, - String text, Object... buttons) { - return MessageUtils.showOptions(width, type, title, text, buttons); - } - - /** - * Shows a message with options presented as an array of buttons. It relies - * on the default width. - * @param type Type of message. - * @param title Title of the message. - * @param text Text of the message. - * @param buttons An array of objects to be presented as buttons. - * @return The index of the selected button, starting from 1. - */ - public static int showOptions(int type, String title, - String text, Object... buttons) { - return MessageUtils.showOptions(type, title, text, buttons); - } - - /** - * Shows a message with a text input. - * @param width Integer value, in pixels. - * @param type Type of message. - * @param title Title of the message. - * @param text Text of the message. - * @return The string representing the input text. - */ - public static String showInput(int width, int type, - String title, String text) { - return MessageUtils.showInput(width, type, title, text); - } - - /** - * Shows a message with a text input. It relies on the default width. - * @param type Type of message. - * @param title Title of the message. - * @param text Text of the message. - * @return The string representing the input text. - */ - public static String showInput(int type, String title, String text) { - return MessageUtils.showInput(type, title, text); - } - - /** - * Shows a message with options presented as a dropdown list of elements. - * @param width Integer value, in pixels. - * @param type Type of message. - * @param title Title of the message. - * @param text Text of the message. - * @param elements An array of objects representing the elements. - * @return The index of the selected element, starting from 1. - */ - public static int showDropdown(int width, int type, String title, - String text, Object... elements) { - return MessageUtils.showDropdown(width, type, title, text, elements); - } - - /** - * Shows a message with options presented as a dropdown list of elements. It - * relies on the default width. - * @param type Type of message. - * @param title Title of the message. - * @param text Text of the message. - * @param elements An array of objects representing the elements. - * @return The index of the selected element, starting from 1. - */ - public static int showDropdown(int type, String title, - String text, Object... elements) { - return MessageUtils.showDropdown(type, title, text, elements); - } - - /** - * Checks if the provided command name is reachable from the system path. - * @param command A string representing the command. - * @return A logic value. - */ - public static boolean isOnPath(String command) { - return CommonUtils.isOnPath(command); - } - - /** - * Gets the full basename. - * @param file The file. - * @return The full basename of the provided file. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static String getFullBasename(File file) throws AraraException { - if (file.isFile()) { - return CommonUtils.getFullBasename(file); - } else { - throw new AraraException( - CommonUtils.getRuleErrorHeader().concat( - messages.getMessage( - Messages.ERROR_BASENAME_NOT_A_FILE, - file.getName() - ) - ) - ); - } - } - - /** - * Gets the full basename. - * @param name The string. - * @return The full basename. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static String getFullBasename(String name) throws AraraException { - return getFullBasename(new File(name)); - } - - /** - * Unsafely executes a system command from the underlying operating system - * and returns a pair containing the exit status and the command output as a - * string. - * @param command The system command to be executed. - * @return A pair containing the exit status and the system command output - * as a string. - */ - public static Pair<Integer, String> - unsafelyExecuteSystemCommand(Command command) { - return UnsafeUtils.executeSystemCommand(command); - } - - /** - * Merges the provided template with a context map and writes the result in - * an output file. This method relies on Apache Velocity. - * @param input The input file. - * @param output The output file. - * @param map The context map. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static void mergeVelocityTemplate(File input, File output, - Map<String, Object> map) throws AraraException { - VelocityUtils.mergeVelocityTemplate(input, output, map); - } - - /** - * Gets the file reference for the current directive. It is important to - * observe that version 4.0 of arara replicates the directive when 'files' - * is detected amongst the parameters, so each instance will have a - * different reference. - * @return A file reference for the current directive. - */ - public static File currentFile() { - return (File) ConfigurationController.getInstance(). - get("execution.directive.reference"); - } - - /** - * Loads a class from the provided file, potentially a Java archive. - * @param file File containing the Java bytecode (namely, a JAR). - * @param name The canonical name of the class. - * @return A pair representing the status and the class. - */ - public static Pair<Integer, Class> loadClass(File file, String name) { - return ClassLoadingUtils.loadClass(file, name); - } - - /** - * Loads a class from the provided string reference, representing a file. - * @param ref String reference representing a file. - * @param name The canonical name of the class. - * @return A pair representing the status and the class. - */ - public static Pair<Integer, Class> loadClass(String ref, String name) { - return ClassLoadingUtils.loadClass(new File(ref), name); - } - - /** - * Loads a class from the provided file, instantiating it. - * @param file File containing the Java bytecode (namely, a JAR). - * @param name The canonical name of the class. - * @return A pair representing the status and the class object. - */ - public static Pair<Integer, Object> loadObject(File file, String name) { - return ClassLoadingUtils.loadObject(file, name); - } - - /** - * Loads a class from the provided string reference, instantiating it. - * @param ref String reference representing a file. - * @param name The canonical name of the class. - * @return A pair representing the status and the class object. - */ - public static Pair<Integer, Object> loadObject(String ref, String name) { - return ClassLoadingUtils.loadObject(new File(ref), name); - } - - /** - * List all files from the provided directory according to the list of - * extensions. The leading dot must be omitted, unless it is part of the - * extension. - * @param directory The provided directory. - * @param extensions The list of extensions. - * @param recursive A flag indicating whether the search is recursive. - * @return A list of files. - */ - public static List<File> listFilesByExtensions(File directory, - List<String> extensions, boolean recursive) { - return FileSearchingUtils.listFilesByExtensions( - directory, - extensions, - recursive - ); - } - - /** - * List all files from the provided string path according to the list of - * extensions. The leading dot must be omitted, unless it is part of the - * extension. - * @param path The provided path as plain string. - * @param extensions The list of extensions. - * @param recursive A flag indicating whether the search is recursive. - * @return A list of files. - */ - public static List<File> listFilesByExtensions(String path, - List<String> extensions, boolean recursive) { - return FileSearchingUtils.listFilesByExtensions( - new File(path), - extensions, - recursive - ); - } - - /** - * List all files from the provided directory matching the list of file - * name patterns. Such list can contain wildcards. - * @param directory The provided directory. - * @param patterns The list of file name patterns. - * @param recursive A flag indicating whether the search is recursive. - * @return A list of files. - */ - public static List<File> listFilesByPatterns(File directory, - List<String> patterns, boolean recursive) { - return FileSearchingUtils.listFilesByPatterns( - directory, - patterns, - recursive - ); - } - - /** - * List all files from the provided path matching the list of file - * name patterns. Such list can contain wildcards. - * @param path The provided path as plain string. - * @param patterns The list of file name patterns. - * @param recursive A flag indicating whether the search is recursive. - * @return A list of files. - */ - public static List<File> listFilesByPatterns(String path, - List<String> patterns, boolean recursive) { - return FileSearchingUtils.listFilesByPatterns( - new File(path), - patterns, - recursive - ); - } - - /** - * Writes the string to a file, using UTF-8 as default encoding. - * @param file The file. - * @param text The string to be written. - * @param append A flag whether to append the content. - * @return A logical value indicating whether it was successful. - */ - public static boolean writeToFile(File file, String text, boolean append) { - return FileHandlingUtils.writeToFile(file, text, append); - } - - /** - * Writes the string to a file, using UTF-8 as default encoding. - * @param path The path. - * @param text The string to be written. - * @param append A flag whether to append the content. - * @return A logical value indicating whether it was successful. - */ - public static boolean writeToFile(String path, String text, - boolean append) { - return FileHandlingUtils.writeToFile(new File(path), text, append); - } - - /** - * Writes the string list to a file, using UTF-8 as default encoding. - * @param file The file. - * @param lines The string list to be written. - * @param append A flag whether to append the content. - * @return A logical value indicating whether it was successful. - */ - public static boolean writeToFile(File file, List<String> lines, - boolean append) { - return FileHandlingUtils.writeToFile(file, lines, append); - } - - /** - * Writes the string list to a file, using UTF-8 as default encoding. - * @param path The path. - * @param lines The string list to be written. - * @param append A flag whether to append the content. - * @return A logical value indicating whether it was successful. - */ - public static boolean writeToFile(String path, List<String> lines, - boolean append) { - return FileHandlingUtils.writeToFile(new File(path), lines, append); - } - - /** - * Reads the provided file into a list of strings. - * @param file The file. - * @return A list of strings. - */ - public static List<String> readFromFile(File file) { - return FileHandlingUtils.readFromFile(file); - } - - /** - * Reads the provided file into a list of strings. - * @param path The path. - * @return A list of strings. - */ - public static List<String> readFromFile(String path) { - return FileHandlingUtils.readFromFile(new File(path)); - } - - /** - * Checks whether a directory is under the project directory. - * @param directory The directory to be inspected. - * @return Logical value indicating whether the directoy is under root. - * @throws AraraException There was a problem with path retrieval. - */ - public static boolean isSubdirectory(File directory) - throws AraraException { - return CommonUtils.isSubDirectory(directory, getOriginalReference()); - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/utils/RuleUtils.java b/support/arara/source/src/main/java/com/github/cereda/arara/utils/RuleUtils.java deleted file mode 100644 index f2fb1c8570..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/utils/RuleUtils.java +++ /dev/null @@ -1,244 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.utils; - -import com.github.cereda.arara.controller.LanguageController; -import com.github.cereda.arara.model.AraraException; -import com.github.cereda.arara.model.Argument; -import com.github.cereda.arara.model.Messages; -import com.github.cereda.arara.model.RuleCommand; -import com.github.cereda.arara.model.Rule; -import java.io.File; -import java.io.FileReader; -import java.util.ArrayList; -import java.util.HashSet; -import java.util.List; -import org.apache.commons.collections4.CollectionUtils; -import org.apache.commons.collections4.Predicate; -import org.yaml.snakeyaml.Yaml; -import org.yaml.snakeyaml.constructor.Constructor; -import org.yaml.snakeyaml.error.MarkedYAMLException; -import org.yaml.snakeyaml.nodes.Tag; -import org.yaml.snakeyaml.representer.Representer; - -/** - * Implements rule utilitary methods. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class RuleUtils { - - // the application messages obtained from the - // language controller - private static final LanguageController messages = - LanguageController.getInstance(); - - /** - * Parses the provided file, checks the identifier and returns a rule - * representation. - * @param file The rule file. - * @param identifier The directive identifier. - * @return The rule object. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - public static Rule parseRule(File file, String identifier) - throws AraraException { - Representer representer = new Representer(); - representer.addClassTag(Rule.class, new Tag("!config")); - Yaml yaml = new Yaml(new Constructor(Rule.class), representer); - Rule rule = null; - try { - rule = yaml.loadAs(new FileReader(file), Rule.class); - } catch (MarkedYAMLException yamlException) { - throw new AraraException( - CommonUtils.getRuleErrorHeader().concat( - messages.getMessage( - Messages.ERROR_PARSERULE_INVALID_YAML - ) - ), - yamlException - ); - } catch (Exception exception) { - throw new AraraException( - CommonUtils.getRuleErrorHeader().concat( - messages.getMessage( - Messages.ERROR_PARSERULE_GENERIC_ERROR - ) - ) - ); - } - validateHeader(rule, identifier); - validateBody(rule); - return rule; - } - - /** - * Validates the rule header according to the directive identifier. - * @param rule The rule object. - * @param identifier The directive identifier. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - private static void validateHeader(Rule rule, String identifier) - throws AraraException { - if (rule.getIdentifier() != null) { - if (!rule.getIdentifier().equals(identifier)) { - throw new AraraException(CommonUtils.getRuleErrorHeader(). - concat( - messages.getMessage( - Messages.ERROR_VALIDATEHEADER_WRONG_IDENTIFIER, - rule.getIdentifier(), - identifier - ) - ) - ); - } - } else { - throw new AraraException( - CommonUtils.getRuleErrorHeader().concat( - messages.getMessage( - Messages.ERROR_VALIDATEHEADER_NULL_ID - ) - ) - ); - } - if (rule.getName() == null) { - throw new AraraException( - CommonUtils.getRuleErrorHeader().concat( - messages.getMessage( - Messages.ERROR_VALIDATEHEADER_NULL_NAME - ) - ) - ); - } - } - - /** - * Validates the rule body. - * @param rule The rule object. - * @throws AraraException Something wrong happened, to be caught in the - * higher levels. - */ - private static void validateBody(Rule rule) throws AraraException { - if (rule.getCommands() == null) { - throw new AraraException( - CommonUtils.getRuleErrorHeader().concat( - messages.getMessage( - Messages.ERROR_VALIDATEBODY_NULL_COMMANDS_LIST - ) - ) - ); - } else { - if (CollectionUtils.exists(rule.getCommands(), - new Predicate<RuleCommand>() { - public boolean evaluate(RuleCommand command) { - return (command.getCommand() == null); - } - })) { - throw new AraraException(CommonUtils.getRuleErrorHeader(). - concat( - messages.getMessage( - Messages.ERROR_VALIDATEBODY_NULL_COMMAND - ) - ) - ); - } - } - if (rule.getArguments() == null) { - throw new AraraException( - CommonUtils.getRuleErrorHeader().concat( - messages.getMessage( - Messages.ERROR_VALIDATEBODY_ARGUMENTS_LIST - ) - ) - ); - } else { - String[] keywords = new String[]{"file", "files", "reference"}; - - List<String> arguments = new ArrayList<String>(); - for (Argument argument : rule.getArguments()) { - if (argument.getIdentifier() != null) { - if ((argument.getFlag() != null) || - (argument.getDefault() != null)) { - arguments.add(argument.getIdentifier()); - } else { - throw new AraraException( - CommonUtils.getRuleErrorHeader().concat( - messages.getMessage( - Messages.ERROR_VALIDATEBODY_MISSING_KEYS - ) - ) - ); - } - } else { - throw new AraraException( - CommonUtils.getRuleErrorHeader().concat( - messages.getMessage( - Messages.ERROR_VALIDATEBODY_NULL_ARGUMENT_ID - ) - ) - ); - } - } - - for (String keyword : keywords) { - if (arguments.contains(keyword)) { - throw new AraraException( - CommonUtils.getRuleErrorHeader().concat( - messages.getMessage( - Messages.ERROR_VALIDATEBODY_ARGUMENT_ID_IS_RESERVED, - keyword - ) - ) - ); - } - } - - int expected = arguments.size(); - int found = (new HashSet<String>(arguments)).size(); - if (expected != found) { - throw new AraraException( - CommonUtils.getRuleErrorHeader().concat( - messages.getMessage( - Messages.ERROR_VALIDATEBODY_DUPLICATE_ARGUMENT_IDENTIFIERS - ) - ) - ); - } - } - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/utils/TeeOutputStream.java b/support/arara/source/src/main/java/com/github/cereda/arara/utils/TeeOutputStream.java deleted file mode 100644 index 58418ea62d..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/utils/TeeOutputStream.java +++ /dev/null @@ -1,109 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.utils; - -import java.io.IOException; -import java.io.OutputStream; -import org.apache.commons.io.IOUtils; - -/** - * Implements a stream splitter. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class TeeOutputStream extends OutputStream { - - // an array of streams in which - // an object of this class will - // split data - private final OutputStream[] streams; - - /** - * Constructor. - * @param outputStreams An array of output streams. - */ - public TeeOutputStream(OutputStream... outputStreams) { - streams = outputStreams; - } - - /** - * Writes the provided integer to each stream. - * @param b The provided integer - * @throws IOException An IO exception. - */ - @Override - public void write(int b) throws IOException { - for (OutputStream ostream : streams) { - ostream.write(b); - } - } - - /** - * Writes the provided byte array to each stream, with the provided offset - * and length. - * @param b The byte array. - * @param offset The offset. - * @param length The length. - * @throws IOException An IO exception. - */ - @Override - public void write(byte[] b, int offset, int length) throws IOException { - for (OutputStream ostream : streams) { - ostream.write(b, offset, length); - } - } - - /** - * Flushes every stream. - * @throws IOException An IO exception. - */ - @Override - public void flush() throws IOException { - for (OutputStream ostream : streams) { - ostream.flush(); - } - } - - /** - * Closes every stream silently. - */ - @Override - public void close() { - for (OutputStream ostream : streams) { - IOUtils.closeQuietly(ostream); - } - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/utils/UnsafeUtils.java b/support/arara/source/src/main/java/com/github/cereda/arara/utils/UnsafeUtils.java deleted file mode 100644 index d5a4058b3e..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/utils/UnsafeUtils.java +++ /dev/null @@ -1,87 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.utils; - -import com.github.cereda.arara.model.Command; -import com.github.cereda.arara.model.Pair; -import org.zeroturnaround.exec.ProcessExecutor; -import org.zeroturnaround.exec.ProcessResult; - -/** - * Implements unsafe utilitary methods. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class UnsafeUtils { - - /** - * Executes a system command from the underlying operating system and - * returns a pair containing the exit status and the command output as a - * string. - * @param command The system command to be executed. - * @return A pair containing the exit status and the system command output - * as a string. - */ - public static Pair<Integer, String> executeSystemCommand(Command command) { - - try { - - // create a process result with the provided - // command, capturing the output - ProcessResult result = new ProcessExecutor( - command.getElements() - ).readOutput(true).execute(); - - // return the pair containing the exit status - // and the output string as UTF-8 - return new Pair<Integer, String>( - result.getExitValue(), - result.outputUTF8() - ); - - } catch (Exception exception) { - - // quack, quack, do nothing, just - // return a default error code - - // if something goes wrong, the default - // error branch returns an exit status of - // -99 and an empty string - return new Pair<Integer, String>(-99, ""); - - } - } - -} diff --git a/support/arara/source/src/main/java/com/github/cereda/arara/utils/VelocityUtils.java b/support/arara/source/src/main/java/com/github/cereda/arara/utils/VelocityUtils.java deleted file mode 100644 index 3f94adc909..0000000000 --- a/support/arara/source/src/main/java/com/github/cereda/arara/utils/VelocityUtils.java +++ /dev/null @@ -1,157 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012 -- 2019, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.utils; - -import com.github.cereda.arara.controller.LanguageController; -import com.github.cereda.arara.model.AraraException; -import com.github.cereda.arara.model.Messages; -import java.io.File; -import java.io.FileOutputStream; -import java.io.IOException; -import java.io.OutputStreamWriter; -import java.io.Writer; -import java.util.Map; -import org.apache.velocity.Template; -import org.apache.velocity.VelocityContext; -import org.apache.velocity.app.VelocityEngine; -import org.apache.velocity.exception.MethodInvocationException; -import org.apache.velocity.exception.ParseErrorException; -import org.apache.velocity.exception.ResourceNotFoundException; -import org.apache.velocity.runtime.RuntimeConstants; - -/** - * Implements the template merging from Apache Velocity. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class VelocityUtils { - - // the language controller - private static final LanguageController messages = - LanguageController.getInstance(); - - /** - * Merges the provided template with the context map and writes the result - * in an output file. The operation relies on the Apache Velocity project. - * @param input The input file. - * @param output The output file. - * @param map The context map. - * @throws AraraException Something terribly wrong happened, to be caught - * in the higher levels. - */ - public static void mergeVelocityTemplate(File input, File output, - Map<String, Object> map) throws AraraException { - - // let us try - try { - - // create the template engine instance - VelocityEngine engine = new VelocityEngine(); - - // use the resource path trick: set the default - // location to the input file's parent directory, - // so our file is easily located - engine.setProperty(RuntimeConstants.FILE_RESOURCE_LOADER_PATH, - input.getCanonicalFile().getParent()); - - // set the logging feature of Apache Velocity to - // register the occurrences in a null provider - // (we do not want unnecessary verbose output) - engine.setProperty(RuntimeConstants.RUNTIME_LOG_LOGSYSTEM_CLASS, - "org.apache.velocity.runtime.log.NullLogSystem"); - - // init the engine with the - // provided settings - engine.init(); - - // create a context for Apache Velocity, - // based on the provided map - VelocityContext context = new VelocityContext(map); - - // get the template from the engine and - // read it as an UTF-8 file - Template template = engine.getTemplate(input.getName(), "UTF-8"); - - // create an output stream from - // the file output reference - FileOutputStream stream = new FileOutputStream(output); - - // create a writer based on the - // previously created stream - Writer writer = new OutputStreamWriter(stream, "UTF-8"); - - // merge the context map with the - // template file and write the result - // to the output stream writer - template.merge(context, writer); - - // close both writer - // and output stream - writer.close(); - stream.close(); - - } catch(ResourceNotFoundException rnfexception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_VELOCITY_FILE_NOT_FOUND - ), - rnfexception - ); - } catch(ParseErrorException peexception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_VELOCITY_PARSE_EXCEPTION - ), - peexception - ); - } catch(MethodInvocationException miexception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_VELOCITY_METHOD_INVOCATION_EXCEPTION - ), - miexception - ); - } catch (IOException ioexception) { - throw new AraraException( - messages.getMessage( - Messages.ERROR_VELOCITY_FILE_NOT_FOUND - ), - ioexception - ); - } - - } - -} diff --git a/support/arara/source/src/main/java/org/islandoftex/arara/utils/Methods.java b/support/arara/source/src/main/java/org/islandoftex/arara/utils/Methods.java new file mode 100644 index 0000000000..bbc46be4a0 --- /dev/null +++ b/support/arara/source/src/main/java/org/islandoftex/arara/utils/Methods.java @@ -0,0 +1,1222 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.utils; + +import kotlin.Pair; +import org.islandoftex.arara.Arara; +import org.islandoftex.arara.configuration.AraraSpec; +import org.islandoftex.arara.filehandling.FileHandlingUtils; +import org.islandoftex.arara.filehandling.FileSearchingUtils; +import org.islandoftex.arara.localization.LanguageController; +import org.islandoftex.arara.localization.Messages; +import org.islandoftex.arara.model.AraraException; +import org.islandoftex.arara.model.Session; +import org.islandoftex.arara.ruleset.Command; + +import java.io.File; +import java.lang.reflect.Method; +import java.util.Arrays; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.stream.Stream; + +/** + * Implements some auxiliary methods for runtime evaluation. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +@SuppressWarnings("unused") +public class Methods { + + // the language controller + private static final LanguageController messages = + LanguageController.INSTANCE; + + // the session controller + private static final Session session = Session.INSTANCE; + + /** + * Get rule methods. + * + * @return A map of method names to method pointers. + */ + public static Map<String, Object> getRuleMethods() { + Map<String, Object> map = new HashMap<>(getConditionalMethods()); + try { + Method[] methods = Methods.class.getMethods(); + Arrays.asList("getOriginalFile", "getOriginalReference", "isEmpty", + "isNotEmpty", "isTrue", "isFalse", "trimSpaces", + "getBasename", "getFiletype", "throwError", "getSession", + "isWindows", "isLinux", "isMac", "isUnix", "isCygwin", + "replicatePattern", "buildString", "getCommand", + "checkClass", "isString", "isList", "isMap", "isBoolean", + "isVerboseMode", "showMessage", "isOnPath", + "unsafelyExecuteSystemCommand", + "getCommandWithWorkingDirectory", "listFilesByExtensions", + "listFilesByPatterns", "writeToFile", "readFromFile", + "isSubdirectory", "halt").forEach(name -> + map.put(name, Stream.of(methods).filter( + m -> m.getName().equals(name)).findFirst().get())); + } catch (Exception exception) { + // quack, quack, quack + } + return map; + } + + /** + * Get conditional methods. + * + * @return A map of method names to method pointers. + */ + public static Map<String, Object> getConditionalMethods() { + Map<String, Object> map = new HashMap<>(); + try { + Method[] methods = Methods.class.getMethods(); + Arrays.asList("exists", "missing", "changed", "unchanged", "found", + "toFile", "showDropdown", "showInput", "showOptions", + "currentFile", "loadClass", "loadObject").forEach(name -> + map.put(name, Stream.of(methods).filter( + m -> m.getName().equals(name)).findFirst().get())); + } catch (Exception exception) { + // quack, quack, quack + } + return map; + } + + /** + * Exit the application normally + */ + public static void halt() { + halt(0); + } + + /** + * Exit the application with status code. + * + * @param status The exit value + */ + public static void halt(int status) { + session.put("arara:" + getOriginalFile() + ":halt", status); + } + + /** + * Gets the original file. + * + * @return The original file. + */ + public static String getOriginalFile() { + File file = Arara.INSTANCE.getConfig() + .get(AraraSpec.Execution.INSTANCE.getReference()); + return file.getName(); + } + + /** + * Gets the original reference. + * + * @return The original reference. + */ + public static File getOriginalReference() { + return Arara.INSTANCE.getConfig() + .get(AraraSpec.Execution.INSTANCE.getReference()); + } + + /** + * Checks if the string is empty. + * + * @param string The string. + * @return A boolean value. + */ + public static boolean isEmpty(String string) { + return string.equals(""); + } + + /** + * Checks if the string is not empty. + * + * @param string The string. + * @return A boolean value. + */ + public static boolean isNotEmpty(String string) { + return !isEmpty(string); + } + + /** + * Checks if the string is empty. + * + * @param string The string. + * @param yes Object to return if true. + * @return An object or empty string. + */ + public static Object isEmpty(String string, Object yes) { + return isEmpty(string) ? yes : ""; + } + + /** + * Checks if the string is not empty. + * + * @param string The string. + * @param yes Object to return if true. + * @return An object or empty string. + */ + public static Object isNotEmpty(String string, Object yes) { + return isNotEmpty(string) ? yes : ""; + } + + /** + * Checks if the string is empty. + * + * @param string The string. + * @param yes Object to return if true. + * @param no Object to return if false. + * @return One of the two objects. + */ + public static Object isEmpty(String string, Object yes, Object no) { + return isEmpty(string) ? yes : no; + } + + /** + * Checks if the string is not empty. + * + * @param string The string. + * @param yes Object to return if true. + * @param no Object to return if false. + * @return One of the two objects. + */ + public static Object isNotEmpty(String string, Object yes, Object no) { + return isNotEmpty(string) ? yes : no; + } + + /** + * Checks if the string holds a true value. + * + * @param string The string. + * @return A boolean value. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static boolean isTrue(String string) throws AraraException { + return !isEmpty(string) && CommonUtils.INSTANCE.checkBoolean(string); + } + + /** + * Checks if the string holds a false value. + * + * @param string The string. + * @return A boolean value. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static boolean isFalse(String string) throws AraraException { + return !isEmpty(string) && !CommonUtils.INSTANCE.checkBoolean(string); + } + + /** + * Checks if the string holds a true value. + * + * @param string The string. + * @param yes Object to return if true. + * @return An object or an empty string. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static Object isTrue(String string, Object yes) + throws AraraException { + return isTrue(string) ? yes : ""; + } + + /** + * Checks if the string holds a false value. + * + * @param string The string. + * @param yes Object to return if true. + * @return An object or an empty string. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static Object isFalse(String string, Object yes) + throws AraraException { + return (isFalse(string) ? yes : ""); + } + + /** + * Checks if the string holds a true value. + * + * @param string The string. + * @param yes Object to return if true. + * @param no Object to return if false. + * @return One of the two objects. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static Object isTrue(String string, Object yes, Object no) + throws AraraException { + return (isTrue(string) ? yes : no); + } + + /** + * Checks if the string holds a false value. + * + * @param string The string. + * @param yes Object to return if true. + * @param no Object to return if false. + * @return One of the two objects. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static Object isFalse(String string, Object yes, Object no) + throws AraraException { + return (isFalse(string) ? yes : no); + } + + /** + * Checks if the string holds a true value. + * + * @param string The string. + * @param yes Object to return if true. + * @param no Object to return if false. + * @param fallback Object to return if string is empty. + * @return One of the three options. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static Object isTrue(String string, Object yes, Object no, + Object fallback) throws AraraException { + return isEmpty(string) ? fallback : (isTrue(string) ? yes : no); + } + + /** + * Checks if the string holds a false value. + * + * @param string The string. + * @param yes Object to return if true. + * @param no Object to return if false. + * @param fallback Object to return if string is empty. + * @return One of the three options. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static Object isFalse(String string, Object yes, Object no, + Object fallback) throws AraraException { + return isEmpty(string) ? fallback : (isFalse(string) ? yes : no); + } + + /** + * Trim spaces from the string. + * + * @param string The string. + * @return A trimmed string. + */ + public static String trimSpaces(String string) { + return string.trim(); + } + + /** + * Checks if the expression resolves to true. + * + * @param value The expression. + * @param yes Object to return if true. + * @return An object or an empty string. + */ + public static Object isTrue(boolean value, Object yes) { + return value ? yes : ""; + } + + /** + * Checks if the expression resolves to false. + * + * @param value The expression. + * @param yes Object to return if true. + * @return An object or an empty string. + */ + public static Object isFalse(boolean value, Object yes) { + return !value ? yes : ""; + } + + /** + * Checks if the expression resolves to true. + * + * @param value The expression. + * @param yes Object to return if true. + * @param no Object to return if false. + * @return One of the two objects. + */ + public static Object isTrue(boolean value, Object yes, Object no) { + return value ? yes : no; + } + + /** + * Checks if the expression resolves to false. + * + * @param value The expression. + * @param yes Object to return if true. + * @param no Object to return if false. + * @return One of the two objects. + */ + public static Object isFalse(boolean value, Object yes, Object no) { + return !value ? yes : no; + } + + /** + * Gets the basename. + * + * @param file The file. + * @return The basename of the provided file. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static String getBasename(File file) throws AraraException { + if (file.isFile()) { + return FileHandlingUtils.INSTANCE.getBasename(file); + } else { + throw new AraraException( + CommonUtils.INSTANCE.getRuleErrorHeader().concat( + messages.getMessage( + Messages.ERROR_BASENAME_NOT_A_FILE, + file.getName() + ) + ) + ); + } + } + + /** + * Gets the basename. + * + * @param filename The string. + * @return The basename. + */ + public static String getBasename(String filename) { + return FileHandlingUtils.INSTANCE.getBasename(new File(filename)); + } + + /** + * Gets the file type. + * + * @param file The provided file. + * @return The file type. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static String getFiletype(File file) throws AraraException { + if (file.isFile()) { + return FileHandlingUtils.INSTANCE.getFileExtension(file); + } else { + throw new AraraException( + CommonUtils.INSTANCE.getRuleErrorHeader().concat( + messages.getMessage( + Messages.ERROR_FILETYPE_NOT_A_FILE, + file.getName() + ) + ) + ); + } + } + + /** + * Gets the file type. + * + * @param filename The provided string. + * @return The file type. + */ + public static String getFiletype(String filename) { + return FileHandlingUtils.INSTANCE.getFileExtension(new File(filename)); + } + + /** + * Replicates the pattern to each element of a list. + * + * @param pattern The pattern. + * @param values The list. + * @return A list of strings containing the pattern applied to the list. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static List<Object> replicatePattern(String pattern, + List<Object> values) + throws AraraException { + return CommonUtils.INSTANCE.replicateList(pattern, values); + } + + /** + * Throws an exception. + * + * @param text The text to be thrown as the exception message. + * @throws AraraException The exception to be thrown by this method. + */ + public static void throwError(String text) throws AraraException { + throw new AraraException(text); + } + + /** + * Gets the session. + * + * @return The session. + */ + public static Session getSession() { + return session; + } + + /** + * Checks if Windows is the underlying operating system. + * + * @return A boolean value. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static boolean isWindows() throws AraraException { + return CommonUtils.INSTANCE.checkOS("windows"); + } + + /** + * Checks if we are inside a Cygwin environment. + * + * @return A boolean value. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static boolean isCygwin() throws AraraException { + return CommonUtils.INSTANCE.checkOS("cygwin"); + } + + /** + * Checks if Linux is the underlying operating system. + * + * @return A boolean value. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static boolean isLinux() throws AraraException { + return CommonUtils.INSTANCE.checkOS("linux"); + } + + /** + * Checks if Mac is the underlying operating system. + * + * @return A boolean value. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static boolean isMac() throws AraraException { + return CommonUtils.INSTANCE.checkOS("mac"); + } + + /** + * Checks if Unix is the underlying operating system. + * + * @return A boolean value. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static boolean isUnix() throws AraraException { + return CommonUtils.INSTANCE.checkOS("unix"); + } + + /** + * Checks if Windows is the underlying operating system. + * + * @param yes Object to return if true. + * @param no Object to return if false. + * @return One of the two objects. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static Object isWindows(Object yes, Object no) + throws AraraException { + return CommonUtils.INSTANCE.checkOS("windows") ? yes : no; + } + + /** + * Checks if we are inside a Cygwin environment. + * + * @param yes Object to return if true. + * @param no Object to return if false. + * @return One of the two objects. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static Object isCygwin(Object yes, Object no) throws AraraException { + return CommonUtils.INSTANCE.checkOS("cygwin") ? yes : no; + } + + /** + * Checks if Linux is the underlying operating system. + * + * @param yes Object to return if true. + * @param no Object to return if false. + * @return One of the two objects. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static Object isLinux(Object yes, Object no) throws AraraException { + return CommonUtils.INSTANCE.checkOS("linux") ? yes : no; + } + + /** + * Checks if Mac is the underlying operating system. + * + * @param yes Object to return if true. + * @param no Object to return if false. + * @return One of the two objects. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static Object isMac(Object yes, Object no) throws AraraException { + return CommonUtils.INSTANCE.checkOS("mac") ? yes : no; + } + + /** + * Checks if Unix is the underlying operating system. + * + * @param yes Object to return if true. + * @param no Object to return if false. + * @return One of the two objects. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static Object isUnix(Object yes, Object no) throws AraraException { + return CommonUtils.INSTANCE.checkOS("unix") ? yes : no; + } + + /** + * Checks if the file exists according to its extension. + * + * @param extension The extension. + * @return A boolean value. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static boolean exists(String extension) throws AraraException { + return FileHandlingUtils.INSTANCE.exists(extension); + } + + /** + * Checks if the file is missing according to its extension. + * + * @param extension The extension. + * @return A boolean value. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static boolean missing(String extension) throws AraraException { + return !exists(extension); + } + + /** + * Checks if the file has changed, according to its extension. + * + * @param extension The extension. + * @return A boolean value. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static boolean changed(String extension) throws AraraException { + return FileHandlingUtils.INSTANCE.hasChanged(extension); + } + + /** + * Checks if the file is unchanged according to its extension. + * + * @param extension The extension. + * @return A boolean value. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static boolean unchanged(String extension) throws AraraException { + return !changed(extension); + } + + /** + * Checks if the file exists. + * + * @param filename The file. + * @return A boolean value. + */ + public static boolean exists(File filename) { + return filename.exists(); + } + + /** + * Checks if the file is missing. + * + * @param filename The file. + * @return A boolean value. + */ + public static boolean missing(File filename) { + return !exists(filename); + } + + /** + * Checks if the file has changed. + * + * @param filename The file. + * @return A boolean value. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static boolean changed(File filename) throws AraraException { + return FileHandlingUtils.INSTANCE.hasChanged(filename); + } + + /** + * Checks if the file is unchanged. + * + * @param filename The file. + * @return A boolean value. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static boolean unchanged(File filename) throws AraraException { + return !changed(filename); + } + + /** + * Build a string based on an array of objects. + * + * @param objects Array of objects. + * @return A string built from the array. + */ + public static String buildString(Object... objects) { + return CommonUtils.INSTANCE.generateString(objects); + } + + /** + * Checks if the file contains the regex, based on its extension. + * + * @param extension The extension. + * @param regex The regex. + * @return A boolean value. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static boolean found(String extension, String regex) + throws AraraException { + return CommonUtils.INSTANCE.checkRegex(extension, regex); + } + + /** + * Checks if the file contains the provided regex. + * + * @param file The file. + * @param regex The regex. + * @return A boolean value. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + public static boolean found(File file, String regex) + throws AraraException { + return CommonUtils.INSTANCE.checkRegex(file, regex); + } + + /** + * Gets the command based on a list of strings. + * + * @param elements The list of strings. + * @return A command. + */ + public static Command getCommand(List<String> elements) { + return new Command(elements); + } + + /** + * Gets the command based on an array of objects. + * + * @param elements Array of objects. + * @return A command. + */ + public static Command getCommand(Object... elements) { + return new Command(elements); + } + + /** + * Gets the command based on an array of objects and with the provided + * working directory as string. + * + * @param path String path representing the working directory. + * @param elements Array of elements. + * @return A command. + */ + public static Command getCommandWithWorkingDirectory(String path, + Object... elements) { + Command command = new Command(elements); + command.setWorkingDirectory(new File(path)); + return command; + } + + /** + * Gets the command based on an array of objects and with the provided + * working directory as file. + * + * @param file File representing the working directory. + * @param elements Array of elements. + * @return A command. + */ + public static Command getCommandWithWorkingDirectory(File file, + Object... elements) { + Command command = new Command(elements); + command.setWorkingDirectory(file); + return command; + } + + /** + * Gets the command based on a list of strings and with the provided + * working directory as string. + * + * @param path String path representing the working directory. + * @param elements List of strings. + * @return A command. + */ + public static Command getCommandWithWorkingDirectory(String path, + List<String> elements) { + Command command = new Command(elements); + command.setWorkingDirectory(new File(path)); + return command; + } + + /** + * Gets the command based on a list of strings and with the provided + * working directory as file. + * + * @param file File representing the working directory. + * @param elements List of strings. + * @return A command. + */ + public static Command getCommandWithWorkingDirectory(File file, + List<String> elements) { + Command command = new Command(elements); + command.setWorkingDirectory(file); + return command; + } + + /** + * Checks if the object is an instance of the provided class. + * + * @param clazz The class. + * @param object The object. + * @return A boolean value. + */ + public static boolean checkClass(Class<?> clazz, Object object) { + return clazz.isInstance(object); + } + + /** + * Checks if the object is a string. + * + * @param object The object. + * @return A boolean value. + */ + public static boolean isString(Object object) { + return checkClass(String.class, object); + } + + /** + * Checks if the object is a list. + * + * @param object The object. + * @return A boolean value. + */ + public static boolean isList(Object object) { + return checkClass(List.class, object); + } + + /** + * Checks if the object is a map. + * + * @param object The object. + * @return A boolean value. + */ + public static boolean isMap(Object object) { + return checkClass(Map.class, object); + } + + /** + * Checks if the object is a boolean. + * + * @param object The object. + * @return A boolean value. + */ + public static boolean isBoolean(Object object) { + return checkClass(Boolean.class, object); + } + + /** + * Checks if the execution is in verbose mode. + * + * @return A boolean value indicating if the execution is in verbose mode. + */ + public static boolean isVerboseMode() { + return Arara.INSTANCE.getConfig() + .get(AraraSpec.Execution.INSTANCE.getVerbose()); + } + + /** + * Returns a file object based on the provided name. + * + * @param name The file name. + * @return A file object. + */ + public static File toFile(String name) { + return new File(name); + } + + /** + * Shows the message. + * + * @param width Integer value, in pixels. + * @param type Type of message. + * @param title Title of the message. + * @param text Text of the message. + */ + public static void showMessage(int width, int type, + String title, String text) { + MessageUtils.INSTANCE.showMessage(width, type, title, text); + } + + /** + * Shows the message. It relies on the default width. + * + * @param type Type of message. + * @param title Title of the message. + * @param text Text of the message. + */ + public static void showMessage(int type, String title, String text) { + MessageUtils.INSTANCE.showMessage(type, title, text); + } + + /** + * Shows a message with options presented as an array of buttons. + * + * @param width Integer value, in pixels. + * @param type Type of message. + * @param title Title of the message. + * @param text Text of the message. + * @param buttons An array of objects to be presented as buttons. + * @return The index of the selected button, starting from 1. + */ + public static int showOptions(int width, int type, String title, + String text, Object... buttons) { + return MessageUtils.INSTANCE.showOptions(width, type, title, text, buttons); + } + + /** + * Shows a message with options presented as an array of buttons. It relies + * on the default width. + * + * @param type Type of message. + * @param title Title of the message. + * @param text Text of the message. + * @param buttons An array of objects to be presented as buttons. + * @return The index of the selected button, starting from 1. + */ + public static int showOptions(int type, String title, + String text, Object... buttons) { + return MessageUtils.INSTANCE.showOptions(type, title, text, buttons); + } + + /** + * Shows a message with a text input. + * + * @param width Integer value, in pixels. + * @param type Type of message. + * @param title Title of the message. + * @param text Text of the message. + * @return The string representing the input text. + */ + public static String showInput(int width, int type, + String title, String text) { + return MessageUtils.INSTANCE.showInput(width, type, title, text); + } + + /** + * Shows a message with a text input. It relies on the default width. + * + * @param type Type of message. + * @param title Title of the message. + * @param text Text of the message. + * @return The string representing the input text. + */ + public static String showInput(int type, String title, String text) { + return MessageUtils.INSTANCE.showInput(type, title, text); + } + + /** + * Shows a message with options presented as a dropdown list of elements. + * + * @param width Integer value, in pixels. + * @param type Type of message. + * @param title Title of the message. + * @param text Text of the message. + * @param elements An array of objects representing the elements. + * @return The index of the selected element, starting from 1. + */ + public static int showDropdown(int width, int type, String title, + String text, Object... elements) { + return MessageUtils.INSTANCE.showDropdown(width, type, title, text, elements); + } + + /** + * Shows a message with options presented as a dropdown list of elements. It + * relies on the default width. + * + * @param type Type of message. + * @param title Title of the message. + * @param text Text of the message. + * @param elements An array of objects representing the elements. + * @return The index of the selected element, starting from 1. + */ + public static int showDropdown(int type, String title, + String text, Object... elements) { + return MessageUtils.INSTANCE.showDropdown(type, title, text, elements); + } + + /** + * Checks if the provided command name is reachable from the system path. + * + * @param command A string representing the command. + * @return A logic value. + */ + public static boolean isOnPath(String command) { + return CommonUtils.INSTANCE.isOnPath(command); + } + + /** + * Unsafely executes a system command from the underlying operating system + * and returns a pair containing the exit status and the command output as a + * string. + * + * @param command The system command to be executed. + * @return A pair containing the exit status and the system command output + * as a string. + */ + public static Pair<Integer, String> unsafelyExecuteSystemCommand(Command command) { + return SystemCallUtils.INSTANCE.executeSystemCommand(command); + } + + /** + * Gets the file reference for the current directive. It is important to + * observe that version 4.0 of arara replicates the directive when 'files' + * is detected amongst the parameters, so each instance will have a + * different reference. + * + * @return A file reference for the current directive. + */ + public static File currentFile() { + return Arara.INSTANCE.getConfig().get(AraraSpec.Execution + .INSTANCE.getFile()); + } + + /** + * Loads a class from the provided file, potentially a Java archive. + * + * @param file File containing the Java bytecode (namely, a JAR). + * @param name The canonical name of the class. + * @return A pair representing the status and the class. + */ + // TODO: refactor to use the enum + public static Pair<Integer, Class<?>> loadClass(File file, String name) { + Pair<ClassLoadingUtils.ClassLoadingStatus, Class<?>> pair = + ClassLoadingUtils.INSTANCE.loadClass(file, name); + return new Pair<>(pair.getFirst().ordinal(), pair.getSecond()); + } + + /** + * Loads a class from the provided string reference, representing a file. + * + * @param ref String reference representing a file. + * @param name The canonical name of the class. + * @return A pair representing the status and the class. + */ + // TODO: refactor to use the enum + public static Pair<Integer, Class<?>> loadClass(String ref, String name) { + Pair<ClassLoadingUtils.ClassLoadingStatus, Class<?>> pair = + ClassLoadingUtils.INSTANCE.loadClass(new File(ref), name); + return new Pair<>(pair.getFirst().ordinal(), pair.getSecond()); + } + + /** + * Loads a class from the provided file, instantiating it. + * + * @param file File containing the Java bytecode (namely, a JAR). + * @param name The canonical name of the class. + * @return A pair representing the status and the class object. + */ + // TODO: refactor to use the enum + public static Pair<Integer, Object> loadObject(File file, String name) { + Pair<ClassLoadingUtils.ClassLoadingStatus, Object> pair = + ClassLoadingUtils.INSTANCE.loadObject(file, name); + return new Pair<>(pair.getFirst().ordinal(), pair.getSecond()); + } + + /** + * Loads a class from the provided string reference, instantiating it. + * + * @param ref String reference representing a file. + * @param name The canonical name of the class. + * @return A pair representing the status and the class object. + */ + // TODO: refactor to use the enum + public static Pair<Integer, Object> loadObject(String ref, String name) { + Pair<ClassLoadingUtils.ClassLoadingStatus, Object> pair = + ClassLoadingUtils.INSTANCE.loadObject(new File(ref), name); + return new Pair<>(pair.getFirst().ordinal(), pair.getSecond()); + } + + /** + * List all files from the provided directory according to the list of + * extensions. The leading dot must be omitted, unless it is part of the + * extension. + * + * @param directory The provided directory. + * @param extensions The list of extensions. + * @param recursive A flag indicating whether the search is recursive. + * @return A list of files. + */ + public static List<File> listFilesByExtensions(File directory, + List<String> extensions, boolean recursive) { + return FileSearchingUtils.INSTANCE.listFilesByExtensions( + directory, + extensions, + recursive + ); + } + + /** + * List all files from the provided string path according to the list of + * extensions. The leading dot must be omitted, unless it is part of the + * extension. + * + * @param path The provided path as plain string. + * @param extensions The list of extensions. + * @param recursive A flag indicating whether the search is recursive. + * @return A list of files. + */ + public static List<File> listFilesByExtensions(String path, + List<String> extensions, boolean recursive) { + return FileSearchingUtils.INSTANCE.listFilesByExtensions( + new File(path), + extensions, + recursive + ); + } + + /** + * List all files from the provided directory matching the list of file + * name patterns. Such list can contain wildcards. + * + * @param directory The provided directory. + * @param patterns The list of file name patterns. + * @param recursive A flag indicating whether the search is recursive. + * @return A list of files. + */ + public static List<File> listFilesByPatterns(File directory, + List<String> patterns, boolean recursive) { + return FileSearchingUtils.INSTANCE.listFilesByPatterns( + directory, + patterns, + recursive + ); + } + + /** + * List all files from the provided path matching the list of file + * name patterns. Such list can contain wildcards. + * + * @param path The provided path as plain string. + * @param patterns The list of file name patterns. + * @param recursive A flag indicating whether the search is recursive. + * @return A list of files. + */ + public static List<File> listFilesByPatterns(String path, + List<String> patterns, boolean recursive) { + return FileSearchingUtils.INSTANCE.listFilesByPatterns( + new File(path), + patterns, + recursive + ); + } + + /** + * Writes the string to a file, using UTF-8 as default encoding. + * + * @param file The file. + * @param text The string to be written. + * @param append A flag whether to append the content. + * @return A logical value indicating whether it was successful. + */ + public static boolean writeToFile(File file, String text, boolean append) { + return FileHandlingUtils.INSTANCE.writeToFile(file, text, append); + } + + /** + * Writes the string to a file, using UTF-8 as default encoding. + * + * @param path The path. + * @param text The string to be written. + * @param append A flag whether to append the content. + * @return A logical value indicating whether it was successful. + */ + public static boolean writeToFile(String path, String text, + boolean append) { + return FileHandlingUtils.INSTANCE.writeToFile(new File(path), text, append); + } + + /** + * Writes the string list to a file, using UTF-8 as default encoding. + * + * @param file The file. + * @param lines The string list to be written. + * @param append A flag whether to append the content. + * @return A logical value indicating whether it was successful. + */ + public static boolean writeToFile(File file, List<String> lines, + boolean append) { + return FileHandlingUtils.INSTANCE.writeToFile(file, lines, append); + } + + /** + * Writes the string list to a file, using UTF-8 as default encoding. + * + * @param path The path. + * @param lines The string list to be written. + * @param append A flag whether to append the content. + * @return A logical value indicating whether it was successful. + */ + public static boolean writeToFile(String path, List<String> lines, + boolean append) { + return FileHandlingUtils.INSTANCE.writeToFile(new File(path), lines, append); + } + + /** + * Reads the provided file into a list of strings. + * + * @param file The file. + * @return A list of strings. + */ + public static List<String> readFromFile(File file) { + return FileHandlingUtils.INSTANCE.readFromFile(file); + } + + /** + * Reads the provided file into a list of strings. + * + * @param path The path. + * @return A list of strings. + */ + public static List<String> readFromFile(String path) { + return FileHandlingUtils.INSTANCE.readFromFile(new File(path)); + } + + /** + * Checks whether a directory is under the project directory. + * + * @param directory The directory to be inspected. + * @return Logical value indicating whether the directoy is under root. + * @throws AraraException There was a problem with path retrieval. + */ + public static boolean isSubdirectory(File directory) + throws AraraException { + return FileHandlingUtils.INSTANCE.isSubDirectory( + directory, getOriginalReference()); + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/Arara.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/Arara.kt new file mode 100644 index 0000000000..2b4efbf8db --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/Arara.kt @@ -0,0 +1,115 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara + +import com.github.ajalt.clikt.parameters.options.versionOption +import com.uchuhimo.konf.Config +import java.time.LocalDate +import kotlin.time.ExperimentalTime +import org.islandoftex.arara.configuration.AraraSpec +import org.islandoftex.arara.configuration.Configuration +import org.islandoftex.arara.localization.LanguageController +import org.islandoftex.arara.localization.Messages +import org.islandoftex.arara.model.AraraException +import org.islandoftex.arara.model.Extractor +import org.islandoftex.arara.model.Interpreter +import org.islandoftex.arara.ruleset.DirectiveUtils +import org.islandoftex.arara.utils.DisplayUtils + +/** + * arara's main entry point + * + * @author Island of TeX + * @version 5.0 + * @since 5.0 + */ +object Arara { + // TODO: watch config files + val baseconfig = Config { addSpec(AraraSpec) } + .from.env() + .from.systemProperties() + var config = baseconfig.withLayer("initial") + + /** + * Main method. This is the application entry point. + * @param args A string array containing all command line arguments. + */ + @ExperimentalTime + @JvmStatic + fun main(args: Array<String>) { + // print the arara logo in the terminal; I just + // hope people use this tool in a good terminal with + // fixed-width fonts, otherwise the logo will be messed + DisplayUtils.printLogo() + + val version = config[AraraSpec.Application.version] + CLI().versionOption(version, names = setOf("-V", "--version"), + message = { + "arara $version\n" + + "Copyright (c) ${LocalDate.now().year}, Island of TeX\n" + + LanguageController.getMessage(Messages + .INFO_PARSER_NOTES) + "\n\n" + + "New features in version $version:\n" + + Arara::class.java + .getResource("/org/islandoftex/arara/configuration/release-notes") + .readText() + }) + .main(args) + } + + @ExperimentalTime + fun run() { + try { + // first of all, let's try to load a potential + // configuration file located at the current + // user's home directory; if there's a bad + // configuration file, arara will panic and + // end the execution + Configuration.load() + + // let's print the current file information; it is a + // basic display, just the file name, the size properly + // formatted as a human readable format, and the last + // modification date; also, in this point, the logging + // feature starts to collect data (of course, if enabled + // either through the configuration file or manually + // in the command line) + DisplayUtils.printFileInformation() + + // time to read the file and try to extract the directives; + // extract() brings us a list of directives properly parsed + // and almost ready to be handled; note that no directives + // in the provided file will raise an exception; this is + // by design and I opted to not include a default fallback + // (although it wouldn't be so difficult to write one, + // I decided not to take the risk) + val extracted = Extractor.extract(config[AraraSpec.Execution + .reference]) + + // it is time to validate the directives (for example, we have + // a couple of keywords that cannot be used as directive + // parameters); another interesting feature of the validate() + // method is to replicate a directive that has the 'files' + // keyword on it, since it's the whole point of having 'files' + // in the first place; if you check the log file, you will see + // that the list of extracted directives might differ from + // the final list of directives to be effectively processed + // by arara + val directives = DirectiveUtils.process(extracted) + + // time to shine, now the interpreter class will interpret + // one directive at a time, get the corresponding rule, + // set the parameters, evaluate it, get the tasks, run them, + // evaluate the result and print the status; note that + // arara, from this version on, will try to evaluate things + // progressively, so in case of an error, the previous tasks + // were already processed and potentially executed + Interpreter(directives).execute() + } catch (exception: AraraException) { + // something bad just happened, so arara will print the proper + // exception and provide details on it, if available; the idea + // here is to propagate an exception throughout the whole + // application and catch it here instead of a local treatment + DisplayUtils.printException(exception) + } + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/CLI.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/CLI.kt new file mode 100644 index 0000000000..9de0f1bd3f --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/CLI.kt @@ -0,0 +1,171 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara + +import com.github.ajalt.clikt.core.CliktCommand +import com.github.ajalt.clikt.parameters.arguments.argument +import com.github.ajalt.clikt.parameters.arguments.multiple +import com.github.ajalt.clikt.parameters.options.default +import com.github.ajalt.clikt.parameters.options.flag +import com.github.ajalt.clikt.parameters.options.option +import com.github.ajalt.clikt.parameters.types.int +import com.github.ajalt.clikt.parameters.types.path +import com.github.ajalt.clikt.parameters.types.restrictTo +import kotlin.system.exitProcess +import kotlin.time.ClockMark +import kotlin.time.ExperimentalTime +import kotlin.time.MonoClock +import kotlin.time.milliseconds +import org.islandoftex.arara.configuration.AraraSpec +import org.islandoftex.arara.filehandling.FileSearchingUtils +import org.islandoftex.arara.localization.Language +import org.islandoftex.arara.localization.LanguageController +import org.islandoftex.arara.localization.Messages +import org.islandoftex.arara.model.AraraException +import org.islandoftex.arara.model.Session +import org.islandoftex.arara.utils.CommonUtils +import org.islandoftex.arara.utils.DisplayUtils +import org.islandoftex.arara.utils.LoggingUtils + +/** + * arara's command line interface + * + * @author Island of TeX + * @version 5.0 + * @since 5.0 + */ +class CLI : CliktCommand(name = "arara", printHelpOnEmptyArgs = true) { + private val log by option("-l", "--log", + help = "Generate a log output") + .flag(default = AraraSpec.Execution.logging.default) + private val verbose by option("-v", "--verbose", + help = "Print the command output") + .flag("-s", "--silent", + default = AraraSpec.Execution.verbose.default) + private val dryrun by option("-n", "--dry-run", + help = "Go through all the motions of running a command, but " + + "with no actual calls") + .flag(default = AraraSpec.Execution.dryrun.default) + private val onlyheader by option("-H", "--header", + help = "Extract directives only in the file header") + .flag(default = AraraSpec.Execution.onlyHeader.default) + private val timeout by option("-t", "--timeout", + help = "Set the execution timeout (in milliseconds)") + .int().restrictTo(min = 1) + private val language by option("-L", "--language", + help = "Set the application language") + .default(AraraSpec.Application.defaultLanguageCode.default) + private val maxLoops by option("-m", "--max-loops", + help = "Set the maximum number of loops (> 0)") + .int().restrictTo(min = 1) + .default(AraraSpec.Execution.maxLoops.default) + private val preamble by option("-p", "--preamble", + help = "Set the file preamble based on the configuration file") + private val workingDirectory by option("-d", "--working-directory", + help = "Set the working directory for all tools") + .path(exists = true, fileOkay = false, readable = true) + .default(AraraSpec.Execution.workingDirectory.default) + + private val reference by argument("file", + help = "The file(s) to evaluate and process") + .multiple(required = true) + + /** + * Update the default configuration with the values parsed from the + * command line. + */ + @ExperimentalTime + private fun updateConfigurationFromCommandLine() { + Arara.config[AraraSpec.Execution.language] = Language(language) + LanguageController.setLocale(Arara.config[AraraSpec.Execution.language] + .locale) + + Arara.config[AraraSpec.Execution.logging] = log + Arara.config[AraraSpec.Execution.verbose] = verbose + Arara.config[AraraSpec.Execution.dryrun] = dryrun + Arara.config[AraraSpec.Execution.onlyHeader] = onlyheader + Arara.config[AraraSpec.Execution.maxLoops] = maxLoops + Arara.config[AraraSpec.Execution.workingDirectory] = workingDirectory + preamble?.let { + val preambles = Arara.config[AraraSpec.Execution.preambles] + if (preambles.containsKey(it)) { + Arara.config[AraraSpec.Execution.preamblesActive] = true + Arara.config[AraraSpec.Execution.preamblesContent] = + // will never throw (see check above) + preambles.getValue(it) + } else { + throw AraraException( + LanguageController.getMessage( + Messages.ERROR_PARSER_INVALID_PREAMBLE, it) + ) + } + } + timeout?.let { + Arara.config[AraraSpec.Execution.timeout] = true + Arara.config[AraraSpec.Execution.timeoutValue] = it.milliseconds + } + + Arara.config[AraraSpec.UserInteraction.displayTime] = true + } + + /** + * The actual main method of arara (when run in command-line mode) + */ + @ExperimentalTime + override fun run() { + // the first component to be initialized is the + // logging controller; note init() actually disables + // the logging, so early exceptions won't generate + // a lot of noise in the terminal + LoggingUtils.init() + + // arara features a stopwatch, so we can see how much time has passed + // since everything started; internally, this class makes use of + // nano time, so we might get an interesting precision here + // (although timing is not a serious business in here, it's + // just a cool addition) + val executionStart: ClockMark = MonoClock.markNow() + + // arara stores the environment variables accessible at the start + // of the execution in the session object for the user + Session.updateEnvironmentVariables() + + // logging has to be initialized only once and for all because + // context resets lead to missing output + LoggingUtils.enableLogging(log) + + try { + // TODO: this will have to change for parallelization + reference.forEach { + // TODO: do we have to reset some more file-specific config? + // especially the working directory will have to be set and + // changed + Arara.config = Arara.baseconfig.withLayer(it) + // next, update the configuration + updateConfigurationFromCommandLine() + FileSearchingUtils.discoverFile(it) + Arara.run() + // add an empty line between file executions + println() + } + + // this is the last command from arara; once the execution time is + // available, print it; note that this notification is suppressed + // when the command line parsing returns false as result (it makes + // no sense to print the execution time for a help message, I guess) + DisplayUtils.printTime(executionStart.elapsedNow().inSeconds) + } catch (ex: AraraException) { + DisplayUtils.printException(ex) + Arara.config[AraraSpec.Execution.status] = 2 + } + + // gets the application exit status; the rule here is: + // 0 : everything went just fine (note that the dry-run mode always + // makes arara exit with 0, unless it is an error in the directive + // builder itself). + // 1 : one of the tasks failed, so the execution ended abruptly. This + // means the error relies on the command line call, not with arara. + // 2 : arara just handled an exception, meaning that something bad + // just happened and might require user intervention. + exitProcess(CommonUtils.exitStatus) + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/configuration/AraraSpec.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/configuration/AraraSpec.kt new file mode 100644 index 0000000000..14100ec98b --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/configuration/AraraSpec.kt @@ -0,0 +1,90 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.configuration + +import com.uchuhimo.konf.ConfigSpec +import java.io.File +import java.nio.file.Paths +import kotlin.time.ExperimentalTime +import kotlin.time.milliseconds +import org.islandoftex.arara.localization.Language + +/** + * Configuration hierarchy for arara + * + * @author Island of TeX + * @version 5.0 + * @since 5.0 + */ +@Suppress("MagicNumber") +object AraraSpec : ConfigSpec() { + object Application : ConfigSpec() { + val defaultLanguageCode by optional("en") + val version by optional(AraraSpec::class.java.`package`.implementationVersion + ?: "DEVELOPMENT BUILD") + val namePattern by optional("arara:\\s") + val width by optional(65) + } + + object Execution : ConfigSpec() { + val maxLoops by optional(10) + val timeout by optional(false) + @ExperimentalTime + val timeoutValue by optional(0.milliseconds) + val haltOnErrors by optional(true) + + val databaseName by optional("arara") + val logName by optional("arara") + + val verbose by optional(false) + val language by optional(Language(Application.defaultLanguageCode.default)) + val logging by optional(false) + val dryrun by optional(false) + val status by optional(0) + val fileTypes by optional(ConfigurationUtils.defaultFileTypes) + val rulePaths by optional(setOf( + ConfigurationUtils.applicationPath.resolve("rules") + .toString() + )) + val preambles by optional(mapOf<String, String>()) + val preamblesActive by optional(false) + val preamblesContent by optional("") + + val workingDirectory by optional(Paths.get("")) + val configurationName by optional("[none]") + val onlyHeader by optional(false) + + // TODO: these are runtime values, they should be properly + // initialized and tested (maybe move them into their own + // Spec or session) + val reference by optional(File("/tmp/")) + val file by optional(File("/tmp/")) + + object InfoSpec : ConfigSpec() { + val ruleId by optional<String?>(null) + val rulePath by optional<String?>(null) + } + + object DirectiveSpec : ConfigSpec() { + val lines by optional(listOf<Int>()) + } + + val filePattern by optional("") + } + + object Directive : ConfigSpec() { + val linebreakPattern by optional("^\\s*-->\\s(.*)$") + + private const val directivestart = """^\s*(\w+)\s*(:\s*(\{.*\})\s*)?""" + private const val pattern = """(\s+(if|while|until|unless)\s+(\S.*))?$""" + val directivePattern by optional(directivestart + pattern) + } + + object UserInteraction : ConfigSpec() { + val lookAndFeel by optional("none") + val displayTime by optional(false) + val displayLine by optional(true) + val displayResult by optional(false) + val displayRolling by optional(false) + val displayException by optional(false) + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/configuration/Configuration.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/configuration/Configuration.kt new file mode 100644 index 0000000000..06abeeb6db --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/configuration/Configuration.kt @@ -0,0 +1,101 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.configuration + +import kotlin.time.ExperimentalTime +import org.islandoftex.arara.Arara +import org.islandoftex.arara.filehandling.FileHandlingUtils +import org.islandoftex.arara.localization.Language +import org.islandoftex.arara.localization.LanguageController +import org.islandoftex.arara.localization.Messages +import org.islandoftex.arara.model.AraraException + +/** + * Implements the configuration model, which holds the default settings and can + * load the configuration file. The idea here is to provide a map that holds + * all configuration settings used by model and utilitary classes throughout + * the execution. This controller is implemented as a singleton. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +object Configuration { + // the application messages obtained from the + // language controller + private val messages = LanguageController + + /** + * Loads the application configuration. + * + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @ExperimentalTime + @Throws(AraraException::class) + fun load() { + // initialize both file type and language models, + // since we can track errors from there instead + // of relying on a check on this level + + // get the configuration file, if any + val file = ConfigurationUtils.configFile + if (file != null) { + // set the configuration file name for + // logging purposes + Arara.config[AraraSpec.Execution.configurationName] = + FileHandlingUtils.getCanonicalPath(file) + + // then validate it and update the + // configuration accordingly + val resource = ConfigurationUtils.loadLocalConfiguration(file) + update(resource) + } + + // just to be sure, update the + // current locale in order to + // display localized messages + val locale = Arara.config[AraraSpec.Execution.language].locale + LanguageController.setLocale(locale) + } + + /** + * Update the configuration based on the provided map. + * + * @param resource Map containing the new configuration settings. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + private fun update(resource: LocalConfiguration) { + if (resource.paths.isNotEmpty()) + Arara.config[AraraSpec.Execution.rulePaths] = + ConfigurationUtils.normalizePaths(resource.paths) + + if (resource.filetypes.isNotEmpty()) { + Arara.config[AraraSpec.Execution.fileTypes] = ConfigurationUtils.normalizeFileTypes(resource.filetypes) + } + + Arara.config[AraraSpec.Execution.verbose] = resource.isVerbose + Arara.config[AraraSpec.Execution.logging] = resource.isLogging + Arara.config[AraraSpec.Execution.onlyHeader] = resource.isHeader + Arara.config[AraraSpec.Execution.language] = + Language(resource.language) + Arara.config[AraraSpec.UserInteraction.lookAndFeel] = resource.laf + + Arara.config[AraraSpec.Execution.databaseName] = + ConfigurationUtils.cleanFileName(resource.dbname) + Arara.config[AraraSpec.Execution.logName] = + ConfigurationUtils.cleanFileName(resource.logname) + + val loops = resource.loops + if (loops <= 0) { + throw AraraException(messages.getMessage(Messages + .ERROR_CONFIGURATION_LOOPS_INVALID_RANGE)) + } else { + Arara.config[AraraSpec.Execution.maxLoops] = loops + } + + if (resource.preambles.isNotEmpty()) + Arara.config[AraraSpec.Execution.preambles] = resource.preambles + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/configuration/ConfigurationUtils.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/configuration/ConfigurationUtils.kt new file mode 100644 index 0000000000..31a92c3009 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/configuration/ConfigurationUtils.kt @@ -0,0 +1,157 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.configuration + +import com.charleskorn.kaml.Yaml +import java.io.File +import java.io.UnsupportedEncodingException +import java.net.URLDecoder +import java.nio.file.Path +import java.nio.file.Paths +import org.islandoftex.arara.Arara +import org.islandoftex.arara.localization.LanguageController +import org.islandoftex.arara.localization.Messages +import org.islandoftex.arara.model.AraraException +import org.islandoftex.arara.model.FileType +import org.islandoftex.arara.utils.CommonUtils + +/** + * Implements configuration utilitary methods. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +object ConfigurationUtils { + // the application messages obtained from the + // language controller + private val messages = LanguageController + + /** + * This map contains all file types that arara accepts + * and their corresponding search patterns (for comments). + */ + val defaultFileTypePatterns = mapOf( + "tex" to "^\\s*%\\s+", + "dtx" to "^\\s*%\\s+", + "ltx" to "^\\s*%\\s+", + "drv" to "^\\s*%\\s+", + "ins" to "^\\s*%\\s+" + ) + + /** + * Set of default file types provided by arara. + * Initialization may throw AraraException if file types are wrong + */ + val defaultFileTypes: Set<FileType> by lazy { + defaultFileTypePatterns + .map { (extension, pattern) -> FileType(extension, pattern) } + .toSet() + } + + /** + * The configuration file in use. + * + * Look for configuration files in the user's working directory first + * if no configuration files are found in the user's working directory, + * try to look up in a global directory, that is, the user home. + */ + val configFile: File? + get() { + val names = listOf(".araraconfig.yaml", + "araraconfig.yaml", ".arararc.yaml", "arararc.yaml") + Arara.config[AraraSpec.Execution.workingDirectory] + .let { workingDir -> + val first = names + .map { workingDir.resolve(it).toFile() } + .firstOrNull { it.exists() } + if (first != null) + return first + } + CommonUtils.getSystemPropertyOrNull("user.home")?.let { userHome -> + return names.map { File(userHome).resolve(it) } + .firstOrNull { it.exists() } + } + return null + } + + /** + * The canonical absolute application path. + * + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + val applicationPath: Path + @Throws(AraraException::class) + get() { + try { + var path = Arara::class.java.protectionDomain.codeSource + .location.path + path = URLDecoder.decode(path, "UTF-8") + return Paths.get(path).parent.toAbsolutePath() + } catch (exception: UnsupportedEncodingException) { + throw AraraException( + messages.getMessage( + Messages.ERROR_GETAPPLICATIONPATH_ENCODING_EXCEPTION + ), + exception + ) + } + } + + /** + * Validates the configuration file. + * + * @param file The configuration file. + * @return The configuration file as a resource. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun loadLocalConfiguration(file: File): LocalConfiguration { + return file.runCatching { + val text = readText() + if (!text.startsWith("!config")) + throw Exception("Configuration should start with !config") + Yaml.default.parse(LocalConfiguration.serializer(), + text) + }.getOrElse { + throw AraraException(messages.getMessage( + Messages.ERROR_CONFIGURATION_GENERIC_ERROR), it) + } + } + + /** + * Normalize a list of rule paths, removing all duplicates. + * + * @param paths The list of rule paths. + * @return A list of normalized paths, without duplicates. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun normalizePaths(paths: Iterable<String>): Set<String> = + paths.union(AraraSpec.Execution.rulePaths.default) + + /** + * Normalize a list of file types, removing all duplicates. + * + * @param types The list of file types. + * @return A list of normalized file types, without duplicates. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun normalizeFileTypes(types: Iterable<FileType>): Set<FileType> = + types.union(defaultFileTypes) + + /** + * Cleans the file name to avoid invalid entries. + * + * @param name The file name. + * @return A cleaned file name. + */ + fun cleanFileName(name: String): String { + val result = File(name).name.trim() + return if (result.isEmpty()) "arara" else result.trim() + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/configuration/LocalConfiguration.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/configuration/LocalConfiguration.kt new file mode 100644 index 0000000000..959f2a9ab8 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/configuration/LocalConfiguration.kt @@ -0,0 +1,85 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.configuration + +import kotlinx.serialization.SerialName +import kotlinx.serialization.Serializable +import org.islandoftex.arara.Arara +import org.islandoftex.arara.model.FileType +import org.islandoftex.arara.utils.CommonUtils +import org.mvel2.templates.TemplateRuntime + +/** + * A local configuration which resembles configuration files in the working + * directory. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +@Serializable +class LocalConfiguration { + // rule paths + var paths: List<String> = listOf() + get() { + val user = mapOf( + "home" to (CommonUtils.getSystemPropertyOrNull("user.home") + ?: ""), + "name" to (CommonUtils.getSystemPropertyOrNull("user.name") + ?: "")) + val application = mapOf( + "workingDirectory" to Arara.config[AraraSpec.Execution.workingDirectory].toAbsolutePath().toString() + ) + + return field.map { input -> + var path = CommonUtils.removeKeywordNotNull(input) + try { + path = TemplateRuntime.eval(path, mapOf( + "user" to user, "application" to application + )) as String + } catch (_: RuntimeException) { + // do nothing, gracefully fallback to + // the default, unparsed path + } + path + } + } + + // file types + var filetypes: List<FileType> = listOf() + + // the application language + // default to English + var language: String = Arara.config[AraraSpec.Application.defaultLanguageCode] + get() = CommonUtils.removeKeywordNotNull(field) + + // maximum number of loops + var loops: Int = Arara.config[AraraSpec.Execution.maxLoops] + + // verbose flag + @SerialName("verbose") + var isVerbose: Boolean = Arara.config[AraraSpec.Execution.verbose] + + // logging flag + @SerialName("logging") + var isLogging: Boolean = Arara.config[AraraSpec.Execution.logging] + + // header flag + @SerialName("header") + var isHeader: Boolean = Arara.config[AraraSpec.Execution.onlyHeader] + + // database name + var dbname: String = Arara.config[AraraSpec.Execution.databaseName] + get() = CommonUtils.removeKeywordNotNull(field) + + // log name + var logname: String = Arara.config[AraraSpec.Execution.logName] + get() = CommonUtils.removeKeywordNotNull(field) + + // map of preambles + var preambles: Map<String, String> = Arara.config[AraraSpec.Execution.preambles] + + // look and feel + // default to none + var laf: String = Arara.config[AraraSpec.UserInteraction.lookAndFeel] + get() = CommonUtils.removeKeywordNotNull(field) +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/filehandling/Database.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/filehandling/Database.kt new file mode 100644 index 0000000000..e4b98cd194 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/filehandling/Database.kt @@ -0,0 +1,24 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.filehandling + +import kotlinx.serialization.Serializable + +/** + * The database model, which keeps track on file changes. + * + * This database is a map because it maps files to hashes. So the key will + * always be a file representation and the value always a string. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +@Serializable +data class Database( + /** + * The whole database is implemented as a map, where + * the key is the absolute canonical file and the value + * is its corresponding CRC32 hash. + */ + val map: MutableMap<String, String> = mutableMapOf() +) : MutableMap<String, String> by map diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/filehandling/DatabaseUtils.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/filehandling/DatabaseUtils.kt new file mode 100644 index 0000000000..f4728c9366 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/filehandling/DatabaseUtils.kt @@ -0,0 +1,97 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.filehandling + +import com.charleskorn.kaml.Yaml +import java.io.File +import org.islandoftex.arara.Arara +import org.islandoftex.arara.configuration.AraraSpec +import org.islandoftex.arara.localization.LanguageController +import org.islandoftex.arara.localization.Messages +import org.islandoftex.arara.model.AraraException + +/** + * Implements database utilitary methods. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +object DatabaseUtils { + // the application messages obtained from the + // language controller + private val messages = LanguageController + + /** + * Gets the file representing the YAML file (database). + * + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + private val file: File + @Throws(AraraException::class) + get() { + val reference = Arara.config[AraraSpec.Execution.reference] + val name = "${Arara.config[AraraSpec.Execution.databaseName]}.yaml" + val path = FileHandlingUtils.getParentCanonicalFile(reference) + return path.resolve(name) + } + + /** + * Loads the YAML file representing the database. + * + * @return The database object. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun load(): Database { + return if (!exists()) { + Database() + } else { + file.runCatching { + val text = readText() + if (!text.startsWith("!database")) + throw Exception("Database should start with !database") + Yaml.default.parse(Database.serializer(), text) + }.getOrElse { + it.printStackTrace() + throw AraraException(messages.getMessage(Messages + .ERROR_LOAD_COULD_NOT_LOAD_XML, file.name), it) + } + } + } + + /** + * Saves the database on a YAML file. + * + * @param database The database object. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun save(database: Database) { + file.runCatching { + val content = "!database\n" + + Yaml.default.stringify(Database.serializer(), database) + writeText(content) + }.getOrElse { + throw AraraException( + messages.getMessage( + Messages.ERROR_SAVE_COULD_NOT_SAVE_XML, + file.name + ), it) + } + } + + /** + * Checks if the YAML file representing the database exists. + * + * @return A boolean value indicating if the YAML file exists. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + private fun exists(): Boolean { + return file.exists() + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/filehandling/FileHandlingUtils.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/filehandling/FileHandlingUtils.kt new file mode 100644 index 0000000000..07f1ecfab9 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/filehandling/FileHandlingUtils.kt @@ -0,0 +1,319 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.filehandling + +import java.io.File +import java.io.IOException +import java.text.SimpleDateFormat +import java.util.zip.CRC32 +import org.islandoftex.arara.Arara +import org.islandoftex.arara.configuration.AraraSpec +import org.islandoftex.arara.localization.LanguageController +import org.islandoftex.arara.localization.Messages +import org.islandoftex.arara.model.AraraException + +/** + * Implements file handling utilitary methods. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +object FileHandlingUtils { + // the application messages obtained from the + // language controller + private val messages = LanguageController + + /** + * Gets the reference of the current file in execution. Note that this + * method might return a value different than the main file provided in + * the command line. + * + * @return A reference of the current file in execution. Might be different + * than the main file provided in the command line. + */ + private val currentFile: File + get() = Arara.config[AraraSpec.Execution.file] + + /** + * Writes the string to a file, using UTF-8 as default encoding. + * @param file The file. + * @param text The string to be written. + * @param append A flag whether to append the content. + * @return A logical value indicating whether it was successful. + */ + fun writeToFile(file: File, text: String, append: Boolean): Boolean { + return try { + // try to write the provided + // string to the file, with + // UTF-8 as encoding + if (append) + file.appendText(text, Charsets.UTF_8) + else + file.writeText(text, Charsets.UTF_8) + true + } catch (_: IOException) { + // if something bad happens, + // gracefully fallback to + // reporting the failure + false + } + } + + /** + * Writes the string list to a file, using UTF-8 as default encoding. + * @param file The file. + * @param lines The string list to be written. + * @param append A flag whether to append the content. + * @return A logical value indicating whether it was successful. + */ + fun writeToFile( + file: File, + lines: List<String>, + append: Boolean + ): Boolean = + try { + writeToFile(file, lines.joinToString(System.lineSeparator()), + append) + } catch (_: IOException) { + false + } + + /** + * Reads the provided file (UTF-8) into a list of strings. + * @param file The file. + * @return A list of strings. + */ + fun readFromFile(file: File): List<String> { + return try { + // returns the contents of + // the provided file as + // a list of strings + file.readLines(Charsets.UTF_8) + } catch (_: IOException) { + // if something bad happens, + // gracefully fallback to + // an empty file list + listOf() + } + } + + /** + * Checks if a file exists based on its extension. + * + * @param extension The extension. + * @return A boolean value indicating if the file exists. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun exists(extension: String): Boolean { + val file = File(getPath(extension)) + return file.exists() + } + + /** + * Gets the parent canonical path of a file. + * + * @param file The file. + * @return The parent canonical path of a file. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun getParentCanonicalPath(file: File): String { + return getParentCanonicalFile(file).toString() + } + + /** + * Gets the parent canonical file of a file. + * + * @param file The file. + * @return The parent canonical file of a file. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun getParentCanonicalFile(file: File): File { + return file.runCatching { + this.canonicalFile.parentFile + }.getOrElse { + // it is IOException || is is SecurityException + throw AraraException(messages.getMessage( + Messages.ERROR_GETPARENTCANONICALPATH_IO_EXCEPTION), it) + } + } + + /** + * Gets the full file path based on the provided extension. + * + * @param extension The extension. + * @return A string containing the full file path. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun getPath(extension: String): String { + val name = currentFile.nameWithoutExtension + ".$extension" + val path = getParentCanonicalFile(currentFile) + return path.resolve(name).toString() + } + + /** + * Gets the canonical path from the provided file. + * + * @param file The file. + * @return The canonical path from the provided file. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun getCanonicalPath(file: File): String { + return getCanonicalFile(file).toString() + } + + /** + * Gets the canonical file from the provided file. + * + * @param file The file. + * @return The canonical file from the provided file. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun getCanonicalFile(file: File): File { + try { + return file.canonicalFile + } catch (exception: IOException) { + throw AraraException( + messages.getMessage( + Messages.ERROR_GETCANONICALFILE_IO_EXCEPTION + ), + exception + ) + } + } + + /** + * Gets the date the provided file was last modified. + * + * @param file The file. + * @return A string representation of the date the provided file was last + * modified. + */ + fun getLastModifiedInformation(file: File): String { + return SimpleDateFormat("MM/dd/yyyy HH:mm:ss") + .format(file.lastModified()) + } + + /** + * Calculates the CRC32 checksum of the provided file. + * + * @param file The file. + * @return A string containing the CRC32 checksum of the provided file. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun calculateHash(file: File): String { + try { + return String.format("%08x", CRC32().run { + update(file.readBytes()) + value + }) + } catch (exception: IOException) { + throw AraraException(messages.getMessage(Messages + .ERROR_CALCULATEHASH_IO_EXCEPTION), exception) + } + } + + /** + * Gets the extension of a file. + * + * @param file The file. + * @return The corresponding file type. + */ + fun getFileExtension(file: File): String = file.extension + + /** + * Gets the base name of a file. + * + * @param file The file. + * @return The corresponding base name. + */ + fun getBasename(file: File): String = file.nameWithoutExtension + + /** + * Checks if a file has changed since the last verification. + * + * @param file The file. + * @return A boolean value indicating if the file has changed since the last + * verification. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun hasChanged(file: File): Boolean { + val database = DatabaseUtils.load() + val path = getCanonicalPath(file) + return if (!file.exists()) { + if (database.containsKey(path)) { + database.remove(path) + DatabaseUtils.save(database) + true + } else { + false + } + } else { + val hash = calculateHash(file) + if (database.containsKey(path)) { + val value = database[path] + if (hash == value) { + false + } else { + database[path] = hash + DatabaseUtils.save(database) + true + } + } else { + database[path] = hash + DatabaseUtils.save(database) + true + } + } + } + + /** + * Checks if the file has changed since the last verification based on the + * provided extension. + * + * @param extension The provided extension. + * @return A boolean value indicating if the file has changed since the last + * verification. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun hasChanged(extension: String): Boolean = + hasChanged(File(getPath(extension))) + + /** + * Checks whether a directory is under a root directory. + * + * @param child Directory to be inspected. + * @param parent Root directory. + * @return Logical value indicating whether the directoy is under root. + * @throws AraraException There was a problem with path retrieval. + */ + @Throws(AraraException::class) + fun isSubDirectory(child: File, parent: File): Boolean { + return if (child.isDirectory && parent.isDirectory) { + getCanonicalPath(child).startsWith( + getParentCanonicalPath(parent) + File.separator + ) + } else { + throw AraraException(messages.getMessage( + Messages.ERROR_ISSUBDIRECTORY_NOT_A_DIRECTORY, + child.name)) + } + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/filehandling/FileSearchingUtils.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/filehandling/FileSearchingUtils.kt new file mode 100644 index 0000000000..5c61bdb2db --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/filehandling/FileSearchingUtils.kt @@ -0,0 +1,158 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.filehandling + +import java.io.File +import java.io.FileFilter +import java.nio.file.FileSystems +import org.islandoftex.arara.Arara +import org.islandoftex.arara.configuration.AraraSpec +import org.islandoftex.arara.localization.LanguageController +import org.islandoftex.arara.localization.Messages +import org.islandoftex.arara.model.AraraException +import org.islandoftex.arara.utils.CommonUtils + +/** + * Implements file searching utilitary methods. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +object FileSearchingUtils { + /** + * List all files from the provided directory according to the list of + * extensions. The leading dot must be omitted, unless it is part of the + * extension. + * @param directory The provided directory. + * @param extensions The list of extensions. + * @param recursive A flag indicating whether the search is recursive. + * @return A list of files. + */ + fun listFilesByExtensions( + directory: File, + extensions: List<String>, + recursive: Boolean + ): + List<File> = try { + // return the result of the + // provided search + if (recursive) + directory.walkTopDown().asSequence() + .filter { !it.isDirectory } + .filter { extensions.contains(it.extension) } + .toList() + else + directory.listFiles( + FileFilter { extensions.contains(it.extension) })!! + .toList() + } catch (_: Exception) { + // if something bad happens, + // gracefully fallback to + // an empty file list + listOf() + } + + /** + * List all files from the provided directory matching the list of file + * name patterns. Such list can contain wildcards. + * @param directory The provided directory. + * @param patterns The list of file name patterns. + * @param recursive A flag indicating whether the search is recursive. + * @return A list of files. + */ + fun listFilesByPatterns( + directory: File, + patterns: List<String>, + recursive: Boolean + ): + List<File> = try { + // return the result of the provided + // search, with the wildcard filter + // and a potential recursive search + val pathMatcher = patterns.map { + FileSystems.getDefault().getPathMatcher("glob:$it") + } + if (recursive) + directory.walkTopDown().asSequence() + .filter { !it.isDirectory } + .filter { file -> + pathMatcher.any { it.matches(file.toPath().fileName) } + }.toList() + else + directory.listFiles { file: File -> + pathMatcher.any { it.matches(file.toPath().fileName) } + }!!.toList() + } catch (_: Exception) { + // if something bad happens, + // gracefully fallback to + // an empty file list + listOf() + } + + /** + * Discovers the file through string reference lookup and sets the + * configuration accordingly. + * + * @param reference The string reference. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun discoverFile(reference: String) { + lookupFile(reference) + ?: throw AraraException( + LanguageController.getMessage( + Messages.ERROR_DISCOVERFILE_FILE_NOT_FOUND, + reference, + CommonUtils.fileTypesList + ) + ) + } + + /** + * Performs a file lookup based on a string reference. + * + * @param reference The file reference as a string. + * @return The file as result of the lookup operation. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + private fun lookupFile(reference: String): File? { + val types = Arara.config[AraraSpec.Execution.fileTypes] + val file = Arara.config[AraraSpec.Execution.workingDirectory] + .resolve(reference).toFile() + val name = file.name + val parent = FileHandlingUtils.getParentCanonicalFile(file) + + // direct search, so we are considering + // the reference as a complete name + val testFile = parent.resolve(name) + if (testFile.exists() && testFile.isFile) { + types.firstOrNull { + testFile.toString().endsWith("." + it.extension) + }?.let { + Arara.config[AraraSpec.Execution.filePattern] = + it.pattern + Arara.config[AraraSpec.Execution.reference] = testFile + return testFile + } + } + + // indirect search; in this case, we are considering + // that the file reference has an implicit extension, + // so we need to add it and look again + // TODO: disable this step in safe mode + return types.map { parent.resolve("$name.${it.extension}") to it } + .union(types.map { + parent.resolve("${name.removeSuffix(".").trim()}.${it.extension}") to it + }) + .firstOrNull { it.first.exists() && it.first.isFile } + ?.let { + Arara.config[AraraSpec.Execution.filePattern] = + it.second.pattern + Arara.config[AraraSpec.Execution.reference] = it.first + file + } + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/localization/Language.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/localization/Language.kt new file mode 100644 index 0000000000..2afa77c41e --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/localization/Language.kt @@ -0,0 +1,69 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.localization + +import java.util.Locale +import org.islandoftex.arara.model.AraraException + +/** + * Implements the language model. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +class Language(code: String) { + // the language code, based on + // ISO 639-1 and language variants + private val code: String + + /** + * Gets the language name. + * + * @return A string representing the language name. + */ + val name: String + get() = languages.getValue(code).first + + /** + * Gets the language locale. + * + * @return The language locale. + */ + val locale: Locale + get() = languages.getValue(code).second + + // throws an exception on invalid language + init { + if (languages.containsKey(code)) { + this.code = code + } else { + throw AraraException( + LanguageController.getMessage( + Messages.ERROR_LANGUAGE_INVALID_CODE, + languagesList + ) + ) + } + } + + companion object { + // map containing all languages + // supported by arara + private val languages = mapOf( + "en" to Pair("English", Locale("en")), + "de" to Pair("German", Locale("de")), + "nl" to Pair("Dutch", Locale("nl")), + "qn" to Pair("Broad Norfolk", Locale("en", "QN")), + "ptbr" to Pair("Brazilian Portuguese", Locale("pt", "BR")), + "it" to Pair("Italian", Locale("it")) + ) + + /** + * String representing the list of available languages + * because they don't change initialized with the string + */ + val languagesList: String = "(" + languages.map { (key, value) -> + value.first + ": " + key + }.joinToString(", ") + ")" + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/localization/LanguageController.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/localization/LanguageController.kt new file mode 100644 index 0000000000..e000ab4d63 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/localization/LanguageController.kt @@ -0,0 +1,59 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.localization + +import ch.qos.cal10n.IMessageConveyor +import ch.qos.cal10n.MessageConveyor +import java.util.Locale +import org.islandoftex.arara.configuration.AraraSpec + +/** + * Implements the language controller. This controller provides a singleton + * object that holds the application messages, easily available to all model + * and utilitary classes. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +object LanguageController { + // the message conveyor helps us to get localized messages + // according to the provided locale + // The fallback language is set to English for all + // messages in arara. + private var conveyor: IMessageConveyor = MessageConveyor(Locale( + AraraSpec.Application.defaultLanguageCode.default)) + + /** + * Sets the current locale. This method actually resets the language + * conveyor in order to use the new locale. It's quite simple. + * @param locale The new locale for localized messages through the language + * conveyor. + */ + fun setLocale(locale: Locale) { + conveyor = MessageConveyor(locale) + } + + /** + * Gets the localized message indexed by the provided enumeration key, + * applying an array of objects as parameters. This method is a wrapper to + * the conveyor's method of the same name. + * @param E Enumeration type that represents the conveyor messages. + * @param key Key set in the provided enumeration type. + * @param parameters Array of objects to be used as parameters. + * @return A string containing a localized message indexed by the provided + * enumeration key and applied the array of objects as parameters. + */ + @Suppress("SpreadOperator") + fun <E : Enum<*>> getMessage(key: E, vararg parameters: Any): String = + conveyor.getMessage(key, *parameters) + + /** + * Gets the localized message indexed by the provided enumeration key. This + * method is a wrapper to the conveyor's method of the same name. + * @param E Enumeration type that represents the conveyor messages. + * @param key Key set in the provided enumeration type. + * @return A string containing a localized message indexed by the provided + * enumeration key. + */ + fun <E : Enum<*>> getMessage(key: E): String = conveyor.getMessage(key) +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/localization/Messages.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/localization/Messages.kt new file mode 100644 index 0000000000..75d957e1df --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/localization/Messages.kt @@ -0,0 +1,106 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.localization + +import ch.qos.cal10n.BaseName +import ch.qos.cal10n.Locale +import ch.qos.cal10n.LocaleData + +/** + * This enumeration contains all application messages. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +@BaseName("org.islandoftex.arara.localization.messages") +@LocaleData(Locale(value = "de", charset = "UTF-8"), + Locale(value = "en", charset = "UTF-8"), + Locale(value = "en_QN", charset = "UTF-8"), + Locale(value = "it", charset = "UTF-8"), + Locale(value = "nl", charset = "UTF-8"), + Locale(value = "pt_BR", charset = "UTF-8")) +enum class Messages { + ERROR_BASENAME_NOT_A_FILE, + ERROR_CALCULATEHASH_IO_EXCEPTION, + ERROR_CHECKBOOLEAN_NOT_VALID_BOOLEAN, + ERROR_CHECKOS_INVALID_OPERATING_SYSTEM, + ERROR_CHECKREGEX_IO_EXCEPTION, + ERROR_CONFIGURATION_GENERIC_ERROR, + ERROR_CONFIGURATION_LOOPS_INVALID_RANGE, + ERROR_DISCOVERFILE_FILE_NOT_FOUND, + ERROR_EVALUATE_COMPILATION_FAILED, + ERROR_EVALUATE_NOT_BOOLEAN_VALUE, + ERROR_EXTRACTOR_IO_ERROR, + ERROR_FILETYPE_NOT_A_FILE, + ERROR_FILETYPE_UNKNOWN_EXTENSION, + ERROR_GETAPPLICATIONPATH_ENCODING_EXCEPTION, + ERROR_GETCANONICALFILE_IO_EXCEPTION, + ERROR_GETPARENTCANONICALPATH_IO_EXCEPTION, + ERROR_INTERPRETER_ARGUMENT_IS_REQUIRED, + ERROR_INTERPRETER_COMMAND_RUNTIME_ERROR, + ERROR_INTERPRETER_DEFAULT_VALUE_RUNTIME_ERROR, + ERROR_INTERPRETER_EXIT_RUNTIME_ERROR, + ERROR_INTERPRETER_FLAG_RUNTIME_EXCEPTION, + ERROR_INTERPRETER_RULE_NOT_FOUND, + ERROR_INTERPRETER_UNKNOWN_KEYS, + ERROR_INTERPRETER_WRONG_EXIT_CLOSURE_RETURN, + ERROR_ISSUBDIRECTORY_NOT_A_DIRECTORY, + ERROR_LANGUAGE_INVALID_CODE, + ERROR_LOAD_COULD_NOT_LOAD_XML, + ERROR_PARSER_INVALID_PREAMBLE, + ERROR_PARSERULE_GENERIC_ERROR, + ERROR_REPLICATELIST_MISSING_FORMAT_ARGUMENTS_EXCEPTION, + ERROR_RULE_IDENTIFIER_AND_PATH, + ERROR_RUN_GENERIC_EXCEPTION, + ERROR_RUN_INTERRUPTED_EXCEPTION, + ERROR_RUN_INVALID_EXIT_VALUE_EXCEPTION, + ERROR_RUN_IO_EXCEPTION, + ERROR_RUN_TIMEOUT_EXCEPTION, + ERROR_RUN_TIMEOUT_INVALID_RANGE, + ERROR_SAVE_COULD_NOT_SAVE_XML, + ERROR_SESSION_OBTAIN_UNKNOWN_KEY, + ERROR_SESSION_REMOVE_UNKNOWN_KEY, + ERROR_VALIDATE_EMPTY_FILES_LIST, + ERROR_VALIDATE_FILES_IS_NOT_A_LIST, + ERROR_VALIDATE_INVALID_DIRECTIVE_FORMAT, + ERROR_VALIDATE_NO_DIRECTIVES_FOUND, + ERROR_VALIDATE_ORPHAN_LINEBREAK, + ERROR_VALIDATE_REFERENCE_IS_RESERVED, + ERROR_VALIDATE_YAML_EXCEPTION, + ERROR_VALIDATEBODY_ARGUMENT_ID_IS_RESERVED, + ERROR_VALIDATEBODY_DUPLICATE_ARGUMENT_IDENTIFIERS, + ERROR_VALIDATEBODY_MISSING_KEYS, + ERROR_VALIDATEBODY_NULL_ARGUMENT_ID, + ERROR_VALIDATEBODY_NULL_COMMAND, + ERROR_VALIDATEHEADER_NULL_ID, + ERROR_VALIDATEHEADER_NULL_NAME, + ERROR_VALIDATEHEADER_WRONG_IDENTIFIER, + INFO_DISPLAY_EXCEPTION_MORE_DETAILS, + INFO_DISPLAY_EXECUTION_TIME, + INFO_DISPLAY_FILE_INFORMATION, + INFO_INTERPRETER_DRYRUN_MODE_BOOLEAN_MODE, + INFO_INTERPRETER_DRYRUN_MODE_SYSTEM_COMMAND, + INFO_LABEL_AUTHOR, + INFO_LABEL_AUTHORS, + INFO_LABEL_CONDITIONAL, + INFO_LABEL_NO_AUTHORS, + INFO_LABEL_ON_DETAILS, + INFO_LABEL_ON_ERROR, + INFO_LABEL_ON_FAILURE, + INFO_LABEL_ON_SUCCESS, + INFO_LABEL_UNNAMED_TASK, + INFO_PARSER_NOTES, + LOG_INFO_BEGIN_BUFFER, + LOG_INFO_BOOLEAN_MODE, + LOG_INFO_DIRECTIVES_BLOCK, + LOG_INFO_END_BUFFER, + LOG_INFO_INTERPRET_RULE, + LOG_INFO_INTERPRET_TASK, + LOG_INFO_POTENTIAL_DIRECTIVE_FOUND, + LOG_INFO_POTENTIAL_PATTERN_FOUND, + LOG_INFO_RULE_LOCATION, + LOG_INFO_SYSTEM_COMMAND, + LOG_INFO_TASK_RESULT, + LOG_INFO_VALIDATED_DIRECTIVES, + LOG_INFO_WELCOME_MESSAGE +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/model/AraraException.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/model/AraraException.kt new file mode 100644 index 0000000000..6bf2d1e617 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/model/AraraException.kt @@ -0,0 +1,50 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.model + +/** + * Implements the specific exception model for arara. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +class AraraException : Exception { + /** + * The underlying exception, used to hold more details + * on what really happened + */ + val exception: Exception? + + /** + * Constructor. Takes the exception message. + * @param message The exception message. + */ + constructor(message: String) : super(message) { + this.exception = null + } + + /** + * Constructor. Takes the exception message and the underlying exception. + * @param message The exception message. + * @param exception The underlying exception object. + */ + constructor(message: String, exception: Exception) : super(message) { + this.exception = exception + } + + /** + * Constructor. Takes the exception message and the underlying exception. + * @param message The exception message. + * @param throwable The underlying exception as generic throwable. + */ + constructor(message: String, throwable: Throwable) : super(message) { + this.exception = RuntimeException(throwable) + } + + /** + * Checks if there is an underlying exception defined in the current object. + * @return A boolean value indicating if the current object has an + * underlying exception. + */ + fun hasException(): Boolean = exception?.message != null +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/model/Evaluator.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/model/Evaluator.kt new file mode 100644 index 0000000000..78b98e709a --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/model/Evaluator.kt @@ -0,0 +1,122 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.model + +import org.islandoftex.arara.Arara +import org.islandoftex.arara.configuration.AraraSpec +import org.islandoftex.arara.localization.LanguageController +import org.islandoftex.arara.localization.Messages +import org.islandoftex.arara.ruleset.Conditional +import org.islandoftex.arara.utils.Methods +import org.mvel2.templates.TemplateRuntime + +/** + * Implements the evaluator model, on which a conditional can be analyzed and + * processed. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +class Evaluator { + // this attribute holds the maximum number of + // loops arara will accept; it's like + // reaching infinity + private val loops: Int = Arara.config[AraraSpec.Execution.maxLoops] + + // the counter for the current execution, it + // helps us keep track of the number of times + // this evaluation has happened, and also to + // prevent potential infinite loops + private var counter: Int = 0 + + // a flag that indicates the + // evaluation to halt regardless + // of the the result + private var halt: Boolean = false + + /** + * Check if a condition is of type if or unless and whether halt + * is set. + * @param type The type to check. + * @param haltCheck The value [halt] should have. + * @return `(type == if || type == unless) && haltCheck` + */ + private fun isIfUnlessAndHalt( + type: Conditional.ConditionalType, + haltCheck: Boolean = true + ): Boolean = + (type == Conditional.ConditionalType.IF || + type == Conditional.ConditionalType.UNLESS) && + halt == haltCheck + + /** + * Only run the evaluation of the conditional including a check whether + * the result needs to be inverted. + * @param conditional The conditional. + * @return The result of the evaluation. + */ + @Throws(AraraException::class, RuntimeException::class) + private fun evaluateCondition(conditional: Conditional): Boolean { + val result = TemplateRuntime.eval("@{ " + conditional.condition + " }", + Methods.getConditionalMethods()) + return if (result is Boolean) { + if (conditional.type == Conditional.ConditionalType.UNLESS || + conditional.type == Conditional.ConditionalType.UNTIL) + !result + else + result + } else { + throw AraraException(messages.getMessage( + Messages.ERROR_EVALUATE_NOT_BOOLEAN_VALUE)) + } + } + + /** + * Evaluate the provided conditional. + * + * @param conditional The conditional object. + * @return A boolean value indicating if the conditional holds. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + @Suppress("TooGenericExceptionCaught") + fun evaluate(conditional: Conditional): Boolean { + // when in dry-run mode or not evaluating a + // conditional, arara always ignores conditional + // evaluations + if (conditional.type == Conditional.ConditionalType.NONE || + Arara.config[AraraSpec.Execution.dryrun] || + isIfUnlessAndHalt(conditional.type, true)) + return false + else if (isIfUnlessAndHalt(conditional.type, false)) { + halt = true + } + + // check counters and see if the execution + // has reached our concept of infinity, + // thus breaking the cycles + counter++ + return when { + conditional.type === Conditional.ConditionalType.WHILE + && counter > loops -> false + conditional.type === Conditional.ConditionalType.UNTIL + && counter >= loops -> false + else -> { + try { + evaluateCondition(conditional) + } catch (exception: RuntimeException) { + throw AraraException(messages.getMessage(Messages + .ERROR_EVALUATE_COMPILATION_FAILED), + exception) + } + } + } + } + + companion object { + // the application messages obtained from the + // language controller + private val messages = LanguageController + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/model/Extractor.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/model/Extractor.kt new file mode 100644 index 0000000000..ed4d811d22 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/model/Extractor.kt @@ -0,0 +1,50 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.model + +import java.io.File +import java.io.IOException +import java.nio.charset.Charset +import org.islandoftex.arara.localization.LanguageController +import org.islandoftex.arara.localization.Messages +import org.islandoftex.arara.ruleset.Directive +import org.islandoftex.arara.ruleset.DirectiveUtils +import org.islandoftex.arara.utils.CommonUtils + +/** + * Extractor for directives from the provided main file. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +object Extractor { + // the application messages obtained from the + // language controller + private val messages = LanguageController + + /** + * Extracts a list of directives from the provided main file, obtained from + * the configuration controller. + * @param file The file to extract the directives from. + * @param charset The charset of the file. + * @return A list of directives. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun extract(file: File, charset: Charset = Charsets.UTF_8): + List<Directive> { + try { + val content = CommonUtils.preambleContent.toMutableList() + content.addAll(file.readLines(charset)) + return DirectiveUtils.extractDirectives(content) + } catch (ioexception: IOException) { + throw AraraException( + messages.getMessage( + Messages.ERROR_EXTRACTOR_IO_ERROR + ), + ioexception + ) + } + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/model/FileType.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/model/FileType.kt new file mode 100644 index 0000000000..e6ed27d51a --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/model/FileType.kt @@ -0,0 +1,110 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.model + +import java.util.regex.PatternSyntaxException +import kotlinx.serialization.Serializable +import org.islandoftex.arara.configuration.ConfigurationUtils +import org.islandoftex.arara.localization.LanguageController +import org.islandoftex.arara.localization.Messages +import org.islandoftex.arara.utils.CommonUtils + +/** + * Implements the file type model. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +@Serializable +class FileType { + // string representing the + // file extension + var extension: String = INVALID_EXTENSION + get() = CommonUtils.removeKeywordNotNull(field) + private set + // string representing the + // file pattern to be used + // as directive lookup + var pattern: String = INVALID_PATTERN + @Throws(AraraException::class) + get() { + CommonUtils.removeKeywordNotNull(field) + if (field == INVALID_PATTERN) { + field = ConfigurationUtils.defaultFileTypePatterns[extension] + ?: throw AraraException( + LanguageController.getMessage( + Messages.ERROR_FILETYPE_UNKNOWN_EXTENSION, + extension, + CommonUtils.fileTypesList + ) + ) + } + return field + } + private set + + constructor(extension: String, pattern: String) { + this.extension = extension + this.pattern = pattern + + try { + pattern.toPattern() + } catch (e: PatternSyntaxException) { + if (!ConfigurationUtils.defaultFileTypePatterns.containsKey(extension)) + throw AraraException( + LanguageController.getMessage( + Messages.ERROR_FILETYPE_UNKNOWN_EXTENSION, + extension, + CommonUtils.fileTypesList + ) + ) + } + } + + companion object { + /** + * This constant identifies an invalid extension. As unices do not + * allow a forward and Windows does not allow a backward slash, this + * should suffice. + */ + const val INVALID_EXTENSION = "/\\" + /** + * This constant identifies an invalid pattern. This is a opening + * character class which is invalid. + */ + const val INVALID_PATTERN = "[" + } + + /** + * Provides a textual representation of the current file type object. + * @return A string containing a textual representation of the current file + * type object. + */ + override fun toString(): String { + return ".$extension" + } + + /** + * Implements the file type equals method, checking if one file type is + * equal to another. Note that only the file extension is considered. + * @param other The object to be analyzed. + * @return A boolean value indicating if those two objects are equal. + */ + override fun equals(other: Any?): Boolean { + if (this === other) return true + if (javaClass != other?.javaClass) return false + + other as FileType + if (extension != other.extension) return false + return true + } + + /** + * Implements the file type hash code. Note that only the file extension is + * considered. + * @return An integer representing the file type hash code. + */ + override fun hashCode(): Int { + return extension.hashCode() + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/model/Interpreter.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/model/Interpreter.kt new file mode 100644 index 0000000000..49cf40f1a2 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/model/Interpreter.kt @@ -0,0 +1,375 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.model + +import java.io.File +import kotlin.time.ExperimentalTime +import org.islandoftex.arara.Arara +import org.islandoftex.arara.configuration.AraraSpec +import org.islandoftex.arara.localization.LanguageController +import org.islandoftex.arara.localization.Messages +import org.islandoftex.arara.ruleset.Argument +import org.islandoftex.arara.ruleset.Command +import org.islandoftex.arara.ruleset.Conditional +import org.islandoftex.arara.ruleset.Directive +import org.islandoftex.arara.ruleset.Rule +import org.islandoftex.arara.ruleset.RuleCommand +import org.islandoftex.arara.ruleset.RuleUtils +import org.islandoftex.arara.utils.CommonUtils +import org.islandoftex.arara.utils.DisplayUtils +import org.islandoftex.arara.utils.InterpreterUtils +import org.islandoftex.arara.utils.Methods +import org.mvel2.templates.TemplateRuntime +import org.slf4j.LoggerFactory + +/** + * Interprets the list of directives. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +class Interpreter( + /** + * The list of directives to be interpreted and evaluated. + */ + val directives: List<Directive> +) { + /** + * Exception class to represent that the interpreter should stop for some + * reason + */ + private class HaltExpectedException(msg: String) : Exception(msg) + + /** + * Gets the rule according to the provided directive. + * + * @param directive The provided directive. + * @return The absolute canonical path of the rule, given the provided + * directive. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + private fun getRule(directive: Directive): File { + return InterpreterUtils.buildRulePath(directive.identifier) + ?: throw AraraException( + messages.getMessage( + Messages.ERROR_INTERPRETER_RULE_NOT_FOUND, + directive.identifier, + "(" + CommonUtils.allRulePaths + .joinToString("; ") + ")" + ) + ) + } + + // TODO: in the following, extract the printing into the higher level + // function + /** + * "Run" a boolean return value + * @param value The boolean. + * @param conditional The conditional to print in dry-run mode. + * @param authors The authors of the rule. + * @return Returns [value] + */ + private fun runBoolean( + value: Boolean, + conditional: Conditional, + authors: List<String> + ): Boolean { + logger.info(messages.getMessage(Messages.LOG_INFO_BOOLEAN_MODE, + value.toString())) + + if (Arara.config[AraraSpec.Execution.dryrun]) { + DisplayUtils.printAuthors(authors) + DisplayUtils.wrapText(messages.getMessage(Messages + .INFO_INTERPRETER_DRYRUN_MODE_BOOLEAN_MODE, + value)) + DisplayUtils.printConditional(conditional) + } + + return value + } + + /** + * Run a command + * @param command The command to run. + * @param conditional The conditional applied to the run (only for printing). + * @param authors The rule authors (only for printing). + * @param ruleCommandExitValue The exit value of the rule command. + * @return Success of the execution. + * @throws AraraException Execution failed. + */ + @ExperimentalTime + @Throws(AraraException::class) + @Suppress("TooGenericExceptionCaught") + private fun runCommand( + command: Command, + conditional: Conditional, + authors: List<String>, + ruleCommandExitValue: String? + ): Boolean { + logger.info(messages.getMessage(Messages.LOG_INFO_SYSTEM_COMMAND, + command)) + var success = true + + if (!Arara.config[AraraSpec.Execution.dryrun]) { + val code = InterpreterUtils.run(command) + val check: Any = try { + val context = mapOf<String, Any>("value" to code) + TemplateRuntime.eval( + "@{ " + (ruleCommandExitValue ?: "value == 0") + " }", + context) + } catch (exception: RuntimeException) { + throw AraraException(CommonUtils.ruleErrorHeader + + messages.getMessage(Messages + .ERROR_INTERPRETER_EXIT_RUNTIME_ERROR), + exception) + } + + success = if (check is Boolean) { + check + } else { + throw AraraException( + CommonUtils.ruleErrorHeader + messages.getMessage( + Messages.ERROR_INTERPRETER_WRONG_EXIT_CLOSURE_RETURN + ) + ) + } + } else { + DisplayUtils.printAuthors(authors) + DisplayUtils.wrapText(messages.getMessage( + Messages.INFO_INTERPRETER_DRYRUN_MODE_SYSTEM_COMMAND, + command)) + DisplayUtils.printConditional(conditional) + } + + return success + } + + /** + * Converts the command evaluation result to a flat list. + * @param result The result + * @return A flat list. + */ + private fun resultToList(result: Any) = if (result is List<*>) { + CommonUtils.flatten(result) + } else { + listOf(result) + } + + /** + * Execute a command. + * @param command The command to evaluate. + * @param conditional Under which condition to execute. + * @param rule The rule (only passed for output purposes). + * @param parameters The parameters for evaluation + * @throws AraraException Running the command failed. + */ + @ExperimentalTime + @Throws(AraraException::class) + @Suppress("TooGenericExceptionCaught", "ThrowsCount") + private fun executeCommand( + command: RuleCommand, + conditional: Conditional, + rule: Rule, + parameters: Map<String, Any> + ) { + val result: Any = try { + TemplateRuntime.eval(command.command!!, parameters) + } catch (exception: RuntimeException) { + throw AraraException(CommonUtils.ruleErrorHeader + + messages.getMessage(Messages + .ERROR_INTERPRETER_COMMAND_RUNTIME_ERROR), + exception) + } + + // TODO: check nullability + resultToList(result).filter { it.toString().isNotBlank() } + .forEach { current -> + DisplayUtils.printEntry(rule.name, command.name + ?: messages.getMessage(Messages + .INFO_LABEL_UNNAMED_TASK)) + + val success = when (current) { + is Boolean -> runBoolean(current, conditional, + rule.authors) + is Command -> runCommand(current, conditional, + rule.authors, command.exit) + else -> TODO("error: this should not happen" + + "we are only supporting boolean + command") + } + + DisplayUtils.printEntryResult(success) + + if (Arara.config[AraraSpec.Execution.haltOnErrors] && !success) + // TODO: localize + throw HaltExpectedException("Command failed") + + // TODO: document this key + val haltKey = "arara:${Arara.config[AraraSpec + .Execution.reference].name}:halt" + if (Session.contains(haltKey)) { + Arara.config[AraraSpec.Execution.status] = + Session[haltKey].toString().toInt() + // TODO: localize + throw HaltExpectedException("User requested halt") + } + } + } + + /** + * Executes each directive, throwing an exception if something bad has + * happened. + * + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @ExperimentalTime + @Throws(AraraException::class) + @Suppress("NestedBlockDepth") + fun execute() { + for (directive in directives) { + logger.info(messages.getMessage(Messages.LOG_INFO_INTERPRET_RULE, + directive.identifier)) + + Arara.config[AraraSpec.Execution.file] = + directive.parameters.getValue("reference") as File + val file = getRule(directive) + + logger.info(messages.getMessage(Messages.LOG_INFO_RULE_LOCATION, + file.parent)) + + Arara.config[AraraSpec.Execution.InfoSpec.ruleId] = + directive.identifier + Arara.config[AraraSpec.Execution.InfoSpec.rulePath] = + file.parent + Arara.config[AraraSpec.Execution.DirectiveSpec.lines] = + directive.lineNumbers + + // parse the rule identified by the directive + // (may throw an exception) + val rule = RuleUtils.parseRule(file, directive.identifier) + val parameters = parseArguments(rule, directive) + .plus(Methods.getRuleMethods()) + + val evaluator = Evaluator() + + var available = true + if (InterpreterUtils.runPriorEvaluation(directive.conditional)) { + available = evaluator.evaluate(directive.conditional) + } + + // if this directive is conditionally disabled, skip + if (!available) continue + // if not execute the commands associated with the directive + do { + rule.commands.forEach { command -> + try { + executeCommand(command, directive.conditional, rule, parameters) + } catch (_: HaltExpectedException) { + // if the user uses the halt rule to trigger + // a halt, this will be raised + return + } + } + } while (evaluator.evaluate(directive.conditional)) + } + } + + /** + * Parses the rule arguments against the provided directive. + * + * @param rule The rule object. + * @param directive The directive. + * @return A map containing all arguments resolved according to the + * directive parameters. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + private fun parseArguments(rule: Rule, directive: Directive): + Map<String, Any> { + val arguments = rule.arguments + val unknown = CommonUtils.getUnknownKeys(directive.parameters, + arguments).minus("reference") + if (unknown.isNotEmpty()) + throw AraraException(CommonUtils.ruleErrorHeader + + messages.getMessage( + Messages.ERROR_INTERPRETER_UNKNOWN_KEYS, + "(" + unknown.joinToString(", ") + ")")) + + val resolvedArguments = mutableMapOf<String, Any>() + resolvedArguments["reference"] = directive.parameters + .getValue("reference") + + val context = mapOf( + "parameters" to directive.parameters, + "reference" to directive.parameters.getValue("reference") + ).plus(Methods.getRuleMethods()) + + arguments.forEach { argument -> + resolvedArguments[argument.identifier!!] = processArgument(argument, + directive.parameters.containsKey(argument.identifier!!), + context) + } + + return resolvedArguments + } + + /** + * Process a single argument and return the evaluated result. + * @param argument The argument to process. + * @param idInDirectiveParams Whether the argument's identifier is + * contained in the directive's parameters field. + * @param context The context for the evaluation. + * @return The result of the evaluation. + * @throws AraraException The argument could not be processed. + */ + @Throws(AraraException::class) + @Suppress("TooGenericExceptionCaught", "ThrowsCount") + private fun processArgument( + argument: Argument, + idInDirectiveParams: Boolean, + context: Map<String, Any> + ): Any { + if (argument.isRequired && !idInDirectiveParams) + throw AraraException(CommonUtils.ruleErrorHeader + + messages.getMessage( + Messages.ERROR_INTERPRETER_ARGUMENT_IS_REQUIRED, + argument.identifier!!)) + + var ret = argument.default?.let { + try { + TemplateRuntime.eval(it, context) + } catch (exception: RuntimeException) { + throw AraraException(CommonUtils.ruleErrorHeader + + messages.getMessage(Messages + .ERROR_INTERPRETER_DEFAULT_VALUE_RUNTIME_ERROR), + exception) + } + } ?: "" + + if (argument.flag != null && idInDirectiveParams) { + ret = try { + TemplateRuntime.eval(argument.flag!!, context) + } catch (exception: RuntimeException) { + throw AraraException(CommonUtils.ruleErrorHeader + messages + .getMessage(Messages + .ERROR_INTERPRETER_FLAG_RUNTIME_EXCEPTION), + exception) + } + } + + return ret + } + + companion object { + // the application messages obtained from the + // language controller + private val messages = LanguageController + + // the class logger obtained from + // the logger factory + private val logger = LoggerFactory.getLogger(Interpreter::class.java) + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/model/Session.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/model/Session.kt new file mode 100644 index 0000000000..c2093429e1 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/model/Session.kt @@ -0,0 +1,119 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.model + +import org.islandoftex.arara.localization.LanguageController +import org.islandoftex.arara.localization.Messages + +/** + * Implements the session. + * + * This class wraps a map that holds the execution session, that is, a dirty + * maneuver to exchange pretty much any data between commands and even rules. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +object Session { + // the application messages obtained from the + // language controller + private val messages = LanguageController + + // the session map which holds the execution session; + // the idea here is to provide wrappers to the map + // methods, so it could be easily manipulated + private val map = mutableMapOf<String, Any>() + + /** + * Gets the object indexed by the provided key from the session. This method + * holds the map method of the very same name. + * + * @param key The provided key. + * @return The object indexed by the provided key. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + operator fun get(key: String): Any { + return if (contains(key)) { + map.getValue(key) + } else { + throw AraraException( + messages.getMessage( + Messages.ERROR_SESSION_OBTAIN_UNKNOWN_KEY, + key + ) + ) + } + } + + /** + * Inserts (or overwrites) the object indexed by the provided key into the + * session. This method holds the map method of the very same name. + * + * @param key The provided key. + * @param value The value to be inserted. + */ + fun put(key: String, value: Any) { + map[key] = value + } + + /** + * Removes the entry indexed by the provided key from the session. This method + * holds the map method of the same name. + * + * @param key The provided key. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun remove(key: String) { + if (contains(key)) { + map.remove(key) + } else { + throw AraraException( + messages.getMessage( + Messages.ERROR_SESSION_REMOVE_UNKNOWN_KEY, + key + ) + ) + } + } + + /** + * Checks if the provided key exists in the session. + * + * @param key The provided key. + * @return A boolean value indicating if the provided key exists in the + * session. + */ + operator fun contains(key: String): Boolean = map.containsKey(key) + + /** + * Clears the session (map). This method, as usual, holds the map method of + * the same name. + */ + fun clear() = map.clear() + + /** + * Update the environment variables stored in the session. + * + * @param additionFilter Which environment variables to include. You can + * filter their names (the string parameter) but not their values. By + * default all values will be added. + * @param removalFilter Which environment variables to remove beforehand. + * By default all values will be removed. + */ + fun updateEnvironmentVariables( + additionFilter: (String) -> Boolean = { true }, + removalFilter: (String) -> Boolean = { true } + ) { + // remove all current environment variables to clean up the session + map.filterKeys { it.startsWith("environment:") } + .filterKeys(removalFilter) + .forEach { remove(it.key) } + // add all relevant new environment variables + System.getenv().filterKeys(additionFilter) + .forEach { map["environment:${it.key}"] = it.value } + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/Argument.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/Argument.kt new file mode 100644 index 0000000000..dfd2b99403 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/Argument.kt @@ -0,0 +1,40 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.ruleset + +import kotlinx.serialization.SerialName +import kotlinx.serialization.Serializable +import org.islandoftex.arara.utils.CommonUtils + +/** + * The rule argument model. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +@Serializable +class Argument { + /** + * The argument identifier + */ + var identifier: String? = null + get() = CommonUtils.removeKeyword(field) + + /** + * Boolean indicating if the current argument is required + */ + @SerialName("required") + var isRequired: Boolean = false + + /** + * Flag to hold the argument value manipulation + */ + var flag: String? = null + get() = CommonUtils.removeKeyword(field) + + /** + * The argument fallback if it is not defined in the directive + */ + var default: String? = null + get() = CommonUtils.removeKeyword(field) +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/Command.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/Command.kt new file mode 100644 index 0000000000..df1ce802f5 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/Command.kt @@ -0,0 +1,57 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.ruleset + +import java.io.File +import org.islandoftex.arara.Arara +import org.islandoftex.arara.configuration.AraraSpec +import org.islandoftex.arara.utils.CommonUtils + +/** + * Implements a command model, containing a list of strings. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +class Command { + /** + * A list of elements which are components + * of a command and represented as strings + */ + val elements: List<String> + + /** + * An optional file acting as a reference for + * the default working directory + */ + var workingDirectory: File = Arara.config[AraraSpec.Execution + .workingDirectory].toFile() + + /** + * Constructor. + * @param values An array of objects. + */ + constructor(vararg values: Any) { + elements = mutableListOf() + val result = CommonUtils.flatten(values.toList()) + result.map { it.toString() }.filter { it.isNotEmpty() } + .forEach { elements.add(it) } + } + + /** + * Constructor. + * @param elements A list of strings. + */ + constructor(elements: List<String>) { + this.elements = elements + } + + /** + * Provides a textual representation of the current command. + * @return A string representing the current command. + */ + override fun toString(): String { + return "[ " + elements.joinToString(", ") + " ]" + + " @ $workingDirectory" + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/Conditional.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/Conditional.kt new file mode 100644 index 0000000000..8a4ec6cb35 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/Conditional.kt @@ -0,0 +1,67 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.ruleset + +/** + * The conditional class, it represents the type of conditional available + * for a directive and its corresponding expression to be evaluated. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +data class Conditional( + /** + * The type of the condition indicates the meaning when evaluated. + * Defaults to [ConditionalType.NONE]. + */ + val type: ConditionalType = ConditionalType.NONE, + /** + * The expression to be evaluated according to its type. Defaults + * to no evaluation (empty string). + */ + val condition: String = "" +) { + /** + * The types of conditionals arara is able to recognize. + */ + enum class ConditionalType { + /** + * Evaluated beforehand, directive is interpreted if and only if the + * result is true. + */ + IF, + /** + * There is no evaluation, directive is interpreted, no extra effort is + * needed. + */ + NONE, + /** + * Evaluated beforehand, directive is interpreted if and only if the + * result is false. + */ + UNLESS, + /** + * Directive is interpreted the first time, then the evaluation is + * done; while the result is false, the directive is interpreted again + * and again. + */ + UNTIL, + /** + * Evaluated beforehand, directive is interpreted if and only if the + * result is true, and the process is repeated while the result still + * holds true. + */ + WHILE + } + + /** + * Provides a textual representation of the conditional object. + * @return A string representation of this object. + */ + override fun toString(): String { + return "{ $type" + + if (type != ConditionalType.NONE) + ", expression: ${condition.trim()}" + else "" + " }" + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/Directive.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/Directive.kt new file mode 100644 index 0000000000..33f8431744 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/Directive.kt @@ -0,0 +1,32 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.ruleset + +/** + * Implements the directive model. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +data class Directive( + /** + * The directive identifier, it is resolved to the rule identifier + * later on. + */ + val identifier: String, + /** + * A map containing the parameters; they are validated later on in + * order to ensure they are valid. + */ + val parameters: Map<String, Any>, + /** + * A conditional containing the type and the expression to be evaluated + * later on. + */ + val conditional: Conditional, + /** + * A list contained all line numbers from the main file which built the + * current directive. + */ + val lineNumbers: List<Int> +) diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/DirectiveAssembler.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/DirectiveAssembler.kt new file mode 100644 index 0000000000..a431df6ae2 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/DirectiveAssembler.kt @@ -0,0 +1,55 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.ruleset + +/** + * Implements a directive assembler in order to help build a directive from a + * list of strings. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +class DirectiveAssembler { + // this variable holds a list of + // line numbers indicating which + // lines composed the resulting + // potential directive + private val lineNumbers = mutableListOf<Int>() + + // this variable holds the textual + // representation of the directive + private var text: String = "" + + /** + * Checks if an append operation is allowed. + * @return A boolean value indicating if an append operation is allowed. + */ + val isAppendAllowed: Boolean + get() = lineNumbers.isNotEmpty() + + /** + * Adds a line number to the assembler. + * @param line An integer representing the line number. + */ + fun addLineNumber(line: Int) = lineNumbers.add(line) + + /** + * Appends the provided line to the assembler text. + * @param line The provided line. + */ + fun appendLine(line: String) { + text = text + " " + line.trim() + } + + /** + * Gets the list of line numbers. + * @return The list of line numbers. + */ + fun getLineNumbers(): List<Int> = lineNumbers + + /** + * Gets the text. + * @return The assembler text, properly trimmed. + */ + fun getText(): String = text.trim() +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/DirectiveUtils.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/DirectiveUtils.kt new file mode 100644 index 0000000000..e901e25fcf --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/DirectiveUtils.kt @@ -0,0 +1,312 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.ruleset + +import com.fasterxml.jackson.databind.ObjectMapper +import com.fasterxml.jackson.dataformat.yaml.YAMLFactory +import com.fasterxml.jackson.module.kotlin.readValue +import com.fasterxml.jackson.module.kotlin.registerKotlinModule +import java.io.File +import java.util.regex.Pattern +import org.islandoftex.arara.Arara +import org.islandoftex.arara.configuration.AraraSpec +import org.islandoftex.arara.filehandling.FileHandlingUtils +import org.islandoftex.arara.localization.LanguageController +import org.islandoftex.arara.localization.Messages +import org.islandoftex.arara.model.AraraException +import org.islandoftex.arara.utils.DisplayUtils +import org.slf4j.LoggerFactory + +/** + * Implements directive utilitary methods. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +@UseExperimental(kotlinx.serialization.ImplicitReflectionSerializer::class) +object DirectiveUtils { + // the application messages obtained from the + // language controller + private val messages = LanguageController + + // get the logger context from a factory + private val logger = LoggerFactory.getLogger(DirectiveUtils::class.java) + + /** + * This function filters the lines of a file to identify the potential + * directives. + * + * @param lines The lines of the file. + * @return A map containing the line number and the line's content. + */ + private fun getPotentialDirectiveLines(lines: List<String>): + Map<Int, String> { + val header = Arara.config[AraraSpec.Execution.onlyHeader] + val validLineRegex = Arara.config[AraraSpec.Execution.filePattern] + val validLinePattern = validLineRegex.toPattern() + val validLineStartPattern = (validLineRegex + Arara.config[AraraSpec + .Application.namePattern]).toPattern() + val map = mutableMapOf<Int, String>() + for ((i, text) in lines.withIndex()) { + val validLineMatcher = validLineStartPattern.matcher(text) + if (validLineMatcher.find()) { + val line = text.substring(validLineMatcher.end()) + map[i + 1] = line + + logger.info(messages.getMessage( + Messages.LOG_INFO_POTENTIAL_PATTERN_FOUND, + i + 1, line.trim())) + } else if (header && !checkLinePattern(validLinePattern, text)) { + // if we should only look within the file's header and reached + // a point where the line pattern does not match anymore, we + // assume we have left the header and break + break + } + } + return map + } + + /** + * Extracts a list of directives from a list of strings. + * + * @param lines List of strings. + * @return A list of directives. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + @Suppress("MagicNumber") + fun extractDirectives(lines: List<String>): List<Directive> { + val pairs = getPotentialDirectiveLines(lines) + .takeIf { it.isNotEmpty() } + ?: throw AraraException(messages.getMessage( + Messages.ERROR_VALIDATE_NO_DIRECTIVES_FOUND)) + + val assemblers = mutableListOf<DirectiveAssembler>() + var assembler = DirectiveAssembler() + val linebreakPattern = Arara.config[AraraSpec.Directive + .linebreakPattern].toPattern() + for ((lineno, content) in pairs) { + val linebreakMatcher = linebreakPattern.matcher(content) + if (linebreakMatcher.find()) { + if (!assembler.isAppendAllowed) { + throw AraraException( + messages.getMessage( + Messages.ERROR_VALIDATE_ORPHAN_LINEBREAK, + lineno + ) + ) + } else { + assembler.addLineNumber(lineno) + assembler.appendLine(linebreakMatcher.group(1)) + } + } else { + if (assembler.isAppendAllowed) { + assemblers.add(assembler) + } + assembler = DirectiveAssembler() + assembler.addLineNumber(lineno) + assembler.appendLine(content) + } + } + if (assembler.isAppendAllowed) { + assemblers.add(assembler) + } + + return assemblers.map { generateDirective(it) } + } + + /** + * Generates a directive from a directive assembler. + * + * @param assembler The directive assembler. + * @return The corresponding directive. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + @Suppress("MagicNumber") + fun generateDirective(assembler: DirectiveAssembler): Directive { + val matcher = Arara.config[AraraSpec.Directive.directivePattern] + .toPattern().matcher(assembler.getText()) + if (matcher.find()) { + val directive = Directive( + identifier = matcher.group(1)!!, + parameters = getParameters(matcher.group(3), + assembler.getLineNumbers()), + conditional = Conditional( + type = getType(matcher.group(5)), + condition = matcher.group(6) ?: "" + ), + lineNumbers = assembler.getLineNumbers() + ) + + logger.info(messages.getMessage( + Messages.LOG_INFO_POTENTIAL_DIRECTIVE_FOUND, directive)) + + return directive + } else { + throw AraraException( + messages.getMessage( + Messages.ERROR_VALIDATE_INVALID_DIRECTIVE_FORMAT, + "(" + assembler.getLineNumbers() + .joinToString(", ") + ")" + ) + ) + } + } + + /** + * Gets the conditional type based on the input string. + * + * @param text The input string. + * @return The conditional type. + */ + private fun getType(text: String?): Conditional.ConditionalType { + return when (text) { + null -> Conditional.ConditionalType.NONE + "if" -> Conditional.ConditionalType.IF + "while" -> Conditional.ConditionalType.WHILE + "until" -> Conditional.ConditionalType.UNTIL + else -> Conditional.ConditionalType.UNLESS + } + } + + /** + * Gets the parameters from the input string. + * + * @param text The input string. + * @param numbers The list of line numbers. + * @return A map containing the directive parameters. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + private fun getParameters( + text: String?, + numbers: List<Int> + ): Map<String, Any> { + if (text == null) + return mapOf() + + /* Before using kotlinx.serialization, there has been a dedicated + * directive resolver which instructed SnakeYAML to do the following: + * + * addImplicitResolver(Tag.MERGE, MERGE, "<") + * addImplicitResolver(Tag.NULL, NULL, "~nN\u0000") + * addImplicitResolver(Tag.NULL, EMPTY, null) + * + * This has been removed. + */ + return ObjectMapper(YAMLFactory()).registerKotlinModule().runCatching { + readValue<Map<String, Any>>(text) + }.getOrElse { + throw AraraException(messages.getMessage( + Messages.ERROR_VALIDATE_YAML_EXCEPTION, + "(" + numbers.joinToString(", ") + ")"), + it) + } + } + + /** + * Replicate a directive for given files. + * + * @param holder The list of files. + * @param parameters The parameters for the directive. + * @param directive The directive to clone. + * @return List of cloned directives. + * @throws AraraException If there is an error validating the [holder] + * object. + */ + @Throws(AraraException::class) + private fun replicateDirective( + holder: Any, + parameters: Map<String, Any>, + directive: Directive + ): List<Directive> { + return if (holder is List<*>) { + // we received a file list, so we map that list to files + holder.filterIsInstance<Any>() + .asSequence() + .map { File(it.toString()) } + .map(FileHandlingUtils::getCanonicalFile) + // and because we want directives, we replicate our + // directive to be applied to that file + .map { reference -> + directive.copy(parameters = parameters + .plus("reference" to reference)) + } + .toList() + // we take the result if and only if we have at least one + // file and we did not filter out any invalid argument + .takeIf { it.isNotEmpty() && holder.size == it.size } + // TODO: check exception according to condition + ?: throw AraraException( + messages.getMessage( + Messages.ERROR_VALIDATE_EMPTY_FILES_LIST, + "(" + directive.lineNumbers + .joinToString(", ") + ")" + ) + ) + } else { + throw AraraException( + messages.getMessage( + Messages.ERROR_VALIDATE_FILES_IS_NOT_A_LIST, + "(" + directive.lineNumbers.joinToString(", ") + ")" + ) + ) + } + } + + /** + * Validates the list of directives, returning a new list. + * + * @param directives The list of directives. + * @return A new list of directives. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun process(directives: List<Directive>): List<Directive> { + val result = mutableListOf<Directive>() + directives.forEach { directive -> + val parameters = directive.parameters + + if (parameters.containsKey("reference")) + throw AraraException(messages.getMessage( + Messages.ERROR_VALIDATE_REFERENCE_IS_RESERVED, + "(" + directive.lineNumbers.joinToString(", ") + ")")) + + if (parameters.containsKey("files")) { + result.addAll(replicateDirective(parameters.getValue("files"), + parameters.minus("files"), directive)) + } else { + result.add(directive.copy(parameters = parameters + .plus("reference" to + Arara.config[AraraSpec.Execution.reference]))) + } + } + + logger.info(messages.getMessage( + Messages.LOG_INFO_VALIDATED_DIRECTIVES)) + logger.info(DisplayUtils.displayOutputSeparator( + messages.getMessage(Messages.LOG_INFO_DIRECTIVES_BLOCK))) + result.forEach { logger.info(it.toString()) } + logger.info(DisplayUtils.displaySeparator()) + + return result + } + + /** + * Checks if the provided line contains the corresponding pattern, based on + * the file type, or an empty line. + * + * @param pattern Pattern to be matched, based on the file type. + * @param line Provided line. + * @return Logical value indicating if the provided line contains the + * corresponding pattern, based on the file type, or an empty line. + */ + private fun checkLinePattern(pattern: Pattern, line: String): Boolean { + return line.isBlank() || pattern.matcher(line).find() + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/Rule.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/Rule.kt new file mode 100644 index 0000000000..53ac2aa8b1 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/Rule.kt @@ -0,0 +1,48 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.ruleset + +import kotlinx.serialization.Serializable +import org.islandoftex.arara.utils.CommonUtils + +/** + * Implements the rule model. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +@Serializable +class Rule { + /** + * The rule identifier + */ + var identifier: String = INVALID_RULE_IDENTIFIER + get() = CommonUtils.removeKeywordNotNull(field) + + /** + * The rule name + */ + var name: String = INVALID_RULE_NAME + get() = CommonUtils.removeKeywordNotNull(field) + + /** + * The list of authors + */ + var authors: List<String> = listOf() + get() = field.mapNotNull { CommonUtils.removeKeyword(it) } + + /** + * The list of commands + */ + var commands: List<RuleCommand> = listOf() + + /** + * The list of arguments + */ + var arguments: List<Argument> = listOf() + + companion object { + const val INVALID_RULE_IDENTIFIER = "INVALID_RULE" + const val INVALID_RULE_NAME = "INVALID_RULE" + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/RuleCommand.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/RuleCommand.kt new file mode 100644 index 0000000000..901718d412 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/RuleCommand.kt @@ -0,0 +1,33 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.ruleset + +import kotlinx.serialization.Serializable +import org.islandoftex.arara.utils.CommonUtils + +/** + * Implements the rule command model. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +@Serializable +class RuleCommand { + /** + * The command name + */ + var name: String? = null + get() = CommonUtils.removeKeyword(field) + + /** + * The command instruction + */ + var command: String? = null + get() = CommonUtils.removeKeyword(field) + + /** + * The exit status expression + */ + var exit: String? = null + get() = CommonUtils.removeKeyword(field) +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/RuleUtils.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/RuleUtils.kt new file mode 100644 index 0000000000..e823e4e598 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/ruleset/RuleUtils.kt @@ -0,0 +1,140 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.ruleset + +import com.charleskorn.kaml.Yaml +import java.io.File +import org.islandoftex.arara.localization.LanguageController +import org.islandoftex.arara.localization.Messages +import org.islandoftex.arara.model.AraraException +import org.islandoftex.arara.utils.CommonUtils + +/** + * Implements rule utilitary methods. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +object RuleUtils { + // the application messages obtained from the + // language controller + private val messages = LanguageController + + /** + * Parses the provided file, checks the identifier and returns a rule + * representation. + * + * @param file The rule file. + * @param identifier The directive identifier. + * @return The rule object. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun parseRule(file: File, identifier: String): Rule { + val rule = file.runCatching { + val text = readText() + if (!text.startsWith("!config")) + throw Exception("Rule should start with !config") + Yaml.default.parse(Rule.serializer(), text) + }.getOrElse { + throw AraraException( + CommonUtils.ruleErrorHeader + messages.getMessage( + Messages.ERROR_PARSERULE_GENERIC_ERROR + ), it) + } + + validateHeader(rule, identifier) + validateBody(rule) + return rule + } + + /** + * Validates the rule header according to the directive identifier. + * + * @param rule The rule object. + * @param identifier The directive identifier. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + @Suppress("ThrowsCount") + private fun validateHeader(rule: Rule, identifier: String) { + if (rule.identifier != Rule.INVALID_RULE_IDENTIFIER) { + if (rule.identifier != identifier) { + throw AraraException(CommonUtils.ruleErrorHeader + + messages.getMessage( + Messages.ERROR_VALIDATEHEADER_WRONG_IDENTIFIER, + rule.identifier, + identifier)) + } + } else { + throw AraraException(CommonUtils.ruleErrorHeader + + messages.getMessage(Messages.ERROR_VALIDATEHEADER_NULL_ID)) + } + if (rule.name == Rule.INVALID_RULE_NAME) { + throw AraraException( + CommonUtils.ruleErrorHeader + messages.getMessage( + Messages.ERROR_VALIDATEHEADER_NULL_NAME + ) + ) + } + } + + /** + * Validates the rule body. + * + * @param rule The rule object. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + @Suppress("ThrowsCount") + private fun validateBody(rule: Rule) { + if (rule.commands.any { it.command == null }) { + throw AraraException(CommonUtils.ruleErrorHeader + + messages.getMessage( + Messages.ERROR_VALIDATEBODY_NULL_COMMAND)) + } + + val arguments = mutableListOf<String>() + for (argument in rule.arguments) { + if (argument.identifier != null) { + if (argument.flag != null || argument.default != null) { + arguments.add(argument.identifier!!) + } else { + throw AraraException( + CommonUtils.ruleErrorHeader + messages.getMessage( + Messages.ERROR_VALIDATEBODY_MISSING_KEYS + ) + ) + } + } else { + throw AraraException( + CommonUtils.ruleErrorHeader + messages.getMessage( + Messages.ERROR_VALIDATEBODY_NULL_ARGUMENT_ID + ) + ) + } + } + + arguments.intersect(listOf("files", "reference")).forEach { + throw AraraException( + CommonUtils.ruleErrorHeader + messages.getMessage( + Messages.ERROR_VALIDATEBODY_ARGUMENT_ID_IS_RESERVED, + it + ) + ) + } + + val expected = arguments.size + val found = arguments.toSet().size + if (expected != found) { + throw AraraException( + CommonUtils.ruleErrorHeader + messages.getMessage( + Messages.ERROR_VALIDATEBODY_DUPLICATE_ARGUMENT_IDENTIFIERS + ) + ) + } + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/ClassLoadingUtils.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/ClassLoadingUtils.kt new file mode 100644 index 0000000000..05a1031a8a --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/ClassLoadingUtils.kt @@ -0,0 +1,121 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.utils + +import java.io.File +import java.lang.reflect.InvocationTargetException +import java.net.MalformedURLException +import java.net.URLClassLoader + +/** + * Implements utilitary methods for classloading and object instantiation. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +object ClassLoadingUtils { + /** + * Indicator of success or failure of class loading. + */ + enum class ClassLoadingStatus { + SUCCESS, + FILE_NOT_FOUND, + MALFORMED_URL, + CLASS_NOT_FOUND, + ILLEGAL_ACCESS, + INSTANTIATION_EXCEPTION + } + + /** + * Loads a class from the provided file, potentially a Java archive. + * @param file File containing the Java bytecode (namely, a JAR). + * @param name The canonical name of the class. + * @return A pair representing the status and the class. + */ + fun loadClass(file: File, name: String): + Pair<ClassLoadingStatus, Class<*>> { + // status and class to be returned, + // it defaults to an object class + var value: Class<*> = Any::class.java + + // if file does not exist, nothing + // can be done, status is changed + val status = if (!file.exists()) { + ClassLoadingStatus.FILE_NOT_FOUND + } else { + // classloading involves defining + // a classloader and fetching the + // desired class from it, based on + // the provided file archive + try { + // creates a new classloader with + // the provided file (potentially + // a JAR file) + val classloader = URLClassLoader(arrayOf(file.toURI().toURL()), + ClassLoadingUtils::class.java.classLoader) + + // fetches the class from the + // instantiated classloader + value = Class.forName(name, true, classloader) + ClassLoadingStatus.SUCCESS + } catch (_: MalformedURLException) { + ClassLoadingStatus.MALFORMED_URL + } catch (_: ClassNotFoundException) { + ClassLoadingStatus.CLASS_NOT_FOUND + } + } + + // return a new pair based on the + // current status and class holder + return status to value + } + + /** + * Loads a class from the provided file, instantiating it. + * @param file File containing the Java bytecode (namely, a JAR). + * @param name The canonical name of the class. + * @return A pair representing the status and the class object. + */ + fun loadObject(file: File, name: String): Pair<ClassLoadingStatus, Any> { + // load the corresponding class + // based on the qualified name + val pair = loadClass(file, name) + + // status and object to be returned, + // it defaults to an object + var status = pair.first + var value = Any() + + // checks if the class actually + // exists, otherwise simply + // ignore instantiation + if (status == ClassLoadingStatus.SUCCESS) { + // object instantiation relies + // on the default constructor + // (without arguments), class + // must implement it + + // OBS: constructors with arguments + // must be invoked through reflection + try { + // get the class reference from + // the pair and instantiate it + // by invoking the default + // constructor (without arguments) + value = pair.second.getDeclaredConstructor().newInstance() + } catch (_: IllegalAccessException) { + status = ClassLoadingStatus.ILLEGAL_ACCESS + } catch (_: InstantiationException) { + // the user wanted to instantiate an abstract class + status = ClassLoadingStatus.INSTANTIATION_EXCEPTION + } catch (_: InvocationTargetException) { + // the underlying constructor caused an exception + status = ClassLoadingStatus.INSTANTIATION_EXCEPTION + } + } + + // return a new pair based on the + // current status and object holder + return status to value + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/CommonUtils.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/CommonUtils.kt new file mode 100644 index 0000000000..6887cd4e84 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/CommonUtils.kt @@ -0,0 +1,422 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.utils + +import java.io.File +import java.io.IOException +import java.util.MissingFormatArgumentException +import java.util.regex.Pattern +import kotlin.math.ln +import kotlin.math.pow +import org.islandoftex.arara.Arara +import org.islandoftex.arara.configuration.AraraSpec +import org.islandoftex.arara.filehandling.FileHandlingUtils +import org.islandoftex.arara.localization.LanguageController +import org.islandoftex.arara.localization.Messages +import org.islandoftex.arara.model.AraraException +import org.islandoftex.arara.ruleset.Argument + +/** + * Implements common utilitary methods. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +object CommonUtils { + // the application messages obtained from the + // language controller + private val messages = LanguageController + + /** + * Gets the list of file types as string, in order. + * + * @return A string representation of the list of file types, in order. + */ + val fileTypesList: String + get() = "[ " + Arara.config[AraraSpec.Execution.fileTypes] + .joinToString(" | ") + " ]" + + /** + * Gets the rule error header, containing the identifier and the path, if + * any. + * + * @return A string representation of the rule error header, containing the + * identifier and the path, if any. + */ + val ruleErrorHeader: String + get() { + return if (Arara.config[AraraSpec.Execution.InfoSpec.ruleId] != null && + Arara.config[AraraSpec.Execution.InfoSpec.rulePath] != null) { + val id = Arara.config[AraraSpec.Execution.InfoSpec.ruleId]!! + val path = Arara.config[AraraSpec.Execution.InfoSpec.rulePath]!! + messages.getMessage( + Messages.ERROR_RULE_IDENTIFIER_AND_PATH, + id, + path + ) + " " + } else { + "" + } + } + + /** + * Gets a list of all rule paths. + * + * @return A list of all rule paths. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + val allRulePaths: List<String> + @Throws(AraraException::class) + get() = Arara.config[AraraSpec.Execution.rulePaths].map { + val location = File(InterpreterUtils.construct(it, "quack")) + FileHandlingUtils.getParentCanonicalPath(location) + } + + /** + * Returns the exit status of the application. + * + * @return An integer representing the exit status of the application. + */ + val exitStatus: Int + get() = Arara.config[AraraSpec.Execution.status] + + /** + * Gets the preamble content, converting a single string into a list of + * strings, based on new lines. + * + * @return A list of strings representing the preamble content. + */ + val preambleContent: List<String> + get() = if (Arara.config[AraraSpec.Execution.preamblesActive]) { + Arara.config[AraraSpec.Execution.preamblesContent] + .split("\n") + .dropLastWhile { it.isEmpty() } + .toList() + } else { + listOf() + } + + /** + * Checks if the input string is equal to a valid boolean value. + * + * @param value The input string. + * @return A boolean value represented by the provided string. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun checkBoolean(value: String): Boolean { + val yes = listOf("yes", "true", "1", "on") + val no = listOf("no", "false", "0", "off") + return if (!yes.union(no).contains(value.toLowerCase())) { + throw AraraException( + messages.getMessage( + Messages.ERROR_CHECKBOOLEAN_NOT_VALID_BOOLEAN, + value + ) + ) + } else { + yes.contains(value.toLowerCase()) + } + } + + /** + * Removes the keyword from the beginning of the provided string. + * + * @param line A string to be analyzed. + * @return The provided string without the keyword. + */ + fun removeKeyword(line: String?): String? { + return if (line == null) null + else removeKeywordNotNull(line) + } + + /** + * Removes the keyword from the beginning of the provided string. + * + * @param line A string to be analyzed. + * @return The provided string without the keyword. + */ + fun removeKeywordNotNull(line: String): String { + var tempLine = line + val pattern = "^(\\s)*<arara>\\s".toPattern() + val matcher = pattern.matcher(tempLine) + if (matcher.find()) { + tempLine = tempLine.substring(matcher.end()) + } + return tempLine.trim() + } + + /** + * Flattens a potential list of lists into a list of objects. + * + * @param list The list to be flattened. + * @return The flattened list. + */ + // TODO: check nullity + fun flatten(list: List<*>): List<Any> { + val result = mutableListOf<Any>() + list.forEach { item -> + if (item is List<*>) + result.addAll(flatten(item)) + else + result.add(item as Any) + } + return result + } + + /** + * Gets a set of strings containing unknown keys from a map and a list. It + * is a set difference from the keys in the map and the entries in the list. + * + * @param parameters The map of parameters. + * @param arguments The list of arguments. + * @return A set of strings representing unknown keys from a map and a list. + */ + fun getUnknownKeys( + parameters: Map<String, Any>, + arguments: List<Argument> + ): Set<String> { + val found = parameters.keys + val expected = arguments.mapNotNull { it.identifier } + return found.subtract(expected) + } + + /** + * Gets a human readable representation of a size. + * + * @param size The byte size to be converted. + * @return A string representation of the size. + */ + @Suppress("MagicNumber") + fun byteSizeToString(size: Long): String { + val language = Arara.config[AraraSpec.Execution.language] + val conversionFactor = 1000.0 + return if (size < conversionFactor) "$size B" + else + (ln(size.toDouble()) / ln(conversionFactor)).toInt().let { exp -> + "%.1f %sB".format(language.locale, + size / conversionFactor.pow(exp.toDouble()), + "kMGTPE"[exp - 1]) + } + } + + /** + * Generates a string based on a list of objects, separating each one of + * them by one space. + * + * @param objects A list of objects. + * @return A string based on the list of objects, separating each one of + * them by one space. Empty values are not considered. + */ + fun generateString(vararg objects: Any): String = objects + .map { it.toString() }.filter { it.isNotEmpty() } + .joinToString(" ") + + /** + * Checks if the file based on the provided extension contains the provided + * regex. + * + * @param extension The file extension. + * @param regex The regex. + * @return A boolean value indicating if the file contains the provided + * regex. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun checkRegex(extension: String, regex: String): Boolean { + val file = File(FileHandlingUtils.getPath(extension)) + return checkRegex(file, regex) + } + + /** + * Checks if the file contains the provided regex. + * + * As we use [File.readText] this should not be called on files > 2GB. + * + * @param file The file. + * @param regex The regex. + * @return A boolean value indicating if the file contains the provided + * regex. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun checkRegex(file: File, regex: String): Boolean { + try { + val text = file.readText() + val pattern = Pattern.compile(regex) + val matcher = pattern.matcher(text) + return matcher.find() + } catch (exception: IOException) { + throw AraraException( + messages.getMessage( + Messages.ERROR_CHECKREGEX_IO_EXCEPTION, + file.name + ), + exception + ) + } + } + + /** + * Replicates a string pattern based on a list of objects, generating a list + * as result. + * + * @param pattern The string pattern. + * @param values The list of objects to be merged with the pattern. + * @return A list containing the string pattern replicated to each object + * from the list. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun replicateList( + pattern: String, + values: List<Any> + ): List<Any> { + return try { + values.map { String.format(pattern, it) } + } catch (exception: MissingFormatArgumentException) { + throw AraraException( + messages.getMessage( + Messages.ERROR_REPLICATELIST_MISSING_FORMAT_ARGUMENTS_EXCEPTION + ), + exception + ) + } + } + + /** + * Checks if the provided operating system string holds according to the + * underlying operating system. + * + * Supported operating systems: + * + * * Windows + * * Linux + * * Mac OS X + * * Unix (Linux || Mac OS) + * * Cygwin + * + * @param value A string representing an operating system. + * @return A boolean value indicating if the provided string refers to the + * underlying operating system. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun checkOS(value: String): Boolean { + fun checkOSProperty(key: String): Boolean = + getSystemPropertyOrNull("os.name") + ?.toLowerCase()?.startsWith(key.toLowerCase()) ?: false + + val values = mutableMapOf<String, Boolean>() + values["windows"] = checkOSProperty("Windows") + values["linux"] = checkOSProperty("Linux") + values["mac"] = checkOSProperty("Mac OS X") + values["unix"] = checkOSProperty("Mac OS X") || + checkOSProperty("Linux") + values["cygwin"] = SystemCallUtils["cygwin"] as Boolean + if (!values.containsKey(value.toLowerCase())) { + throw AraraException( + messages.getMessage( + Messages.ERROR_CHECKOS_INVALID_OPERATING_SYSTEM, + value + ) + ) + } + // will never throw, see check above + return values.getValue(value.toLowerCase()) + } + + /** + * Gets the system property according to the provided key, or resort to the + * fallback value if an exception is thrown or if the key is invalid. + * + * @param key The system property key. + * @param fallback The fallback value. + * @return A string containing the system property value or the fallback. + */ + fun getSystemProperty(key: String, fallback: String): String = + System.getProperties().runCatching { + getOrDefault(key, fallback).toString().takeIf { it != "" } + }.getOrNull() ?: fallback + + /** + * Access a system property. + * + * @param key The key of the property. + * @return The value of the system property or null if there is an + * exception. + */ + fun getSystemPropertyOrNull(key: String): String? = + System.getProperties().runCatching { getValue(key).toString() } + .getOrNull() + + /** + * Generates a list of filenames from the provided command based on a list + * of extensions for each underlying operating system. + * + * @param command A string representing the command. + * @return A list of filenames. + */ + private fun appendExtensions(command: String): List<String> { + // list of extensions, specific for + // each operating system (in fact, it + // is more Windows specific) + val extensions = if (checkOS("windows")) { + // the application is running on + // Windows, so let's look for the + // following extensions in order + + // this list is actually a sublist from + // the original Windows PATHEXT environment + // variable which holds the list of executable + // extensions that Windows supports + listOf(".com", ".exe", ".bat", ".cmd") + } else { + // no Windows, so the default + // extension will be just an + // empty string + listOf("") + } + + // return the resulting list holding the + // filenames generated from the + // provided command + return extensions.map { "$command$it" } + } + + /** + * Checks if the provided command name is reachable from the system path. + * + * @param command A string representing the command. + * @return A logic value. + */ + fun isOnPath(command: String): Boolean { + // first and foremost, let's build the list + // of filenames based on the underlying + // operating system + val filenames = appendExtensions(command) + return kotlin.runCatching { + // break the path into several parts + // based on the path separator symbol + System.getenv("PATH").split(File.pathSeparator) + .asSequence() + .mapNotNull { File(it).listFiles() } + // if the search does not return an empty + // list, one of the filenames got a match, + // and the command is available somewhere + // in the system path + .firstOrNull { + it.any { file -> + filenames.contains(file.name) && !file.isDirectory + } + }?.let { true } + }.getOrNull() ?: false + // otherwise (and in case of an exception) it is not in the path + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/DisplayUtils.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/DisplayUtils.kt new file mode 100644 index 0000000000..213a9a21c3 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/DisplayUtils.kt @@ -0,0 +1,415 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.utils + +import org.islandoftex.arara.Arara +import org.islandoftex.arara.configuration.AraraSpec +import org.islandoftex.arara.configuration.ConfigurationUtils +import org.islandoftex.arara.filehandling.FileHandlingUtils +import org.islandoftex.arara.localization.LanguageController +import org.islandoftex.arara.localization.Messages +import org.islandoftex.arara.model.AraraException +import org.islandoftex.arara.ruleset.Conditional +import org.slf4j.LoggerFactory + +/** + * Implements display utilitary methods. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +object DisplayUtils { + // the application messages obtained from the + // language controller + private val messages = LanguageController + + // get the logger context from a factory + private val logger = LoggerFactory.getLogger(DisplayUtils::class.java) + + /** + * The length of the longest result match as integer. + */ + private val longestMatch: Int = listOf( + messages.getMessage(Messages.INFO_LABEL_ON_SUCCESS), + messages.getMessage(Messages.INFO_LABEL_ON_FAILURE), + messages.getMessage(Messages.INFO_LABEL_ON_ERROR)) + .map { it.length }.max()!! + /** + * If the longest match is longer than the width, then it will be truncated + * to this length. + */ + private const val shortenedLongestMatch = 10 + + /** + * The default terminal width defined in the settings. + */ + private val width: Int + get() = Arara.config[AraraSpec.Application.width] + + /** + * Checks if the execution is in dry-run mode. + */ + private val isDryRunMode: Boolean + get() = Arara.config[AraraSpec.Execution.dryrun] + + /** + * Checks if the execution is in verbose mode. + */ + private val isVerboseMode: Boolean + get() = Arara.config[AraraSpec.Execution.verbose] + + /** + * The application path. + */ + private val applicationPath: String + get() = try { + ConfigurationUtils.applicationPath.toString() + } catch (ae: AraraException) { + "[unknown application path]" + } + + /** + * Displays the short version of the current entry in the terminal. + * + * @param name Rule name. + * @param task Task name. + */ + private fun buildShortEntry(name: String, task: String) { + val result = if (longestMatch >= width) + shortenedLongestMatch + else + longestMatch + val space = width - result - 1 + val line = "($name) $task ".abbreviate(space - "... ".length) + print(line.padEnd(space, '.') + " ") + } + + /** + * Displays the short version of the current entry result in the terminal. + * + * @param value The boolean value to be displayed. + */ + private fun buildShortResult(value: Boolean) { + val result = longestMatch + println(getResult(value).padStart(result)) + } + + /** + * Displays the current entry result in the terminal. + * + * @param value The boolean value to be displayed. + */ + fun printEntryResult(value: Boolean) { + Arara.config[AraraSpec.UserInteraction.displayLine] = false + Arara.config[AraraSpec.UserInteraction.displayResult] = true + Arara.config[AraraSpec.Execution.status] = if (value) 0 else 1 + logger.info( + messages.getMessage( + Messages.LOG_INFO_TASK_RESULT + ) + " " + getResult(value) + ) + if (!isDryRunMode) { + if (!isVerboseMode) { + buildShortResult(value) + } else { + buildLongResult(value) + } + } + } + + /** + * Displays a long version of the current entry result in the terminal. + * + * @param value The boolean value to be displayed + */ + private fun buildLongResult(value: Boolean) { + val width = width + println("\n" + (" " + getResult(value)).padStart(width, '-')) + } + + /** + * Displays the current entry in the terminal. + * + * @param name The rule name. + * @param task The task name. + */ + fun printEntry(name: String, task: String) { + logger.info( + messages.getMessage( + Messages.LOG_INFO_INTERPRET_TASK, + task, + name + ) + ) + Arara.config[AraraSpec.UserInteraction.displayLine] = true + Arara.config[AraraSpec.UserInteraction.displayResult] = false + if (!isDryRunMode) { + if (!isVerboseMode) { + buildShortEntry(name, task) + } else { + buildLongEntry(name, task) + } + } else { + buildDryRunEntry(name, task) + } + } + + /** + * Displays a long version of the current entry in the terminal. + * + * @param name Rule name. + * @param task Task name. + */ + private fun buildLongEntry(name: String, task: String) { + if (Arara.config[AraraSpec.UserInteraction.displayRolling]) { + addNewLine() + } else { + Arara.config[AraraSpec.UserInteraction.displayRolling] = true + } + println(displaySeparator()) + println("($name) $task".abbreviate(width)) + println(displaySeparator()) + } + + /** + * Displays a dry-run version of the current entry in the terminal. + * + * @param name The rule name. + * @param task The task name. + */ + private fun buildDryRunEntry(name: String, task: String) { + if (Arara.config[AraraSpec.UserInteraction.displayRolling]) { + addNewLine() + } else { + Arara.config[AraraSpec.UserInteraction.displayRolling] = true + } + println("[DR] ($name) $task".abbreviate(width)) + println(displaySeparator()) + } + + /** + * Displays the exception in the terminal. + * + * @param exception The exception object. + */ + fun printException(exception: AraraException) { + Arara.config[AraraSpec.UserInteraction.displayException] = true + Arara.config[AraraSpec.Execution.status] = 2 + + val display = Arara.config[AraraSpec.UserInteraction.displayLine] + if (Arara.config[AraraSpec.UserInteraction.displayResult]) + addNewLine() + if (display) { + if (!isDryRunMode) { + if (!isVerboseMode) { + buildShortError() + } else { + buildLongError() + } + addNewLine() + } + } + val text = (if (exception.hasException()) + exception.message + " " + messages.getMessage( + Messages.INFO_DISPLAY_EXCEPTION_MORE_DETAILS) + else + exception.message) ?: "EXCEPTION PROVIDES NO MESSAGE" + // TODO: check null handling + logger.error(text) + wrapText(text) + if (exception.hasException()) { + addNewLine() + displayDetailsLine() + val details = exception.exception!!.message!! + logger.error(details) + wrapText(details) + } + } + + /** + * Gets the string representation of the provided boolean value. + * + * @param value The boolean value. + * @return The string representation. + */ + private fun getResult(value: Boolean): String { + return if (value) + messages.getMessage( + Messages.INFO_LABEL_ON_SUCCESS + ) + else + messages.getMessage(Messages.INFO_LABEL_ON_FAILURE) + } + + /** + * Displays the short version of an error in the terminal. + */ + private fun buildShortError() { + val result = longestMatch + println(messages.getMessage(Messages.INFO_LABEL_ON_ERROR) + .padStart(result)) + } + + /** + * Displays the long version of an error in the terminal. + */ + private fun buildLongError() { + println((" " + messages.getMessage(Messages.INFO_LABEL_ON_ERROR)) + .padStart(width, '-')) + } + + /** + * Displays the provided text wrapped nicely according to the default + * terminal width. + * + * @param text The text to be displayed. + */ + fun wrapText(text: String) = println(text.wrap(width)) + + /** + * Displays the rule authors in the terminal. + * + * @param authors The list of authors. + */ + fun printAuthors(authors: List<String>) { + val line = if (authors.size == 1) + messages.getMessage(Messages.INFO_LABEL_AUTHOR) + else + messages.getMessage(Messages.INFO_LABEL_AUTHORS) + val text = if (authors.isEmpty()) + messages.getMessage(Messages.INFO_LABEL_NO_AUTHORS) + else + authors.joinToString(", ") { it.trim() } + wrapText("$line $text") + } + + /** + * Displays the current conditional in the terminal. + * + * @param conditional The conditional object. + */ + fun printConditional(conditional: Conditional) { + if (conditional.type !== Conditional.ConditionalType.NONE) { + wrapText(messages.getMessage(Messages.INFO_LABEL_CONDITIONAL) + + " (" + conditional.type + ") " + + conditional.condition) + } + } + + /** + * Displays the file information in the terminal. + */ + fun printFileInformation() { + val file = Arara.config[AraraSpec.Execution.reference] + val version = Arara.config[AraraSpec.Application.version] + val line = messages.getMessage( + Messages.INFO_DISPLAY_FILE_INFORMATION, + file.name, + CommonUtils.byteSizeToString(file.length()), + FileHandlingUtils.getLastModifiedInformation(file) + ) + logger.info(messages.getMessage( + Messages.LOG_INFO_WELCOME_MESSAGE, + version + )) + logger.info(displaySeparator()) + logger.debug("::: arara @ $applicationPath") + logger.debug("::: Java %s, %s".format( + CommonUtils.getSystemProperty("java.version", + "[unknown version]"), + CommonUtils.getSystemProperty("java.vendor", + "[unknown vendor]") + )) + logger.debug("::: %s".format( + CommonUtils.getSystemProperty("java.home", + "[unknown location]") + )) + logger.debug("::: %s, %s, %s".format( + CommonUtils.getSystemProperty("os.name", + "[unknown OS name]"), + CommonUtils.getSystemProperty("os.arch", + "[unknown OS arch]"), + CommonUtils.getSystemProperty("os.version", + "[unknown OS version]") + )) + logger.debug("::: user.home @ %s".format( + CommonUtils.getSystemProperty("user.home", + "[unknown user's home directory]") + )) + logger.debug("::: CF @ %s".format(Arara.config[AraraSpec.Execution + .configurationName])) + logger.debug(displaySeparator()) + logger.info(line) + wrapText(line) + addNewLine() + } + + /** + * Displays the elapsed time in the terminal. + * + * @param seconds The elapsed seconds. + */ + fun printTime(seconds: Double) { + val language = Arara.config[AraraSpec.Execution.language] + + if (Arara.config[AraraSpec.UserInteraction.displayTime]) { + if (Arara.config[AraraSpec.UserInteraction.displayLine] || + Arara.config[AraraSpec.UserInteraction.displayException]) + addNewLine() + + val text = messages.getMessage( + Messages.INFO_DISPLAY_EXECUTION_TIME, + "%1.2f".format(language.locale, seconds)) + logger.info(text) + wrapText(text) + } + } + + /** + * Displays the application logo in the terminal. + */ + fun printLogo() { + println(""" + __ _ _ __ __ _ _ __ __ _ + / _` | '__/ _` | '__/ _` | + | (_| | | | (_| | | | (_| | + \__,_|_| \__,_|_| \__,_| + """.trimIndent()) + addNewLine() + } + + /** + * Adds a new line in the terminal. + */ + private fun addNewLine() { + println() + } + + /** + * Displays a line containing details. + */ + private fun displayDetailsLine() { + val line = messages.getMessage( + Messages.INFO_LABEL_ON_DETAILS) + " " + println(line.abbreviate(width).padEnd(width, '-')) + } + + /** + * Gets the output separator with the provided text. + * + * @param message The provided text. + * @return A string containing the output separator with the provided text. + */ + fun displayOutputSeparator(message: String): String { + return " $message ".center(width, '-') + } + + /** + * Gets the line separator. + * + * @return A string containing the line separator. + */ + fun displaySeparator(): String { + return "-".repeat(width) + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/Extensions.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/Extensions.kt new file mode 100644 index 0000000000..10ace0b7f1 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/Extensions.kt @@ -0,0 +1,68 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.utils + +import kotlin.math.ceil + +/** + * Abbreviate a String to a maximal width. + * + * @param maxWidth The maximal width to truncate to. + * @param ellipsis The string to use to indicate an ellipsis. + * @throws IllegalArgumentException If the string would consist only of the + * ellipsis after shortening. + * @return The abbreviated string. + */ +@Throws(IllegalArgumentException::class) +fun String.abbreviate(maxWidth: Int, ellipsis: String = "…"): String { + return when { + maxWidth < ellipsis.length + 1 -> + throw IllegalArgumentException("Can't abbreviate text further") + this.length < maxWidth -> this + else -> this.substring(0, maxWidth - ellipsis.length) + ellipsis + } +} + +/** + * Center a string within a specified number of columns. + * + * This does not center anything if the string is longer than the specified + * width. + * + * @param width The number of columns. + * @param padChar The char to pad with. + * @return The padded string. + */ +fun String.center(width: Int, padChar: Char): String { + return if (this.length > width) this + else { + val charsLeft = width - this.length + padChar.toString().repeat(charsLeft / 2) + this + + padChar.toString().repeat(ceil(charsLeft.toDouble() / 2.0).toInt()) + } +} + +/** + * Wrap text at a specified width. + * + * Algorithm from Wikipedia: + * https://en.wikipedia.org/wiki/Line_wrap_and_word_wrap#Minimum_number_of_lines + * + * @param width The width to wrap at. + * @return Wrapped text. + */ +fun String.wrap(width: Int): String { + val words = this.split(" ") + var wrapped = words[0] + var spaceLeft = width - wrapped.length + words.drop(1).forEach { + val len = it.length + wrapped += if (len + 1 > spaceLeft) { + spaceLeft = width - len + "\n$it" + } else { + spaceLeft -= len + 1 + " $it" + } + } + return wrapped +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/InterpreterUtils.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/InterpreterUtils.kt new file mode 100644 index 0000000000..00313a7714 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/InterpreterUtils.kt @@ -0,0 +1,164 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.utils + +import java.io.ByteArrayOutputStream +import java.io.File +import java.io.IOException +import java.io.OutputStream +import java.util.concurrent.TimeUnit +import java.util.concurrent.TimeoutException +import kotlin.time.Duration +import kotlin.time.ExperimentalTime +import org.islandoftex.arara.Arara +import org.islandoftex.arara.configuration.AraraSpec +import org.islandoftex.arara.localization.LanguageController +import org.islandoftex.arara.localization.Messages +import org.islandoftex.arara.model.AraraException +import org.islandoftex.arara.ruleset.Command +import org.islandoftex.arara.ruleset.Conditional +import org.slf4j.LoggerFactory +import org.zeroturnaround.exec.InvalidExitValueException +import org.zeroturnaround.exec.ProcessExecutor +import org.zeroturnaround.exec.listener.ShutdownHookProcessDestroyer + +/** + * Implements interpreter utilitary methods. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +object InterpreterUtils { + // the application messages obtained from the + // language controller + private val messages = LanguageController + + // get the logger context from a factory + private val logger = LoggerFactory.getLogger(InterpreterUtils::class.java) + + /** + * Checks if the current conditional has a prior evaluation. + * + * @param conditional The current conditional object. + * @return A boolean value indicating if the current conditional has a prior + * evaluation. + */ + fun runPriorEvaluation(conditional: Conditional): Boolean { + return if (Arara.config[AraraSpec.Execution.dryrun]) { + false + } else { + when (conditional.type) { + Conditional.ConditionalType.IF, + Conditional.ConditionalType.WHILE, + Conditional.ConditionalType.UNLESS -> true + else -> false + } + } + } + + @ExperimentalTime + private fun getProcessExecutorForCommand( + command: Command, + buffer: OutputStream + ): + ProcessExecutor { + val timeOutValue = Arara.config[AraraSpec.Execution.timeoutValue] + var executor = ProcessExecutor().command((command).elements) + .directory(command.workingDirectory.absoluteFile) + .addDestroyer(ShutdownHookProcessDestroyer()) + if (Arara.config[AraraSpec.Execution.timeout]) { + if (timeOutValue == Duration.ZERO) { + throw AraraException(messages.getMessage(Messages + .ERROR_RUN_TIMEOUT_INVALID_RANGE)) + } + executor = executor.timeout(timeOutValue.toLongNanoseconds(), + TimeUnit.NANOSECONDS) + } + val tee = if (Arara.config[AraraSpec.Execution.verbose]) { + executor = executor.redirectInput(System.`in`) + TeeOutputStream(System.out, buffer) + } else { + TeeOutputStream(buffer) + } + executor = executor.redirectOutput(tee).redirectError(tee) + return executor + } + + /** + * Runs the command in the underlying operating system. + * + * @param command An object representing the command. + * @return An integer value representing the exit code. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @ExperimentalTime + @Throws(AraraException::class) + fun run(command: Command): Int { + val buffer = ByteArrayOutputStream() + val executor = getProcessExecutorForCommand(command, buffer) + return executor.runCatching { + val exit = execute().exitValue + logger.info(DisplayUtils.displayOutputSeparator( + messages.getMessage(Messages.LOG_INFO_BEGIN_BUFFER))) + logger.info(buffer.toString()) + logger.info(DisplayUtils.displayOutputSeparator( + messages.getMessage(Messages.LOG_INFO_END_BUFFER))) + exit + }.getOrElse { + throw AraraException(messages.getMessage( + when (it) { + is IOException -> Messages.ERROR_RUN_IO_EXCEPTION + is InterruptedException -> + Messages.ERROR_RUN_INTERRUPTED_EXCEPTION + is InvalidExitValueException -> + Messages.ERROR_RUN_INVALID_EXIT_VALUE_EXCEPTION + is TimeoutException -> + Messages.ERROR_RUN_TIMEOUT_EXCEPTION + else -> Messages.ERROR_RUN_GENERIC_EXCEPTION + }), it) + } + } + + /** + * Builds the rule path based on the rule name and returns the corresponding + * file location. + * + * @param name The rule name. + * @return The rule file. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun buildRulePath(name: String): File? { + Arara.config[AraraSpec.Execution.rulePaths].forEach { path -> + val location = File(construct(path, name)) + if (location.exists()) + return location + } + return null + } + + /** + * Constructs the path given the current path and the rule name. + * + * @param path The current path. + * @param name The rule name. + * @return The constructed path. + * @throws AraraException Something wrong happened, to be caught in the + * higher levels. + */ + @Throws(AraraException::class) + fun construct(path: String, name: String): String { + val fileName = "$name.yaml" + val location = File(path) + return if (location.isAbsolute) { + location.resolve(fileName).toString() + } else { + Arara.config[AraraSpec.Execution.workingDirectory] + // first resolve the path (rule path) against the working + // directory, then the rule name we want to resolve + .resolve(path).resolve(fileName).toAbsolutePath().toString() + } + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/LoggingUtils.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/LoggingUtils.kt new file mode 100644 index 0000000000..f9719fa31f --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/LoggingUtils.kt @@ -0,0 +1,70 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.utils + +import ch.qos.logback.classic.LoggerContext +import ch.qos.logback.classic.joran.JoranConfigurator +import ch.qos.logback.core.joran.spi.JoranException +import java.io.InputStream +import org.islandoftex.arara.Arara +import org.islandoftex.arara.configuration.AraraSpec +import org.slf4j.LoggerFactory + +/** + * Implements the logging controller. This class actually sets the logging + * configuration in order to allow appending results to a file. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +object LoggingUtils { + // configuration resource as an input stream + // the configuration is actually a XML file. + private val resource: InputStream by lazy { + LoggingUtils::class.java + .getResourceAsStream("/org/islandoftex/arara/configuration/logback.xml") + } + + /** + * Sets the logging configuration according to the provided boolean value. + * If the value is set to true, the log entries will be appended to a file, + * otherwise the logging feature will keep silent. + * @param enable A boolean value that indicates the logging behaviour + * throughout the application. + */ + fun enableLogging(enable: Boolean) { + // get the logger context from a factory, set a + // new context and reset it + val loggerContext = LoggerFactory.getILoggerFactory() as LoggerContext + + try { + // get a new configuration and set + // the context + val configurator = JoranConfigurator() + configurator.context = loggerContext + loggerContext.reset() + + // if enabled, the log entries will be + // appended to a file, otherwise it will + // remain silent + if (enable) { + // set the file name and configure + // the logging controller to append + // entries to the file + val name = Arara.config[AraraSpec.Execution.logName] + loggerContext.putProperty("name", name) + configurator.doConfigure(resource) + } + } catch (_: JoranException) { + // quack, quack, quack! + } + } + + /** + * Initializes the logging controller by disabling it. I don't want an odd + * behaviour out of the box. + */ + fun init() { + enableLogging(false) + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/MessageUtils.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/MessageUtils.kt new file mode 100644 index 0000000000..ae695c44fb --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/MessageUtils.kt @@ -0,0 +1,266 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.utils + +import javax.swing.JOptionPane +import javax.swing.UIManager +import org.islandoftex.arara.Arara +import org.islandoftex.arara.configuration.AraraSpec + +/** + * Implements utilitary methods for displaying messages. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +object MessageUtils { + // holds the default width for the + // message body, in pixels + private const val WIDTH = 250 + + // let's start the UI manager and set + // the default look and feel to be as + // close as possible to the system + init { + // get the current look and feel + var laf = Arara.config[AraraSpec.UserInteraction.lookAndFeel] + + // check if one is actually set + if (laf != "none") { + // use a special keyword to indicate + // the use of a system look and feel + if (laf == "system") { + laf = UIManager.getSystemLookAndFeelClassName() + } + + // let's try it, in case it fails, + // rely to the default look and feel + try { + // get the system look and feel name + // and try to set it as default + UIManager.setLookAndFeel(laf) + } catch (_: Exception) { + // quack, quack, quack + } + } + } + + /** + * Normalizes the icon type to one of the five available icons. + * @param value An integer value. + * @return The normalized integer value. + */ + @Suppress("MagicNumber") + private fun normalizeIconType(value: Int): Int { + // do the normalization according to the available + // icons in the underlying message implementation + return when (value) { + 1 -> JOptionPane.ERROR_MESSAGE + 2 -> JOptionPane.INFORMATION_MESSAGE + 3 -> JOptionPane.WARNING_MESSAGE + 4 -> JOptionPane.QUESTION_MESSAGE + else -> JOptionPane.PLAIN_MESSAGE + } + } + + /** + * Normalizes the message width, so only valid nonzero values are accepted. + * @param value An integer value corresponding to the message width. + * @return The normalized width. + */ + private fun normalizeMessageWidth(value: Int): Int { + return if (value > 0) value else WIDTH + } + + /** + * Shows the message. + * @param width Integer value, in pixels. + * @param type Type of message. + * @param title Title of the message. + * @param text Text of the message. + */ + fun showMessage( + width: Int, + type: Int, + title: String, + text: String + ) { + // effectively shows the message based + // on the provided parameters + JOptionPane.showMessageDialog(null, + String.format( + "<html><body style=\"width:%dpx\">%s</body></html>", + normalizeMessageWidth(width), + text), + title, + normalizeIconType(type) + ) + } + + /** + * Shows the message. It relies on the default width. + * @param type Type of message. + * @param title Title of the message. + * @param text Text of the message. + */ + fun showMessage(type: Int, title: String, text: String) { + showMessage(WIDTH, type, title, text) + } + + /** + * Shows a message with options presented as an array of buttons. + * @param width Integer value, in pixels. + * @param type Type of message. + * @param title Title of the message. + * @param text Text of the message. + * @param buttons An array of objects to be presented as buttons. + * @return The index of the selected button, starting from 1. + */ + fun showOptions( + width: Int, + type: Int, + title: String, + text: String, + vararg buttons: Any + ): Int { + // returns the index of the selected button, + // zero if nothing is selected + return JOptionPane.showOptionDialog(null, + String.format( + "<html><body style=\"width:%dpx\">%s</body></html>", + normalizeMessageWidth(width), + text), + title, + JOptionPane.DEFAULT_OPTION, + normalizeIconType(type), null, + buttons, + buttons[0] + ) + 1 + } + + /** + * Shows a message with options presented as an array of buttons. It relies + * on the default width. + * @param type Type of message. + * @param title Title of the message. + * @param text Text of the message. + * @param buttons An array of objects to be presented as buttons. + * @return The index of the selected button, starting from 1. + */ + @Suppress("SpreadOperator") + fun showOptions( + type: Int, + title: String, + text: String, + vararg buttons: Any + ): Int { + return showOptions(WIDTH, type, title, text, *buttons) + } + + /** + * Shows a message with a text input. + * @param width Integer value, in pixels. + * @param type Type of message. + * @param title Title of the message. + * @param text Text of the message. + * @return The string representing the input text. + */ + fun showInput( + width: Int, + type: Int, + title: String, + text: String + ): String { + // get the string from the + // input text, if any + val input = JOptionPane.showInputDialog(null, + String.format( + "<html><body style=\"width:%dpx\">%s</body></html>", + normalizeMessageWidth(width), + text), + title, + normalizeIconType(type)) + + // if the input is not null, that is, + // the user actually typed something + // return the trimmed string otherwise + // an empty string + return input?.trim() ?: "" + } + + /** + * Shows a message with a text input. It relies on the default width. + * @param type Type of message. + * @param title Title of the message. + * @param text Text of the message. + * @return The string representing the input text. + */ + fun showInput(type: Int, title: String, text: String): String { + return showInput(WIDTH, type, title, text) + } + + /** + * Shows a message with options presented as a dropdown list of elements. + * @param width Integer value, in pixels. + * @param type Type of message. + * @param title Title of the message. + * @param text Text of the message. + * @param elements An array of objects representing the elements. + * @return The index of the selected element, starting from 1. + */ + fun showDropdown( + width: Int, + type: Int, + title: String, + text: String, + vararg elements: Any + ): Int { + // show the dropdown list and get + // the selected object, if any + val index = JOptionPane.showInputDialog(null, + String.format( + "<html><body style=\"width:%dpx\">%s</body></html>", + normalizeMessageWidth(width), + text), + title, + normalizeIconType(type), null, + elements, + elements[0]) + + // if it's not a null object, let's + // find the corresponding index + if (index != null) { + elements.forEachIndexed { i, value -> + // if the element is found, simply + // return the index plus 1, as zero + // corresponds to no selection at all + if (value == index) { + return i + 1 + } + } + } + + // nothing was selected, + // simply return zero + return 0 + } + + /** + * Shows a message with options presented as a dropdown list of elements. It + * relies on the default width. + * @param type Type of message. + * @param title Title of the message. + * @param text Text of the message. + * @param elements An array of objects representing the elements. + * @return The index of the selected element, starting from 1. + */ + @Suppress("SpreadOperator") + fun showDropdown( + type: Int, + title: String, + text: String, + vararg elements: Any + ): Int { + return showDropdown(WIDTH, type, title, text, *elements) + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/SystemCallUtils.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/SystemCallUtils.kt new file mode 100644 index 0000000000..9b443736a1 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/SystemCallUtils.kt @@ -0,0 +1,105 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.utils + +import org.islandoftex.arara.model.AraraException +import org.islandoftex.arara.ruleset.Command +import org.zeroturnaround.exec.ProcessExecutor + +/** + * Implements a system call controller. + * + * This class wraps a map that holds the result of system specific variables + * not directly available at runtime and makes unsafe calling of system + * commands available to rules. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +object SystemCallUtils { + /** + * When executing a system call goes wrong, this status code is returned. + */ + const val errorExitStatus = -99 + /** + * When executing a system call goes wrong and the caller asked for output, + * this output will be returned. + */ + const val errorCommandOutput = "" + + // the system call map which holds the result of + // system specific variables not directly available + // at runtime; the idea here is to provide wrappers + // to the map getter, so it could be easily manipulated + // create the new map instance to be + // populated on demand + private val map: MutableMap<String, Any> = mutableMapOf() + + // the commands map will allow the system call map being + // populated only on demand, that is, if the key is not + // found, this map will provide the corresponding method + // and update the value + // create the new map of commands and + // add the corresponding system calls + private val commands: MutableMap<String, () -> Any> = mutableMapOf( + "cygwin" to { + // Implements the body of the command. In this particular + // instance, it checks if we are inside a Cygwin environment. + // Returns a boolean value indicating if we are inside a Cygwin + // environment. + + // execute a new system call to 'uname -s', read the output + // as an UTF-8 string, lowercase it and check if it starts + // with the 'cygwin' string; if so, we are inside Cygwin + executeSystemCommand(Command("uname", "-s")) + .second.toLowerCase().startsWith("cygwin") + }) + + /** + * Gets the object indexed by the provided key. This method actually holds + * the map method of the very same name. + * + * @param key The provided map key. + * @return The object indexed by the provided map key. + */ + @Throws(NoSuchElementException::class, AraraException::class) + operator fun get(key: String): Any { + // if key is not found, meaning that + // the value wasn't required before + if (!map.containsKey(key)) { + if (commands.containsKey(key)) + // perform the system call and + // populate the corresponding value + map[key] = commands[key]!!.invoke() + else + throw AraraException("The requested key could not be " + + "translated into a command to get the call value.") + } + + // simply return the corresponding + // value based on the provided key + return map.getValue(key) + } + + /** + * Executes a system command from the underlying operating system and + * returns a pair containing the exit status and the command output as a + * string. + * @param command The system command to be executed. + * @return A pair containing the exit status and the system command output + * as a string. + */ + fun executeSystemCommand(command: Command): Pair<Int, String> { + return ProcessExecutor(command.elements).runCatching { + directory(command.workingDirectory) + readOutput(true) + execute().run { + exitValue to outputUTF8() + } + }.getOrElse { + // quack, quack, do nothing, just + // return a default error code + errorExitStatus to errorCommandOutput + } + } +} diff --git a/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/TeeOutputStream.kt b/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/TeeOutputStream.kt new file mode 100644 index 0000000000..dee15176f2 --- /dev/null +++ b/support/arara/source/src/main/kotlin/org/islandoftex/arara/utils/TeeOutputStream.kt @@ -0,0 +1,66 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.utils + +import java.io.IOException +import java.io.OutputStream + +/** + * Implements a stream splitter. + * + * @author Island of TeX + * @version 5.0 + * @since 4.0 + */ +class TeeOutputStream( + /** + * The array of output streams holds every output stream that will be + * written to. + */ + vararg outputStreams: OutputStream +) : OutputStream() { + /** + * An array of streams in which an object of this class will split data. + */ + private val streams: List<OutputStream> = outputStreams.toList() + + /** + * Writes the provided integer to each stream. + * + * @param b The provided integer + * @throws IOException An IO exception. + */ + @Throws(IOException::class) + override fun write(b: Int) = streams.forEach { it.write(b) } + + /** + * Writes the provided byte array to each stream, with the provided offset + * and length. + * + * @param b The byte array. + * @param offset The offset. + * @param length The length. + * @throws IOException An IO exception. + */ + @Throws(IOException::class) + override fun write(b: ByteArray, offset: Int, length: Int) = + streams.forEach { it.write(b, offset, length) } + + /** + * Flushes every stream. + * + * @throws IOException An IO exception. + */ + @Throws(IOException::class) + override fun flush() = streams.forEach { it.flush() } + + /** + * Closes every stream silently. + */ + override fun close() = streams.forEach { + try { + it.close() + } catch (ignored: IOException) { + // do nothing on purpose + } + } +} diff --git a/support/arara/source/src/main/resources/com/github/cereda/arara/configuration/logback.xml b/support/arara/source/src/main/resources/org/islandoftex/arara/configuration/logback.xml index 93e5e14cea..03572873eb 100644 --- a/support/arara/source/src/main/resources/com/github/cereda/arara/configuration/logback.xml +++ b/support/arara/source/src/main/resources/org/islandoftex/arara/configuration/logback.xml @@ -34,19 +34,19 @@ <configuration> - <appender name="FILE" class="ch.qos.logback.core.FileAppender"> - <file>${name}.log</file> - <append>false</append> - <encoder> - <charset>UTF-8</charset> - <pattern>%date{dd MMM yyyy HH:mm:ss.SSS} %-5level - %msg%n</pattern> - </encoder> - </appender> + <appender name="FILE" class="ch.qos.logback.core.FileAppender"> + <file>${name}.log</file> + <append>false</append> + <encoder> + <charset>UTF-8</charset> + <pattern>%date{dd MMM yyyy HH:mm:ss.SSS} %-5level - %msg%n</pattern> + </encoder> + </appender> + + <logger name="org.zeroturnaround.exec" level="OFF"/> + + <root level="ALL"> + <appender-ref ref="FILE"/> + </root> - <logger name="org.zeroturnaround.exec" level="OFF" /> - - <root level="ALL"> - <appender-ref ref="FILE" /> - </root> - </configuration>
\ No newline at end of file diff --git a/support/arara/source/src/main/resources/org/islandoftex/arara/configuration/release-notes b/support/arara/source/src/main/resources/org/islandoftex/arara/configuration/release-notes new file mode 100644 index 0000000000..002c277ecd --- /dev/null +++ b/support/arara/source/src/main/resources/org/islandoftex/arara/configuration/release-notes @@ -0,0 +1,5 @@ +* Introduced working directory support. +* Reorganized code base for more speed. +* Removed triggers and introduced session namespaces. +* Removed the velocity templating language and several outdated methods. +* Removed string-based commands (return "command";). diff --git a/support/arara/source/src/main/resources/com/github/cereda/arara/localization/messages.properties b/support/arara/source/src/main/resources/org/islandoftex/arara/localization/messages.properties index dd1972fd5c..f802f04b0d 100644 --- a/support/arara/source/src/main/resources/com/github/cereda/arara/localization/messages.properties +++ b/support/arara/source/src/main/resources/org/islandoftex/arara/localization/messages.properties @@ -34,15 +34,12 @@ # Language: English # Translators: Paulo Roberto Massa Cereda # --------------------------------------------------------------------- - ERROR_BASENAME_NOT_A_FILE=The ''basename'' method requires a file, not a directory. It looks like ''{0}'' does not appear to be a file at all. If you need to perform tasks on a directory, you could use a couple of methods from the Java API. ERROR_CALCULATEHASH_IO_EXCEPTION=For whatever reason, I could not calculate the hash. I have no idea why it failed, though. Perhaps the file was moved or deleted before or during the hashing operation. Or maybe I do not have the proper permissions to read the file. ERROR_CHECKBOOLEAN_NOT_VALID_BOOLEAN=It looks like ''{0}'' is not a valid boolean value. This should be an easy fix. Make sure to use a valid string that represents boolean values (yes and no, true and false, 1 and 0, and on and off). ERROR_CHECKOS_INVALID_OPERATING_SYSTEM=I could not check your operating system. The provided value ''{0}'' does not look like a valid operating system entry in my list (I might also be wrong, of course). Please correct the value and try again. ERROR_CHECKREGEX_IO_EXCEPTION=I could not read the contents of the file ''{0}'', I got an IO error. I have no idea why it failed, though. Perhaps the file was moved or deleted before or during the reading operation. Or maybe I do not have the proper permissions to read the file. -ERROR_CONFIGURATION_FILETYPE_MISSING_EXTENSION=One of your entries in the 'filetypes' list in the configuration file has no 'extension'. Sadly, I cannot apply a new filetype if the extension is not set. This should be an easy fix: add a new extension and try again. ERROR_CONFIGURATION_GENERIC_ERROR=I could not parse the configuration file, something bad happened. This part is quite tricky, since it involves aspects of the underlying data serialization format. I will do my best to help you in any way I can. -ERROR_CONFIGURATION_INVALID_YAML=I could not parse the configuration file, something bad happened. Apparently, the provided YAML file is invalid. I will do my best to help you in any way I can. ERROR_CONFIGURATION_LOOPS_INVALID_RANGE=The value defined in the 'loops' key in the configuration file in order to denote the maximum number of loops has an invalid range. Please make sure to use a positive long value. ERROR_DISCOVERFILE_FILE_NOT_FOUND=I could not find the provided file ''{0}'' {1}. Please make sure the file exists and it has a valid extension. ERROR_EVALUATE_COMPILATION_FAILED=For whatever reason, I could not compile the expression in the provided conditional. This part is quite tricky, since it involves aspects of the underlying expression language. I will do my best to help you in any way I can. @@ -52,27 +49,20 @@ ERROR_FILETYPE_NOT_A_FILE=The ''filetype'' method requires a file, not a directo ERROR_FILETYPE_UNKNOWN_EXTENSION=I cannot recognize ''{0}'' as a default extension. If you want to define a new file type, make sure to provide the extension and pattern. These are the default extensions: {1} ERROR_GETAPPLICATIONPATH_ENCODING_EXCEPTION=There was an encoding problem while trying to obtain the application path. There is nothing much I can do about it. ERROR_GETCANONICALFILE_IO_EXCEPTION=I could not get the canonical file due to an IO error. I have no idea why it failed, though. Perhaps the file was moved or deleted before or during the lookup operation. Or maybe I do not have the proper permissions. -ERROR_GETCANONICALPATH_IO_EXCEPTION=I could not get the canonical path due to an IO error. I have no idea why it failed, though. Perhaps the file was moved or deleted before or during the lookup operation. Or maybe I do not have the proper permissions. ERROR_GETPARENTCANONICALPATH_IO_EXCEPTION=I could not get the parent canonical path due to an IO error. I have no idea why it failed, though. Perhaps the file was moved or deleted before or during the hashing operation. Or maybe I do not have the proper permissions. ERROR_INTERPRETER_ARGUMENT_IS_REQUIRED=It seems that ''{0}'' is marked as required in the rule, but I could not find it in the directive parameters. Please make sure to add it as parameter for your directive and try again. ERROR_INTERPRETER_COMMAND_RUNTIME_ERROR=I could not evaluate one of the provided commands. This part is quite tricky, since it involves aspects of the underlying expression language. I will do my best to help you in any way I can. ERROR_INTERPRETER_DEFAULT_VALUE_RUNTIME_ERROR=I could not evaluate the default value expression of one of the arguments. This part is quite tricky, since it involves aspects of the underlying expression language. I will do my best to help you in any way I can. ERROR_INTERPRETER_EXIT_RUNTIME_ERROR=I could not evaluate the exit status expression of one of the provided commands. This part is quite tricky, since it involves aspects of the underlying expression language. I will do my best to help you in any way I can. ERROR_INTERPRETER_FLAG_RUNTIME_EXCEPTION=I could not evaluate the flag expression of one of the arguments. This part is quite tricky, since it involves aspects of the underlying expression language. I will do my best to help you in any way I can. -ERROR_INTERPRETER_NULL_COMMAND=I am sorry, but apparently one of the provided commands resolved to a null value. Please make sure the command is valid and try again. ERROR_INTERPRETER_RULE_NOT_FOUND=I could not find a rule named ''{0}'' in the provided rule paths. Perhaps a misspelled word? I was looking for a file named ''{0}.yaml'' in the following paths in order of priority: {1} ERROR_INTERPRETER_UNKNOWN_KEYS=I found these unknown keys in the directive: {0}. This should be an easy fix, just remove them from your map. ERROR_INTERPRETER_WRONG_EXIT_CLOSURE_RETURN=The 'exit' expression must always return a boolean value (even if there is no computation in the closure body). This should be an easy fix: make sure to correct the type return statement and try again. ERROR_ISSUBDIRECTORY_NOT_A_DIRECTORY=The ''isSubdirectory'' method requires a directory, not a file. It looks like ''{0}'' does not appear to be a directory at all. ERROR_LANGUAGE_INVALID_CODE=The provided language code is invalid. Currently, I know how to speak the following languages: {0} -ERROR_LOAD_COULD_NOT_LOAD_XML=I could not load the XML database named ''{0}''. I have no idea why it failed, though. Perhaps the file was moved or deleted before or during the reading operation. Or maybe I do not have the proper permissions to read the file. By the way, make sure the XML file is well-formed. +ERROR_LOAD_COULD_NOT_LOAD_XML=I could not load the YAML database named ''{0}''. I have no idea why it failed, though. Perhaps the file was moved or deleted before or during the reading operation. Or maybe I do not have the proper permissions to read the file. By the way, make sure the YAML file is well-formed. ERROR_PARSER_INVALID_PREAMBLE=I am sorry, but the preamble ''{0}'' could not be found. Please make sure this key exists in the configuration file. -ERROR_PARSER_LOOPS_INVALID_RANGE=The value defined in the command line for the maximum number of loops has an invalid range. Please make sure to use a positive long value. -ERROR_PARSER_LOOPS_NAN=The maximum number of loops option expects a number as argument. This should be an easy fix. Just make sure to provide a positive long value. -ERROR_PARSER_TIMEOUT_INVALID_RANGE=The value defined in the command line for the execution timeout has an invalid range. Please make sure to use a positive long value. -ERROR_PARSER_TIMEOUT_NAN=The execution timeout option expects a number as argument. This should be an easy fix. Just make sure to provide a positive long value. ERROR_PARSERULE_GENERIC_ERROR=I could not parse the rule, something bad happened. This part is quite tricky, since it involves aspects of the underlying data serialization format. I will do my best to help you in any way I can. -ERROR_PARSERULE_INVALID_YAML=I could not parse the rule, something bad happened. Apparently, the provided YAML file is invalid. I will do my best to help you in any way I can. ERROR_REPLICATELIST_MISSING_FORMAT_ARGUMENTS_EXCEPTION=I could not replicate the list due to a missing format argument. My guess is that there are less (or more) parameters than expected. Make sure to correct the number of parameters and try again. ERROR_RULE_IDENTIFIER_AND_PATH=I have spotted an error in rule ''{0}'' located at ''{1}''. ERROR_RUN_GENERIC_EXCEPTION=I could not run the provided system command, something bad happened. This part is quite tricky, since it involves aspects of the underlying expression language. I will do my best to help you in any way I can. @@ -81,13 +71,10 @@ ERROR_RUN_INVALID_EXIT_VALUE_EXCEPTION=The provided system command execution has ERROR_RUN_IO_EXCEPTION=The system command execution has failed due to an IO error. Are you sure the provided system command exists in your path? It might be a good idea to check the path and see if the command is available. ERROR_RUN_TIMEOUT_EXCEPTION=The system command execution reached the provided timeout value and was aborted. If the time was way too short, make sure to provide a longer value. ERROR_RUN_TIMEOUT_INVALID_RANGE=The timeout value is probably missing (although timeout is enabled). This should be an easy fix. Please make sure to provide a positive long value. -ERROR_SAVE_COULD_NOT_SAVE_XML=I could not save the XML database named ''{0}''. I have no idea why it failed, though. Perhaps I do not have the proper permissions to write the XML file to disk. -ERROR_SESSION_OBTAIN_UNKNOWN_KEY=The ''obtain'' method has found an unknown key ''{0}'' in the session scope. I could not get something I do not have in the first place. Please enter a valid key and try again. +ERROR_SAVE_COULD_NOT_SAVE_XML=I could not save the YAML database named ''{0}''. I have no idea why it failed, though. Perhaps I do not have the proper permissions to write the YAML file to disk. +ERROR_SESSION_OBTAIN_UNKNOWN_KEY=The ''get'' method has found an unknown key ''{0}'' in the session scope. I could not get something I do not have in the first place. Please enter a valid key and try again. ERROR_SESSION_REMOVE_UNKNOWN_KEY=The ''remove'' method has found an unknown key ''{0}'' in the session scope. I could not remove something I do not have in the first place. Please enter a valid key and try again. -ERROR_TRIGGER_ACTION_NOT_FOUND=The trigger action ''{0}'' was not found. Make sure to take a look at the list of all available triggers and try again. -ERROR_TRIGGER_CALL_EXCEPTION=The trigger action ''{0}'' could not be called. Something really bad happened. ERROR_VALIDATE_EMPTY_FILES_LIST=I read a directive {0} and found out that the provided ''files'' list is empty. This is an easy fix: make sure the list has at least one element and try again. -ERROR_VALIDATE_FILE_IS_RESERVED=I read a directive {0} and found out that the key ''file'' was used. This key is reserved, so you cannot use it. But do not worry, this should be an easy fix. Just replace it by another name. ERROR_VALIDATE_FILES_IS_NOT_A_LIST=I read a directive {0} and found out that ''files'' requires a list. Please make sure to correct the type to a proper list and try again. ERROR_VALIDATE_INVALID_DIRECTIVE_FORMAT=I spotted an invalid directive {0} in the provided file. Make sure to fix the directive and try again. ERROR_VALIDATE_NO_DIRECTIVES_FOUND=It looks like no directives were found in the provided file. Make sure to include at least one directive and try again. @@ -95,26 +82,18 @@ ERROR_VALIDATE_ORPHAN_LINEBREAK=Apparently there is an orphan directive line bre ERROR_VALIDATE_REFERENCE_IS_RESERVED=I read a directive {0} and found out that the key ''reference'' was used. This key is reserved, so you cannot use it. But do not worry, this should be an easy fix. Just replace it by another name. ERROR_VALIDATE_YAML_EXCEPTION=There was a problem with the provided YAML map in a directive {0}. This part is quite tricky, since it involves aspects of the underlying data serialization format. ERROR_VALIDATEBODY_ARGUMENT_ID_IS_RESERVED=The argument identifier ''{0}'' is reserved, so you cannot use it. This should be an easy fix. Just replace it by another name. -ERROR_VALIDATEBODY_ARGUMENTS_LIST=I could not find the list of arguments. I need such list, even if it is empty. Make sure to fix this issue and try again. ERROR_VALIDATEBODY_DUPLICATE_ARGUMENT_IDENTIFIERS=Apparently you have duplicate argument identifiers in your rule. Make sure to fix this issue and try again. ERROR_VALIDATEBODY_MISSING_KEYS=When defining a rule argument scope, at least 'flag' or 'default' must be used. Please, make sure to use at least one of them. ERROR_VALIDATEBODY_NULL_ARGUMENT_ID=I found out that one of the arguments has no identifier. Please, make sure to add a valid identifier to the argument and try again. ERROR_VALIDATEBODY_NULL_COMMAND=I found a null command in the provided rule. This should be an easy fix. Make sure to add a valid command to the rule. -ERROR_VALIDATEBODY_NULL_COMMANDS_LIST=I need a list of commands. Make sure to fix this issue and try again. ERROR_VALIDATEHEADER_NULL_ID=The provided rule has no identifier. This is a crucial information, please make sure to fix this issue and try again. Make sure the identifier has the same name of the rule file (without the extension, of course). ERROR_VALIDATEHEADER_NULL_NAME=The provided rule has no name. This should be an easy fix. Make sure to add a valid name and try again. ERROR_VALIDATEHEADER_WRONG_IDENTIFIER=The rule has a wrong identifier. I was expecting ''{0}'', but found ''{1}''. This should be an easy fix: just replace the wrong identifier by the correct one. -ERROR_VELOCITY_FILE_NOT_FOUND=The template engine was not able to find the provided input file. Make sure the location is correct and try again. -ERROR_VELOCITY_PARSE_EXCEPTION=There was a parse error in the provided input file. Make sure the file complies with the Velocity Template Language (VTL) specification and try again. -ERROR_VELOCITY_METHOD_INVOCATION_EXCEPTION=There was a method invocation error in the provided input file. Make sure the file complies with the Velocity Template Language (VTL) specification and try again. -ERROR_VELOCITY_IO_EXCEPTION=The template engine was not able to write the output file. Make sure the path has the proper permissions and try again. INFO_DISPLAY_EXCEPTION_MORE_DETAILS=There are more details available on this exception: INFO_DISPLAY_EXECUTION_TIME=Total: {0} seconds INFO_DISPLAY_FILE_INFORMATION=Processing ''{0}'' (size: {1}, last modified: {2}), please wait. INFO_INTERPRETER_DRYRUN_MODE_BOOLEAN_MODE=Although executing in dry-run mode, this entry might be already processed since it returned a boolean value: {0} INFO_INTERPRETER_DRYRUN_MODE_SYSTEM_COMMAND=About to run: {0} -INFO_INTERPRETER_DRYRUN_MODE_TRIGGER_MODE=Although executing in dry-run mode, this entry is always processed since it is a trigger. Note that the effects of a trigger might influence the current execution. -INFO_INTERPRETER_VERBOSE_MODE_TRIGGER_MODE=This entry is a trigger originated from the rule scope. Note that the effects of a trigger might influence the current execution. INFO_LABEL_AUTHOR=Author: INFO_LABEL_AUTHORS=Authors: INFO_LABEL_CONDITIONAL=Conditional: @@ -124,19 +103,7 @@ INFO_LABEL_ON_ERROR=ERROR INFO_LABEL_ON_FAILURE=FAILURE INFO_LABEL_ON_SUCCESS=SUCCESS INFO_LABEL_UNNAMED_TASK=Unnamed task -INFO_PARSER_ALL_RIGHTS_RESERVED=All rights reserved -INFO_PARSER_DRYRUN_MODE_DESCRIPTION=go through all the motions of running a command, but with no actual calls -INFO_PARSER_HELP_DESCRIPTION=print the help message -INFO_PARSER_LANGUAGE_DESCRIPTION=set the application language -INFO_PARSER_LOG_DESCRIPTION=generate a log output -INFO_PARSER_LOOPS_DESCRIPTION=set the maximum number of loops -INFO_PARSER_NOTES=This tool makes use of the following libraries and their respective licenses: CAL10N: MIT, Commons CLI: Apache 2.0, Commons Collections: Apache 2.0, Commons IO: Apache 2.0, Commons Lang: Apache 2.0, MVEL: Apache 2.0, Logback: dual licensing with EPL 1.0 and LGPL 2.1, Simple framework: Apache 2.0, SLF4J: MIT, SnakeYAML: Apache 2.0, Velocity: Apache 2.0, and ZT-Exec: Apache 2.0. At last but not least, arara itself is released under the New BSD license. -INFO_PARSER_ONLY_HEADER=extract directives only in the file header -INFO_PARSER_PREAMBLE_DESCRIPTION=set the file preamble based on the configuration file -INFO_PARSER_SILENT_MODE_DESCRIPTION=hide the command output -INFO_PARSER_TIMEOUT_DESCRIPTION=set the execution timeout (in milliseconds) -INFO_PARSER_VERBOSE_MODE_DESCRIPTION=print the command output -INFO_PARSER_VERSION_DESCRIPTION=print the application version +INFO_PARSER_NOTES=arara is released under the New BSD license. LOG_INFO_BEGIN_BUFFER=BEGIN OUTPUT BUFFER LOG_INFO_BOOLEAN_MODE=Boolean value: {0} LOG_INFO_DIRECTIVES_BLOCK=DIRECTIVES @@ -149,4 +116,4 @@ LOG_INFO_RULE_LOCATION=Rule location: ''{0}'' LOG_INFO_SYSTEM_COMMAND=System command: {0} LOG_INFO_TASK_RESULT=Task result: LOG_INFO_VALIDATED_DIRECTIVES=All directives were validated. We are good to go. -LOG_INFO_WELCOME_MESSAGE=Welcome to arara {0} (revision {1})! +LOG_INFO_WELCOME_MESSAGE=Welcome to arara {0}! diff --git a/support/arara/source/src/main/resources/com/github/cereda/arara/localization/messages_de.properties b/support/arara/source/src/main/resources/org/islandoftex/arara/localization/messages_de.properties index eb8bb41fd6..e0edb70443 100644 --- a/support/arara/source/src/main/resources/com/github/cereda/arara/localization/messages_de.properties +++ b/support/arara/source/src/main/resources/org/islandoftex/arara/localization/messages_de.properties @@ -34,87 +34,66 @@ # Language: German # Translators: Marco Daniel # --------------------------------------------------------------------- - ERROR_BASENAME_NOT_A_FILE=Die Methode des ''Dateinamens'' (''basename'') benötigt eine Datei und kein Verzeichnis. Es scheint, als sei ''{0}'' keine Datei. Falls du Aufgaben auf ein Verzeichnis bzw. Ordner anwenden willst, kannst du eine Vielzahl von JAVA API-Methoden verwenden. ERROR_CALCULATEHASH_IO_EXCEPTION=Aus was für einem Grund auch immer kann ich die Prüfziffer (checksum) nicht berechnen. Ich habe keine Idee, warum es fehlschlägt. Vielleicht wurde die Datei bevor oder während der Prüfziffer-Operation bewegt oder gelöscht. Möglicherweise habe ich nicht die geeigneten Rechte, um die Datei zu lesen. ERROR_CHECKBOOLEAN_NOT_VALID_BOOLEAN=Es scheint, als sei ''{0}'' kein logischer Ausdruck (boolean value). Das sollte leicht zu beheben sein. Stelle sicher, dass der Eingabestring ein zugelassener logischer Ausdruck ist (''yes'' oder ''no'', ''true'' oder ''false'', ''1'' oder ''0'' sowie ''on'' oder ''off''). ERROR_CHECKOS_INVALID_OPERATING_SYSTEM=Ich konnte dein Betriebssystem nicht überprüfen. Der ermittelte Wert ''{0}'' sieht nicht wie ein gültiges Betriebssystem in meiner Liste aus. (Ich kann natürlich auch falsch liegen.) Bitte korrigiere den Wert und versuche es erneut. ERROR_CHECKREGEX_IO_EXCEPTION=Ich konnte den Inhalt der Datei ''{0}'' nicht lesen. Ich erhielt einen IO-Fehler. Ich habe keine Idee für die Fehlerursache, obwohl?. Vielleicht wurde die Datei bevor oder während des Leseprozesses bewegt oder gelöscht. Möglicherweise habe ich nicht die geeigneten Rechte, um die Datei zu lesen. -ERROR_CONFIGURATION_FILETYPE_MISSING_EXTENSION=In der Konfigurationsdatei hat einer deiner Einträge in der Liste für Dateitypen 'filetypes' keine Dateiendung 'extension'. Leider kann ich keinen neuen Dateitypen anwenden, wenn die Dateiendung nicht gesetzt ist. Dies sollte leicht zu beheben sein: Ergänze die neue Dateiendung und versuche es erneut. ERROR_CONFIGURATION_GENERIC_ERROR=Ich konnte die Konfigurationsdatei nicht analysieren, etwas schlechtes passierte. Dieser Teil ist ziemlich knifflig, denn er bezieht das zugrundeliegende Datenserialisierungsformat mit ein. Ich werde mein Bestes tun, um dir in jeglicher Art und Weise zu helfen. -ERROR_CONFIGURATION_INVALID_YAML=Ich konnte die Konfigurationsdatei nicht analysieren. etwas schlechtes passierte. Anscheinend ist die bereitgestellte YAML-Datei ungültig. Ich werde mein Bestes tun, um dir in jeglicher Art und Weise zu helfen. ERROR_CONFIGURATION_LOOPS_INVALID_RANGE=In der Konfigurationsdatei hat der eingegebenen Wert 'loops' zur Festlegung der maximalen Anzahl an Schleifendurchgängen einen ungültigen Bereich. Bitte stelle sicher, dass eine positive Zahl eingetragen wird. ERROR_DISCOVERFILE_FILE_NOT_FOUND=Ich konnte die vorausgesetzte Datei ''{0}'' {1} nicht finden. Bitte stelle sicher, dass die Datei existiert und eine gültige Dateiendung hat. ERROR_EVALUATE_COMPILATION_FAILED=Aus was für einen Grund auch immer kann ich den Ausdruck in der bereitgestellten Bedingung nicht kompilieren. Dieser Teil ist ziemlich knifflig, denn er bezieht die zugrundeliegende Sprache mit ein. Ich werde mein Bestes tun, um dir in jeglicher Art und Weise zu helfen. -ERROR_EVALUATE_NOT_BOOLEAN_VALUE=Die Auswertung der Bedingung (conditional) hat einen boolschen Ausdruck als Ergebnis erwartet. Das sollte leicht zu beheben sein. Stelle einfach sicher, dass die Bedingung einen booleschen Ausdruck ('yes' oder 'no', 'true' oder 'false', '1' oder '0' sowie 'on' oder 'off') als Ergebnis erhält. +ERROR_EVALUATE_NOT_BOOLEAN_VALUE=Die Auswertung der Bedingung (conditional) hat einen boolschen Ausdruck als Ergebnis erwartet. Das sollte leicht zu beheben sein. Stelle einfach sicher, dass die Bedingung einen booleschen Ausdruck ('yes' oder 'no', 'true' oder 'false', '1' oder '0' sowie 'on' oder 'off') als Ergebnis erhält. ERROR_EXTRACTOR_IO_ERROR=Es gab einen IO-Fehler während ich versuchte, die Direktive zu extrahieren. Ich habe keine Idee, warum es fehlschlug. Vielleicht wurde die Datei bevor oder während der Prüfziffer-Operation bewegt oder gelöscht. Möglicherweise habe ich nicht die geeigneten Rechte, um die Datei zu lesen. ERROR_FILETYPE_NOT_A_FILE=Die Methode der Dateitypen ''filetype'' fordert als Eingabe eine Datei und kein Verzeichnis. Es scheint, als sei ''{0}'' keine Datei. Falls du Aufgaben auf ein Verzeichnis bzw. Ordner anwenden willst, kannst du eine Vielzahl von JAVA API-Methoden verwenden. ERROR_FILETYPE_UNKNOWN_EXTENSION=Ich kann ''{0}'' als keine vorgegebene Dateiendung erkennen. Falls du einen neuen Dateitypen definieren möchtest, stelle sich, dass die Dateiendung sowie die entsprechende Struktur bereitgestellt wird. Das sind die vordefinierten Dateiendungen: {1} ERROR_GETAPPLICATIONPATH_ENCODING_EXCEPTION=Es gab ein Kodierungsproblem während ich versuchte den Anwendungspfad zu erhalten. Es gibt leider nicht viel, was ich tun kann. ERROR_GETCANONICALFILE_IO_EXCEPTION=Ich konnte die vorschriftsmäßige Datei auf Grund eines IO-Fehlers nicht bekommen. Ich habe keine Idee für die Fehlerursache, obwohl?. Vielleicht wurde die Datei bevor oder während des Suchvorganges bewegt oder gelöscht. Möglicherweise habe ich nicht die geeigneten Rechte, um die Datei zu lesen. -ERROR_GETCANONICALPATH_IO_EXCEPTION=Ich konnte den vorschriftsmäßigen Pfad auf Grund eines IO-Fehlers nicht bekommen. Ich habe keine Idee für die Fehlerursache, obwohl?. Vielleicht wurde die Datei bevor oder während des Suchvorganges bewegt oder gelöscht. Möglicherweise habe ich nicht die geeigneten Rechte, um die Datei zu lesen. ERROR_GETPARENTCANONICALPATH_IO_EXCEPTION=Ich konnte den vorschriftsmäßigen Elternpfad auf Grund eines IO-Fehlers nicht bekommen. Ich habe keine Idee für die Fehlerursache, obwohl?. Vielleicht wurde die Datei bevor oder während der Prüfziffer-Operation bewegt oder gelöscht. Möglicherweise habe ich nicht die geeigneten Rechte, um die Datei zu lesen. ERROR_INTERPRETER_ARGUMENT_IS_REQUIRED=Es scheint, als sei ''{0}'' eine geforderte Eingabe in der Regel, aber ich kann sie in den Eingabeparametern nicht finden. Bitte stelle sicher, dass der Parameter in deiner Direktive ergänzt wird und versuche es erneut. ERROR_INTERPRETER_COMMAND_RUNTIME_ERROR=Ich konnte eines der genutzten Kommandos nicht auswerten. Dieser Teil ist ziemlich knifflig, denn er bezieht Aspekte der zugrundeliegenden Sprache mit ein. Ich werde mein Bestes tun, um dir in jeglicher Art und Weise zu helfen. ERROR_INTERPRETER_DEFAULT_VALUE_RUNTIME_ERROR=Ich konnte den Standardwert eines Argumentes nicht auswerten. Dieser Teil ist ziemlich knifflig, denn er bezieht Aspekte der zugrundeliegenden Sprache mit ein. Ich werde mein Bestes tun, um dir in jeglicher Art und Weise zu helfen. ERROR_INTERPRETER_EXIT_RUNTIME_ERROR=Ich kann den Status der Fertigmeldung (exit status) von einer der genutzten Anweisungen nicht auswerten. Dieser Teil ist ziemlich knifflig, denn er bezieht Aspekte der zugrundeliegenden Sprache mit ein. Ich werde mein Bestes tun, um dir in jeglicher Art und Weise zu helfen. ERROR_INTERPRETER_FLAG_RUNTIME_EXCEPTION=Ich kann den Statusindikator (flag expression) eines Argumentes nicht auswerten. Dieser Teil ist ziemlich knifflig, denn er bezieht Aspekte der zugrundeliegenden Sprache mit ein. Ich werde mein Bestes tun, um dir in jeglicher Art und Weise zu helfen. -ERROR_INTERPRETER_NULL_COMMAND=Es tut mir leid, aber eine der genutzten Anweisungen gibt einen Nullwert zurück. Bitte stelle sicher, dass die Anweisung gültig ist und versuche es erneut. ERROR_INTERPRETER_RULE_NOT_FOUND=Ich konnte keine Regel mit dem Namen ''{0}'' in den hinterlegten Regelverzeichnissen finden. Vielleicht ein falsch geschriebenes Wort? Ich habe nach dem Dateinamen ''{0}.yaml'' in den nachstehenden Verzeichnissen mit entsprechender Priorität gesucht: {1} ERROR_INTERPRETER_UNKNOWN_KEYS=Ich habe folgende unbekannte Keys in der Direktive gefunden: {0}. Das sollte leicht zu beheben sein, entferne sie einfach. ERROR_INTERPRETER_WRONG_EXIT_CLOSURE_RETURN=Der Ausdruck 'exit' muss immer einen logischen Wert (boolean value) zurückgeben (sogar wenn es keine Berechnung in der Prozedur gibt). Das sollte leicht zu beheben sein: Stelle einen korrekten Rückgabewert sicher und versuche es erneut. ERROR_ISSUBDIRECTORY_NOT_A_DIRECTORY=Die ''isSubdirectory'' Methode erwartet als Argument einen Ordner, nicht eine Datei. ''{0}'' scheint kein Ordner zu sein. ERROR_LANGUAGE_INVALID_CODE=Der bereitgestellte Sprachauswahlcode ist ungültig. Derzeit kann ich folgende Sprachen sprechen: {0} -ERROR_LOAD_COULD_NOT_LOAD_XML=Ich konnte die XML-Datenbank mit dem Namen ''{0}'' nicht laden. Ich habe keine Idee für die Fehlerursache, obwohl? Vielleicht wurde die Datei bevor oder während der Leseoperation bewegt oder gelöscht. Möglicherweise habe ich nicht die geeigneten Rechte, um die Datei zu lesen. +ERROR_LOAD_COULD_NOT_LOAD_XML=Ich konnte die YAML-Datenbank mit dem Namen ''{0}'' nicht laden. Ich habe keine Idee für die Fehlerursache, obwohl? Vielleicht wurde die Datei bevor oder während der Leseoperation bewegt oder gelöscht. Möglicherweise habe ich nicht die geeigneten Rechte, um die Datei zu lesen. ERROR_PARSER_INVALID_PREAMBLE=Leider konnte die Präambel ''{0}'' nicht gefunden werden. Bitte stelle sicher, dass dieser Schlüssel in der Konfigurationsdatei existiert. -ERROR_PARSER_LOOPS_INVALID_RANGE=Bei der Anweisungseingabe hat der Wert für die maximale Anzahl an Schleifendurchgängen einen ungültigen Wert. Bitte stelle sicher, dass eine positive Zahl eingetragen wird. -ERROR_PARSER_LOOPS_NAN=Die maximale Anzahl an Schleifendurchgängen erwartet eine Zahl als Argument. Das sollte leicht zu beheben sein. Bitte stelle sicher, dass eine positive Zahl eingetragen wird. -ERROR_PARSER_TIMEOUT_INVALID_RANGE=Bei der Anweisungseingabe hat der Wert für die Ausführungszeit einen ungültigen Wert. Bitte stelle sicher, dass eine positive Zahl (long) eingetragen wird. -ERROR_PARSER_TIMEOUT_NAN=Die Option für die Zeitbeschränkung 'timeout' erwartet eine Zahl als Argument. Das sollte leicht zu beheben sein. Bitte stelle sicher, dass eine positive Zahl eingetragen wird. ERROR_PARSERULE_GENERIC_ERROR=Ich konnte die Regel nicht auswerten, etwas schlechtes passierte. Dieser Teil ist ziemlich knifflig, denn er bezieht Aspekte der zugrundeliegenden Serialisierung mit ein. Ich werde mein Bestes tun, um dir in jeglicher Art und Weise zu helfen. -ERROR_PARSERULE_INVALID_YAML=Ich konnte die Regel nicht auswerten, etwas schlechtes passierte. Anscheinend ist die bereitgestellte YAML-Datei ungültig. Ich werde mein Bestes tun, um dir in jeglicher Art und Weise zu helfen. -ERROR_REPLICATELIST_MISSING_FORMAT_ARGUMENTS_EXCEPTION=Ich konnte die Liste auf Grund eines fehlendes Formatargumentes nicht replizieren. Meine Vermutung ist, dass es weniger (oder mehr) Parameter als erwartet gibt. Stelle sicher, dass die korrekte Anzahl an Parametern übergeben wird und versuche es erneut. +ERROR_REPLICATELIST_MISSING_FORMAT_ARGUMENTS_EXCEPTION=Ich konnte die Liste auf Grund eines fehlendes Formatargumentes nicht replizieren. Meine Vermutung ist, dass es weniger (oder mehr) Parameter als erwartet gibt. Stelle sicher, dass die korrekte Anzahl an Parametern übergeben wird und versuche es erneut. ERROR_RULE_IDENTIFIER_AND_PATH=Ich habe einen Fehler in der Regel ''{0}'' an der Stellte ''{1}'' entdeckt. ERROR_RUN_GENERIC_EXCEPTION=Ich konnte das geforderte Systemkommando nicht ausführen, etwas schlechtes passierte. Dieser Teil ist ziemlich knifflig, denn er bezieht Aspekte der zugrundeliegenden Sprache mit ein. Ich werde mein Bestes tun, um dir in jeglicher Art und Weise zu helfen. -ERROR_RUN_INTERRUPTED_EXCEPTION=Das aufgerufene Systemkommando ist plötzlich unterbrochen worden. Vielleicht gab es eine externe Unterbrechung, die das Kommando abrupt zur Beendigung zwang. -ERROR_RUN_INVALID_EXIT_VALUE_EXCEPTION=Das aufgerufene Systemkommando hat einen ungültigen Abschluss gemeldet. +ERROR_RUN_INTERRUPTED_EXCEPTION=Das aufgerufene Systemkommando ist plötzlich unterbrochen worden. Vielleicht gab es eine externe Unterbrechung, die das Kommando abrupt zur Beendigung zwang. +ERROR_RUN_INVALID_EXIT_VALUE_EXCEPTION=Das aufgerufene Systemkommando hat einen ungültigen Abschluss gemeldet. ERROR_RUN_IO_EXCEPTION=Der Aufruf des Systemkommandos misslang auf Grund eines IO-Fehlers. Bist du dir sicher, dass das Systemkommando in deinem Pfad existiert? Es sollte eine gute Idee sein, die Systempfade sowie die Verfügbarkeit des Kommandos zu prüfen. -ERROR_RUN_TIMEOUT_EXCEPTION=Die Ausführung des Systemkommandos hat die Zeitbegrenzung erreicht und wurde abgebrochen. Falls die Zeit etwas zu kurz war, kannst du diese erhöhen. +ERROR_RUN_TIMEOUT_EXCEPTION=Die Ausführung des Systemkommandos hat die Zeitbegrenzung erreicht und wurde abgebrochen. Falls die Zeit etwas zu kurz war, kannst du diese erhöhen. ERROR_RUN_TIMEOUT_INVALID_RANGE=Der Wert für die Zeitbegrenzung ('timeout') fehlt vermutlich (obwohl die Zeitbegrenzung aktiviert ist). Das sollte leicht zu beheben sein. Bitte stelle sicher, dass eine positive Zahl eingetragen wird. -ERROR_SAVE_COULD_NOT_SAVE_XML=Ich konnte die XML-Datenbank mit dem Namen ''{0}'' nicht speichern. Ich habe keine Idee für die Fehlerursache, obwohl? Möglicherweise habe ich nicht die geeigneten Rechte, um die Datei XML-Datei auf der Festplatte zu speichern. -ERROR_SESSION_OBTAIN_UNKNOWN_KEY=Die ''obtain'' Methode hat den unbekannten Eintrag (key) ''{0}'' in der Session gefunden. Ich konnte nichts erhalten, was ich nicht bereits habe. Bitte gebe einen gültigen Key ein und versuche es erneut. +ERROR_SAVE_COULD_NOT_SAVE_XML=Ich konnte die YAML-Datenbank mit dem Namen ''{0}'' nicht speichern. Ich habe keine Idee für die Fehlerursache, obwohl? Möglicherweise habe ich nicht die geeigneten Rechte, um die Datei YAML-Datei auf der Festplatte zu speichern. +ERROR_SESSION_OBTAIN_UNKNOWN_KEY=Die ''get'' Methode hat den unbekannten Eintrag (key) ''{0}'' in der Session gefunden. Ich konnte nichts erhalten, was ich nicht bereits habe. Bitte gebe einen gültigen Key ein und versuche es erneut. ERROR_SESSION_REMOVE_UNKNOWN_KEY=Die ''remove'' Methode hat den unbekannten Eintrag (key) ''{0}'' in der Session gefunden. Ich konnte nichts erhalten, was ich nicht bereits habe. Bitte gebe einen gültigen Key ein und versuche es erneut. -ERROR_TRIGGER_ACTION_NOT_FOUND=Die Aktion des Triggers ''{0}'' wurde nicht gefunden. Stelle bitte sicher, dass du einen Blick auf die Liste der verfügbaren Trigger wirfst und versuche es erneut. -ERROR_TRIGGER_CALL_EXCEPTION=Die Aktion des Triggers ''{0}'' konnte nicht aufgerufen werden. Etwas wirklich schlechtes ist passiert. ERROR_VALIDATE_EMPTY_FILES_LIST=Ich habe die Direktive {0} gelesen und fand heraus, dass die bereitgestellte Dateienliste leer ist. Das sollte leicht zu beheben sein. Bitte stelle sicher, dass die Liste mindestens ein Element hat und versuche es erneut. -ERROR_VALIDATE_FILE_IS_RESERVED=Ich habe die Direktive {0} gelesen und fand heraus, dass der Key ''file'' genutzt wurde. Dieser Key ist reserviert, deshalb kannst du ihn nicht nutzen. Aber keine Sorge, dass sollte leicht zu beheben sein. Du musst nur einen anderen Namen verwenden. -ERROR_VALIDATE_FILES_IS_NOT_A_LIST=Ich habe die Direktive {0} gelesen und fand heraus, dass der Eintrag ''files'' keine Liste übergeben bekommen hat. Bitte stelle sicher, dass du eine passende Liste verwendest und versuche es erneut. +ERROR_VALIDATE_FILES_IS_NOT_A_LIST=Ich habe die Direktive {0} gelesen und fand heraus, dass der Eintrag ''files'' keine Liste übergeben bekommen hat. Bitte stelle sicher, dass du eine passende Liste verwendest und versuche es erneut. ERROR_VALIDATE_INVALID_DIRECTIVE_FORMAT=Ich entdecke eine ungültige Direktive namens {0} in der bereitgestellten Datei. Stellte sicher, dass die Direktive gültig ist und versuche es erneut. ERROR_VALIDATE_NO_DIRECTIVES_FOUND=Es sieht so aus, als wurden keine Direktiven in der bereitgestellten Datei gefunden. Bitte stelle sicher, dass wenigstens eine Direktive enthalten ist und versuche es erneut. -ERROR_VALIDATE_ORPHAN_LINEBREAK=Anscheinend gibt es einen verwaisten Zeilenumbruch in der Direktive in der Zeile {0}. Ich kann nicht fortfahren. Bitte korrigiere die Direktive und versuche es erneut. +ERROR_VALIDATE_ORPHAN_LINEBREAK=Anscheinend gibt es einen verwaisten Zeilenumbruch in der Direktive in der Zeile {0}. Ich kann nicht fortfahren. Bitte korrigiere die Direktive und versuche es erneut. ERROR_VALIDATE_REFERENCE_IS_RESERVED=Ich las die Direktive {0} und fand heraus, dass der Key ''reference'' genutzt wurde. Dieser Key ist reserviert, deshalb kannst du ihn nicht nutzen. Aber keine Sorge, das sollte einfach zu beheben sein. Du musst nur einen anderen Namen verwenden. ERROR_VALIDATE_YAML_EXCEPTION=Es gab ein Problem mit dem bereitgestellten YAML-Ausdruck in der Direktive {0}. Dieser Teil ist ziemlich knifflig, denn er bezieht Aspekte der zugrundeliegenden Serialisierung mit ein. ERROR_VALIDATEBODY_ARGUMENT_ID_IS_RESERVED=Die Argumentenbezeichnung ''{0}'' ist reserviert, somit kannst du sie nicht nutzen. Dies sollte einfach zu beheben sein. Du musst nur einen anderen Namen verwenden. -ERROR_VALIDATEBODY_ARGUMENTS_LIST=Ich konnte die Liste der Argumente nicht finden. Ich benötige eine solche Liste, sogar wenn diese leer ist. Bitte behebe diesen Fehler und versuche es erneut. ERROR_VALIDATEBODY_DUPLICATE_ARGUMENT_IDENTIFIERS=Anscheinend hast du Duplikate von Bezeichnern in deiner Regel. Bitte behebe diesen Fehler und versuche es erneut. ERROR_VALIDATEBODY_MISSING_KEYS=Wenn du ein Argument einer Regel definierst, musst du mindestens 'flag' oder 'default' nutzen. Stelle bitte sicher, dass du mindestens eines nutzt. ERROR_VALIDATEBODY_NULL_ARGUMENT_ID=Ich habe herausgefunden, dass eines der Argumente keinen Bezeichner hat. Bitte ergänze einen gültigen Bezeichner im Argument und versuche es erneut. ERROR_VALIDATEBODY_NULL_COMMAND=Ich habe eine Nullanweisung in der vorgegebenen Regel gefunden. Bitte stelle sicher, dass ein gültiges Kommando zur Regel hinzugefügt wird. -ERROR_VALIDATEBODY_NULL_COMMANDS_LIST=Ich benötige eine Liste von Kommandos. Bitte behebe diesen Zustand und versuche es erneut. -ERROR_VALIDATEHEADER_NULL_ID=Die geforderte Regel hat keinen Bezeichner. Das ist eine wesentliche Information, bitte stelle sicher, dass du dies behebst und versuche es erneut. Beachte hierbei, dass der Bezeichner identisch zum Dateinamen (ohne Dateiendung natürlich) sein muss. -ERROR_VALIDATEHEADER_NULL_NAME=Die gewünschte Regel hat keinen Namen. Das sollte leicht zu beheben sein. Ergänze einen gültigen Namen und versuche es erneut. +ERROR_VALIDATEHEADER_NULL_ID=Die geforderte Regel hat keinen Bezeichner. Das ist eine wesentliche Information, bitte stelle sicher, dass du dies behebst und versuche es erneut. Beachte hierbei, dass der Bezeichner identisch zum Dateinamen (ohne Dateiendung natürlich) sein muss. +ERROR_VALIDATEHEADER_NULL_NAME=Die gewünschte Regel hat keinen Namen. Das sollte leicht zu beheben sein. Ergänze einen gültigen Namen und versuche es erneut. ERROR_VALIDATEHEADER_WRONG_IDENTIFIER=Die Regel hat einen falschen Bezeichner. Ich erwartete ''{0}'' fand aber ''{1}''. Das solle leicht zu beheben sein: Ersetze einfach den falschen durch einen korrekten Bezeichner. -ERROR_VELOCITY_FILE_NOT_FOUND=Die Template-Engine konnte die angegebene Eingabe-Datei nicht finden. Bitte stelle sicher, dass der Pfad korrekt ist, und versuche es noch einmal. -ERROR_VELOCITY_PARSE_EXCEPTION=Es gab einen Lesefehler beim Verarbeiten der angegebenen Eingabe-Datei. Stelle sicher, dass sie die Spezifikationen der Velocity Template Language (VTL) erfüllt und versuche es noch einmal. -ERROR_VELOCITY_METHOD_INVOCATION_EXCEPTION=Es gibt einen fehlerhaften Metheodenaufruf in der angegebenen Eingabe-Datei. Stelle sicher, dass sie die Spezifikationen der Velocity Template Language (VTL) erfüllt und versuche es noch einmal. -ERROR_VELOCITY_IO_EXCEPTION=Die Template-Engine konnte die Ausgabe-Datei nicht schreiben. Stelle sicher, dass sie die nötigen Berechtigungen hat, und versuche es noch einmal. INFO_DISPLAY_EXCEPTION_MORE_DETAILS=Es sind mehr Details für diese Ausnahme verfügbar. INFO_DISPLAY_EXECUTION_TIME=Gesamt: {0} Sekunden INFO_DISPLAY_FILE_INFORMATION=Verarbeitung ''{0}'' (Größe: {1}, letzte Modifikation: {2}), bitte warten. INFO_INTERPRETER_DRYRUN_MODE_BOOLEAN_MODE=Trotz dry-run Modus wurde dieser Eintrag wahrscheinlich bereits verarbeitet, da er den boolschen Wert {0} zurückgegeben hat. INFO_INTERPRETER_DRYRUN_MODE_SYSTEM_COMMAND=Los geht''s: {0} -INFO_INTERPRETER_DRYRUN_MODE_TRIGGER_MODE=Obwohl du im 'dry-run-mode' ausführst, wird der Eintrag immer verarbeitet, da es einen Trigger ist. Beachte, dass der Effekt eines Triggers die aktuelle Ausführung beeinflussen kann. -INFO_INTERPRETER_VERBOSE_MODE_TRIGGER_MODE=Dieser Eintrag ist ein Trigger, welcher aus dem Regelumfeld entstand. Beachte, dass der Effekt eines Triggers die aktuelle Ausführung beeinflussen kann. INFO_LABEL_AUTHOR=Autor: INFO_LABEL_AUTHORS=Autoren: INFO_LABEL_CONDITIONAL=Bedingung: @@ -124,19 +103,7 @@ INFO_LABEL_ON_ERROR=FEHLER INFO_LABEL_ON_FAILURE=MISSERFOLG INFO_LABEL_ON_SUCCESS=ERFOLGREICH INFO_LABEL_UNNAMED_TASK=Namenlose Aufgabe -INFO_PARSER_ALL_RIGHTS_RESERVED=Alle Rechte vorbehalten. -INFO_PARSER_DRYRUN_MODE_DESCRIPTION=Tue so, als ob du durch alle Anweisungen gehst, aber mit keinem aktuellen Aufruf. -INFO_PARSER_HELP_DESCRIPTION=Gebe die Hilfe aus -INFO_PARSER_LANGUAGE_DESCRIPTION=Setze die Anwendungssprache -INFO_PARSER_LOG_DESCRIPTION=Erstelle einen log-Output -INFO_PARSER_LOOPS_DESCRIPTION=Setze die maximale Anzahl an Schleifendurchgängen -INFO_PARSER_NOTES=Dieses Tool nutzt die folgenden Bibliotheken und deren jeweilge Lizenz: CAL10N: MIT, Commons CLI: Apache 2.0, Commons Collections: Apache 2.0, Commons IO: Apache 2.0, Commons Lang: Apache 2.0, MVEL: Apache 2.0, Logback: dual licensing with EPL 1.0 and LGPL 2.1, Simple framework: Apache 2.0, SLF4J: MIT, SnakeYAML: Apache 2.0, Velocity: Apache 2.0, and ZT-Exec: Apache 2.0. Zu guter Letzt, arara selbst ist veröffentlicht nach der New BSD license. -INFO_PARSER_ONLY_HEADER=Extrahiere Direktiven nur im Datei-Kopf -INFO_PARSER_PREAMBLE_DESCRIPTION=Setze die Datei-Präambel basierend auf der Konfigurationsdatei -INFO_PARSER_SILENT_MODE_DESCRIPTION=Unterdrückt die Befehlsausgabe -INFO_PARSER_TIMEOUT_DESCRIPTION=Setze die Zeitabschaltung für die Ausführung (in Millisekunden). -INFO_PARSER_VERBOSE_MODE_DESCRIPTION=Gibt zusätzliche Statusinformationen aus -INFO_PARSER_VERSION_DESCRIPTION=Gebe die Anwendungsversion aus +INFO_PARSER_NOTES=arara ist unter der New BSD license veröffentlicht. LOG_INFO_BEGIN_BUFFER=BEGIN OUTPUT BUFFER LOG_INFO_BOOLEAN_MODE=Boolscher Wert: {0} LOG_INFO_DIRECTIVES_BLOCK=DIREKTIVEN @@ -149,4 +116,4 @@ LOG_INFO_RULE_LOCATION=Verzeichnis der Regel: ''{0}'' LOG_INFO_SYSTEM_COMMAND=Systemkommando: {0} LOG_INFO_TASK_RESULT=Resultat der Aufgabe: LOG_INFO_VALIDATED_DIRECTIVES=Alle Direktiven sind gültig. Wir sind guter Dinge. -LOG_INFO_WELCOME_MESSAGE=Willkommen bei arara {0} (Revision {1})! +LOG_INFO_WELCOME_MESSAGE=Willkommen bei arara {0}! diff --git a/support/arara/source/src/main/resources/com/github/cereda/arara/localization/messages_en.properties b/support/arara/source/src/main/resources/org/islandoftex/arara/localization/messages_en.properties index dd1972fd5c..f802f04b0d 100644 --- a/support/arara/source/src/main/resources/com/github/cereda/arara/localization/messages_en.properties +++ b/support/arara/source/src/main/resources/org/islandoftex/arara/localization/messages_en.properties @@ -34,15 +34,12 @@ # Language: English # Translators: Paulo Roberto Massa Cereda # --------------------------------------------------------------------- - ERROR_BASENAME_NOT_A_FILE=The ''basename'' method requires a file, not a directory. It looks like ''{0}'' does not appear to be a file at all. If you need to perform tasks on a directory, you could use a couple of methods from the Java API. ERROR_CALCULATEHASH_IO_EXCEPTION=For whatever reason, I could not calculate the hash. I have no idea why it failed, though. Perhaps the file was moved or deleted before or during the hashing operation. Or maybe I do not have the proper permissions to read the file. ERROR_CHECKBOOLEAN_NOT_VALID_BOOLEAN=It looks like ''{0}'' is not a valid boolean value. This should be an easy fix. Make sure to use a valid string that represents boolean values (yes and no, true and false, 1 and 0, and on and off). ERROR_CHECKOS_INVALID_OPERATING_SYSTEM=I could not check your operating system. The provided value ''{0}'' does not look like a valid operating system entry in my list (I might also be wrong, of course). Please correct the value and try again. ERROR_CHECKREGEX_IO_EXCEPTION=I could not read the contents of the file ''{0}'', I got an IO error. I have no idea why it failed, though. Perhaps the file was moved or deleted before or during the reading operation. Or maybe I do not have the proper permissions to read the file. -ERROR_CONFIGURATION_FILETYPE_MISSING_EXTENSION=One of your entries in the 'filetypes' list in the configuration file has no 'extension'. Sadly, I cannot apply a new filetype if the extension is not set. This should be an easy fix: add a new extension and try again. ERROR_CONFIGURATION_GENERIC_ERROR=I could not parse the configuration file, something bad happened. This part is quite tricky, since it involves aspects of the underlying data serialization format. I will do my best to help you in any way I can. -ERROR_CONFIGURATION_INVALID_YAML=I could not parse the configuration file, something bad happened. Apparently, the provided YAML file is invalid. I will do my best to help you in any way I can. ERROR_CONFIGURATION_LOOPS_INVALID_RANGE=The value defined in the 'loops' key in the configuration file in order to denote the maximum number of loops has an invalid range. Please make sure to use a positive long value. ERROR_DISCOVERFILE_FILE_NOT_FOUND=I could not find the provided file ''{0}'' {1}. Please make sure the file exists and it has a valid extension. ERROR_EVALUATE_COMPILATION_FAILED=For whatever reason, I could not compile the expression in the provided conditional. This part is quite tricky, since it involves aspects of the underlying expression language. I will do my best to help you in any way I can. @@ -52,27 +49,20 @@ ERROR_FILETYPE_NOT_A_FILE=The ''filetype'' method requires a file, not a directo ERROR_FILETYPE_UNKNOWN_EXTENSION=I cannot recognize ''{0}'' as a default extension. If you want to define a new file type, make sure to provide the extension and pattern. These are the default extensions: {1} ERROR_GETAPPLICATIONPATH_ENCODING_EXCEPTION=There was an encoding problem while trying to obtain the application path. There is nothing much I can do about it. ERROR_GETCANONICALFILE_IO_EXCEPTION=I could not get the canonical file due to an IO error. I have no idea why it failed, though. Perhaps the file was moved or deleted before or during the lookup operation. Or maybe I do not have the proper permissions. -ERROR_GETCANONICALPATH_IO_EXCEPTION=I could not get the canonical path due to an IO error. I have no idea why it failed, though. Perhaps the file was moved or deleted before or during the lookup operation. Or maybe I do not have the proper permissions. ERROR_GETPARENTCANONICALPATH_IO_EXCEPTION=I could not get the parent canonical path due to an IO error. I have no idea why it failed, though. Perhaps the file was moved or deleted before or during the hashing operation. Or maybe I do not have the proper permissions. ERROR_INTERPRETER_ARGUMENT_IS_REQUIRED=It seems that ''{0}'' is marked as required in the rule, but I could not find it in the directive parameters. Please make sure to add it as parameter for your directive and try again. ERROR_INTERPRETER_COMMAND_RUNTIME_ERROR=I could not evaluate one of the provided commands. This part is quite tricky, since it involves aspects of the underlying expression language. I will do my best to help you in any way I can. ERROR_INTERPRETER_DEFAULT_VALUE_RUNTIME_ERROR=I could not evaluate the default value expression of one of the arguments. This part is quite tricky, since it involves aspects of the underlying expression language. I will do my best to help you in any way I can. ERROR_INTERPRETER_EXIT_RUNTIME_ERROR=I could not evaluate the exit status expression of one of the provided commands. This part is quite tricky, since it involves aspects of the underlying expression language. I will do my best to help you in any way I can. ERROR_INTERPRETER_FLAG_RUNTIME_EXCEPTION=I could not evaluate the flag expression of one of the arguments. This part is quite tricky, since it involves aspects of the underlying expression language. I will do my best to help you in any way I can. -ERROR_INTERPRETER_NULL_COMMAND=I am sorry, but apparently one of the provided commands resolved to a null value. Please make sure the command is valid and try again. ERROR_INTERPRETER_RULE_NOT_FOUND=I could not find a rule named ''{0}'' in the provided rule paths. Perhaps a misspelled word? I was looking for a file named ''{0}.yaml'' in the following paths in order of priority: {1} ERROR_INTERPRETER_UNKNOWN_KEYS=I found these unknown keys in the directive: {0}. This should be an easy fix, just remove them from your map. ERROR_INTERPRETER_WRONG_EXIT_CLOSURE_RETURN=The 'exit' expression must always return a boolean value (even if there is no computation in the closure body). This should be an easy fix: make sure to correct the type return statement and try again. ERROR_ISSUBDIRECTORY_NOT_A_DIRECTORY=The ''isSubdirectory'' method requires a directory, not a file. It looks like ''{0}'' does not appear to be a directory at all. ERROR_LANGUAGE_INVALID_CODE=The provided language code is invalid. Currently, I know how to speak the following languages: {0} -ERROR_LOAD_COULD_NOT_LOAD_XML=I could not load the XML database named ''{0}''. I have no idea why it failed, though. Perhaps the file was moved or deleted before or during the reading operation. Or maybe I do not have the proper permissions to read the file. By the way, make sure the XML file is well-formed. +ERROR_LOAD_COULD_NOT_LOAD_XML=I could not load the YAML database named ''{0}''. I have no idea why it failed, though. Perhaps the file was moved or deleted before or during the reading operation. Or maybe I do not have the proper permissions to read the file. By the way, make sure the YAML file is well-formed. ERROR_PARSER_INVALID_PREAMBLE=I am sorry, but the preamble ''{0}'' could not be found. Please make sure this key exists in the configuration file. -ERROR_PARSER_LOOPS_INVALID_RANGE=The value defined in the command line for the maximum number of loops has an invalid range. Please make sure to use a positive long value. -ERROR_PARSER_LOOPS_NAN=The maximum number of loops option expects a number as argument. This should be an easy fix. Just make sure to provide a positive long value. -ERROR_PARSER_TIMEOUT_INVALID_RANGE=The value defined in the command line for the execution timeout has an invalid range. Please make sure to use a positive long value. -ERROR_PARSER_TIMEOUT_NAN=The execution timeout option expects a number as argument. This should be an easy fix. Just make sure to provide a positive long value. ERROR_PARSERULE_GENERIC_ERROR=I could not parse the rule, something bad happened. This part is quite tricky, since it involves aspects of the underlying data serialization format. I will do my best to help you in any way I can. -ERROR_PARSERULE_INVALID_YAML=I could not parse the rule, something bad happened. Apparently, the provided YAML file is invalid. I will do my best to help you in any way I can. ERROR_REPLICATELIST_MISSING_FORMAT_ARGUMENTS_EXCEPTION=I could not replicate the list due to a missing format argument. My guess is that there are less (or more) parameters than expected. Make sure to correct the number of parameters and try again. ERROR_RULE_IDENTIFIER_AND_PATH=I have spotted an error in rule ''{0}'' located at ''{1}''. ERROR_RUN_GENERIC_EXCEPTION=I could not run the provided system command, something bad happened. This part is quite tricky, since it involves aspects of the underlying expression language. I will do my best to help you in any way I can. @@ -81,13 +71,10 @@ ERROR_RUN_INVALID_EXIT_VALUE_EXCEPTION=The provided system command execution has ERROR_RUN_IO_EXCEPTION=The system command execution has failed due to an IO error. Are you sure the provided system command exists in your path? It might be a good idea to check the path and see if the command is available. ERROR_RUN_TIMEOUT_EXCEPTION=The system command execution reached the provided timeout value and was aborted. If the time was way too short, make sure to provide a longer value. ERROR_RUN_TIMEOUT_INVALID_RANGE=The timeout value is probably missing (although timeout is enabled). This should be an easy fix. Please make sure to provide a positive long value. -ERROR_SAVE_COULD_NOT_SAVE_XML=I could not save the XML database named ''{0}''. I have no idea why it failed, though. Perhaps I do not have the proper permissions to write the XML file to disk. -ERROR_SESSION_OBTAIN_UNKNOWN_KEY=The ''obtain'' method has found an unknown key ''{0}'' in the session scope. I could not get something I do not have in the first place. Please enter a valid key and try again. +ERROR_SAVE_COULD_NOT_SAVE_XML=I could not save the YAML database named ''{0}''. I have no idea why it failed, though. Perhaps I do not have the proper permissions to write the YAML file to disk. +ERROR_SESSION_OBTAIN_UNKNOWN_KEY=The ''get'' method has found an unknown key ''{0}'' in the session scope. I could not get something I do not have in the first place. Please enter a valid key and try again. ERROR_SESSION_REMOVE_UNKNOWN_KEY=The ''remove'' method has found an unknown key ''{0}'' in the session scope. I could not remove something I do not have in the first place. Please enter a valid key and try again. -ERROR_TRIGGER_ACTION_NOT_FOUND=The trigger action ''{0}'' was not found. Make sure to take a look at the list of all available triggers and try again. -ERROR_TRIGGER_CALL_EXCEPTION=The trigger action ''{0}'' could not be called. Something really bad happened. ERROR_VALIDATE_EMPTY_FILES_LIST=I read a directive {0} and found out that the provided ''files'' list is empty. This is an easy fix: make sure the list has at least one element and try again. -ERROR_VALIDATE_FILE_IS_RESERVED=I read a directive {0} and found out that the key ''file'' was used. This key is reserved, so you cannot use it. But do not worry, this should be an easy fix. Just replace it by another name. ERROR_VALIDATE_FILES_IS_NOT_A_LIST=I read a directive {0} and found out that ''files'' requires a list. Please make sure to correct the type to a proper list and try again. ERROR_VALIDATE_INVALID_DIRECTIVE_FORMAT=I spotted an invalid directive {0} in the provided file. Make sure to fix the directive and try again. ERROR_VALIDATE_NO_DIRECTIVES_FOUND=It looks like no directives were found in the provided file. Make sure to include at least one directive and try again. @@ -95,26 +82,18 @@ ERROR_VALIDATE_ORPHAN_LINEBREAK=Apparently there is an orphan directive line bre ERROR_VALIDATE_REFERENCE_IS_RESERVED=I read a directive {0} and found out that the key ''reference'' was used. This key is reserved, so you cannot use it. But do not worry, this should be an easy fix. Just replace it by another name. ERROR_VALIDATE_YAML_EXCEPTION=There was a problem with the provided YAML map in a directive {0}. This part is quite tricky, since it involves aspects of the underlying data serialization format. ERROR_VALIDATEBODY_ARGUMENT_ID_IS_RESERVED=The argument identifier ''{0}'' is reserved, so you cannot use it. This should be an easy fix. Just replace it by another name. -ERROR_VALIDATEBODY_ARGUMENTS_LIST=I could not find the list of arguments. I need such list, even if it is empty. Make sure to fix this issue and try again. ERROR_VALIDATEBODY_DUPLICATE_ARGUMENT_IDENTIFIERS=Apparently you have duplicate argument identifiers in your rule. Make sure to fix this issue and try again. ERROR_VALIDATEBODY_MISSING_KEYS=When defining a rule argument scope, at least 'flag' or 'default' must be used. Please, make sure to use at least one of them. ERROR_VALIDATEBODY_NULL_ARGUMENT_ID=I found out that one of the arguments has no identifier. Please, make sure to add a valid identifier to the argument and try again. ERROR_VALIDATEBODY_NULL_COMMAND=I found a null command in the provided rule. This should be an easy fix. Make sure to add a valid command to the rule. -ERROR_VALIDATEBODY_NULL_COMMANDS_LIST=I need a list of commands. Make sure to fix this issue and try again. ERROR_VALIDATEHEADER_NULL_ID=The provided rule has no identifier. This is a crucial information, please make sure to fix this issue and try again. Make sure the identifier has the same name of the rule file (without the extension, of course). ERROR_VALIDATEHEADER_NULL_NAME=The provided rule has no name. This should be an easy fix. Make sure to add a valid name and try again. ERROR_VALIDATEHEADER_WRONG_IDENTIFIER=The rule has a wrong identifier. I was expecting ''{0}'', but found ''{1}''. This should be an easy fix: just replace the wrong identifier by the correct one. -ERROR_VELOCITY_FILE_NOT_FOUND=The template engine was not able to find the provided input file. Make sure the location is correct and try again. -ERROR_VELOCITY_PARSE_EXCEPTION=There was a parse error in the provided input file. Make sure the file complies with the Velocity Template Language (VTL) specification and try again. -ERROR_VELOCITY_METHOD_INVOCATION_EXCEPTION=There was a method invocation error in the provided input file. Make sure the file complies with the Velocity Template Language (VTL) specification and try again. -ERROR_VELOCITY_IO_EXCEPTION=The template engine was not able to write the output file. Make sure the path has the proper permissions and try again. INFO_DISPLAY_EXCEPTION_MORE_DETAILS=There are more details available on this exception: INFO_DISPLAY_EXECUTION_TIME=Total: {0} seconds INFO_DISPLAY_FILE_INFORMATION=Processing ''{0}'' (size: {1}, last modified: {2}), please wait. INFO_INTERPRETER_DRYRUN_MODE_BOOLEAN_MODE=Although executing in dry-run mode, this entry might be already processed since it returned a boolean value: {0} INFO_INTERPRETER_DRYRUN_MODE_SYSTEM_COMMAND=About to run: {0} -INFO_INTERPRETER_DRYRUN_MODE_TRIGGER_MODE=Although executing in dry-run mode, this entry is always processed since it is a trigger. Note that the effects of a trigger might influence the current execution. -INFO_INTERPRETER_VERBOSE_MODE_TRIGGER_MODE=This entry is a trigger originated from the rule scope. Note that the effects of a trigger might influence the current execution. INFO_LABEL_AUTHOR=Author: INFO_LABEL_AUTHORS=Authors: INFO_LABEL_CONDITIONAL=Conditional: @@ -124,19 +103,7 @@ INFO_LABEL_ON_ERROR=ERROR INFO_LABEL_ON_FAILURE=FAILURE INFO_LABEL_ON_SUCCESS=SUCCESS INFO_LABEL_UNNAMED_TASK=Unnamed task -INFO_PARSER_ALL_RIGHTS_RESERVED=All rights reserved -INFO_PARSER_DRYRUN_MODE_DESCRIPTION=go through all the motions of running a command, but with no actual calls -INFO_PARSER_HELP_DESCRIPTION=print the help message -INFO_PARSER_LANGUAGE_DESCRIPTION=set the application language -INFO_PARSER_LOG_DESCRIPTION=generate a log output -INFO_PARSER_LOOPS_DESCRIPTION=set the maximum number of loops -INFO_PARSER_NOTES=This tool makes use of the following libraries and their respective licenses: CAL10N: MIT, Commons CLI: Apache 2.0, Commons Collections: Apache 2.0, Commons IO: Apache 2.0, Commons Lang: Apache 2.0, MVEL: Apache 2.0, Logback: dual licensing with EPL 1.0 and LGPL 2.1, Simple framework: Apache 2.0, SLF4J: MIT, SnakeYAML: Apache 2.0, Velocity: Apache 2.0, and ZT-Exec: Apache 2.0. At last but not least, arara itself is released under the New BSD license. -INFO_PARSER_ONLY_HEADER=extract directives only in the file header -INFO_PARSER_PREAMBLE_DESCRIPTION=set the file preamble based on the configuration file -INFO_PARSER_SILENT_MODE_DESCRIPTION=hide the command output -INFO_PARSER_TIMEOUT_DESCRIPTION=set the execution timeout (in milliseconds) -INFO_PARSER_VERBOSE_MODE_DESCRIPTION=print the command output -INFO_PARSER_VERSION_DESCRIPTION=print the application version +INFO_PARSER_NOTES=arara is released under the New BSD license. LOG_INFO_BEGIN_BUFFER=BEGIN OUTPUT BUFFER LOG_INFO_BOOLEAN_MODE=Boolean value: {0} LOG_INFO_DIRECTIVES_BLOCK=DIRECTIVES @@ -149,4 +116,4 @@ LOG_INFO_RULE_LOCATION=Rule location: ''{0}'' LOG_INFO_SYSTEM_COMMAND=System command: {0} LOG_INFO_TASK_RESULT=Task result: LOG_INFO_VALIDATED_DIRECTIVES=All directives were validated. We are good to go. -LOG_INFO_WELCOME_MESSAGE=Welcome to arara {0} (revision {1})! +LOG_INFO_WELCOME_MESSAGE=Welcome to arara {0}! diff --git a/support/arara/source/src/main/resources/com/github/cereda/arara/localization/messages_en_QN.properties b/support/arara/source/src/main/resources/org/islandoftex/arara/localization/messages_en_QN.properties index c9a2013d26..7b88fd3e86 100644 --- a/support/arara/source/src/main/resources/com/github/cereda/arara/localization/messages_en_QN.properties +++ b/support/arara/source/src/main/resources/org/islandoftex/arara/localization/messages_en_QN.properties @@ -35,15 +35,12 @@ # Translators: Nicola Talbot # --------------------------------------------------------------------- # With thanks to Keith Skipper for suggestions! - ERROR_BASENAME_NOT_A_FILE=Yew''re gotta hev a file for the ''basename'', not a directory. That ''{0}'' yew give me ent a file. Do yew need ter do jarbs on a directory, yew myte try the Java API. ERROR_CALCULATEHASH_IO_EXCEPTION=Thass a rum ole dew, bor, I can't work out th' hash. I ent got no idea why thass gorn wrong. Praps the file was hulled abowt afore or time the hashing operation was doing else maybe I're gotta he'some proper permissions to snout abowt in the file. ERROR_CHECKBOOLEAN_NOT_VALID_BOOLEAN=That look like ''{0}'' ent a proper boolean value but dunt yew git yerself inta a rite ole puckaterry. Do yew jist make sure to use proper boolean values (yes and no, true and false, 1 and 0, and on and off). ERROR_CHECKOS_INVALID_OPERATING_SYSTEM=Thass a rum un. I hent got no idear whass yar operating system. Wuh, that ole value ''{0}'' I got dunt look like thass a proper operating system (howsomever I might be sorft in the head and got that wrong). Do yew fix that value and try agin. ERROR_CHECKREGEX_IO_EXCEPTION=Cor blast me, but I feel a bit ona tewl. I can''t read any ona file ''{0}'', thass giving me an IO error. I''re got no idear but praps the file was hulled abowt afore or time the reading operation was doing else maybe I''re gotta he''some proper permissions to snout abowt the file. -ERROR_CONFIGURATION_FILETYPE_MISSING_EXTENSION=One onyar entries in that ole list a 'filetypes' in the configuration file ent got no 'extension'. Thass a rum un cos I can't do a new filetype if the extension ent been set. That shoont be a problem: do yew jist add a new extension and try agin, bor. ERROR_CONFIGURATION_GENERIC_ERROR=Thass hully gone wrong, ole partner. I coont unnerstand the configuration file. Wuh, yew're gotta he'sum idear wot this is orl abowt ter git th' hang o'this bit else yew myte be in a rite ole puckaterry but I'll help yew git it done if I can, my bewty. -ERROR_CONFIGURATION_INVALID_YAML=Thass a rum ole dew, I're got in a rite ole puckaterry trying to read the configuration file. That YAML do need some tricolating to git it rite but I'll lend yew a hand, tergether. ERROR_CONFIGURATION_LOOPS_INVALID_RANGE=Atwin me, yew an' the geartepust that 'loops' key value ent rite. Yew're gotta giv' a number thass bigger than nuffin. ERROR_DISCOVERFILE_FILE_NOT_FOUND=Dunt yew git yarself inta a rite ole puckaterry, but I can''t find yar file ''{0}'' {1}. Yew''re gotta find the file and do yew see that has a proper extension on the end onnit, tergether. ERROR_EVALUATE_COMPILATION_FAILED=Wuh, I ent got no idear wass gorn on but I coont git the hang o'that conditional. Yew're gotta he'sum idear wot this is orl abowt else yew mite be in a rite ole puckaterry but I'll help yew git it done if I can, ole partner. @@ -53,27 +50,20 @@ ERROR_FILETYPE_NOT_A_FILE=Yew gotta hev a file for the ''filetype'', not a direc ERROR_FILETYPE_UNKNOWN_EXTENSION=Cor blast me, ole partner, but I ent never heard of ''{0}'' as a default extension. Yew''re gotta giv me yer know about the match and that ole extension on the end onnit do you want a new file type. I ony know abowt the default extensions: {1} ERROR_GETAPPLICATIONPATH_ENCODING_EXCEPTION=Dunt yew git yarself inta a rite ole puckaterry, my bewty, cos there's nuffin I can dew abowt it but I're gotta mobbing abowt th'encoding time I was trying to get the application path. ERROR_GETCANONICALFILE_IO_EXCEPTION=Cor blast me, my bewty, I ent got no idear wass gorn on but I coont get the canonical file. Praps the file was hulled abowt afore or time the lookup operation was doing else maybe I're gotta he'sum proper permissions. -ERROR_GETCANONICALPATH_IO_EXCEPTION=Cor blast me, my bewty, I ent got no idear wass gorn on but I coont get the canonical path. Praps the file was hulled abowt afore or time the lookup operation was doing else maybe I're gotta he'sum proper permissions. ERROR_GETPARENTCANONICALPATH_IO_EXCEPTION=Cor blast me, my bewty, I ent got no idear wass gorn on but I coont get the parent canonical path. Praps the file was hulled abowt afore or time the hashing operation was doing else maybe I're gotta he'sum proper permissions. ERROR_INTERPRETER_ARGUMENT_IS_REQUIRED=That seem like the rule say yew gotta have ''{0}'', but I coont find it in the directive parameters. Dew yew add it as a parameter for yar directive and try agin. ERROR_INTERPRETER_COMMAND_RUNTIME_ERROR=That ent gorn right wi' one onnem commands you giv' me. Wuh, yew're gotta he'sum idear wot this is orl abowt ter git th' hang o'this bit else yew myte be in a rite ole puckaterry but I'll help yew git it done if I can, my bewty. ERROR_INTERPRETER_DEFAULT_VALUE_RUNTIME_ERROR=That ent gorn right wi' ter default value of one onnem arguments you giv' me. Wuh, yew're gotta he'sum idear wot this is orl abowt ter git th' hang o'this bit else yew myte be in a rite ole puckaterry but I'll help yew git it done if I can, tergether. ERROR_INTERPRETER_EXIT_RUNTIME_ERROR=That ent gorn right wi' th' exit status of onnem commands you giv' me. Wuh, yew're gotta he'sum idear wot this is orl abowt ter git th' hang o'this bit else yew myte be in a rite ole puckaterry but I'll help yew git it done if I can, my bewty. ERROR_INTERPRETER_FLAG_RUNTIME_EXCEPTION=That ent gorn right wi' th' flag for onnem arguments you giv' me. Wuh, yew're gotta he'sum idear wot this is orl abowt ter git th' hang o'this bit else yew myte be in a rite ole puckaterry but I'll help yew git it done if I can, my bewty. -ERROR_INTERPRETER_NULL_COMMAND=Thass a rum ole dew but one onnem commands have hulled me a null value. Do you check that and try agin, ole partner. ERROR_INTERPRETER_RULE_NOT_FOUND=Thass a rum ole dew but there ent no ''{0}'' in any onnem rule paths. Praps you ent spelled that right. I coont find ''{0}.yaml'' in any onner paths: {1} ERROR_INTERPRETER_UNKNOWN_KEYS=Atwin me, yew an'' the geartepost I ent got no idear abowt these keys in the directive: {0}. Howsomever, dunt you git yarself inta a rite ole puckaterry. Do you jist hull them outta yar map. ERROR_INTERPRETER_WRONG_EXIT_CLOSURE_RETURN=Wuh, ole partner, that 'exit' expression ent givin' me a yis or no answer. Thass allus got to dew that even if there ent nuffin else to dew. Howsomever, dunt you git yarself inta a rite ole puckaterry, dew you jist tricolate the return statement and try agin. ERROR_ISSUBDIRECTORY_NOT_A_DIRECTORY=The ''isSubdirectory'' method requires a directory, not a file. It looks like ''{0}'' does not appear to be a directory at all. ERROR_LANGUAGE_INVALID_CODE=Cor blast me, my bewty, but you hully copped me there wi'' that language code. I can ony mardle in these languages: {0} -ERROR_LOAD_COULD_NOT_LOAD_XML=Cor blast me, ole partner, but that XML database ''{0}'' ent half puttin'' on its parts but I ent got no idear wass gone wrong. Praps the file was hulled abowt afore or time the reading operation was doing else maybe I''re gotta he''sum proper permissions to snout abowt the file. Atwin yew, me an'' the geartepost, do yew make sure the XML is in good kelter. +ERROR_LOAD_COULD_NOT_LOAD_XML=Cor blast me, ole partner, but that YAML database ''{0}'' ent half puttin'' on its parts but I ent got no idear wass gone wrong. Praps the file was hulled abowt afore or time the reading operation was doing else maybe I''re gotta he''sum proper permissions to snout abowt the file. Atwin yew, me an'' the geartepost, do yew make sure the YAML is in good kelter. ERROR_PARSER_INVALID_PREAMBLE=Thass a rum ole dew, ole partner, but I can''t find the preamble ''{0}''. Do yew make sure that key exist in the configuration file. -ERROR_PARSER_LOOPS_INVALID_RANGE=Wuh, I dunt want to hully mob you, my bewty, but that value you giv' me in the command line ent rite for the sight o' loops I mite hev to dew. Dew you giv' me a proper number what I can count to. -ERROR_PARSER_LOOPS_NAN=Wuh, I dunt want to hully mob you, ole partner, but that value you giv' me in the command line for the sight o' loops I mite hev to dew ent a number. Dew you giv' me a proper number what I can count to. -ERROR_PARSER_TIMEOUT_INVALID_RANGE=Cor blast me, my bewty, but that timeout value you giv' me in the command line ent rite. Dew you giv' me a proper number what I can count to. -ERROR_PARSER_TIMEOUT_NAN=Cor blast me, ole partner, but that timeout value you giv' me in the command line ent a number. Dew you giv' me a proper number what I can count to. ERROR_PARSERULE_GENERIC_ERROR=Thass a rum ole dew, that rule is hully puttin' on its parts. Wuh, yew're gotta he'sum idear wot this is orl abowt ter git th' hang o'this bit else yew myte be in a rite ole puckaterry but I'll help yew git it done if I can, tergether. -ERROR_PARSERULE_INVALID_YAML=Thass a rum ole dew, that rule ent half putting on its parts. That YAML file is hully on the huh but dunt yew git yarself in a rite ole puckaterry. I'll help you if I can, my bewty. ERROR_REPLICATELIST_MISSING_FORMAT_ARGUMENTS_EXCEPTION=Blast, bor, but I coont replicate that duzzy ole list cors you ent giv' me a format argument. I rackon there's a slight more or less parameters than yew giv' me. Dew yew go an' check it and try agin. ERROR_RULE_IDENTIFIER_AND_PATH=Wuh, that ent right, ole partner. That rule ''{0}'' have gone on the slosh at ''{1}''. ERROR_RUN_GENERIC_EXCEPTION=Thass a rum ole dew, my bewty, but I coont dew the system command but I ent got no idear wass gone wrong. Wuh, yew're gotta he'sum idear wot this is orl abowt ter git th' hang o'this bit else yew myte be in a rite ole puckaterry but I'll help yew git it done if I can, tergether. @@ -82,13 +72,10 @@ ERROR_RUN_INVALID_EXIT_VALUE_EXCEPTION=That system command is hully puttin' on i ERROR_RUN_IO_EXCEPTION=I rackon that system command have blundered over the troschel. Are yew sure that exist in yar path? Dew yew check the path, ole partner, to see where thass hidin'. Maybe thass gorn in the backus for some bread an' pullet. ERROR_RUN_TIMEOUT_EXCEPTION=That slummockun gret system command have run on for too long so I gev it a clout round the lug. If thass hully short for yew, dew yew giv' me a longer timeout value. ERROR_RUN_TIMEOUT_INVALID_RANGE=Hold yew hard, that timeout value ent here. I rackon thass gorn for some fourses. Dew yew giv' me a number wot I can count to. -ERROR_SAVE_COULD_NOT_SAVE_XML=Thass a rum ole dew, ole partner. I coont save that ole XML database that oughta be called ''{0}''. Howsomever I hent got no idea why thass gone wrong. Praps I''re gotta he''sum proper permissions to write the XML file to disk. -ERROR_SESSION_OBTAIN_UNKNOWN_KEY=Cor blast me, my bewty, but I hent got no idear wass that ''{0}'' key is dewun in that ''obtain'' method. I can''t giv'' you suffin I ent got. Dew yew ax for suffin I can git yew. +ERROR_SAVE_COULD_NOT_SAVE_XML=Thass a rum ole dew, ole partner. I coont save that ole YAML database that oughta be called ''{0}''. Howsomever I hent got no idea why thass gone wrong. Praps I''re gotta he''sum proper permissions to write the YAML file to disk. +ERROR_SESSION_OBTAIN_UNKNOWN_KEY=Cor blast me, my bewty, but I hent got no idear wass that ''{0}'' key is dewun in that ''get'' method. I can''t giv'' you suffin I ent got. Dew yew ax for suffin I can git yew. ERROR_SESSION_REMOVE_UNKNOWN_KEY=Cor blast me, ole partner, but I hent got no idear wass that ''{0}'' key is dewin in that ''remove'' method. I can''t remove suffin that ent there. Dew yew ax for suffin else. -ERROR_TRIGGER_ACTION_NOT_FOUND=Cor blast me, bor, but there ent no trigger action called ''{0}'' that I ever heard of. Dew yew hev'' a look at that list of trigger actions and try agin. -ERROR_TRIGGER_CALL_EXCEPTION=Thass a rum ole dew, my bewty, but that trigger action ''{0}'' is hully puttin'' on its parts and I ent got no idear what to dew. ERROR_VALIDATE_EMPTY_FILES_LIST=Cor blast me, my bewty. I read a directive {0} but there ent nuffin in the provided ''files'' list. Do yew just make sure there''s at least one element in the list and try agin. -ERROR_VALIDATE_FILE_IS_RESERVED=Thass a rum ole dew, ole partner. I read a directive {0} but blast me if that key ''file'' ent used. That key is reserved, so yew can''t use it. But dunt yew git yarself in a rite ole puckaterry. Do yew give it another name. ERROR_VALIDATE_FILES_IS_NOT_A_LIST=That ent rite, ole partner. I read a directive {0} and found out that ''files'' require a list. Do yew fix the type to a proper list and try agin. ERROR_VALIDATE_INVALID_DIRECTIVE_FORMAT=That directive {0} in the provided file ent rite. But dunt git yarself into a puckaterry. Do yew just fix the directive and try agin. ERROR_VALIDATE_NO_DIRECTIVES_FOUND=That look like no directives were found in the provided file. Do yew include at least one directive and try agin. @@ -96,26 +83,18 @@ ERROR_VALIDATE_ORPHAN_LINEBREAK=Thass a rum ole dew, ole partner. There''s an or ERROR_VALIDATE_REFERENCE_IS_RESERVED=That ain''t right, my bewty. You can''t use the key ''reference'' in {0}. Thass a reserved key, but there ain''t no use you gittin'' in a rite ole puckaterry abowt it. Dew yew giv'' it another name. ERROR_VALIDATE_YAML_EXCEPTION=Thass a rum ole dew, my bewty. Suffin''s gone wrong in the YAML map in a directive {0}. Wuh, yew''re gotta he''sum idear wot this is orl abowt ter git th'' hang o''this bit else yew myte be in a rite ole puckaterry. ERROR_VALIDATEBODY_ARGUMENT_ID_IS_RESERVED=That ent rite, ole partner. Yew can''t use ''{0}''. Thass reserved, but dunt yew git yarself into a rite ole puckaterry, dew yew jist giv'' it another name. -ERROR_VALIDATEBODY_ARGUMENTS_LIST=Thass a rum ole dew, my bewty, but there ent no list of arguments. I need that even if that ent got nuffin in it. Dew you fix it and try agin. ERROR_VALIDATEBODY_DUPLICATE_ARGUMENT_IDENTIFIERS=Thass a rum ole dew, ole partner. You've got duplicate argument identifiers in yar rule. Dew you fix that and try agin. ERROR_VALIDATEBODY_MISSING_KEYS=That ent rite, ole partner. You gotta use at least 'flag' or 'default' when you define a rule argument scope. Do yew make sure to use at least one onnem. ERROR_VALIDATEBODY_NULL_ARGUMENT_ID=That ent rite, my bewty. You gotta hev an identifier but one onnem arguments ent for one. Dew yew add a valid identifier to the argument and try agin. ERROR_VALIDATEBODY_NULL_COMMAND=Thass a rum dew, ole partner. Thass a null command in that ole rule. Do you add a proper command there. -ERROR_VALIDATEBODY_NULL_COMMANDS_LIST=Wuh, thass hully wrong. Do yew giv' me a list o' commands, my bewty, and try agin. ERROR_VALIDATEHEADER_NULL_ID=Wuh, ole partner, I'm gornta hev to mob that rule o' yars. That ent got no identifier. Thass hully important and there ent no use putting on yar parts abowt it. That slummockin' gret rule oughta hev' an identifier what have the same name as that ole rule file (without the extension, dew yew dunt know that). ERROR_VALIDATEHEADER_NULL_NAME=Cor blast me, bor, but that rule ent got no name, but dunt yew git yarself in a puckaterry, dew you jist giv' it a proper name and try agin. ERROR_VALIDATEHEADER_WRONG_IDENTIFIER=My heart alive, my bewty, but that rule ent got the right identifier. That oughta be ''{0}'', not ''{1}'', but dunt yew git yarself in a puckaterry. Dew you jist fix that. -ERROR_VELOCITY_FILE_NOT_FOUND=Cor blast me, bor, but the template engine can't find the provided input file. Dew yew mearke sure the location is correct and try agin. -ERROR_VELOCITY_PARSE_EXCEPTION=Wuh, that ent roight, ole partner. There wus a parse error in the provided input file. Dew yew mearke hully sure the file comply wuth the Velocity Template Language (VTL) specification and try agin. -ERROR_VELOCITY_METHOD_INVOCATION_EXCEPTION=Thass a rum ole dew. There wus a method invocation error in the provided input file. Dew yew mearke sure the file comply with the Velocity Template Language (VTL) specification and try agin. -ERROR_VELOCITY_IO_EXCEPTION=That ent gorn right, my bewty. The template engine wunt able to write the output file. Dew yew mearke sure the path has the proper permissions and try agin. INFO_DISPLAY_EXCEPTION_MORE_DETAILS=Hear's orl my know on that aggraweartin' exception: INFO_DISPLAY_EXECUTION_TIME=Wuh that took {0} seconds but if thass a slight longer than you expected, dunt yew go mobbing me abowt it cors that ent my fault. My grandf''ar dint have none of these pearks. He had to use a pen and a bit o'' pearper, but thass bin nice mardling wi'' yew. Dew yew keep a troshin''! INFO_DISPLAY_FILE_INFORMATION=Hold yew hard, ole partner, I''m gornta hev a look at ''{0}'' (thass {1} big, that is, and that was last chearnged on {2} in case yew dunt remember). INFO_INTERPRETER_DRYRUN_MODE_BOOLEAN_MODE=Although executing in dry-run mode, this entry might be already processed since it returned a boolean value: {0} INFO_INTERPRETER_DRYRUN_MODE_SYSTEM_COMMAND=This is what I''m abowt to dew: {0} -INFO_INTERPRETER_DRYRUN_MODE_TRIGGER_MODE=Wuh, ole partner, I know this is a dry-run, but this entry has gorta be done cos thass a trigger. Thass hully important yew should know that might doss things on the huh. -INFO_INTERPRETER_VERBOSE_MODE_TRIGGER_MODE=Wuh, ole partner, this entry is one onem triggers what come from the rule scope. Thass hully important yew should know that might put this jarb hully on the huh. INFO_LABEL_AUTHOR=Thass the one wot wrote this masterous jarb: INFO_LABEL_AUTHORS=Here's the ones wot wrote this masterous jarb: INFO_LABEL_CONDITIONAL=Conditional (thass a yis or no thing): @@ -125,19 +104,7 @@ INFO_LABEL_ON_ERROR=SUFFIN'S GORN WRONG INFO_LABEL_ON_FAILURE=THAT ENT GORN RIGHT, OLE PARTNER INFO_LABEL_ON_SUCCESS=THASS A MASTERLY JOB, MY BEWTY INFO_LABEL_UNNAMED_TASK=That task ent got no name -INFO_PARSER_ALL_RIGHTS_RESERVED=Orl them rights are reserved, ole partner -INFO_PARSER_DRYRUN_MODE_DESCRIPTION=that'll look like I'm dewun suffin, but I ent -INFO_PARSER_HELP_DESCRIPTION=wuh, cor blast me, my bewty, but that'll tell me to dew jist what I'm dewun rite now -INFO_PARSER_LANGUAGE_DESCRIPTION=that'll tell me what language to mardle in -INFO_PARSER_LOG_DESCRIPTION=that'll make a log file wi' orl my know dew suffin go wrong -INFO_PARSER_LOOPS_DESCRIPTION=wuh, yew dunt want me to run on forever, dew you, so use this to say when you want me to stop -INFO_PARSER_NOTES=This masterous fine perk use orl these other perks and here's their licences an'orl: CAL10N: MIT, Commons CLI: Apache 2.0, Commons Collections: Apache 2.0, Commons IO: Apache 2.0, Commons Lang: Apache 2.0, MVEL: Apache 2.0, Logback: dual licensing with EPL 1.0 and LGPL 2.1, Simple framework: Apache 2.0, SLF4J: MIT, SnakeYAML: Apache 2.0, Velocity: Apache 2.0, and ZT-Exec: Apache 2.0. At last but not least, arara itself is released under the New BSD license. -INFO_PARSER_ONLY_HEADER=wuh, my bewty, that'll only peek at directives what are in the file header -INFO_PARSER_PREAMBLE_DESCRIPTION=dew yew git hold o' that preamble from the configuration file -INFO_PARSER_SILENT_MODE_DESCRIPTION=that'll make them system commands clam up and not run on about what's dewin -INFO_PARSER_TIMEOUT_DESCRIPTION=wuh, yew dunt want them system commands to run on forever dew suffin' go wrong, dew you, so use this to set the execution timeout (thass in milliseconds) -INFO_PARSER_VERBOSE_MODE_DESCRIPTION=thass dew you want ter system commands to hav' a mardle wi'yew an'orl -INFO_PARSER_VERSION_DESCRIPTION=dew yew use this dew you want my know abowt this version +INFO_PARSER_NOTES=arara is released under the New BSD license. LOG_INFO_BEGIN_BUFFER=BEGIN OUTPUT BUFFER LOG_INFO_BOOLEAN_MODE=Boolean value: {0} LOG_INFO_DIRECTIVES_BLOCK=DIRECTIVES @@ -150,4 +117,4 @@ LOG_INFO_RULE_LOCATION=That ole rule come from: ''{0}'' LOG_INFO_SYSTEM_COMMAND=System command: {0} LOG_INFO_TASK_RESULT=Here's what that jarb say: LOG_INFO_VALIDATED_DIRECTIVES=Thass a masterous jarb, orl the directives are in good kelter. We can git troshin'. -LOG_INFO_WELCOME_MESSAGE=Hello, my bewty. Welcome to arara {0} (revision {1})! (Thass one onnem hully big birds they git in Brazil.) +LOG_INFO_WELCOME_MESSAGE=Hello, my bewty. Welcome to arara {0}! (Thass one onnem hully big birds they git in Brazil.) diff --git a/support/arara/source/src/main/resources/com/github/cereda/arara/localization/messages_it.properties b/support/arara/source/src/main/resources/org/islandoftex/arara/localization/messages_it.properties index 1f32907fbd..1a9117c241 100644 --- a/support/arara/source/src/main/resources/com/github/cereda/arara/localization/messages_it.properties +++ b/support/arara/source/src/main/resources/org/islandoftex/arara/localization/messages_it.properties @@ -34,15 +34,12 @@ # Language: Italian # Translators: Enrico Gregorio # --------------------------------------------------------------------- - ERROR_BASENAME_NOT_A_FILE=Il metodo ''basename'' richiede un file, non una directory. ''{0}'' non sembra proprio essere un file. Se devi eseguire un compito su una directory, puoi adoperare uno dei metodi delle API Java. ERROR_CALCULATEHASH_IO_EXCEPTION=Per qualche motivo, non ho potuto calcolare un hash. Purtroppo non ho idea del perché sia andata male. Forse il file è stato spostato o cancellato durante l'operazione di hashing. O forse non ho i permessi necessari per leggere il file. ERROR_CHECKBOOLEAN_NOT_VALID_BOOLEAN=Sembra che ''{0}'' non sia un valore booleano valido. Penso che sia facile correggerlo. Assicurati di adoperare una stringa valida che rappresenti un valore booleano (yes e no, true e false, 1 e 0, oppure on e off). ERROR_CHECKOS_INVALID_OPERATING_SYSTEM=Non sono riuscito a distinguere il tuo sistema operativo. Il valore dichiarato ''{0}'' non compare nella mia lista di sistemi operativi (potrei sbagliarmi, però). Per favore, correggi il valore e riprova. ERROR_CHECKREGEX_IO_EXCEPTION=Non sono riuscito a leggere il contenuto del file ''{0}'' e ho ricevuto in errore di I/O. Purtroppo non ho idea del perché sia andata male. Forse il file è stato spostato o cancellato durante l''operazione di hashing. O forse non ho i permessi necessari per leggere il file. -ERROR_CONFIGURATION_FILETYPE_MISSING_EXTENSION=Uno degli oggetti nella lista di 'filetypes' nel file di configurazione è senza 'estensione'. Mi dispiace, non posso gestire un nuovo 'filetype' se l'estensione non è specificata. Dovrebbe essere facile correggerlo: aggiungi l'estensione e riprova. ERROR_CONFIGURATION_GENERIC_ERROR=Non sono riuscito a leggere il file di configurazione, è successo qualcosa che non va. Questa parte è un po' complicata, perché riguarda aspetti del formato interno di serializzazione dei dati. Farò del mio meglio per darti una mano, per quanto posso. -ERROR_CONFIGURATION_INVALID_YAML=Non sono riuscito a leggere il file di configurazione, è successo qualcosa che non va. Sembra che il file YAML fornito non sia valido. Farò del mio meglio per darti una mano, per quanto posso. ERROR_CONFIGURATION_LOOPS_INVALID_RANGE=Il valore definito nella chiave 'loops' del file di configurazione per stabilire il massimo numero di cicli ha un intervallo non valido. Assicurati che sia un valore 'lungo' e positivo. ERROR_DISCOVERFILE_FILE_NOT_FOUND=Non sono riuscito a trovare il file ''{0}'' {1}. Assicurati che il file esista e abbia un''estensione valida. ERROR_EVALUATE_COMPILATION_FAILED=Per qualche ragione, non sono riuscito a compilare l'espressione del condizionale fornito. Questa parte è un po' complicata, perché riguarda aspetti del linguaggio interno per le espressioni. Farò del mio meglio per darti una mano, per quanto posso. @@ -52,27 +49,20 @@ ERROR_FILETYPE_NOT_A_FILE=Il metodo ''filetype'' richiede un file, non una direc ERROR_FILETYPE_UNKNOWN_EXTENSION=Non riconosco ''{0}'' come un''estensione standard. Se vuoi definire un nuovo tipo di file, assicurati di fornire l''estensione e lo schema. Queste sono le estensioni standard: {1} ERROR_GETAPPLICATIONPATH_ENCODING_EXCEPTION=C'è stato un problema di codifica mentre tentavo di ottenere il percorso dell'applicazione. Non c'è molto che possa fare al riguardo. ERROR_GETCANONICALFILE_IO_EXCEPTION=Non sono riuscito ad accedere al file canonico per via di un errore di I/O. Purtroppo non ho idea del perché sia andata male. Forse il file è stato spostato o cancellato prima o durante l'operazione di hashing. O forse non ho i permessi necessari per leggere il file. -ERROR_GETCANONICALPATH_IO_EXCEPTION=Non sono riuscito a ottenere il percorso canonico per via di un errore di I/O. Purtroppo non ho idea del perché sia andata male. Forse il file è stato spostato o cancellato prima o durante l'operazione di hashing. O forse non ho i permessi necessari per leggere il file. ERROR_GETPARENTCANONICALPATH_IO_EXCEPTION=Non sono riuscito a ottenere il percorso canonico progenitore per via di un errore di I/O. Purtroppo non ho idea del perché sia andata male. Forse il file è stato spostato o cancellato prima o durante l'operazione di hashing. O forse non ho i permessi necessari per leggere il file. ERROR_INTERPRETER_ARGUMENT_IS_REQUIRED=Sembra che ''{0}'' sia contrassegnato come obbligatorio nella regola, ma non l''ho trovato nei parametri della direttiva. Assicurati di aggiungerlo come parametro nella direttiva e riprova. ERROR_INTERPRETER_COMMAND_RUNTIME_ERROR=Non ho potuto valutare uno dei comandi forniti. Questa parte è un po' complicata perché coinvolge aspetti del linguaggio per le espressioni sottostante. Farò del mio meglio per darti una mano, per quanto posso. ERROR_INTERPRETER_DEFAULT_VALUE_RUNTIME_ERROR=Non ho potuto valutare il valore di default dell'espressione in uno degli argomenti. Questa parte è un po' complicata perché coinvolge aspetti del linguaggio per le espressioni sottostante. Farò del mio meglio per darti una mano, per quanto posso. ERROR_INTERPRETER_EXIT_RUNTIME_ERROR=Non sono riuscito a valutare lo stato di uscita di uno dei comandi forniti. Questa parte è un po' complicata perché coinvolge aspetti del linguaggio per le espressioni sottostante. Farò del mio meglio per darti una mano, per quanto posso. ERROR_INTERPRETER_FLAG_RUNTIME_EXCEPTION=Non ho potuto valutare la flag di uno degli argomenti. Questa parte è un po' complicata perché coinvolge aspetti del linguaggio per le espressioni sottostante. Farò del mio meglio per darti una mano, per quanto posso. -ERROR_INTERPRETER_NULL_COMMAND=Sono spiacente, ma a quanto pare il risultato di uno dei comandi forniti è un valore nullo. Assicurati che il comando sia valido e riprova. ERROR_INTERPRETER_RULE_NOT_FOUND=Non sono riuscito a trovare una regola chiamata ''{0}'' nei percorsi per le regole impostati. Forse una parola scritta sbagliata? Stavo cercando un file con il nome ''{0}.yaml'' nei seguenti percorsi in ordine di priorità: {1} ERROR_INTERPRETER_UNKNOWN_KEYS=Ho trovato queste chiavi sconosciute nella direttiva: {0}. Dovrebbbe essere facile correggere, toglile dalla mappa. ERROR_INTERPRETER_WRONG_EXIT_CLOSURE_RETURN=L'espressione di 'uscita' deve essere sempre un valore booleano (anche se non c'è alcun calcolo nella parte di chiusura). Dovrebbe essere facile correggere: assicurati che l'asserzione del 'type return' sia giusta e riprova. ERROR_ISSUBDIRECTORY_NOT_A_DIRECTORY=Il metodo ''isSubdirectory'' richiede una directory, non un file. Sembra proprio che ''{0}'' non sia una directory. ERROR_LANGUAGE_INVALID_CODE=La lingua richiesta non è valida. Al momento, so parlare le seguenti lingue: {0} -ERROR_LOAD_COULD_NOT_LOAD_XML=Non ho potuto caricare il database XML di nome ''{0}''. Purtroppo non ho idea del perché sia andata male. Forse il file è stato spostato o cancellato prima o durante l''operazione di lettura. O forse non ho i permessi necessari per leggere il file. Già che ci siamo, assicurati che il file XML sia ben formato. +ERROR_LOAD_COULD_NOT_LOAD_XML=Non ho potuto caricare il database YAML di nome ''{0}''. Purtroppo non ho idea del perché sia andata male. Forse il file è stato spostato o cancellato prima o durante l''operazione di lettura. O forse non ho i permessi necessari per leggere il file. Già che ci siamo, assicurati che il file YAML sia ben formato. ERROR_PARSER_INVALID_PREAMBLE=Mi dispiace, ma non è stato possibile trovare il preambolo ''{0}''. Assicurati che questa chiave esista nel file di configurazione. -ERROR_PARSER_LOOPS_INVALID_RANGE=Il valore definito nella linea di comando per il massimo numero di cicli ha un intervallo non valido. Assicurati di adoperare un valore 'lungo' e positivo. -ERROR_PARSER_LOOPS_NAN=Il numero massimo di cicli deve essere specificato come un intero. È facile correggerlo: assicurati di adoperare un valore 'lungo' e positivo. -ERROR_PARSER_TIMEOUT_INVALID_RANGE=Il valore definito nella linea di comando per il timeout in esecuzione non è nell'intervallo valido. Assicurati di adoperare un valore 'lungo' e positivo. -ERROR_PARSER_TIMEOUT_NAN=Il valore dell'opzione per il timeout in esecuzione deve essere un numero. Assicurati di adoperare un valore 'lungo' e positivo. ERROR_PARSERULE_GENERIC_ERROR=Non ho potuto analizzare la regola, qualcosa è andato storto. Questa parte è un po' complicata, perché riguarda aspetti del formato interno di serializzazione dei dati. Farò del mio meglio per darti una mano, per quanto posso. -ERROR_PARSERULE_INVALID_YAML=Non ho potuto analizzare la regola, qualcosa è andato storto. Sembra che il file YAML fornito non sia valido. Farò del mio meglio per darti una mano, per quanto posso. ERROR_REPLICATELIST_MISSING_FORMAT_ARGUMENTS_EXCEPTION=Non sono riuscito a replicare la lista perché manca un argomento per il formato. Penso che si tratti di un numero sbagliato di parametri. Assicurati che il numero di parametri sia corretto e riprova. ERROR_RULE_IDENTIFIER_AND_PATH=Ho trovato un errore nella regola ''{0}'' alla posizione ''{1}''. ERROR_RUN_GENERIC_EXCEPTION=Non ho potuto lanciare il comando di sistema richiesto, qualcosa è andato storto. Questa parte è un po' complicata, perché riguarda aspetti del linguaggio interno per le espressioni. Farò del mio meglio per darti una mano, per quanto posso. @@ -81,13 +71,10 @@ ERROR_RUN_INVALID_EXIT_VALUE_EXCEPTION=Il comando di sistema richiesto ha restit ERROR_RUN_IO_EXCEPTION=L'esecuzione del comando di sistema è fallita per via di un errore di I/O. Sei sicuro che il programma esista nei tuoi percorsi? Meglio controllare se il programma è davvero disponibile. ERROR_RUN_TIMEOUT_EXCEPTION=L'esecuzione del comando di sistema ha raggiunto il valore di timeout impostato ed è stata interrotta. Se il tempo è troppo breve, assicurati di impostarne uno più lungo. ERROR_RUN_TIMEOUT_INVALID_RANGE=Il valore di timeout probabilmente manca (sebbene il timeout sia abilitato). È facile correggerlo: assicurati di adoperare un valore 'lungo' e positivo. -ERROR_SAVE_COULD_NOT_SAVE_XML=Non ho potuto salvare il database XML con il nome ''{0}''. Purtroppo non ho idea del perché sia successo. Forse non ho i permessi appropriati per scrivere il file XML sul disco. -ERROR_SESSION_OBTAIN_UNKNOWN_KEY=Il metodo ''obtain'' ha trovato una chiave sconosciuta ''{0}'' nell''ambito della sessione. Non posso ottenere qualcosa che non ho da nessuna parte. Specifica una chiave valida e riprova. +ERROR_SAVE_COULD_NOT_SAVE_XML=Non ho potuto salvare il database YAML con il nome ''{0}''. Purtroppo non ho idea del perché sia successo. Forse non ho i permessi appropriati per scrivere il file YAML sul disco. +ERROR_SESSION_OBTAIN_UNKNOWN_KEY=Il metodo ''get'' ha trovato una chiave sconosciuta ''{0}'' nell''ambito della sessione. Non posso ottenere qualcosa che non ho da nessuna parte. Specifica una chiave valida e riprova. ERROR_SESSION_REMOVE_UNKNOWN_KEY=Il metodo ''remove'' ha trovato una chiave sconosciuta ''{0}'' nell''ambito della sessione. Non posso ottenere qualcosa che non ho da nessuna parte. Specifica una chiave valida e riprova. -ERROR_TRIGGER_ACTION_NOT_FOUND=Non ho trovato l''azione ''trigger'' ''{0}''. Da'' un''occhiata alla lista dei ''trigger'' disponibili e riprova. -ERROR_TRIGGER_CALL_EXCEPTION=Non ho potuto eseguire l''azione ''trigger'' ''{0}''. Qualcosa è andata proprio storta. ERROR_VALIDATE_EMPTY_FILES_LIST=Ho letto la direttiva {0}, ma la lista ''files'' fornita è vuota. Puoi correggerlo facilmente assicurandoti che la lista abbia almeno un elemento, poi riprova. -ERROR_VALIDATE_FILE_IS_RESERVED=Ho letto la direttiva {0} dove è stata usata la chiave ''file''. Questa chiave è riservata e non puoi usarla. Non preoccuparti, lo metti facilmente a posto dando un altro nome. ERROR_VALIDATE_FILES_IS_NOT_A_LIST=Ho letto la direttiva {0} e ho scoperto che ''files'' richiede una lista. Assicurati di correggere il tipo a una lista appropriata e riprova. ERROR_VALIDATE_INVALID_DIRECTIVE_FORMAT=Ho visto nel file fornito la direttiva {0} che non è valida. Assicurati di correggere la direttiva e riprova. ERROR_VALIDATE_NO_DIRECTIVES_FOUND=Sembra che nel file fornito non ci siano direttive. Assicurati che ce ne sia almeno una e riprova. @@ -95,26 +82,18 @@ ERROR_VALIDATE_ORPHAN_LINEBREAK=Sembra che ci sia un fine riga che lascia orfana ERROR_VALIDATE_REFERENCE_IS_RESERVED=Ho letto la direttiva {0} dove è stata usata la chiave ''reference''. Questa chiave è riservata e non puoi usarla. Non preoccuparti, lo metti facilmente a posto dando un altro nome. ERROR_VALIDATE_YAML_EXCEPTION=C''è stato un problema con la mappa YAML fornita con la direttiva {0}. Questa parte è un po'' complicata, perché riguarda aspetti del formato interno di serializzazione dei dati. Farò del mio meglio per darti una mano, per quanto posso. ERROR_VALIDATEBODY_ARGUMENT_ID_IS_RESERVED=L''identificatore dell''argomento ''{0}'' è riservato, quindi non puoi adoperarlo. È facile correggerlo: chiamalo in modo diverso. -ERROR_VALIDATEBODY_ARGUMENTS_LIST=Non ho potuto trovare la lista degli argomenti. La lista mi serve anche se è vuota. Correggi e riprova. ERROR_VALIDATEBODY_DUPLICATE_ARGUMENT_IDENTIFIERS=Sembra che tu abbia identificatori di argomenti duplicati nella tua regola. Correggi e riprova. ERROR_VALIDATEBODY_MISSING_KEYS=Quando si definisce un ambito per l'argomento in una regola bisogna adoperare almeno 'flag' o 'default'. Assicurati che ci sia uno di questi. ERROR_VALIDATEBODY_NULL_ARGUMENT_ID=Ho trovato che uno degli argomenti non ha identificatore. Assicurati di assegnare un identificatore all'argomento e riprova. ERROR_VALIDATEBODY_NULL_COMMAND=Ho trovato un comando 'nullo' nella regola fornita. Dovrebbe essere facile correggere: aggiungi un comando valido alla regola. -ERROR_VALIDATEBODY_NULL_COMMANDS_LIST=Mi serve una lista di comandi. Specificala e riprova. ERROR_VALIDATEHEADER_NULL_ID=La regola fornita non ha un identificatore. Quest'informazione è cruciale, assicurati di sistemarla e riprova. L'identificatore deve avere lo stesso nome della regola (senza estensione, ovviamente). ERROR_VALIDATEHEADER_NULL_NAME=La regola fornita non ha nome. È facile correggere: specifica un nome valido e riprova. ERROR_VALIDATEHEADER_WRONG_IDENTIFIER=La regola ha un identificatore sbagliato. Mi sarei aspettato ''{0}'', ma ho trovato ''{1}''. È facile correggere: correggi l''identificatore sbagliato con quello giusto. -ERROR_VELOCITY_FILE_NOT_FOUND=Il motore per i 'template' non è riuscito a trovare il file di input richiesto. Assicurati che la posizione del file sia giusta e riprova. -ERROR_VELOCITY_PARSE_EXCEPTION=C'è stato un errore durante l'analisi del file di input indicato. Assicurati che il file segua le specifiche del Velocity Template Language (VTL) e riprova. -ERROR_VELOCITY_METHOD_INVOCATION_EXCEPTION=Il file di input indicato ha un errore nella chiamata del metodo. Assicurati che il file segua le specifiche del Velocity Template Language (VTL) e riprova. -ERROR_VELOCITY_IO_EXCEPTION=Il motore per i 'template' non è riuscito a scrivere il file di output. Assicurati che il percorso abbia i permessi appropriati e riprova. INFO_DISPLAY_EXCEPTION_MORE_DETAILS=Ci sono altri dettagli riguardo a questa eccezione: INFO_DISPLAY_EXECUTION_TIME=Totale: {0} secondi INFO_DISPLAY_FILE_INFORMATION=Elaborazione ''{0}'' (totale: {1}, modificato il: {2}), attendere. INFO_INTERPRETER_DRYRUN_MODE_BOOLEAN_MODE=Sebbene stia eseguendo in modo ''dry-run'', questo elemento potrebbe essere già stato elaborato, perché ha restituito un valore booleano: {0} INFO_INTERPRETER_DRYRUN_MODE_SYSTEM_COMMAND=Sto per lanciare: {0} -INFO_INTERPRETER_DRYRUN_MODE_TRIGGER_MODE=Sebbene stia eseguendo in modo 'dry-run', questo elemento è sempre elaborato perché è un 'trigger'. Nota che gli effetti di un 'trigger' possono influenzare l'esecuzione. -INFO_INTERPRETER_VERBOSE_MODE_TRIGGER_MODE=Questo elemento è un 'trigger' generato nell'ambito della regola. Nota che gli effetti di un 'trigger' possono influenzare l'esecuzione. INFO_LABEL_AUTHOR=Autore: INFO_LABEL_AUTHORS=Autori: INFO_LABEL_CONDITIONAL=Condizionale: @@ -124,19 +103,7 @@ INFO_LABEL_ON_ERROR=ERROR INFO_LABEL_ON_FAILURE=FAILURE INFO_LABEL_ON_SUCCESS=SUCCESS INFO_LABEL_UNNAMED_TASK=Compito senza nome -INFO_PARSER_ALL_RIGHTS_RESERVED=Tutti i diritti riservati -INFO_PARSER_DRYRUN_MODE_DESCRIPTION=procedi lungo tutte le fasi dell'esecuzione di un comando, ma senza chiamarne alcuno in modo effettivo -INFO_PARSER_HELP_DESCRIPTION=mostra il messaggio di aiuto -INFO_PARSER_LANGUAGE_DESCRIPTION=imposta la lingua del programma -INFO_PARSER_LOG_DESCRIPTION=genera un file di log -INFO_PARSER_LOOPS_DESCRIPTION=imposta il massimo numero di cicli -INFO_PARSER_NOTES=Questo programma usa le seguenti librerie e le rispettive licenze: CAL10N: MIT, Commons CLI: Apache 2.0, Commons Collections: Apache 2.0, Commons IO: Apache 2.0, Commons Lang: Apache 2.0, MVEL: Apache 2.0, Logback: licenza duale con EPL 1.0 and LGPL 2.1, Simple framework: Apache 2.0, SLF4J: MIT, SnakeYAML: Apache 2.0, Velocity: Apache 2.0, e ZT-Exec: Apache 2.0. Per ultimo e non ultimo, arara stesso è rilasciato in accordo con la licenza New BSD. -INFO_PARSER_ONLY_HEADER=estrai le direttive solo nel 'file header' -INFO_PARSER_PREAMBLE_DESCRIPTION=imposta il preambolo del file sulla base del file di configurazione -INFO_PARSER_SILENT_MODE_DESCRIPTION=nascondi l'output del comando -INFO_PARSER_TIMEOUT_DESCRIPTION=imposta il timeout di esecuzione (in millisecondi) -INFO_PARSER_VERBOSE_MODE_DESCRIPTION=mostra l'outout del comando -INFO_PARSER_VERSION_DESCRIPTION=mostra la versione dell'applicazione +INFO_PARSER_NOTES=arara stesso è rilasciato in accordo con la licenza New BSD. LOG_INFO_BEGIN_BUFFER=BEGIN OUTPUT BUFFER LOG_INFO_BOOLEAN_MODE=Valore booleano: {0} LOG_INFO_DIRECTIVES_BLOCK=DIRECTIVES @@ -149,4 +116,4 @@ LOG_INFO_RULE_LOCATION=Posizione della regola: ''{0}'' LOG_INFO_SYSTEM_COMMAND=Comando di sistema: {0} LOG_INFO_TASK_RESULT=Risultato del compito: LOG_INFO_VALIDATED_DIRECTIVES=Tutte le direttive erano valide. Pronti a partire. -LOG_INFO_WELCOME_MESSAGE=Benvenuto in arara {0} (revisione {1})! +LOG_INFO_WELCOME_MESSAGE=Benvenuto in arara {0}! diff --git a/support/arara/source/src/main/resources/com/github/cereda/arara/localization/messages_nl.properties b/support/arara/source/src/main/resources/org/islandoftex/arara/localization/messages_nl.properties index 6aa6afa6c6..1f6e1b8a99 100644 --- a/support/arara/source/src/main/resources/com/github/cereda/arara/localization/messages_nl.properties +++ b/support/arara/source/src/main/resources/org/islandoftex/arara/localization/messages_nl.properties @@ -34,15 +34,12 @@ # Language: Dutch # Translators: Marijn Schraagen # --------------------------------------------------------------------- - ERROR_BASENAME_NOT_A_FILE=De ''basename''-methode vereist een bestand, geen directory. Het lijkt erop dat ''{0}'' geen bestand is. Als je taken wil uitvoeren met een directory kan je een aantal methodes uit de Java API gebruiken. ERROR_CALCULATEHASH_IO_EXCEPTION=Om een of andere reden kan ik de hash niet berekenen. Ik weet niet waarom het precies fout ging. Misschien is het bestand verplaatst of verwijderd voor of tijdens de hashing, of misschien heb ik niet de juiste rechten om het bestand te lezen. ERROR_CHECKBOOLEAN_NOT_VALID_BOOLEAN=Het lijkt erop dat ''{0}'' geen boolean-waarde is. Dit zou makkelijk op te lossen moeten zijn. Gebruik een geldige representatie voor een boolean (yes en no, true en false, 1 en 0, on en off). ERROR_CHECKOS_INVALID_OPERATING_SYSTEM=Ik kon het besturingssysteem niet achterhalen. De opgegeven waarde ''{0}'' staat niet in mijn lijst van geldige besturingssystemen (ik kan het natuurlijk mishebben). Controleer de waarde alsjeblieft en probeer het opnieuw. ERROR_CHECKREGEX_IO_EXCEPTION=Ik kon de inhoud van het bestand ''{0}'' niet lezen vanwege een IO-fout. Ik weet niet waarom het precies fout ging. Misschien is het bestand verplaatst of verwijderd voor of tijdens de leesoperatie, of misschien heb ik niet de juiste rechten om het bestand te lezen. -ERROR_CONFIGURATION_FILETYPE_MISSING_EXTENSION=Een van de elementen in de 'filetypes'-lijst in het configuratiebestand heeft geen 'extension'. Helaas kan ik een nieuw bestandstype niet gebruiken als de extensie niet bekend is. Dit zou makkelijk op te lossen moeten zijn: voeg een extensie toe en probeer het opnieuw. ERROR_CONFIGURATION_GENERIC_ERROR=Ik kon het configuratiebestand niet verwerken, er is iets verkeerd gegaan. Dit probleem is ingewikkeld, omdat het te maken heeft met aspecten van de onderliggende serialisatiesyntax. Ik zal mijn best doen om je zoveel mogelijk hiermee te helpen. -ERROR_CONFIGURATION_INVALID_YAML=Ik kon het configuratiebestand niet verwerken, er is iets verkeerd gegaan. Het lijkt erop dat het YAML-bestand een fout bevat. Ik zal mijn best doen om je zoveel mogelijk hiermee te helpen. ERROR_CONFIGURATION_LOOPS_INVALID_RANGE=De waarde gedefinieerd in de 'loops'-optie in het configuratiebestand om het maximumaantal herhalingen te specificeren heeft een ongeldig bereik. Geef alsjeblieft een positieve long integer-waarde op. ERROR_DISCOVERFILE_FILE_NOT_FOUND=Ik kon het opgegeven bestand ''{0}'' {1} niet vinden. Zorg ervoor dat het bestand bestaat en dat het een geldige extensie heeft. ERROR_EVALUATE_COMPILATION_FAILED=Om een of andere reden kon ik de expressie in de opgegeven voorwaarde niet compileren. Dit is een ingewikkeld probleem, omdat het te maken heeft met aspecten van de onderliggende expressietaal. Ik zal mijn best doen om je zoveel mogelijk hiermee te helpen. @@ -52,27 +49,20 @@ ERROR_FILETYPE_NOT_A_FILE=De ''filetype''-methode vereist een bestand, geen dire ERROR_FILETYPE_UNKNOWN_EXTENSION=De extensie ''{0}'' is niet herkend als een standaardextensie. Als je een nieuw bestandstype wil definiëren zorg dan dat de extensie en het patroon zijn opgegeven. De volgende extensies zijn standaard: {1} ERROR_GETAPPLICATIONPATH_ENCODING_EXCEPTION=Er was een coderingsprobleem bij het verkrijgen van het applicatiepad. Daar kan ik niet zo veel aan doen. ERROR_GETCANONICALFILE_IO_EXCEPTION=Ik kon het canonical-pad niet lezen vanwege een IO-fout. Ik weet niet waarom het precies fout ging. Misschien is het bestand verplaatst of verwijderd, of misschien heb ik niet de juiste rechten om het bestand te lezen. -ERROR_GETCANONICALPATH_IO_EXCEPTION=Ik kon het canonical-bestand niet lezen vanwege een IO-fout. Ik weet niet waarom het precies fout ging. Misschien is het bestand verplaatst of verwijderd, of misschien heb ik niet de juiste rechten om het bestand te lezen. ERROR_GETPARENTCANONICALPATH_IO_EXCEPTION=Ik kon het canonical ouderpad niet lezen vanwege een IO-fout. Ik weet niet waarom het precies fout ging. Misschien is het pad veranderd, of misschien heb ik niet de juiste leesrechten. ERROR_INTERPRETER_ARGUMENT_IS_REQUIRED=Het argument ''{0}'' is gemarkeerd als verplicht in de regel, maar ik kon het niet vinden in de parameters van de directive. Zorg ervoor dat het als parameter voor de directive wordt toegevoegd en probeer het opnieuw. ERROR_INTERPRETER_COMMAND_RUNTIME_ERROR=Ik kon een van de opgegeven opdrachten niet evalueren. Dit is een ingewikkeld probleem, omdat het te maken heeft met aspecten van de onderliggende expressietaal. Ik zal mijn best doen om je zoveel mogelijk hiermee te helpen. ERROR_INTERPRETER_DEFAULT_VALUE_RUNTIME_ERROR=Ik kon de standaardwaarde van een van de argumenten niet evalueren. Dit is een ingewikkeld probleem, omdat het te maken heeft met aspecten van de onderliggende expressietaal. Ik zal mijn best doen om je zoveel mogelijk hiermee te helpen. ERROR_INTERPRETER_EXIT_RUNTIME_ERROR=Ik kon de exitwaardemelding van een van de opgegeven opdrachten niet evalueren. Dit is een ingewikkeld probleem, omdat het te maken heeft met aspecten van de onderliggende expressietaal. Ik zal mijn best doen om je zoveel mogelijk hiermee te helpen. ERROR_INTERPRETER_FLAG_RUNTIME_EXCEPTION=Ik kon de optie-expressie van een van de argumenten niet evalueren. Dit is een ingewikkeld probleem, omdat het te maken heeft met aspecten van de onderliggende expressietaal. Ik zal mijn best doen om je zoveel mogelijk hiermee te helpen. -ERROR_INTERPRETER_NULL_COMMAND=Het spijt me, maar een van de opgegeven opdrachten heeft een null-waarde teruggegeven. Zorg ervoor dat de opdracht valide is en probeer het opnieuw. ERROR_INTERPRETER_RULE_NOT_FOUND=Ik kon de regel met de naam ''{0}'' niet vinden in de opgegeven regelpaden. Misschien een spelfout? Ik heb geprobeerd het bestand ''{0}.yaml'' te vinden in de volgende paden in volgorde van prioriteit: {1} ERROR_INTERPRETER_UNKNOWN_KEYS=Ik heb de volgende onbekende verwijzingen gevonden in de directive: {0}. Dit zou makkelijk op te lossen moeten zijn: verwijder deze uit de verwijzingstabel. ERROR_INTERPRETER_WRONG_EXIT_CLOSURE_RETURN=De 'exit'-expressie moet altijd een boolean waarde teruggeven (zelfs als er geen berekening heeft plaatsgevonden). Dit zou makkelijk op te lossen moeten zijn: pas het type van de return-regel aan en probeer het opnieuw. ERROR_ISSUBDIRECTORY_NOT_A_DIRECTORY=De ''isSubdirectory''-methode vereist een mapje, geen bestand. Het lijkt erop dat ''{0}'' geen mapje is. ERROR_LANGUAGE_INVALID_CODE=De opgegeven taalcode is ongeldig. Op het moment accepteer ik de volgende talen: {0} -ERROR_LOAD_COULD_NOT_LOAD_XML=Ik kon de XML-database met de naam ''{0}'' niet laden. Ik weet niet waarom het precies fout ging. Misschien was het bestand verplaatst of verwijderd tijdens de leesoperatie. Of misschien heb ik niet de juiste rechten om het bestand te lezen. Overigens: zorg ervoor dat het XML-bestand welgevormd is. +ERROR_LOAD_COULD_NOT_LOAD_XML=Ik kon de YAML-database met de naam ''{0}'' niet laden. Ik weet niet waarom het precies fout ging. Misschien was het bestand verplaatst of verwijderd tijdens de leesoperatie. Of misschien heb ik niet de juiste rechten om het bestand te lezen. Overigens: zorg ervoor dat het YAML-bestand welgevormd is. ERROR_PARSER_INVALID_PREAMBLE=Het spijt me, maar de preamble ''{0}'' is niet gevonden. Zorg ervoor dat deze verwijzing bestaat in het configuratiebestand. -ERROR_PARSER_LOOPS_INVALID_RANGE=De waarde gedefinieerd in de opdrachtregel voor het maximumaantal herhalingen heeft een ongeldig bereik. Geef alsjeblieft een positieve long integer-waarde op. -ERROR_PARSER_LOOPS_NAN=De optie voor het maximumaantal herhalingen verwacht een getal als argument. Dit zou makkelijk op te lossen moeten zijn. Zorg ervoor dat je een positieve long integer-waarde opgeeft. -ERROR_PARSER_TIMEOUT_INVALID_RANGE=De maximum uitvoeringsduur zoals opgegeven op de opdrachtregel heeft een ongeldige waarde. Zorg ervoor dat je een positieve long integer-waarde opgeeft. -ERROR_PARSER_TIMEOUT_NAN=De optie voor maximum uitvoeringsduur verwacht een getal als argument. Dit zou makkelijk op te lossen moeten zijn. Zorg ervoor dat je een positieve long integer-waarde opgeeft. ERROR_PARSERULE_GENERIC_ERROR=Ik kon de regel niet verwerken, er is iets verkeerd gegaan. Dit probleem is ingewikkeld, omdat het te maken heeft met aspecten van de onderliggende dataserialisatiesyntax. Ik zal mijn best doen om je zoveel mogelijk hiermee te helpen. -ERROR_PARSERULE_INVALID_YAML=Ik kon de regel niet verwerken, er is iets verkeerd gegaan. Het lijkt erop dat het YAML-bestand ongeldig is. Ik zal mijn best doen om je zoveel mogelijk hiermee te helpen. ERROR_REPLICATELIST_MISSING_FORMAT_ARGUMENTS_EXCEPTION=Ik kon de lijst niet genereren vanwege een ontbrekend format-argument. Ik denk dat er minder (of meer) parameters zijn dan verwacht. Geef het juiste aantal argumenten op en probeer het opnieuw. ERROR_RULE_IDENTIFIER_AND_PATH=Ik heb een fout gevonden in regel ''{0}'' op positie ''{1}''. ERROR_RUN_GENERIC_EXCEPTION=Ik kon het opgegeven systeemcommando niet uitvoeren, er is iets misgegaan. Dit is een ingewikkeld probleem, omdat het te maken heeft met aspecten van de onderliggende expressietaal. Ik zal mijn best doen om je zoveel mogelijk hiermee te helpen. @@ -81,40 +71,29 @@ ERROR_RUN_INVALID_EXIT_VALUE_EXCEPTION=Het opgegeven systeemcommando heeft een o ERROR_RUN_IO_EXCEPTION=Het uitvoeren van het systeemcommando is mislukt vanwege een IO-fout. Weet je zeker dat het commando bestaat in het pad? Het is misschien een goed idee om het pad te controleren en te kijken of het commando beschikbaar is. ERROR_RUN_TIMEOUT_EXCEPTION=Het uitvoeren van het systeemcommando is onderbroken omdat de maximale uitvoeringsduur overschreden is. Als de tijd te kort was, pas dan de maximale uitvoeringsduur aan. ERROR_RUN_TIMEOUT_INVALID_RANGE=De maximale uitvoeringsduur ontbreekt (hoewel deze optie wel actief is). Dit zou makkelijk op te lossen moeten zijn. Zorg ervoor dat je een positieve long integer-waarde opgeeft. -ERROR_SAVE_COULD_NOT_SAVE_XML=Ik kon de XML-database met de naam ''{0}'' niet opslaan. Ik weet niet precies waarom het fout ging. Misschien heb ik niet de juiste schrijfrechten om het XML-bestand op te slaan. -ERROR_SESSION_OBTAIN_UNKNOWN_KEY=De ''obtain''-methode heeft een onbekende verwijzing gevonden in de sessie: ''{0}''. Als ik iets niet heb kan ik het ook niet gebruiken. Geef een bestaande verwijzing op en probeer het opnieuw. +ERROR_SAVE_COULD_NOT_SAVE_XML=Ik kon de YAML-database met de naam ''{0}'' niet opslaan. Ik weet niet precies waarom het fout ging. Misschien heb ik niet de juiste schrijfrechten om het YAML-bestand op te slaan. +ERROR_SESSION_OBTAIN_UNKNOWN_KEY=De ''get''-methode heeft een onbekende verwijzing gevonden in de sessie: ''{0}''. Als ik iets niet heb kan ik het ook niet gebruiken. Geef een bestaande verwijzing op en probeer het opnieuw. ERROR_SESSION_REMOVE_UNKNOWN_KEY=De ''remove''-methode heeft een onbekende verwijzing gevonden in de sessie: ''{0}''. Als ik iets niet heb kan ik het ook niet verwijderen. Geef een bestaande verwijzing op en probeer het opnieuw. -ERROR_TRIGGER_ACTION_NOT_FOUND=De trigger-actie ''{0}'' is niet gevonden. Controleer de lijst met beschikbare triggers en probeer het opnieuw. -ERROR_TRIGGER_CALL_EXCEPTION=De trigger-actie ''{0}'' kon niet worden aangeroepen. Er is iets misgegaan. ERROR_VALIDATE_EMPTY_FILES_LIST=Ik heb een directive {0} gelezen en kwam erachter dat de opgegeven ''files''-lijst leeg is. Dit zou makkelijk op te lossen moeten zijn: zorg ervoor dat de lijst tenminste een element heeft en probeer het opnieuw. -ERROR_VALIDATE_FILE_IS_RESERVED=Ik heb een directive {0} gelezen en kwam erachter dat de verwijzing ''file'' gebruikt is. Deze verwijzing is gereserveerd, dus je kan het niet gebruiken. Maar maak je geen zorgen, dit zou makkelijk op te lossen moeten zijn: gebruik een andere naam. ERROR_VALIDATE_FILES_IS_NOT_A_LIST=Ik heb een directive {0} gelezen en kwam erachter dat ''files'' een lijst nodig heeft. Zorg dat je het type aanpast naar een lijst en probeer het opnieuw. ERROR_VALIDATE_INVALID_DIRECTIVE_FORMAT=Ik heb een ongeldige directive {0} gevonden in het opgegeven bestand. Pas de directive aan en probeer het opnieuw. ERROR_VALIDATE_NO_DIRECTIVES_FOUND=Er zijn geen directives gevonden in het opgegeven bestand. Zorg ervoor dat er tenminste een directive in het bestand staat en probeer het opnieuw. -ERROR_VALIDATE_ORPHAN_LINEBREAK=Er is een ongeldig directive-regeleinde in regel {0}. Ik kan niet verder. Pas de directive aan en probeer het opnieuw. +ERROR_VALIDATE_ORPHAN_LINEBREAK=Er is een ongeldig directive-regeleinde in regel {0}. Ik kan niet verder. Pas de directive aan en probeer het opnieuw. ERROR_VALIDATE_REFERENCE_IS_RESERVED=Ik heb een directive {0} gelezen en kwam erachter dat de verwijzing ''reference'' gebruikt is. Deze verwijzing is gereserveerd, en kan dus niet gebruikt worden. Maar maak je geen zorgen, dit zou makkelijk op te lossen moeten zijn: gebruik een andere naam. ERROR_VALIDATE_YAML_EXCEPTION=Er is een probleem met de opgegeven YAML-omzetting in directive {0}. Dit probleem is ingewikkeld, omdat het te maken heeft met aspecten van de onderliggende serialisatiesyntax. ERROR_VALIDATEBODY_ARGUMENT_ID_IS_RESERVED=De argumentverwijzing ''{0}'' is gereserveerd, en kan dus niet gebruikt worden. Dit zou makkelijk op te lossen moeten zijn: gebruik een andere naam. -ERROR_VALIDATEBODY_ARGUMENTS_LIST=Ik kon de lijst met argumenten niet vinden. Ik heb de lijst nodig, zelfs als deze leeg is. Pas dit aan en probeer het opnieuw. ERROR_VALIDATEBODY_DUPLICATE_ARGUMENT_IDENTIFIERS=Blijkbaar zijn er dubbele argumentnamen in de regel. Pas dit aan en probeer het opnieuw. ERROR_VALIDATEBODY_MISSING_KEYS=Bij het definiëren van het argumentbereik van een regel moet tenminste 'flag' of 'default' worden gebruikt. Zorg ervoor dat je in ieder geval een van deze gebruikt. ERROR_VALIDATEBODY_NULL_ARGUMENT_ID=Ik kwam erachter dat een van de argumenten geen verwijsnaam heeft. Zorg ervoor dat een geldige naam aan het argument wordt toegewezen en probeer het opnieuw. ERROR_VALIDATEBODY_NULL_COMMAND=Ik heb een null-opdracht in de opgegeven regel gevonden. Dit zou makkelijk op te lossen moeten zijn: geef een geldige opdracht op voor deze regel. -ERROR_VALIDATEBODY_NULL_COMMANDS_LIST=Ik heb een lijst opdrachten nodig. Pas dit aan en probeer het opnieuw. ERROR_VALIDATEHEADER_NULL_ID=De opgegeven regel heeft geen verwijsnaam. Dit is cruciale informatie, pas dit aan en probeer het opnieuw. Zorg ervoor dat de naam hetzelfde is als de bestandsnaam (zonder extensie). ERROR_VALIDATEHEADER_NULL_NAME=De opgegeven regel heeft geen naam. Dit zou makkelijk op te lossen moeten zijn: geef een geldige naam op en probeer het opnieuw. ERROR_VALIDATEHEADER_WRONG_IDENTIFIER=De regel heeft een verkeerde verwijsnaam. Ik verwachtte ''{0}'', maar vond ''{1}''. Dit zou makkelijk op te lossen moeten zijn: vervang de verkeerde verwijsnaam met de correcte naam. -ERROR_VELOCITY_FILE_NOT_FOUND=De template-verwerking kon het opgegeven invoerbestand niet vinden. Zorg dat de locatie correct is en probeer het opnieuw. -ERROR_VELOCITY_PARSE_EXCEPTION=Er was een parseerfout in het opgegeven invoerbestand. Zorg dat het bestand voldoet aan de specificatie van de Velocity Template Language (VLT) en probeer het opnieuw. -ERROR_VELOCITY_METHOD_INVOCATION_EXCEPTION=Er was een fout in een methode-aanroep in het opgegeven invoerbestand. Zorg dat het bestand voldoet aan de specificatie van de Velocity Template Language (VLT) en probeer het opnieuw. -ERROR_VELOCITY_IO_EXCEPTION=De template-verwerking kon niet naar het uitvoerbestand schrijven. Zorg ervoor dat het pad de juiste permissies heeft en probeer het opnieuw. INFO_DISPLAY_EXCEPTION_MORE_DETAILS=Er zijn meer details beschikbaar voor deze exception: INFO_DISPLAY_EXECUTION_TIME=Totaal: {0} seconden INFO_DISPLAY_FILE_INFORMATION=Verwerken van ''{0}'' (grootte: {1}, laatst gewijzigd: {2}), een ogenblik geduld. -INFO_INTERPRETER_DRYRUN_MODE_BOOLEAN_MODE=Ondanks het uitvoeren in dry-runmodus is dit item mogelijk al verwerkt omdat het de booleaanse waarde terug heeft gegeven: {0} +INFO_INTERPRETER_DRYRUN_MODE_BOOLEAN_MODE=Ondanks het uitvoeren in dry-runmodus is dit item mogelijk al verwerkt omdat het de booleaanse waarde terug heeft gegeven: {0} INFO_INTERPRETER_DRYRUN_MODE_SYSTEM_COMMAND=Begin met uitvoeren: {0} -INFO_INTERPRETER_DRYRUN_MODE_TRIGGER_MODE=Ondanks het uitvoeren in dry-runmodus wordt dit onderdeel altijd uitgevoerd omdat het een trigger is. Merk op dat de effecten van een trigger de huidige uitvoering kunnen beïnvloeden. -INFO_INTERPRETER_VERBOSE_MODE_TRIGGER_MODE=Dit onderdeel is een trigger die binnen het bereik van de regel valt. Merk op dat de effecten van een trigger de huidige uitvoering kunnen beïnvloeden. INFO_LABEL_AUTHOR=Auteur: INFO_LABEL_AUTHORS=Auteurs: INFO_LABEL_CONDITIONAL=Voorwaarde: @@ -124,19 +103,7 @@ INFO_LABEL_ON_ERROR=FOUT INFO_LABEL_ON_FAILURE=MISLUKT INFO_LABEL_ON_SUCCESS=SUCCESVOL INFO_LABEL_UNNAMED_TASK=Naamloze taak -INFO_PARSER_ALL_RIGHTS_RESERVED=Alle rechten voorbehouden -INFO_PARSER_DRYRUN_MODE_DESCRIPTION=Controleer alle onderdelen van een opdracht, maar voer niets uit -INFO_PARSER_HELP_DESCRIPTION=toon het hulpbericht -INFO_PARSER_LANGUAGE_DESCRIPTION=stel de applicatietaal in -INFO_PARSER_LOG_DESCRIPTION=genereer een loguitvoer -INFO_PARSER_LOOPS_DESCRIPTION=stel het maximumaantal herhalingen in -INFO_PARSER_NOTES=Deze applicatie gebruikt de volgende libraries en hun respectievelijke licenties: CAL10N: MIT, Commons CLI: Apache 2.0, Commons Collections: Apache 2.0, Commons IO: Apache 2.0, Commons Lang: Apache 2.0, MVEL: Apache 2.0, Logback: dubbele licentie met EPL 1.0 en LGPL 2.1, Simple framework: Apache 2.0, SLF4J: MIT, SnakeYAML: Apache 2.0, Velocity: Apache 2.0, and ZT-Exec: Apache 2.0. Als laatste is arara zelf uitgebracht onder de New BSD licentie. -INFO_PARSER_ONLY_HEADER=lees directives alleen in de bestandsheader -INFO_PARSER_PREAMBLE_DESCRIPTION=stel de preamble in op basis van het configuratiebestand -INFO_PARSER_SILENT_MODE_DESCRIPTION=dempt de opdrachtuitvoer -INFO_PARSER_TIMEOUT_DESCRIPTION=stel de maximale uitvoeringsduur in (in milliseconden) -INFO_PARSER_VERBOSE_MODE_DESCRIPTION=toon de opdrachtuitvoer -INFO_PARSER_VERSION_DESCRIPTION=toon de applicatieversie +INFO_PARSER_NOTES=arara is uitgebracht onder de New BSD licentie. LOG_INFO_BEGIN_BUFFER=OPEN UITVOER LOG_INFO_BOOLEAN_MODE=Booleaanse waarde: {0} LOG_INFO_DIRECTIVES_BLOCK=DIRECTIVES diff --git a/support/arara/source/src/main/resources/com/github/cereda/arara/localization/messages_pt_BR.properties b/support/arara/source/src/main/resources/org/islandoftex/arara/localization/messages_pt_BR.properties index 3ce8cd2fb6..a5b046e909 100644 --- a/support/arara/source/src/main/resources/com/github/cereda/arara/localization/messages_pt_BR.properties +++ b/support/arara/source/src/main/resources/org/islandoftex/arara/localization/messages_pt_BR.properties @@ -34,15 +34,12 @@ # Language: Brazilian Portuguese # Translators: Paulo Roberto Massa Cereda # --------------------------------------------------------------------- - ERROR_BASENAME_NOT_A_FILE=O método ''basename'' requer um arquivo, não um diretório. Observe que ''{0}'' não parece ser um arquivo. Se você precisa realizar alguma tarefa em um diretório, experimente os métodos disponíveis na API Java. ERROR_CALCULATEHASH_IO_EXCEPTION=Por alguma razão, eu não pude calcular o hash. Não tenho ideia porque não deu certo. Talvez o arquivo tenha sido movido ou removido antes ou durante a operação de hash. Ou talvez eu não tenha as permissões corretas para leitura do arquivo. ERROR_CHECKBOOLEAN_NOT_VALID_BOOLEAN=Observe que ''{0}'' não é um valor lógico. Isso é fácil de resolver. Certifique-se de usar uma palavra válida que represente valores lógicos (''yes'' e ''no'', ''true'' e ''false'', ''1'' e ''0'', e ''on'' e ''off''). ERROR_CHECKOS_INVALID_OPERATING_SYSTEM=Não consegui descobrir qual é o seu sistema operacional. O valor ''{0}'' não parece ser uma entrada válida de sistema operacional na minha lista (Eu posso também estar errado, é claro). Por favor, corrija o valor e tente novamente. ERROR_CHECKREGEX_IO_EXCEPTION=Não consegui ler o conteúdo do arquivo ''{0}'', houve um erro de entrada e saída. Não tenho ideia porque não deu certo. Talvez o arquivo tenha sido movido ou removido antes ou durante a operação de leitura. Ou talvez eu não tenha as permissões corretas para leitura do arquivo. -ERROR_CONFIGURATION_FILETYPE_MISSING_EXTENSION=Uma de suas entradas na lista de 'filetypes' no arquivo de configuração não tem a chave 'extension'. Infelizmente, eu não posso definir um novo tipo de arquivo se a extensão correspondente não é informada. Isso é fácil de resolver: adicione uma nova extensão e tente novamente. ERROR_CONFIGURATION_GENERIC_ERROR=Não consegui analisar o arquivo de configuração, alguma coisa de errado aconteceu. Esta parte é complicada, pois envolve aspectos do formato de serialização de dados subjacente. Eu farei o possível para te ajudar da melhor forma que puder. -ERROR_CONFIGURATION_INVALID_YAML=Não consegui analisar o arquivo de configuração, alguma coisa de errado aconteceu. Aparentemente, o arquivo YAML especificado é inválido. Eu farei o possível para te ajudar da melhor forma que puder. ERROR_CONFIGURATION_LOOPS_INVALID_RANGE=O valor definido na chave 'loops' no arquivo de configuração, que define o número máximo de iterações, possui um intervalo inválido. Por favor, certifique-se de especificar um valor inteiro positivo. ERROR_DISCOVERFILE_FILE_NOT_FOUND=Não consegui encontrar o arquivo especificado ''{0}'' {1}. Por favor, certifique-se de que o arquivo existe e que possui uma extensão válida. ERROR_EVALUATE_COMPILATION_FAILED=Por alguma razão, eu não consegui compilar a expressão condicional especificada. Esta parte é complicada, pois envolve aspectos da linguagem de expressão subjacente. Eu farei o possível para te ajudar da melhor forma que puder. @@ -52,27 +49,20 @@ ERROR_FILETYPE_NOT_A_FILE=O método ''filetype'' requer um arquivo, não um dire ERROR_FILETYPE_UNKNOWN_EXTENSION=Não consegui reconhecer ''{0}'' como uma extensão padrão. Se você quiser definir um novo tipo de arquivo, certifique-se de especificar a extensão e o padrão. Estas são as extensões definidas por padrão: {1} ERROR_GETAPPLICATIONPATH_ENCODING_EXCEPTION=Houve um problema de codificação enquanto eu tentava obter o caminho da aplicação. Não há muito o que eu possa fazer sobre isso. ERROR_GETCANONICALFILE_IO_EXCEPTION=Não consegui obter o arquivo canônico por causa de um erro de entrada e saída. Talvez o arquivo tenha sido movido ou removido antes ou durante a operação de busca. Ou talvez eu não tenha as permissões corretas. -ERROR_GETCANONICALPATH_IO_EXCEPTION=Não consegui obter o caminho canônico por causa de um erro de entrada e saída. Talvez o arquivo tenha sido movido ou removido antes ou durante a operação de busca. Ou talvez eu não tenha as permissões corretas. ERROR_GETPARENTCANONICALPATH_IO_EXCEPTION=Não consegui obter o caminho canônico ascendente por causa de um erro de entrada e saída. Talvez o arquivo tenha sido movido ou removido antes ou durante a operação de busca. Ou talvez eu não tenha as permissões corretas. ERROR_INTERPRETER_ARGUMENT_IS_REQUIRED=Parece que o argumento ''{0}'' está marcado como obrigatório na regra, mas eu não consegui encontrá-lo nos parâmetros da diretiva correspondente. Por favor, certifique-se de adicioná-lo como parâmetro em sua diretiva e tente novamente. ERROR_INTERPRETER_COMMAND_RUNTIME_ERROR=Não consegui avaliar um dos comandos disponibilizados. Esta parte é complicada, pois envolve aspectos da linguagem de expressão subjacente. Eu farei o possível para te ajudar da melhor forma que puder. ERROR_INTERPRETER_DEFAULT_VALUE_RUNTIME_ERROR=Não consegui avaliar a expressão associada ao valor padrão de um dos argumentos. Esta parte é complicada, pois envolve aspectos da linguagem de expressão subjacente. Eu farei o possível para te ajudar da melhor forma que puder. ERROR_INTERPRETER_EXIT_RUNTIME_ERROR=Não consegui avaliar a expressão associada ao código de saída de um dos comandos disponibilizados. Esta parte é complicada, pois envolve aspectos da linguagem de expressão subjacente. Eu farei o possível para te ajudar da melhor forma que puder. ERROR_INTERPRETER_FLAG_RUNTIME_EXCEPTION=Não consegui avaliar a expressão associada à presença de um dos argumentos. Esta parte é complicada, pois envolve aspectos da linguagem de expressão subjacente. Eu farei o possível para te ajudar da melhor forma que puder. -ERROR_INTERPRETER_NULL_COMMAND=Sinto muito, mas, aparentemente, um dos comandos disponibilizados retornou um valor nulo. Por favor, certifique-se de que o comando é válido e tente novamente. ERROR_INTERPRETER_RULE_NOT_FOUND=Não consegui encontrar uma regra chamada ''{0}'' nos caminhos de regras especificados. Talvez uma palavra digitada incorretamente? Eu estava procurando por um arquivo chamado ''{0}.yaml'' nos seguintes caminhos, em ordem de prioridade: {1} ERROR_INTERPRETER_UNKNOWN_KEYS=Encontrei as seguintes chaves desconhecidas na diretiva: {0}. Isso é fácil de resolver, apenas remova essas chaves do seu mapa. ERROR_INTERPRETER_WRONG_EXIT_CLOSURE_RETURN=A expressão 'exit' referente ao código de saída deve sempre retornar um valor lógico (mesmo se não há computação propriamente dita). Isso é fácil de resolver: apenas certifique-se de corrigir o tipo de retorno e tente novamente. ERROR_ISSUBDIRECTORY_NOT_A_DIRECTORY=O método ''isSubdirectory'' requer um diretório, não um arquivo. Observe que ''{0}'' não parece ser um diretório. ERROR_LANGUAGE_INVALID_CODE=O código de idioma especificado é inválido. No momento, eu sei falar os seguintes idiomas: {0} -ERROR_LOAD_COULD_NOT_LOAD_XML=Não consegui carregar o banco de dados XML chamado ''{0}''. Não tenho ideia porque não deu certo. Talvez o arquivo tenha sido movido ou removido antes ou durante a operação de leitura. Ou talvez eu não tenha as permissões corretas para leitura do arquivo. A propósito, certifique-se de que o arquivo XML esteja correto. +ERROR_LOAD_COULD_NOT_LOAD_XML=Não consegui carregar o banco de dados YAML chamado ''{0}''. Não tenho ideia porque não deu certo. Talvez o arquivo tenha sido movido ou removido antes ou durante a operação de leitura. Ou talvez eu não tenha as permissões corretas para leitura do arquivo. A propósito, certifique-se de que o arquivo YAML esteja correto. ERROR_PARSER_INVALID_PREAMBLE=Sinto muito, mas o preâmbulo ''{0}'' não foi encontrado. Por favor, certifique-se de que esta chave existe no arquivo de configuração. -ERROR_PARSER_LOOPS_INVALID_RANGE=O valor definido na linha de comando para o número máximo de iterações possui um intervalo inválido. Por favor, certifique-se de especificar um valor inteiro positivo. -ERROR_PARSER_LOOPS_NAN=A opção referente ao número máximo de iterações requer, é claro, um número como argumento. Isso é fácil de resolver. Apenas certifique-se de especificar um valor inteiro positivo. -ERROR_PARSER_TIMEOUT_INVALID_RANGE=O valor definido na linha de comando para o timeout de execução possui um intervalo inválido. Por favor, certifique-se de especificar um valor inteiro positivo. -ERROR_PARSER_TIMEOUT_NAN=A opção referente ao timeout de execução requer um número como argumento. Isso é fácil de resolver. Apenas certifique-se de especificar um valor inteiro positivo. ERROR_PARSERULE_GENERIC_ERROR=Não consegui analisar a regra, alguma coisa de errado aconteceu. Esta parte é complicada, pois envolve aspectos do formato de serialização de dados subjacente. Eu farei o possível para te ajudar da melhor forma que puder. -ERROR_PARSERULE_INVALID_YAML=Não consegui analisar a regra, alguma coisa de errado aconteceu. Aparentemente, o arquivo YAML especificado é inválido. Eu farei o possível para te ajudar da melhor forma que puder. ERROR_REPLICATELIST_MISSING_FORMAT_ARGUMENTS_EXCEPTION=Não consegui replicar a lista por causa de um formato de argumento faltante. Meu palpite é que existem menos (ou mais) parâmetros do que o esperado. Certifique-se de corrigir o número de parâmetros e tente novamente. ERROR_RULE_IDENTIFIER_AND_PATH=Encontrei um erro na regra ''{0}'' localizada em ''{1}''. ERROR_RUN_GENERIC_EXCEPTION=Não consegui executar o comando de sistema disponibilizado, alguma coisa de errado aconteceu. Esta parte é complicada, pois envolve aspectos da linguagem de expressão subjacente. Eu farei o possível para te ajudar da melhor forma que puder. @@ -81,13 +71,10 @@ ERROR_RUN_INVALID_EXIT_VALUE_EXCEPTION=A execução do comando de sistema retorn ERROR_RUN_IO_EXCEPTION=A execução do comando de sistema falhou por causa de um erro de entrada e saída. Você tem certeza de que o comando de sistema especificado existe no seu caminho? Pode ser uma boa ideia verificar o caminho do sistema e confirmar se o comando realmente está disponível. ERROR_RUN_TIMEOUT_EXCEPTION=A execução do comando de sistema atingiu o timeout especificado e foi abortada. Se o tempo foi muito curto, certifique-se de especificar um valor maior. ERROR_RUN_TIMEOUT_INVALID_RANGE=O valor de timeout provavelmente está faltando (apesar de estar habilitado). Isso é fácil de resolver. Por favor, certifique-se de especificar um valor positivo inteiro. -ERROR_SAVE_COULD_NOT_SAVE_XML=Não consegui salvar o banco de dados XML chamado ''{0}''. Não tenho ideia porque não deu certo. Talvez eu não tenha as permissões corretas para escrever o arquivo XML no disco. -ERROR_SESSION_OBTAIN_UNKNOWN_KEY=O método ''obtain'' encontrou a chave desconhecida ''{0}'' no escopo de sessão. Não posso obter um valor que não existe na sessão. Por favor, especifique uma chave válida e tente novamente. +ERROR_SAVE_COULD_NOT_SAVE_XML=Não consegui salvar o banco de dados YAML chamado ''{0}''. Não tenho ideia porque não deu certo. Talvez eu não tenha as permissões corretas para escrever o arquivo YAML no disco. +ERROR_SESSION_OBTAIN_UNKNOWN_KEY=O método ''get'' encontrou a chave desconhecida ''{0}'' no escopo de sessão. Não posso obter um valor que não existe na sessão. Por favor, especifique uma chave válida e tente novamente. ERROR_SESSION_REMOVE_UNKNOWN_KEY=O método ''remove'' encontrou a chave desconhecida ''{0}'' no escopo de sessão. Não posso remover um valor que não existe na sessão. Por favor, especifique uma chave válida e tente novamente. -ERROR_TRIGGER_ACTION_NOT_FOUND=A ação de gatilho ''{0}'' não foi encontrada. Certifique-se de consultar a lista de gatilhos disponíveis e tente novamente. -ERROR_TRIGGER_CALL_EXCEPTION=A ação de gatilho ''{0}'' não pôde ser executada. Alguma coisa de errado aconteceu. ERROR_VALIDATE_EMPTY_FILES_LIST=Li uma diretiva {0} e descobri que a lista ''files'' especificada está vazia. Isso é fácil de resolver: certifique-se de que a lista possua, pelo menos, um elemento e tente novamente. -ERROR_VALIDATE_FILE_IS_RESERVED=Li uma diretiva {0} e descobri que a chave ''file'' foi utilizada. Esta chave é reservada, portanto você não pode utilizá-la! Mas não se preocupe, isso é fácil de resolver. Apenas substitua esse nome por outro. ERROR_VALIDATE_FILES_IS_NOT_A_LIST=Li uma diretiva {0} e descobri que ''files'' requer uma lista. Por favor, certifique-se de corrigir o tipo para uma lista adequada e tente novamente. ERROR_VALIDATE_INVALID_DIRECTIVE_FORMAT=Encontrei uma diretiva inválida {0} no arquivo especificado. Certifique-se de corrigir a diretiva e tente novamente. ERROR_VALIDATE_NO_DIRECTIVES_FOUND=Parece que o arquivo especificado não possui diretivas! Certifique-se de incluir, pelo menos, uma diretiva e tente novamente. @@ -95,26 +82,18 @@ ERROR_VALIDATE_ORPHAN_LINEBREAK=Aparentemente, existe uma quebra de linha de uma ERROR_VALIDATE_REFERENCE_IS_RESERVED=Li uma diretiva {0} e descobri que a chave ''reference'' foi utilizada. Esta chave é reservada, portanto você não pode utilizá-la! Mas não se preocupe, isso é fácil de resolver. Apenas substitua esse nome por outro. ERROR_VALIDATE_YAML_EXCEPTION=Ocorreu um problema com o mapa YAML especificado em uma diretiva {0}. Esta parte é complicada, pois envolve aspectos do formato de serialização de dados subjacente. ERROR_VALIDATEBODY_ARGUMENT_ID_IS_RESERVED=O identificador de argumento ''{0}'' está reservado, portanto você não pode utilizá-lo. Isso é fácil de resolver. Apenas substitua esse nome por outro. -ERROR_VALIDATEBODY_ARGUMENTS_LIST=Não consegui encontrar a lista de argumentos. Preciso dessa lista, mesmo que ela esteja vazia. Certifique-se de corrigir esse erro e tente novamente. ERROR_VALIDATEBODY_DUPLICATE_ARGUMENT_IDENTIFIERS=Aparentemente, você possui identificadores de argumentos duplicados em sua regra. Certifique-se de corrigir esse erro e tente novamente. ERROR_VALIDATEBODY_MISSING_KEYS=Ao definir um escopo de argumento de regra, ao menos a chave 'flag' ou 'default' deve ser utilizada. Por favor, certifique-se de utilizar, pelo menos, uma delas. ERROR_VALIDATEBODY_NULL_ARGUMENT_ID=Descobri que um dos argumentos não possui identificador associado. Por favor, certifique-se de adicionar um identificador válido ao argumento e tente novamente. ERROR_VALIDATEBODY_NULL_COMMAND=Encontrei um comando nulo na regra especificada. Isso é fácil de resolver. Certifique-se de adicionar um comando válido na regra. -ERROR_VALIDATEBODY_NULL_COMMANDS_LIST=Preciso de uma lista de comandos. Certifique-se de corrigir esse erro e tente novamente. ERROR_VALIDATEHEADER_NULL_ID=A regra especificada não possui identificador. É uma informação crucial, portanto, certifique-se de corrigir esse erro e tente novamente. Lembre-se de que o identificador deve possuir o mesmo nome do arquivo da regra (sem a extensão, é claro). ERROR_VALIDATEHEADER_NULL_NAME=A regra especificada não possui nome. Isso é fácil de resolver. Certifique-se de adicionar um nome válido e tente novamente. ERROR_VALIDATEHEADER_WRONG_IDENTIFIER=A regra possui um identificador incorreto. Eu estava esperando ''{0}'', mas encontrei ''{1}''. Isso é fácil de resolver: apenas substitua o identificador incorreto pelo valor correto. -ERROR_VELOCITY_FILE_NOT_FOUND=O motor de modelo não conseguiu encontrar o arquivo de entrada especificado. Certifique-se de que a localização está correta e tente novamente. -ERROR_VELOCITY_PARSE_EXCEPTION=Ocorreu um erro de análise no arquivo de entrada especificado. Certifique-se de que o arquivo esteja aderente ao formato Velocity Template Language (VTL) e tente novamente. -ERROR_VELOCITY_METHOD_INVOCATION_EXCEPTION=Ocorreu um erro de invocação de método no arquivo de entrada especificado. Certifique-se de que o arquivo esteja aderente ao formato Velocity Template Language (VTL) e tente novamente. -ERROR_VELOCITY_IO_EXCEPTION=O motor de modelo não conseguiu escrever no arquivo de saída. Certifique-se de que o caminho possui as permissões corretas e tente novamente. INFO_DISPLAY_EXCEPTION_MORE_DETAILS=Detalhes adicionais estão disponíveis para esta exceção: INFO_DISPLAY_EXECUTION_TIME=Total: {0} segundos INFO_DISPLAY_FILE_INFORMATION=Processando ''{0}'' (tamanho: {1}, última modificação: {2}), por favor, aguarde. INFO_INTERPRETER_DRYRUN_MODE_BOOLEAN_MODE=Apesar da execução em modo dry-run, é provável que esta entrada já foi processada, dado que o seguinte valor lógico foi retornado: {0} INFO_INTERPRETER_DRYRUN_MODE_SYSTEM_COMMAND=A executar: {0} -INFO_INTERPRETER_DRYRUN_MODE_TRIGGER_MODE=Apesar da execução em modo dry-run, esta entrada é sempre processada por tratar-se de um gatilho. Observe que os efeitos de um gatilho podem influenciar a execução corrente. -INFO_INTERPRETER_VERBOSE_MODE_TRIGGER_MODE=Esta entrada é um gatilho originado a partir do escopo da regra. Observe que os efeitos de um gatilho podem influenciar a execução corrente. INFO_LABEL_AUTHOR=Autor: INFO_LABEL_AUTHORS=Autores: INFO_LABEL_CONDITIONAL=Expressão condicional: @@ -124,19 +103,7 @@ INFO_LABEL_ON_ERROR=ERRO INFO_LABEL_ON_FAILURE=FRACASSO INFO_LABEL_ON_SUCCESS=SUCESSO INFO_LABEL_UNNAMED_TASK=Tarefa sem nome -INFO_PARSER_ALL_RIGHTS_RESERVED=Todos os direitos reservados -INFO_PARSER_DRYRUN_MODE_DESCRIPTION=passa por todas as preparações para executar um comando, mas sem chamadas reais -INFO_PARSER_HELP_DESCRIPTION=imprime a mensagem de ajuda -INFO_PARSER_LANGUAGE_DESCRIPTION=define o idioma da aplicação -INFO_PARSER_LOG_DESCRIPTION=gera uma saída para registro -INFO_PARSER_LOOPS_DESCRIPTION=define o número máximo de iterações -INFO_PARSER_NOTES=Esta ferramenta utiliza as seguintes bibliotecas e suas respectivas licenças: CAL10N: MIT, Commons CLI: Apache 2.0, Commons Collections: Apache 2.0, Commons IO: Apache 2.0, Commons Lang: Apache 2.0, MVEL: Apache 2.0, Logback: licença dupla com EPL 1.0 e LGPL 2.1, Simple framework: Apache 2.0, SLF4J: MIT, SnakeYAML: Apache 2.0, Velocity: Apache 2.0, and ZT-Exec: Apache 2.0. Por fim, mas não menos importante, arara é distribuída sob a licença New BSD. -INFO_PARSER_ONLY_HEADER=extrai diretivas apenas no cabeçalho do arquivo -INFO_PARSER_PREAMBLE_DESCRIPTION=define o preâmbulo de arquivo de acordo com o arquivo de configuração -INFO_PARSER_SILENT_MODE_DESCRIPTION=oculta a saída do comando -INFO_PARSER_TIMEOUT_DESCRIPTION=define o timeout de execução (em milissegundos) -INFO_PARSER_VERBOSE_MODE_DESCRIPTION=imprime a saída do comando -INFO_PARSER_VERSION_DESCRIPTION=imprime a versão da aplicação +INFO_PARSER_NOTES=arara é distribuída sob a licença New BSD. LOG_INFO_BEGIN_BUFFER=INÍCIO DO BUFFER DE SAÍDA LOG_INFO_BOOLEAN_MODE=Valor lógico: {0} LOG_INFO_DIRECTIVES_BLOCK=DIRETIVAS diff --git a/support/arara/source/src/test/java/com/github/cereda/arara/tests/LocalizationTest.java b/support/arara/source/src/test/java/com/github/cereda/arara/tests/LocalizationTest.java deleted file mode 100644 index ab5978265d..0000000000 --- a/support/arara/source/src/test/java/com/github/cereda/arara/tests/LocalizationTest.java +++ /dev/null @@ -1,115 +0,0 @@ -/** - * Arara, the cool TeX automation tool - * Copyright (c) 2012, Paulo Roberto Massa Cereda - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions - * are met: - * - * 1. Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * 3. Neither the name of the project's author nor the names of its - * contributors may be used to endorse or promote products derived from - * this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, - * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; - * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT - * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY - * WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ -package com.github.cereda.arara.tests; - -import ch.qos.cal10n.verifier.Cal10nError; -import ch.qos.cal10n.verifier.IMessageKeyVerifier; -import ch.qos.cal10n.verifier.MessageKeyVerifier; -import com.github.cereda.arara.model.Messages; -import java.util.List; -import java.util.Locale; -import static org.junit.Assert.assertEquals; -import org.junit.Test; - -/** - * Tests the localizated messages, checking if all keys are set. - * @author Paulo Roberto Massa Cereda - * @version 4.0 - * @since 4.0 - */ -public class LocalizationTest { - - /** - * Helper method, checks the provided locale. - * @param locale The locale. - * @return The size of the error list. - */ - private int check(Locale locale) { - IMessageKeyVerifier verifier = new MessageKeyVerifier(Messages.class); - List<Cal10nError> errors = verifier.verify(locale); - for(Cal10nError error : errors) { - System.err.println(error); - } - return errors.size(); - } - - /** - * Verifies the English localization (provided by Paulo). - */ - @Test - public void verifyEnglish() { - assertEquals(0, check(new Locale("en"))); - } - - /** - * Verifies the German localization (provided by Marco). - */ - @Test - public void verifyGerman() { - assertEquals(0, check(new Locale("de"))); - } - - /** - * Verifies the Broad Norfolk localization (provided by Nicola). - */ - @Test - public void verifyBroadNorfolk() { - assertEquals(0, check(new Locale("en", "QN"))); - } - - /** - * Verifies the Dutch localization (provided by Marijn). - */ - @Test - public void verifyDutch() { - assertEquals(0, check(new Locale("nl"))); - } - - /** - * Verifies the Brazilian Portuguese localization (provided by Paulo). - */ - @Test - public void verifyBrazilianPortuguese() { - assertEquals(0, check(new Locale("pt", "BR"))); - } - - /** - * Verifies the Italian localization (provided by Enrico). - */ - @Test - public void verifyItalian() { - assertEquals(0, check(new Locale("it"))); - } - -} diff --git a/support/arara/source/src/test/kotlin/org/islandoftex/arara/filehandling/FileHandlingUtilsTest.kt b/support/arara/source/src/test/kotlin/org/islandoftex/arara/filehandling/FileHandlingUtilsTest.kt new file mode 100644 index 0000000000..55b13a8fe5 --- /dev/null +++ b/support/arara/source/src/test/kotlin/org/islandoftex/arara/filehandling/FileHandlingUtilsTest.kt @@ -0,0 +1,62 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.filehandling + +import io.kotlintest.shouldBe +import io.kotlintest.shouldThrow +import io.kotlintest.specs.ShouldSpec +import java.io.File +import java.nio.file.Files +import org.islandoftex.arara.Arara +import org.islandoftex.arara.configuration.AraraSpec +import org.islandoftex.arara.model.AraraException + +class FileHandlingUtilsTest : ShouldSpec({ + should("fail generating CRC sums on inexistent files") { + shouldThrow<AraraException> { + FileHandlingUtils.calculateHash(File("QUACK")) + } + } + should("generate correct CRC sums") { + FileHandlingUtils.calculateHash(File("../LICENSE")) shouldBe "2396b4e2" + FileHandlingUtils.calculateHash(File("../CODE_OF_CONDUCT.md")) shouldBe "536c426f" + } + + should("find correct extension") { + FileHandlingUtils.getFileExtension(File("QUACK")) shouldBe "" + FileHandlingUtils.getFileExtension(File("a.tex")) shouldBe "tex" + FileHandlingUtils.getFileExtension(File(".tex")) shouldBe "tex" + } + should("find correct basename") { + FileHandlingUtils.getBasename(File("QUACK")) shouldBe "QUACK" + FileHandlingUtils.getBasename(File("a.tex")) shouldBe "a" + FileHandlingUtils.getBasename(File(".tex")) shouldBe "" + } + + should("get subdirecotry relationship right") { + FileHandlingUtils.isSubDirectory(File("../docs"), File("..")) shouldBe true + FileHandlingUtils.isSubDirectory(File(".."), File("../docs")) shouldBe false + shouldThrow<AraraException> { + FileHandlingUtils.isSubDirectory(File("../LICENSE"), File("..")) + } + shouldThrow<AraraException> { + FileHandlingUtils.isSubDirectory(File(".."), File("../LICENSE")) + } + } + + should("detect changes on file") { + val file = Files.createTempFile(null, null).toFile() + val referenceBackup = Arara.config[AraraSpec.Execution.reference] + Arara.config[AraraSpec.Execution.reference] = file.parentFile.resolve("reference") + FileHandlingUtils.hasChanged(file) shouldBe true + FileHandlingUtils.hasChanged(file) shouldBe false + file.writeText("QUACK") + FileHandlingUtils.hasChanged(file) shouldBe true + FileHandlingUtils.hasChanged(file) shouldBe false + file.writeText("QUACK2") + FileHandlingUtils.hasChanged(file) shouldBe true + file.delete() + FileHandlingUtils.hasChanged(file) shouldBe true + FileHandlingUtils.hasChanged(file) shouldBe false + Arara.config[AraraSpec.Execution.reference] = referenceBackup + } +}) diff --git a/support/arara/source/src/test/kotlin/org/islandoftex/arara/filehandling/FileSearchingUtilsTest.kt b/support/arara/source/src/test/kotlin/org/islandoftex/arara/filehandling/FileSearchingUtilsTest.kt new file mode 100644 index 0000000000..47f9916c43 --- /dev/null +++ b/support/arara/source/src/test/kotlin/org/islandoftex/arara/filehandling/FileSearchingUtilsTest.kt @@ -0,0 +1,58 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.filehandling + +import io.kotlintest.shouldBe +import io.kotlintest.specs.ShouldSpec +import java.nio.file.Files +import java.nio.file.Path +import kotlin.reflect.full.declaredMemberFunctions +import kotlin.reflect.jvm.isAccessible + +class FileSearchingUtilsTest : ShouldSpec({ + // TODO: test implicit extensions + + fun prepareFileSystem(): Path { + val tempDir = Files.createTempDirectory(System.nanoTime().toString()) + tempDir.resolve("quack/quack").toFile().mkdirs() + listOf("quack", "quack/quack", "quack/quack/quack").forEach { + tempDir.resolve("$it.tex").toFile().writeText(" ") + tempDir.resolve("$it.txt").toFile().writeText(" ") + } + return tempDir + } + + should("fail looking up inexistent file") { + val lookupFile = FileSearchingUtils::class.declaredMemberFunctions + .first { it.name == "lookupFile" } + lookupFile.isAccessible = true + lookupFile.call(FileSearchingUtils, "QUACK") shouldBe null + } + + should("fail on existing directory") { + val lookupFile = FileSearchingUtils::class.declaredMemberFunctions + .first { it.name == "lookupFile" } + lookupFile.isAccessible = true + lookupFile.call(FileSearchingUtils, "../buildSrc") shouldBe null + } + + should("find file by extension") { + val tempDir = prepareFileSystem() + FileSearchingUtils.listFilesByExtensions(tempDir.toFile(), + listOf("tex"), false).toSet() shouldBe + setOf(tempDir.resolve("quack.tex").toFile()) + FileSearchingUtils.listFilesByExtensions(tempDir.toFile(), + listOf("tex"), true).toSet() shouldBe + listOf("quack", "quack/quack", "quack/quack/quack") + .map { tempDir.resolve("$it.tex").toFile() }.toSet() + } + should("find file by pattern") { + val tempDir = prepareFileSystem() + FileSearchingUtils.listFilesByPatterns(tempDir.toFile(), + listOf("*q*.txt"), false).toSet() shouldBe + setOf(tempDir.resolve("quack.txt").toFile()) + FileSearchingUtils.listFilesByPatterns(tempDir.toFile(), + listOf("q*.txt"), true).toSet() shouldBe + listOf("quack", "quack/quack", "quack/quack/quack") + .map { tempDir.resolve("$it.txt").toFile() }.toSet() + } +}) diff --git a/support/arara/source/src/test/kotlin/org/islandoftex/arara/localization/LanguageCoverageTest.kt b/support/arara/source/src/test/kotlin/org/islandoftex/arara/localization/LanguageCoverageTest.kt new file mode 100644 index 0000000000..704d3e319d --- /dev/null +++ b/support/arara/source/src/test/kotlin/org/islandoftex/arara/localization/LanguageCoverageTest.kt @@ -0,0 +1,102 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.localization + +import ch.qos.cal10n.verifier.MessageKeyVerifier +import io.kotlintest.inspectors.forAll +import io.kotlintest.matchers.collections.shouldNotBeEmpty +import io.kotlintest.shouldBe +import io.kotlintest.shouldThrow +import io.kotlintest.specs.ShouldSpec +import java.io.File +import java.io.IOException +import java.nio.file.Files +import java.nio.file.Path +import java.nio.file.Paths +import java.util.Locale +import java.util.stream.Collectors +import org.islandoftex.arara.model.AraraException + +class LanguageCoverageTest : ShouldSpec({ + "locale definitions" { + /** + * Helper method, checks the provided locale (all keys set?). + * + * @param locale The locale. + * @return The size of the error list. + */ + fun check(locale: Locale): Int { + val errors = MessageKeyVerifier(Messages::class.java).verify(locale) + errors.forEach(System.err::println) + return errors.size + } + + should("succeed instantiating known locale") { + Language("en").locale.language shouldBe "en" + } + should("throw on unknown locale instantiation") { + shouldThrow<AraraException> { + Language("quack") + } + } + + should("not error on known localizations") { + listOf("en", "de", "nl", "it").forAll { + check(Locale(it)) shouldBe 0 + } + check(Locale("en", "QN")) shouldBe 0 + check(Locale("pt", "BR")) shouldBe 0 + } + } + "language coverage" { + /* + * Tests the localized messages, checking if all messages are properly + * quoted (but not necessarily whether they are loadable). + */ + should("get all strings from every language") { + // get all files + val files = Files.list( + Paths.get("src/main/resources/org/islandoftex/arara/localization")) + .map { p: Path -> + val f = p.toFile() + if (f.name.endsWith("properties") && !f.isDirectory) f + else null + } + .collect(Collectors.toList()) + .toList() + .filterNotNull() + files.shouldNotBeEmpty() + + // for each report, print + // the corresponding entry + files.map { file: File -> + try { + LanguageReport.analyze(file) + } catch (exception: IOException) { + throw AssertionError( + "Fatal exception: an error was raised while " + + "trying to read one of the languages. Please " + + "make sure all languages in the provided " + + "directory have read permission.") + } + }.forEach { report -> + // debug output + println(report.reference.name + + "\t" + String.format(" %2.2f%%", report.coverage)) + + // if there are problematic lines, + // add the current language report + if (report.lines.isNotEmpty()) { + // legend: S = Simple message, single quotes should not be doubled + // P = Parametrized message, single quotes must be doubled + + // build the beginning of the line + println(report.reference.name) + // print error lines + println(report.lines) + } + + report.coverage shouldBe 100.0f + } + } + } +}) diff --git a/support/arara/source/src/test/kotlin/org/islandoftex/arara/localization/LanguageReport.kt b/support/arara/source/src/test/kotlin/org/islandoftex/arara/localization/LanguageReport.kt new file mode 100644 index 0000000000..addcd0262c --- /dev/null +++ b/support/arara/source/src/test/kotlin/org/islandoftex/arara/localization/LanguageReport.kt @@ -0,0 +1,143 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.localization + +import java.io.File + +/** + * Implements the language report model. + * + * @author Island of TeX + * @version 5.0 + * @since 5.0 + */ +data class LanguageReport( + /** + * The file reference. + */ + val reference: File, + /** + * Total of checked lines. + */ + val total: Int, + /** + * List of problematic lines and their corresponding error types. + */ + val lines: Map<Int, Char> +) { + /** + * Language coverage of the file. + */ + val coverage: Float + get() = if (lines.isEmpty()) { + 100f + } else { + (1f - lines.size.toFloat() / total) * 100f + } + + companion object { + /** + * Analyzes the list of lines. + * + * @param file The file to read. + * @return The language report. + */ + internal fun analyze(file: File): LanguageReport { + // holds the current line number + var number = 1 + // holds the number of checked lines + var checked = 0 + + // flag that holds the + // current analysis + var check: Int + + val reportLines = mutableMapOf<Int, Char>() + + // check every line of the language file + file.forEachLine { line -> + // let's only analyze lines + // that are not comments + if (!line.trim().startsWith("#")) { + // increment the checked + // line counter + checked++ + + // line is a parametrized message + check = if (line.contains("{0}")) { + // check the corresponding pattern + checkParametrizedMessage(line) + } else { + // check the corresponding pattern + checkMessage(line) + } + + // we found an error, + // report it + if (check != 0) { + // add line and error type to the report + reportLines[number] = if (check == 1) 'P' else 'S' + } + } + + // let's move to the next line + number++ + } + + // return the language report + return LanguageReport( + reference = file, + total = checked, + lines = reportLines) + } + + /** + * Checks if the provided message follows the simple format. + * + * @param text Message. + * @return An integer value. + */ + private fun checkMessage(text: String): Int { + var i = 0 + var c: Char + for (element in text) { + c = element + i = if (c == '\'') { + if (i == 1) { + return 2 + } else { + 1 + } + } else { + 0 + } + } + return 0 + } + + /** + * Checks if the provided message follows the parametrized format. + * + * @param text Message. + * @return An integer value. + */ + private fun checkParametrizedMessage(text: String): Int { + var i = 0 + var c: Char + for (element in text) { + c = element + if (c == '\'') { + i += 1 + } else { + if (i != 0) { + if (i != 2) { + return 1 + } else { + i = 0 + } + } + } + } + return 0 + } + } +} diff --git a/support/arara/source/src/test/kotlin/org/islandoftex/arara/localization/LanguageTest.kt b/support/arara/source/src/test/kotlin/org/islandoftex/arara/localization/LanguageTest.kt new file mode 100644 index 0000000000..92d38ebc9b --- /dev/null +++ b/support/arara/source/src/test/kotlin/org/islandoftex/arara/localization/LanguageTest.kt @@ -0,0 +1,20 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.localization + +import io.kotlintest.shouldBe +import io.kotlintest.shouldThrow +import io.kotlintest.specs.ShouldSpec +import java.util.Locale +import org.islandoftex.arara.model.AraraException + +class LanguageTest : ShouldSpec({ + should("instantiate with known code") { + Language("en").locale shouldBe Locale.ENGLISH + } + + should("throw on unknown language") { + shouldThrow<AraraException> { + Language("quack") + } + } +}) diff --git a/support/arara/source/src/test/kotlin/org/islandoftex/arara/model/SessionTest.kt b/support/arara/source/src/test/kotlin/org/islandoftex/arara/model/SessionTest.kt new file mode 100644 index 0000000000..7580d8c81e --- /dev/null +++ b/support/arara/source/src/test/kotlin/org/islandoftex/arara/model/SessionTest.kt @@ -0,0 +1,76 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.model + +import io.kotlintest.shouldBe +import io.kotlintest.shouldNotThrow +import io.kotlintest.shouldThrow +import io.kotlintest.specs.ShouldSpec + +class SessionTest : ShouldSpec({ + should("include all environment variables") { + Session.clear() + Session.updateEnvironmentVariables() + Session.contains("environment:PATH") shouldBe true + } + + should("properly check existence") { + Session.clear() + Session.put("A", "B") + Session.contains("A") shouldBe true + Session.contains("C") shouldBe false + } + + should("support insertion") { + Session.clear() + Session.put("A", "B") + Session.contains("A") shouldBe true + } + + should("support get") { + Session.clear() + Session.put("A", "B") + Session["A"] shouldBe "B" + } + + should("support removal") { + Session.clear() + Session.put("A", "B") + Session.put("C", "D") + Session.contains("A") shouldBe true + Session.contains("C") shouldBe true + Session.remove("A") + Session.contains("A") shouldBe false + Session.contains("C") shouldBe true + } + + should("clear itself") { + Session.clear() + Session.put("A", "B") + Session.put("C", "D") + Session.contains("A") shouldBe true + Session.contains("C") shouldBe true + Session.clear() + Session.contains("A") shouldBe false + Session.contains("C") shouldBe false + } + + should("throw on unknown removal") { + Session.clear() + Session.put("A", "B") + shouldNotThrow<AraraException> { + Session.remove("A") + } + shouldThrow<AraraException> { + Session.remove("C") + } + } + + should("throw on unknown getter") { + Session.clear() + Session.put("A", "B") + Session["A"] shouldBe "B" + shouldThrow<AraraException> { + Session["C"] + } + } +}) diff --git a/support/arara/source/src/test/kotlin/org/islandoftex/arara/utils/CommonUtilsTest.kt b/support/arara/source/src/test/kotlin/org/islandoftex/arara/utils/CommonUtilsTest.kt new file mode 100644 index 0000000000..b77b901ef6 --- /dev/null +++ b/support/arara/source/src/test/kotlin/org/islandoftex/arara/utils/CommonUtilsTest.kt @@ -0,0 +1,33 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.utils + +import io.kotlintest.shouldBe +import io.kotlintest.specs.ShouldSpec +import org.islandoftex.arara.Arara +import org.islandoftex.arara.configuration.AraraSpec +import org.islandoftex.arara.localization.Language + +class CommonUtilsTest : ShouldSpec({ + should("format bytes correctly") { + Arara.config[AraraSpec.Execution.language] = Language("en") + mapOf(800 to "800 B", + 1000 to "1.0 kB", + 1024 to "1.0 kB", + 1000000 to "1.0 MB").forEach { (key, value) -> + CommonUtils.byteSizeToString(key.toLong()) shouldBe value + } + } + + should("find system utils") { + CommonUtils.isOnPath("echo") shouldBe true + } + should("not find utils with fantasy name") { + // hopefully no one will have such a command in the path… + CommonUtils.isOnPath("echoQuackForArara") shouldBe false + } + + should("flatten lists correctly") { + CommonUtils.flatten(listOf(1, 2, listOf(3, 4, listOf(5, 6)))) + .toSet() shouldBe (setOf(1, 2, 3, 4, 5, 6) as Set<Any>) + } +}) diff --git a/support/arara/source/src/test/kotlin/org/islandoftex/arara/utils/ExecutionTest.kt b/support/arara/source/src/test/kotlin/org/islandoftex/arara/utils/ExecutionTest.kt new file mode 100644 index 0000000000..a0cc52145a --- /dev/null +++ b/support/arara/source/src/test/kotlin/org/islandoftex/arara/utils/ExecutionTest.kt @@ -0,0 +1,139 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.utils + +import io.kotlintest.DoNotParallelize +import io.kotlintest.matchers.string.shouldContain +import io.kotlintest.matchers.string.shouldNotContain +import io.kotlintest.shouldBe +import io.kotlintest.shouldNotBe +import io.kotlintest.shouldThrow +import io.kotlintest.specs.ShouldSpec +import java.io.ByteArrayOutputStream +import java.io.File +import java.io.PrintStream +import java.nio.file.Paths +import kotlin.time.ExperimentalTime +import org.islandoftex.arara.Arara +import org.islandoftex.arara.configuration.AraraSpec +import org.islandoftex.arara.configuration.Configuration +import org.islandoftex.arara.filehandling.FileSearchingUtils +import org.islandoftex.arara.model.AraraException +import org.islandoftex.arara.model.Extractor +import org.islandoftex.arara.model.Interpreter +import org.islandoftex.arara.ruleset.DirectiveUtils + +@ExperimentalTime +@DoNotParallelize +class ExecutionTest : ShouldSpec({ + fun getPathForTest(name: String): String = "src/test/resources/executiontests/$name" + fun outputForTest(testName: String, fileName: String = "$testName.tex"): + String { + val sysout = System.out + val output = ByteArrayOutputStream() + try { + System.setOut(PrintStream(output)) + Arara.config[AraraSpec.Execution.workingDirectory] = + Paths.get(getPathForTest(testName)) + Configuration.load() + Arara.config[AraraSpec.Execution.verbose] = true + FileSearchingUtils.discoverFile(fileName) + val directives = DirectiveUtils.process(Extractor.extract( + File("${getPathForTest(testName)}/$fileName"))) + Interpreter(directives).execute() + return output.toByteArray().toString(Charsets.UTF_8) + } catch (ex: Exception) { + throw ex + } finally { + System.setOut(sysout) + output.close() + } + } + + should("be able to store variables sessions") { + outputForTest("sessions") shouldContain "MeowQuack" + } + + should("honor falsy existence test") { + val file = File(getPathForTest("conditionals") + "/conditionals.quack") + if (file.exists()) file.delete() + val output = outputForTest("conditionals") + output shouldContain "QuackOne" + output shouldContain "QuackFour" + output shouldNotContain "QuackTwo" + output shouldNotContain "QuackThree" + } + should("honor truthy existence (falsy contains) test") { + val file = File(getPathForTest("conditionals") + "/conditionals.quack") + file.writeText("Meow") + val output = outputForTest("conditionals") + file.delete() + output shouldContain "QuackOne" + output shouldContain "QuackFour" + output shouldContain "QuackTwo" + output shouldNotContain "QuackThree" + } + should("honor truthy contains test") { + val file = File(getPathForTest("conditionals") + "/conditionals.quack") + file.writeText("Duck") + val output = outputForTest("conditionals") + file.delete() + output shouldContain "QuackOne" + output shouldContain "QuackFour" + output shouldContain "QuackTwo" + output shouldContain "QuackThree" + } + + should("track changes") { + val file = File(getPathForTest("changes") + "/arara.yaml") + if (file.exists()) file.delete() + outputForTest("changes") shouldContain "QuackOne" + outputForTest("changes") shouldNotContain "QuackOne" + } + + should("gracefully halt on halt rule") { + val output = outputForTest("halt") + output shouldContain "QuackOne" + output shouldNotContain "QuackTwo" + CommonUtils.exitStatus shouldBe 0 + } + should("forcefully halt on halt error rule") { + val output = outputForTest("halt-error") + output shouldContain "QuackOne" + output shouldNotContain "QuackTwo" + CommonUtils.exitStatus shouldNotBe 0 + } + + should("fail on invalid config") { + val exception = shouldThrow<AraraException> { + outputForTest("invalid-config") + } + exception.message shouldContain "could not parse the configuration" + } + + should("read foreign extension") { + val output = outputForTest("foreign-extension", "foreign-extension.my") + output shouldContain "QuackOne" + } + should("fail on unknown extension") { + shouldThrow<AraraException> { + outputForTest("foreign-extension", "foreign-extension.xy") + } + } + should("accept empty pattern on known extension") { + val output = outputForTest("known-extension") + output shouldContain "QuackOne" + } + + should("execute option-less directives") { + val output = outputForTest("simple-directive") + output shouldContain "The echoer" + output shouldContain "SUCCESS" + } + should("execute directive with options") { + val output = outputForTest("directive-with-options") + output shouldContain "The echoer" + output shouldContain "batchmode" + output shouldContain "SUCCESS" + output shouldNotContain "FAILURE" + } +}) diff --git a/support/arara/source/src/test/kotlin/org/islandoftex/arara/utils/ExtensionTest.kt b/support/arara/source/src/test/kotlin/org/islandoftex/arara/utils/ExtensionTest.kt new file mode 100644 index 0000000000..cd41545ee9 --- /dev/null +++ b/support/arara/source/src/test/kotlin/org/islandoftex/arara/utils/ExtensionTest.kt @@ -0,0 +1,23 @@ +// SPDX-License-Identifier: BSD-3-Clause +package org.islandoftex.arara.utils + +import io.kotlintest.shouldBe +import io.kotlintest.shouldThrow +import io.kotlintest.specs.ShouldSpec + +class ExtensionTest : ShouldSpec({ + should("abbreviate strings correctly") { + "Quack quack".abbreviate(6) shouldBe "Quack…" + "Quack Quack".abbreviate(80) shouldBe "Quack Quack" + shouldThrow<IllegalArgumentException> { "Quack".abbreviate(1) } + } + + should("center strings correctly") { + "Quack".center(3, '-') shouldBe "Quack" + "Quack".center(9, '-') shouldBe "--Quack--" + } + + should("wrap strings correctly") { + "This text should be wrapped".wrap(10) shouldBe "This text\nshould be\nwrapped" + } +}) diff --git a/support/arara/source/src/test/resources/executiontests/changes/arara.yaml b/support/arara/source/src/test/resources/executiontests/changes/arara.yaml new file mode 100644 index 0000000000..3014ff9662 --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/changes/arara.yaml @@ -0,0 +1,3 @@ +!database +map: + "/home/paulo/Projetos/arara/application/src/test/resources/executiontests/changes/changes.tex": "404aaef6"
\ No newline at end of file diff --git a/support/arara/source/src/test/resources/executiontests/changes/arararc.yaml b/support/arara/source/src/test/resources/executiontests/changes/arararc.yaml new file mode 100644 index 0000000000..54afa4c5fc --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/changes/arararc.yaml @@ -0,0 +1,3 @@ +!config +paths: + - './'
\ No newline at end of file diff --git a/support/arara/source/src/test/resources/executiontests/changes/changes.tex b/support/arara/source/src/test/resources/executiontests/changes/changes.tex new file mode 100644 index 0000000000..10646cc412 --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/changes/changes.tex @@ -0,0 +1,3 @@ +% arara: echoone if changed('tex') +Quack +\bye diff --git a/support/arara/source/src/test/resources/executiontests/changes/echoone.yaml b/support/arara/source/src/test/resources/executiontests/changes/echoone.yaml new file mode 100644 index 0000000000..7c304b991f --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/changes/echoone.yaml @@ -0,0 +1,10 @@ +!config +identifier: echoone +name: Test rule for conditionals 1 +commands: + - name: The echoer + command: > + @{ + return getCommand('echo', 'QuackOne'); + } +arguments: [] diff --git a/support/arara/source/src/test/resources/executiontests/conditionals/arararc.yaml b/support/arara/source/src/test/resources/executiontests/conditionals/arararc.yaml new file mode 100644 index 0000000000..54afa4c5fc --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/conditionals/arararc.yaml @@ -0,0 +1,3 @@ +!config +paths: + - './'
\ No newline at end of file diff --git a/support/arara/source/src/test/resources/executiontests/conditionals/conditionals.tex b/support/arara/source/src/test/resources/executiontests/conditionals/conditionals.tex new file mode 100644 index 0000000000..35a3208e12 --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/conditionals/conditionals.tex @@ -0,0 +1,6 @@ +% arara: echoone +% arara: echotwo if exists('quack') +% arara: echothree if (exists('quack') && found('quack', 'Duck')) +% arara: echofour +Quack +\bye diff --git a/support/arara/source/src/test/resources/executiontests/conditionals/echofour.yaml b/support/arara/source/src/test/resources/executiontests/conditionals/echofour.yaml new file mode 100644 index 0000000000..17db18947c --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/conditionals/echofour.yaml @@ -0,0 +1,10 @@ +!config +identifier: echofour +name: Test rule for conditionals 4 +commands: + - name: The echoer + command: > + @{ + return getCommand('echo', 'QuackFour'); + } +arguments: [] diff --git a/support/arara/source/src/test/resources/executiontests/conditionals/echoone.yaml b/support/arara/source/src/test/resources/executiontests/conditionals/echoone.yaml new file mode 100644 index 0000000000..7c304b991f --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/conditionals/echoone.yaml @@ -0,0 +1,10 @@ +!config +identifier: echoone +name: Test rule for conditionals 1 +commands: + - name: The echoer + command: > + @{ + return getCommand('echo', 'QuackOne'); + } +arguments: [] diff --git a/support/arara/source/src/test/resources/executiontests/conditionals/echothree.yaml b/support/arara/source/src/test/resources/executiontests/conditionals/echothree.yaml new file mode 100644 index 0000000000..4f71872321 --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/conditionals/echothree.yaml @@ -0,0 +1,10 @@ +!config +identifier: echothree +name: Test rule for conditionals 3 +commands: + - name: The echoer + command: > + @{ + return getCommand('echo', 'QuackThree'); + } +arguments: [] diff --git a/support/arara/source/src/test/resources/executiontests/conditionals/echotwo.yaml b/support/arara/source/src/test/resources/executiontests/conditionals/echotwo.yaml new file mode 100644 index 0000000000..61915393b5 --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/conditionals/echotwo.yaml @@ -0,0 +1,10 @@ +!config +identifier: echotwo +name: Test rule for conditionals 2 +commands: + - name: The echoer + command: > + @{ + return getCommand('echo', 'QuackTwo'); + } +arguments: [] diff --git a/support/arara/source/src/test/resources/executiontests/directive-with-options/arararc.yaml b/support/arara/source/src/test/resources/executiontests/directive-with-options/arararc.yaml new file mode 100644 index 0000000000..54afa4c5fc --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/directive-with-options/arararc.yaml @@ -0,0 +1,3 @@ +!config +paths: + - './'
\ No newline at end of file diff --git a/support/arara/source/src/test/resources/executiontests/directive-with-options/directive-with-options.tex b/support/arara/source/src/test/resources/executiontests/directive-with-options/directive-with-options.tex new file mode 100644 index 0000000000..db521b5ce1 --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/directive-with-options/directive-with-options.tex @@ -0,0 +1,6 @@ +% arara: echoone: { interaction: batchmode } +% arara: echoone: { synctex: 1 } +% arara: echoone: { synctex: yes } +% arara: echoone: { extensions: [aux, log, pdf] } +Quack +\bye diff --git a/support/arara/source/src/test/resources/executiontests/directive-with-options/echoone.yaml b/support/arara/source/src/test/resources/executiontests/directive-with-options/echoone.yaml new file mode 100644 index 0000000000..825edea9bb --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/directive-with-options/echoone.yaml @@ -0,0 +1,36 @@ +!config +identifier: echoone +name: Test rule for conditionals 1 +commands: + - name: The echoer + command: > + @{ + return getCommand('echo', 'QuackOne', interaction, synctex); + } +arguments: +- identifier: interaction + flag: > + @{ + if ([ 'batchmode', 'nonstopmode', 'scrollmode', + 'errorstopmode' ].contains(parameters.interaction)) { + return '--interaction='.concat(parameters.interaction); + } + else { + throwError('The provided interaction value is not valid.'); + } + } +- identifier: synctex + flag: > + @{ + isTrue(parameters.synctex, '--synctex=1', '--synctex=0') + } +- identifier: extensions + flag: > + @{ + if (isList(parameters.extensions)) { + return parameters.extensions; + } + else { + throwError('I was expecting a list of extensions.'); + } + } diff --git a/support/arara/source/src/test/resources/executiontests/foreign-extension/arararc.yaml b/support/arara/source/src/test/resources/executiontests/foreign-extension/arararc.yaml new file mode 100644 index 0000000000..f1b78d5861 --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/foreign-extension/arararc.yaml @@ -0,0 +1,6 @@ +!config +paths: + - './' +filetypes: + - extension: my + pattern: ^\s*%\s+
\ No newline at end of file diff --git a/support/arara/source/src/test/resources/executiontests/foreign-extension/echoone.yaml b/support/arara/source/src/test/resources/executiontests/foreign-extension/echoone.yaml new file mode 100644 index 0000000000..7c304b991f --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/foreign-extension/echoone.yaml @@ -0,0 +1,10 @@ +!config +identifier: echoone +name: Test rule for conditionals 1 +commands: + - name: The echoer + command: > + @{ + return getCommand('echo', 'QuackOne'); + } +arguments: [] diff --git a/support/arara/source/src/test/resources/executiontests/foreign-extension/foreign-extension.my b/support/arara/source/src/test/resources/executiontests/foreign-extension/foreign-extension.my new file mode 100644 index 0000000000..9947e30964 --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/foreign-extension/foreign-extension.my @@ -0,0 +1,3 @@ +% arara: echoone +Quack +\bye
\ No newline at end of file diff --git a/support/arara/source/src/test/resources/executiontests/foreign-extension/foreign-extension.xy b/support/arara/source/src/test/resources/executiontests/foreign-extension/foreign-extension.xy new file mode 100644 index 0000000000..9947e30964 --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/foreign-extension/foreign-extension.xy @@ -0,0 +1,3 @@ +% arara: echoone +Quack +\bye
\ No newline at end of file diff --git a/support/arara/source/src/test/resources/executiontests/halt-error/arararc.yaml b/support/arara/source/src/test/resources/executiontests/halt-error/arararc.yaml new file mode 100644 index 0000000000..54afa4c5fc --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/halt-error/arararc.yaml @@ -0,0 +1,3 @@ +!config +paths: + - './'
\ No newline at end of file diff --git a/support/arara/source/src/test/resources/executiontests/halt-error/echoone.yaml b/support/arara/source/src/test/resources/executiontests/halt-error/echoone.yaml new file mode 100644 index 0000000000..7c304b991f --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/halt-error/echoone.yaml @@ -0,0 +1,10 @@ +!config +identifier: echoone +name: Test rule for conditionals 1 +commands: + - name: The echoer + command: > + @{ + return getCommand('echo', 'QuackOne'); + } +arguments: [] diff --git a/support/arara/source/src/test/resources/executiontests/halt-error/echotwo.yaml b/support/arara/source/src/test/resources/executiontests/halt-error/echotwo.yaml new file mode 100644 index 0000000000..61915393b5 --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/halt-error/echotwo.yaml @@ -0,0 +1,10 @@ +!config +identifier: echotwo +name: Test rule for conditionals 2 +commands: + - name: The echoer + command: > + @{ + return getCommand('echo', 'QuackTwo'); + } +arguments: [] diff --git a/support/arara/source/src/test/resources/executiontests/halt-error/halt-error.tex b/support/arara/source/src/test/resources/executiontests/halt-error/halt-error.tex new file mode 100644 index 0000000000..cf8d291ccf --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/halt-error/halt-error.tex @@ -0,0 +1,5 @@ +% arara: echoone +% arara: halt +% arara: echotwo +Quack +\bye
\ No newline at end of file diff --git a/support/arara/source/src/test/resources/executiontests/halt-error/halt.yaml b/support/arara/source/src/test/resources/executiontests/halt-error/halt.yaml new file mode 100644 index 0000000000..53df1a295b --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/halt-error/halt.yaml @@ -0,0 +1,16 @@ +!config +# Arara, the cool TeX automation tool +# Copyright (c) 2018, Paulo Roberto Massa Cereda +# All rights reserved. +# +# This rule is part of arara. +identifier: halt +name: Halt +commands: + - name: The halt trigger + command: > + @{ + halt(1); + return true; + } +arguments: [] diff --git a/support/arara/source/src/test/resources/executiontests/halt/arararc.yaml b/support/arara/source/src/test/resources/executiontests/halt/arararc.yaml new file mode 100644 index 0000000000..54afa4c5fc --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/halt/arararc.yaml @@ -0,0 +1,3 @@ +!config +paths: + - './'
\ No newline at end of file diff --git a/support/arara/source/src/test/resources/executiontests/halt/echoone.yaml b/support/arara/source/src/test/resources/executiontests/halt/echoone.yaml new file mode 100644 index 0000000000..7c304b991f --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/halt/echoone.yaml @@ -0,0 +1,10 @@ +!config +identifier: echoone +name: Test rule for conditionals 1 +commands: + - name: The echoer + command: > + @{ + return getCommand('echo', 'QuackOne'); + } +arguments: [] diff --git a/support/arara/source/src/test/resources/executiontests/halt/echotwo.yaml b/support/arara/source/src/test/resources/executiontests/halt/echotwo.yaml new file mode 100644 index 0000000000..61915393b5 --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/halt/echotwo.yaml @@ -0,0 +1,10 @@ +!config +identifier: echotwo +name: Test rule for conditionals 2 +commands: + - name: The echoer + command: > + @{ + return getCommand('echo', 'QuackTwo'); + } +arguments: [] diff --git a/support/arara/source/src/test/resources/executiontests/halt/halt.tex b/support/arara/source/src/test/resources/executiontests/halt/halt.tex new file mode 100644 index 0000000000..cf8d291ccf --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/halt/halt.tex @@ -0,0 +1,5 @@ +% arara: echoone +% arara: halt +% arara: echotwo +Quack +\bye
\ No newline at end of file diff --git a/support/arara/source/src/test/resources/executiontests/halt/halt.yaml b/support/arara/source/src/test/resources/executiontests/halt/halt.yaml new file mode 100644 index 0000000000..1c14644bcb --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/halt/halt.yaml @@ -0,0 +1,19 @@ +!config +# Arara, the cool TeX automation tool +# Copyright (c) 2020, Island of TeX +# All rights reserved. +# +# This rule is part of arara. +identifier: halt +name: Halt +authors: +- Heiko Oberdiek +- Island of TeX +commands: +- name: The halt trigger + command: > + @{ + halt(0); + return true; + } +arguments: [] diff --git a/support/arara/source/src/test/resources/executiontests/invalid-config/arararc.yaml b/support/arara/source/src/test/resources/executiontests/invalid-config/arararc.yaml new file mode 100644 index 0000000000..e6edd71dba --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/invalid-config/arararc.yaml @@ -0,0 +1,2 @@ +paths: + - './'
\ No newline at end of file diff --git a/support/arara/source/src/test/resources/executiontests/invalid-config/invalid-config.tex b/support/arara/source/src/test/resources/executiontests/invalid-config/invalid-config.tex new file mode 100644 index 0000000000..24b11d5eb3 --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/invalid-config/invalid-config.tex @@ -0,0 +1,3 @@ +% arara: pdftex +Quack +\bye
\ No newline at end of file diff --git a/support/arara/source/src/test/resources/executiontests/known-extension/arararc.yaml b/support/arara/source/src/test/resources/executiontests/known-extension/arararc.yaml new file mode 100644 index 0000000000..5342ec007e --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/known-extension/arararc.yaml @@ -0,0 +1,5 @@ +!config +paths: + - './' +filetypes: + - extension: tex
\ No newline at end of file diff --git a/support/arara/source/src/test/resources/executiontests/known-extension/echoone.yaml b/support/arara/source/src/test/resources/executiontests/known-extension/echoone.yaml new file mode 100644 index 0000000000..7c304b991f --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/known-extension/echoone.yaml @@ -0,0 +1,10 @@ +!config +identifier: echoone +name: Test rule for conditionals 1 +commands: + - name: The echoer + command: > + @{ + return getCommand('echo', 'QuackOne'); + } +arguments: [] diff --git a/support/arara/source/src/test/resources/executiontests/known-extension/known-extension.tex b/support/arara/source/src/test/resources/executiontests/known-extension/known-extension.tex new file mode 100644 index 0000000000..9947e30964 --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/known-extension/known-extension.tex @@ -0,0 +1,3 @@ +% arara: echoone +Quack +\bye
\ No newline at end of file diff --git a/support/arara/source/src/test/resources/executiontests/sessions/arararc.yaml b/support/arara/source/src/test/resources/executiontests/sessions/arararc.yaml new file mode 100644 index 0000000000..54afa4c5fc --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/sessions/arararc.yaml @@ -0,0 +1,3 @@ +!config +paths: + - './'
\ No newline at end of file diff --git a/support/arara/source/src/test/resources/executiontests/sessions/sessionrule.yaml b/support/arara/source/src/test/resources/executiontests/sessions/sessionrule.yaml new file mode 100644 index 0000000000..9b26f740d7 --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/sessions/sessionrule.yaml @@ -0,0 +1,16 @@ +!config +identifier: sessionrule +name: Test rule for sessions +commands: + - name: The echoer + command: > + @{ + getSession().put('quack', 'Quack'); + return getCommand('echo', 'Quack'); + } + - name: The echoer mark II + command: > + @{ + return getCommand('echo', 'Meow' + getSession().get('quack')); + } +arguments: [] diff --git a/support/arara/source/src/test/resources/executiontests/sessions/sessions.tex b/support/arara/source/src/test/resources/executiontests/sessions/sessions.tex new file mode 100644 index 0000000000..9cfb354cdf --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/sessions/sessions.tex @@ -0,0 +1,3 @@ +% arara: sessionrule +Quack +\bye
\ No newline at end of file diff --git a/support/arara/source/src/test/resources/executiontests/simple-directive/arararc.yaml b/support/arara/source/src/test/resources/executiontests/simple-directive/arararc.yaml new file mode 100644 index 0000000000..54afa4c5fc --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/simple-directive/arararc.yaml @@ -0,0 +1,3 @@ +!config +paths: + - './'
\ No newline at end of file diff --git a/support/arara/source/src/test/resources/executiontests/simple-directive/echoone.yaml b/support/arara/source/src/test/resources/executiontests/simple-directive/echoone.yaml new file mode 100644 index 0000000000..7c304b991f --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/simple-directive/echoone.yaml @@ -0,0 +1,10 @@ +!config +identifier: echoone +name: Test rule for conditionals 1 +commands: + - name: The echoer + command: > + @{ + return getCommand('echo', 'QuackOne'); + } +arguments: [] diff --git a/support/arara/source/src/test/resources/executiontests/simple-directive/simple-directive.tex b/support/arara/source/src/test/resources/executiontests/simple-directive/simple-directive.tex new file mode 100644 index 0000000000..8d8f2cf697 --- /dev/null +++ b/support/arara/source/src/test/resources/executiontests/simple-directive/simple-directive.tex @@ -0,0 +1,3 @@ +% arara: echoone +Quack +\bye |