//////////////////////////////////////////////////////////////////////////////// // // Copyright 2006 - 2014, Paul Beckingham, Federico Hernandez. // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the "Software"), to deal // in the Software without restriction, including without limitation the rights // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell // copies of the Software, and to permit persons to whom the Software is // furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included // in all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL // THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE // SOFTWARE. // // http://www.opensource.org/licenses/mit-license.php // //////////////////////////////////////////////////////////////////////////////// #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #ifdef HAVE_COMMIT #include #endif // Supported modifiers, synonyms on the same line. static const char* modifierNames[] = { "before", "under", "below", "after", "over", "above", "none", "any", "is", "equals", "isnt", "not", "has", "contains", "hasnt", "startswith", "left", "endswith", "right", "word", "noword" }; #define NUM_MODIFIER_NAMES (sizeof (modifierNames) / sizeof (modifierNames[0])) //////////////////////////////////////////////////////////////////////////////// Context::Context () : rc_file () , data_dir () , config () , tdb2 () , dom () , determine_color_use (true) , use_color (true) , verbosity_legacy (false) , terminal_width (0) , terminal_height (0) { } //////////////////////////////////////////////////////////////////////////////// Context::~Context () { std::map::iterator com; for (com = commands.begin (); com != commands.end (); ++com) delete com->second; std::map::iterator col; for (col = columns.begin (); col != columns.end (); ++col) delete col->second; } //////////////////////////////////////////////////////////////////////////////// int Context::initialize (int argc, const char** argv) { timer_init.start (); int rc = 0; try { // Assume default .taskrc and .task locations. assumeLocations (); // Initialize the command line parser. program = (argc ? argv[0] : "task"); parser.initialize (argc, argv); // task arg0 arg1 ... // echo one two -- three | task zero --> task zero one two // 'three' is left in the input buffer. parser.appendStdin (); // echo stdin0 | task ... // Process 'rc:' command line override. parser.findOverrides (); // rc: rc.: parser.getOverrides (home_dir, rc_file); // <-- // TASKRC environment variable overrides the command line. char* override = getenv ("TASKRC"); if (override) { rc_file = File (override); header (format (STRING_CONTEXT_RC_OVERRIDE, rc_file._data)); } // Dump any existing values and load rc file. config.clear (); config.load (rc_file); loadAliases (); // The data location, Context::data_dir, is determined from the assumed // location (~/.task), or set by data.location in the config file, or // overridden by rc.data.location on the command line. parser.getDataLocation (data_dir); // <-- rc.data.location= override = getenv ("TASKDATA"); if (override) { data_dir = Directory (override); config.set ("data.location", data_dir._data); header (format (STRING_CONTEXT_DATA_OVERRIDE, data_dir._data)); } // Create missing config file and data directory, if necessary. parser.applyOverrides (); createDefaultConfig (); // Initialize the color rules, if necessary. if (color ()) initializeColorRules (); // Instantiate built-in command objects. Command::factory (commands); std::map ::iterator cmd; for (cmd = commands.begin (); cmd != commands.end (); ++cmd) { parser.entity ("cmd", cmd->first); if (cmd->first[0] == '_') parser.entity ("helper", cmd->first); if (cmd->second->read_only ()) parser.entity ("readcmd", cmd->first); else parser.entity ("writecmd", cmd->first); } // Instantiate built-in column objects. Column::factory (columns); std::map ::iterator col; for (col = columns.begin (); col != columns.end (); ++col) parser.entity ("attribute", col->first); // Entities: Pseudo-attributes. Hard-coded. parser.entity ("pseudo", "limit"); // Entities: Modifiers. for (unsigned int i = 0; i < NUM_MODIFIER_NAMES; ++i) parser.entity ("modifier", modifierNames[i]); // Entities: Operators. std::vector operators; Eval::getOperators (operators); std::vector ::iterator op; for (op = operators.begin (); op != operators.end (); ++op) parser.entity ("operator", *op); // Now the entities are loaded, parsing may resume. parser.findBinary (); // parser.resolveAliases (); parser.findCommand (); // parser.findUUIDList (); // Before findIdSequence parser.findIdSequence (); // parser.injectDefaults (); // rc.default.command staticInitialization (); // Decouple code from Context. parser.parse (); // Parse all elements. tdb2.set_location (data_dir); // Prepare the task database. // First opportunity to run a hook script. hooks.initialize (); hooks.onLaunch (); } catch (const std::string& message) { error (message); rc = 2; } catch (int) { // Hooks can terminate processing by throwing integers. rc = 4; } catch (...) { error (STRING_UNKNOWN_ERROR); rc = 3; } // Dump all debug messages, controlled by rc.debug. if (rc && config.getBoolean ("debug")) { std::vector ::iterator d; for (d = debugMessages.begin (); d != debugMessages.end (); ++d) if (color ()) std::cerr << colorizeDebug (*d) << "\n"; else std::cerr << *d << "\n"; } // Dump all headers, controlled by 'header' verbosity token. if (rc && verbose ("header")) { std::vector ::iterator h; for (h = headers.begin (); h != headers.end (); ++h) if (color ()) std::cerr << colorizeHeader (*h) << "\n"; else std::cerr << *h << "\n"; } // Dump all footnotes, controlled by 'footnote' verbosity token. if (rc && verbose ("footnote")) { std::vector ::iterator f; for (f = footnotes.begin (); f != footnotes.end (); ++f) if (color ()) std::cerr << colorizeFootnote (*f) << "\n"; else std::cerr << *f << "\n"; } // Dump all errors, non-maskable. // Colorized as footnotes. if (rc) { std::vector ::iterator e; for (e = errors.begin (); e != errors.end (); ++e) if (color ()) std::cerr << colorizeFootnote (*e) << "\n"; else std::cerr << *e << "\n"; } timer_init.stop (); return rc; } //////////////////////////////////////////////////////////////////////////////// int Context::run () { int rc; std::string output; try { rc = dispatch (output); if (hooks.onExit ()) tdb2.commit (); std::stringstream s; s << "Perf " << PACKAGE_STRING << " " #ifdef HAVE_COMMIT << COMMIT #else << "-" #endif << " " << Date ().toISO () << " init:" << timer_init.total () << " load:" << timer_load.total () << " gc:" << timer_gc.total () << " filter:" << timer_filter.total () << " commit:" << timer_commit.total () << " sort:" << timer_sort.total () << " render:" << timer_render.total () << " hooks:" << timer_hooks.total () << " total:" << (timer_init.total () + timer_load.total () + timer_gc.total () + timer_filter.total () + timer_commit.total () + timer_sort.total () + timer_render.total () + timer_hooks.total ()) << "\n"; debug (s.str ()); } catch (const std::string& message) { error (message); rc = 2; } catch (...) { error (STRING_UNKNOWN_ERROR); rc = 3; } // Dump all debug messages, controlled by rc.debug. if (config.getBoolean ("debug")) { std::vector ::iterator d; for (d = debugMessages.begin (); d != debugMessages.end (); ++d) if (color ()) std::cerr << colorizeDebug (*d) << "\n"; else std::cerr << *d << "\n"; } // Dump all headers, controlled by 'header' verbosity token. if (verbose ("header")) { std::vector ::iterator h; for (h = headers.begin (); h != headers.end (); ++h) if (color ()) std::cerr << colorizeHeader (*h) << "\n"; else std::cerr << *h << "\n"; } // Dump the report output. std::cout << output; // Dump all footnotes, controlled by 'footnote' verbosity token. if (verbose ("footnote")) { std::vector ::iterator f; for (f = footnotes.begin (); f != footnotes.end (); ++f) if (color ()) std::cerr << colorizeFootnote (*f) << "\n"; else std::cerr << *f << "\n"; } // Dump all errors, non-maskable. // Colorized as footnotes. std::vector ::iterator e; for (e = errors.begin (); e != errors.end (); ++e) if (color ()) std::cerr << colorizeError (*e) << "\n"; else std::cerr << *e << "\n"; return rc; } //////////////////////////////////////////////////////////////////////////////// // Dispatch to the command found by the parser. int Context::dispatch (std::string &out) { // Autocomplete args against keywords. std::string command = parser.getCommand (); if (command != "") { updateXtermTitle (); updateVerbosity (); Command* c = commands[command]; // GC is invoked prior to running any command that displays task IDs, if // possible. bool auto_commit = false; if (c->displays_id () && !tdb2.read_only ()) { tdb2.gc (); auto_commit = true; } // Only read-only commands can be run when TDB2 is read-only. // TODO Implement TDB2::read_only /* if (tdb2.read_only () && !c->read_only ()) throw std::string (""); */ int rc = c->execute (out); if (auto_commit) tdb2.commit (); // Write commands cause an update of the shadow file, if configured. if (! c->read_only ()) shadow (); return rc; } assert (commands["help"]); return commands["help"]->execute (out); return 1; } //////////////////////////////////////////////////////////////////////////////// bool Context::color () { #ifdef FEATURE_COLOR if (determine_color_use) { // What the config says. use_color = config.getBoolean ("color"); // Only tty's support color. if (! isatty (fileno (stdout))) { // No ioctl. config.set ("detection", "off"); config.set ("color", "off"); // Files don't get color. use_color = false; } // Override. if (config.getBoolean ("_forcecolor")) { config.set ("color", "on"); use_color = true; } // No need to go through this again. determine_color_use = false; } // Cached result. return use_color; #else return false; #endif } //////////////////////////////////////////////////////////////////////////////// // Support verbosity levels: // // rc.verbose=1 Show all feedback. // rc.verbose=0 Show regular feedback. // rc.verbose=nothing Show the absolute minimum. // rc.verbose=one,two Show verbosity for 'one' and 'two' only. // // TODO This mechanism is clunky, and should slowly evolve into something more // logical and consistent. This should probably mean that 'nothing' should // take the place of '0'. bool Context::verbose (const std::string& token) { if (! verbosity.size ()) { verbosity_legacy = config.getBoolean ("verbose"); split (verbosity, config.get ("verbose"), ','); // Regular feedback means almost everything. // This odd test is to see if a Boolean-false value is a real one, which // means it is not 1/true/T/yes/on, but also should not be one of the // valid tokens either. if (!verbosity_legacy && verbosity.size () && verbosity[0] != "nothing" && verbosity[0] != "blank" && // This list must be complete. verbosity[0] != "header" && // verbosity[0] != "footnote" && // verbosity[0] != "label" && // verbosity[0] != "new-id" && // verbosity[0] != "new-uuid" && // verbosity[0] != "affected" && // verbosity[0] != "edit" && // verbosity[0] != "special" && // verbosity[0] != "project" && // verbosity[0] != "sync" && // verbosity[0] != "filter") // { verbosity.clear (); // This list emulates rc.verbose=off in version 1.9.4. verbosity.push_back ("blank"); verbosity.push_back ("label"); verbosity.push_back ("new-id"); verbosity.push_back ("edit"); } } // rc.verbose=true|y|yes|1|on overrides all. if (verbosity_legacy) return true; // rc.verbose=nothing overrides all. if (verbosity.size () == 1 && verbosity[0] == "nothing") return false; // Specific token match. if (std::find (verbosity.begin (), verbosity.end (), token) != verbosity.end ()) return true; return false; } //////////////////////////////////////////////////////////////////////////////// // This needs to be taken out and shot, as soon as hooks will allow. void Context::shadow () { std::string file_name = config.get ("shadow.file"); std::string command = config.get ("shadow.command"); std::string rcfile = rc_file; // A missing shadow file command uses the default command instead. if (command == "") command = config.get ("default.command"); if (file_name != "" && command != "") { File shadow_file (file_name); // Check for dangerous shadow file settings. std::string location = config.get ("data.location"); if (shadow_file._data == location + "/pending.data") throw std::string (STRING_CONTEXT_SHADOW_P); if (shadow_file._data == location + "/completed.data") throw std::string (STRING_CONTEXT_SHADOW_C); if (shadow_file._data == location + "/undo.data") throw std::string (STRING_CONTEXT_SHADOW_U); if (shadow_file._data == location + "/backlog.data") throw std::string (STRING_CONTEXT_SHADOW_B); // Compose the command. Put the rc overrides up front, so that they may // be overridden by rc.shadow.command. command = program + " rc.detection:off" + // No need to determine terminal size " rc.color:off" + // Color off by default " rc.gc:off " + // GC off, to reduce headaches " rc.locking:off" + // No file locking " rc:" + rcfile + " " + // Use specified rc file command + // User specified command " >" + // Capture shadow_file._data; // User specified file debug ("Running shadow command: " + command); system (command.c_str ()); // Optionally display a notification that the shadow file was updated. // TODO Convert to a verbosity token. if (config.getBoolean ("shadow.notify")) footnote (format (STRING_CONTEXT_SHADOW_UPDATE, shadow_file._data)); } } //////////////////////////////////////////////////////////////////////////////// const std::vector Context::getColumns () const { std::vector output; std::map ::const_iterator i; for (i = columns.begin (); i != columns.end (); ++i) output.push_back (i->first); return output; } //////////////////////////////////////////////////////////////////////////////// const std::vector Context::getCommands () const { std::vector output; std::map ::const_iterator i; for (i = commands.begin (); i != commands.end (); ++i) output.push_back (i->first); return output; } //////////////////////////////////////////////////////////////////////////////// // A value of zero mean unlimited. // A value of 'page' means however many screen lines there are. // A value of a positive integer is a row/task limit. void Context::getLimits (int& rows, int& lines) { rows = 0; lines = 0; // This is an integer specified as a filter (limit:10). std::string limit = parser.getLimit (); if (limit != "") { if (limit == "page") { rows = 0; lines = getHeight (); } else { rows = (int) strtol (limit.c_str (), NULL, 10); lines = 0; } } } //////////////////////////////////////////////////////////////////////////////// // The 'Task' object, among others, is shared between projects. To make this // easier, it has been decoupled from Context. void Context::staticInitialization () { Task::defaultProject = config.get ("default.project"); Task::defaultPriority = config.get ("default.priority"); Task::defaultDue = config.get ("default.due"); Task::searchCaseSensitive = config.getBoolean ("search.case.sensitive"); Task::regex = config.getBoolean ("regex"); std::map ::iterator i; for (i = columns.begin (); i != columns.end (); ++i) Task::attributes[i->first] = i->second->type (); Task::urgencyPriorityCoefficient = config.getReal ("urgency.priority.coefficient"); Task::urgencyProjectCoefficient = config.getReal ("urgency.project.coefficient"); Task::urgencyActiveCoefficient = config.getReal ("urgency.active.coefficient"); Task::urgencyScheduledCoefficient = config.getReal ("urgency.scheduled.coefficient"); Task::urgencyWaitingCoefficient = config.getReal ("urgency.waiting.coefficient"); Task::urgencyBlockedCoefficient = config.getReal ("urgency.blocked.coefficient"); Task::urgencyInheritCoefficient = config.getReal ("urgency.inherit.coefficient"); Task::urgencyAnnotationsCoefficient = config.getReal ("urgency.annotations.coefficient"); Task::urgencyTagsCoefficient = config.getReal ("urgency.tags.coefficient"); Task::urgencyNextCoefficient = config.getReal ("urgency.next.coefficient"); Task::urgencyDueCoefficient = config.getReal ("urgency.due.coefficient"); Task::urgencyBlockingCoefficient = config.getReal ("urgency.blocking.coefficient"); Task::urgencyAgeCoefficient = config.getReal ("urgency.age.coefficient"); Task::urgencyAgeMax = config.getReal ("urgency.age.max"); // Tag- and project-specific coefficients. std::vector all; config.all (all); std::vector ::iterator var; for (var = all.begin (); var != all.end (); ++var) { if (var->substr (0, 13) == "urgency.user." || var->substr (0, 12) == "urgency.uda.") Task::coefficients[*var] = config.getReal (*var); } Lexer::dateFormat = config.get ("dateformat"); Variant::dateFormat = config.get ("dateformat"); Variant::searchCaseSensitive = config.getBoolean ("search.case.sensitive"); } //////////////////////////////////////////////////////////////////////////////// void Context::assumeLocations () { rc_file = File ("~/.taskrc"); data_dir = Directory ("~/.task"); } //////////////////////////////////////////////////////////////////////////////// void Context::createDefaultConfig () { // Do we need to create a default rc? if (! rc_file.exists ()) { if (config.getBoolean ("confirmation") && !confirm (format (STRING_CONTEXT_CREATE_RC, home_dir, rc_file._data))) throw std::string (STRING_CONTEXT_NEED_RC); config.createDefaultRC (rc_file, data_dir._original); } // Create data location, if necessary. config.createDefaultData (data_dir); } //////////////////////////////////////////////////////////////////////////////// void Context::decomposeSortField ( const std::string& field, std::string& key, bool& ascending, bool& breakIndicator) { int length = field.length (); int decoration = 1; breakIndicator = false; if (field[length - decoration] == '/') { breakIndicator = true; ++decoration; } if (field[length - decoration] == '+') { ascending = true; key = field.substr (0, length - decoration); } else if (field[length - decoration] == '-') { ascending = false; key = field.substr (0, length - decoration); } else { ascending = true; key = field; } } //////////////////////////////////////////////////////////////////////////////// // Note: The reason some of these are commented out is because the ::clear // method is not really "clear" but "clear_some". Some members do not need to // be initialized. That makes this method something of a misnomer. So be it. void Context::clear () { tdb2.clear (); parser.clear (); // Eliminate the command objects. std::map ::iterator com; for (com = commands.begin (); com != commands.end (); ++com) delete com->second; commands.clear (); // Eliminate the column objects. std::map ::iterator col; for (col = columns.begin (); col != columns.end (); ++col) delete col->second; columns.clear (); clearMessages (); } //////////////////////////////////////////////////////////////////////////////// // This capability is to answer the question of 'what did I just do to generate // this output?'. void Context::updateXtermTitle () { if (config.getBoolean ("xterm.title") && isatty (fileno (stdout))) { std::string command = parser.getCommand (); std::string title; Tree* tree = parser.tree (); std::vector ::iterator i; for (i = tree->_branches.begin (); i != tree->_branches.end (); ++i) { if (i != tree->_branches.begin ()) title += ' '; title += (*i)->attribute ("raw"); } std::cout << "]0;task " << command << " " << title << ""; } } //////////////////////////////////////////////////////////////////////////////// // This function allows a clean output if the command is a helper subcommand. void Context::updateVerbosity () { std::string command = parser.getCommand (); if (command != "" && command[0] == '_') { verbosity.clear (); verbosity.push_back ("nothing"); } } //////////////////////////////////////////////////////////////////////////////// void Context::loadAliases () { std::map ::iterator i; for (i = config.begin (); i != config.end (); ++i) if (i->first.substr (0, 6) == "alias.") parser.alias (i->first.substr (6), i->second); } //////////////////////////////////////////////////////////////////////////////// void Context::header (const std::string& input) { if (input.length () && std::find (headers.begin (), headers.end (), input) == headers.end ()) headers.push_back (input); } //////////////////////////////////////////////////////////////////////////////// void Context::footnote (const std::string& input) { if (input.length () && std::find (footnotes.begin (), footnotes.end (), input) == footnotes.end ()) footnotes.push_back (input); } //////////////////////////////////////////////////////////////////////////////// void Context::error (const std::string& input) { if (input.length () && std::find (errors.begin (), errors.end (), input) == errors.end ()) errors.push_back (input); } //////////////////////////////////////////////////////////////////////////////// void Context::debug (const std::string& input) { if (input.length () && std::find (debugMessages.begin (), debugMessages.end (), input) == debugMessages.end ()) debugMessages.push_back (input); } //////////////////////////////////////////////////////////////////////////////// void Context::clearMessages () { headers.clear (); footnotes.clear (); errors.clear (); debugMessages.clear (); } ////////////////////////////////////////////////////////////////////////////////