4 // Fraunhofer Institute for Open Communication Systems (FOKUS)
5 // Competence Center NETwork research (NET), St. Augustin, GERMANY
6 // Stefan Bund <g0dil@berlios.de>
8 // This program is free software; you can redistribute it and/or modify
9 // it under the terms of the GNU General Public License as published by
10 // the Free Software Foundation; either version 2 of the License, or
11 // (at your option) any later version.
13 // This program is distributed in the hope that it will be useful,
14 // but WITHOUT ANY WARRANTY; without even the implied warranty of
15 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 // GNU General Public License for more details.
18 // You should have received a copy of the GNU General Public License
19 // along with this program; if not, write to the
20 // Free Software Foundation, Inc.,
21 // 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
24 \brief Executor public header */
27 #define HH_Executor_ 1
30 #include <boost/utility.hpp>
32 #include "../Utils/Logger/SenfLog.hh"
35 //#include "Executor.mpp"
36 ///////////////////////////////hh.p////////////////////////////////////////
41 /** \brief Execute config/console commands
43 The Executor interprets parsed config/console commands and executes them. It manages the
44 current execution context (current directory, directory stack and so on).
46 The executor is normally called directly by the parser callback for each command.
48 Executing the built-in 'exit' command will throw Executor::ExitException. This exception
49 (which is not derived from std::exception since it's not a real exception) must be handled
52 All directories are managed using weak pointers. If any of the directories expires (current
53 directory, directory stack, last directory) it will be replaced with the root
54 directory. Directories expire when they are destructed or when they are detached from the
55 config tree root node.
60 SENF_LOG_CLASS_AREA();
61 SENF_LOG_DEFAULT_LEVEL( senf::log::VERBOSE );
63 ///////////////////////////////////////////////////////////////////////////
66 /// Thrown by built-in 'exit' command
67 struct ExitException {};
69 ///////////////////////////////////////////////////////////////////////////
70 //\/name Structors and default members
76 ///////////////////////////////////////////////////////////////////////////
78 void execute(std::ostream & output, ParseCommandInfo const & command);
80 /**< Output will be written to \a output.
81 Same as operator()(). */
83 void operator()(std::ostream & output, ParseCommandInfo const & command);
85 /**< Output will be written to \a output.
87 DirectoryNode & cwd() const; ///< Current working directory
92 GenericNode & traverseNode(ParseCommandInfo::argument_value_type const & path);
93 GenericNode & traverseCommand(ParseCommandInfo::CommandPathRange const & path);
94 DirectoryNode & traverseDirectory(ParseCommandInfo::argument_value_type const & path);
96 struct InvalidPathException {};
97 struct InvalidDirectoryException {};
98 struct InvalidCommandException {};
100 DirectoryNode::weak_ptr cwd_;
101 DirectoryNode::weak_ptr oldCwd_;
102 typedef std::vector<DirectoryNode::weak_ptr> DirStack;
109 ///////////////////////////////hh.e////////////////////////////////////////
110 #include "Executor.cci"
111 //#include "Executor.ct"
112 //#include "Executor.cti"
119 // comment-column: 40
120 // c-file-style: "senf"
121 // indent-tabs-mode: nil
122 // ispell-local-dictionary: "american"
123 // compile-command: "scons -u test"