initial commit into repository0.0

1 files changed, 459 insertions, 0 deletions

diff --git a/include/sitecing/configuration.h b/include/sitecing/configuration.h
new file mode 100644
index 0000000..330a5a6
--- a/dev/null
+++ b/include/sitecing/configuration.h
@@ -0,0 +1,459 @@
+#ifndef __SITECING_CONFIGURATION_H
+#define __SITECING_CONFIGURATION_H
+
+#include <sys/types.h>
+#include <sys/stat.h>
+#include <string>
+#include <list>
+#include <map>
+#include <pcre++.h>
+
+/**
+ * @file
+ * @brief Classes related to configuration.
+ */
+
+namespace sitecing {
+    using namespace std;
+
+    class configuration;
+
+    /**
+     * The config options container class.
+     */
+    class config_options {
+	public:
+	    /**
+	     * The flags enumeration.
+	     */
+	    enum _flags {
+		/**
+		 * Skeleton has been specified in the context.
+		 * @see skeleton
+		 */
+		flag_skeleton             = 0x0001,
+		/**
+		 * CPPFLAGS have been specified in the context
+		 * @see cpp_flags
+		 */
+		flag_cpp_flags            = 0x0002,
+		/**
+		 * LDFLAGS have been specified in the context.
+		 * @see ld_flags
+		 */
+		flag_ld_flags             = 0x0004,
+		/**
+		 * Enforced intermediate dependencies have been specified in the
+		 * context.
+		 * @see internediate_deps
+		 */
+		flag_intermediate_deps    = 0x0008,
+		/**
+		 * Enforced .so dependencies have been specified in the context.
+		 * @see so_deps
+		 */
+		flag_so_deps              = 0x0010,
+		/**
+		 * Whether components should be built specified in the context.
+		 * @see build
+		 */
+		flag_build                = 0x0020,
+		/**
+		 * Whether to track down cpp dependencies has been specified in
+		 * the context.
+		 * @see cpp_deps
+		 */
+		flag_cpp_deps             = 0x0040,
+		/**
+		 * The exception handler has been specified in the context.
+		 * @see exception_handler
+		 */
+		flag_exception_handler    = 0x0080,
+		/**
+		 * Action handlers have been specified in the context.
+		 * @see action_handlers
+		 */
+		flag_action_handlers      = 0x0100,
+		/**
+		 * HTTP status handerls have been specified in the context.
+		 * @see http_status_handlers
+		 */
+		flag_http_status_handlers = 0x0200,
+		/**
+		 * The files to be built are specified in the context.
+		 * @see auto_build_files
+		 */
+		flag_auto_build_files     = 0x0400
+	    };
+	    /**
+	     * The flags specifying what parts of configuration have been
+	     * specified for the context.
+	     */
+	    int flags;
+
+	    /**
+	     * The skeleton for building components.
+	     */
+	    string skeleton;
+	    /**
+	     * The flags to pass to compiler.
+	     */
+	    list<string> cpp_flags;
+	    /**
+	     * The flags to pass to linker.
+	     */
+	    list<string> ld_flags;
+	    /**
+	     * Whether to build inexstent and outdated components.
+	     */
+	    bool build;
+	    /**
+	     * Whether to track cpp dependencies.
+	     */
+	    bool cpp_deps;
+	    /**
+	     * The component handling caught exceptions.
+	     */
+	    string exception_handler;
+	    /**
+	     * Enforced intermediate dependencies.
+	     */
+	    list<string> intermediate_deps;
+	    /**
+	     * Enforced depencies for .so objects.
+	     */
+	    list<string> so_deps;
+	    /**
+	     * The action handler type.
+	     */
+	    struct action_handler_t {
+		/**
+		 * The regexp to check request against.
+		 */
+		string s_regex;
+		/**
+		 * Precompiled regex.
+		 */
+		pcrepp::Pcre regex;
+		/**
+		 * The action handler component.
+		 */
+		string action;
+		/**
+		 * Arguments for the action hander coponent.
+		 */
+		list<string> args;
+
+		action_handler_t(const string& s,const string& a)
+		    : s_regex(s), regex(s), action(a) { }
+		action_handler_t(const action_handler_t& s)
+		    : s_regex(s.s_regex), regex(s.regex), action (s.action), args(s.args) { }
+	    };
+	    /**
+	     * Type for the list of action handlers.
+	     */
+	    typedef list<action_handler_t> action_handlers_t;
+	    /**
+	     * The list of action handlers.
+	     */
+	    action_handlers_t action_handlers;
+	    /**
+	     * Type for the map of HTTP status handler components.
+	     */
+	    typedef map<string,string> http_status_handlers_t;
+	    /**
+	     * The map of HTTP status handler components.
+	     */
+	    http_status_handlers_t http_status_handlers;
+	    /**
+	     * Files to be built automatically.
+	     */
+	    list<string> auto_build_files;
+
+	    config_options()
+		: flags(0) { }
+
+	    /**
+	     * Look up if there is an action handler for the target defined.
+	     * @param target the target component.
+	     * @return the pointer to handler or zero.
+	     */
+	    action_handler_t *lookup_action_handler(const string& target);
+	    /**
+	     * Look up if there is a handler defined for the HTTP status.
+	     * @param status HTTP status
+	     * @return the handler component.
+	     */
+	    string lookup_http_status_handler(const string& status);
+	    /**
+	     * Check whether the file should be build automatically.
+	     * @param fn file name.
+	     * @param rv reference to the boolean where the answer should go.
+	     * @return true if we know the answer.
+	     */
+	    bool match_autobuild_files(const char *fn,bool &rv);
+    };
+
+    /**
+     * Configuration data container for the configuration loaded from disk file.
+     */
+    class loaded_options : public config_options {
+	public:
+	    /**
+	     * The file where configuration originates from.
+	     */
+	    string source_file;
+	    /**
+	     * The stat structure for the source file as it was when we have
+	     * loaded it.
+	     */
+	    struct stat st;
+
+	    /**
+	     * See if the data is still valid.
+	     * @return true if yes.
+	     */
+	    bool is_valid();
+
+	    /**
+	     * Load the configuration file.
+	     * @param config the main configuration container.
+	     * @param the configuration file.
+	     */
+	    void parse(configuration *config,const string& cfile);
+    };
+
+    /**
+     * The main configuration container.
+     */
+    class configuration {
+	public:
+	    /**
+	     * @todo TODO:: document me.
+	     */
+	    bool autobuild;
+	    /**
+	     * The flags enumeration.
+	     */
+	    enum _flags {
+		/**
+		 * Was the source root specified?
+		 * @see root_source
+		 */
+		flag_root_source        = 0x00000001,
+		/**
+		 * Was the root for intermediate files specified?
+		 * @see root_intermediate
+		 */
+		flag_root_intermediate  = 0x00000002,
+		/**
+		 * Was the root for the resulting .so files specified?
+		 * @see root_so
+		 */
+		flag_root_so            = 0x00000004,
+		/**
+		 * Was the socket to listen to specified?
+		 * @see listen_socket
+		 */
+		flag_listen_socket      = 0x00000008,
+		/**
+		 * Was the per-dir config file name specified.
+		 * @see rc_file_name
+		 */
+		flag_rc_file_name       = 0x00000010,
+		/**
+		 * Was the minimum number of child processes specified?
+		 * @see min_children
+		 */
+		flag_min_children       = 0x00000020,
+		/**
+		 * Was the maximum number of child processes specified?
+		 * @see max_children
+		 */
+		flag_max_children       = 0x00000040,
+		/**
+		 * Was the minimum number of spare child processes specified?
+		 * @see min_spare_children
+		 */
+		flag_min_spare_children = 0x00000080,
+		/**
+		 * Was he maximum number of spare child processes specified?
+		 * @see max_spare_children
+		 */
+		flag_max_spare_children = 0x00000100,
+		/**
+		 * Was the number of requests to handle per child process
+		 * specified?
+		 * @see requests_per_child
+		 */
+		flag_requests_per_child = 0x00000200,
+		/**
+		 * Was the multiprocess node (or it's absences) specified?
+		 * @see multi_process
+		 */
+		flag_multi_process      = 0x00000400,
+		/**
+		 * Was the user specified?
+		 * @see user
+		 */
+		flag_user               = 0x00000800,
+		/**
+		 * @Was the group specified?
+		 * @see group
+		 */
+		flag_group              = 0x00001000,
+		/**
+		 * Was the root to change to specified?
+		 * @see chroot
+		 */
+		flag_chroot             = 0x00002000,
+		/**
+		 * Was the file for storing PID specified?
+		 * @see pidfile
+		 */
+		flag_pid_file           = 0x00004000,
+		/**
+		 * Was it specified wether we should daemonize the process?
+		 * @see daemonize
+		 */
+		flag_daemonize          = 0x00008000
+	    };
+	    /**
+	     * The flags specifying what parts of the configuration has been
+	     * loaded into the object.
+	     */
+	    long flags;
+
+	    /**
+	     * The root for the components source code.
+	     */
+	    string root_source;
+	    /**
+	     * The root for intermediate files.
+	     */
+	    string root_intermediate;
+	    /**
+	     * The root for .so files.
+	     */
+	    string root_so;
+	    /**
+	     * Socket to bind to
+	     */
+	    string listen_socket;
+	    /**
+	     * per-dir config file name.
+	     */
+	    string rc_file_name;
+	    /**
+	     * The minimum number of child processes in multiprocess mode.
+	     */
+	    int min_children;
+	    /**
+	     * The maxium number of child processes in multiprocess mode.
+	     */
+	    int max_children;
+	    /**
+	     * The minimum number of spare chidren in multiprocess mode.
+	     */
+	    int min_spare_children;
+	    /**
+	     * The maximum number of spare children in multiprocess mode.
+	     */
+	    int max_spare_children;
+	    /**
+	     * The number of requests the child process should handle before
+	     * exiting.
+	     */
+	    int requests_per_child;
+	    /**
+	     * Whether we should run in multiprocess mode or not.
+	     */
+	    bool multi_process;
+	    /**
+	     * User to change to.
+	     */
+	    string user;
+	    /**
+	     * Group to set to.
+	     */
+	    string group;
+	    /**
+	     * Directory to change root to.
+	     */
+	    string chroot;
+	    /**
+	     * The file to store PID into.
+	     */
+	    string pid_file;
+	    /**
+	     * Whether we should fork into background.
+	     */
+	    bool daemonize;
+
+	    typedef map<string,config_options> specs_t;
+	    /**
+	     * The local config options map.
+	     */
+	    specs_t specs;
+	    typedef map<string,loaded_options> loaded_specs_t;
+	    /**
+	     * The local config options as specified in per-dir config files
+	     * map.
+	     */
+	    loaded_specs_t loaded_specs;
+
+	    configuration();
+	    /**
+	     * @param cfile the configuration file.
+	     * @param ab @todo TODO:: document me
+	     */
+	    configuration(const string& cfile,bool ab=false);
+
+	    /**
+	     * Parse the configuration file.
+	     * @param cfile the configuration file.
+	     */
+	    void parse(const string& cfile);
+
+	    /**
+	     * Fetch the reference to options for the very root.
+	     */
+	    config_options& root_options() { return specs[""]; }
+	    /**
+	     * Lookup where the certain config option for the target lies in.
+	     * @param target the target component.
+	     * @param flag the flag specifying the option we're looking for.
+	     * @return the destination options continer or zero.
+	     */
+	    config_options* lookup_config(const string& target,int flag);
+	    /**
+	     * Lookup the action handler for the target.
+	     * @param target the target request.
+	     * @return the action handler or zero.
+	     */
+	    config_options::action_handler_t *lookup_action_handler(const string& target);
+	    /**
+	     * Lookup the HTPP status handler for the target.
+	     * @param target the target.
+	     * @param status the HTTP status.
+	     * @return the handler component.
+	     */
+	    string lookup_http_status_handler(const string& target,const string& status);
+	    /**
+	     * Lookup the options loaded from per-dir config for the target
+	     * @param target the target.
+	     * @return options container or zero.
+	     */
+	    loaded_options* lookup_loaded_options(const string& target);
+	    /**
+	     * Check whether the components for the target should be prebuilt.
+	     * @param target the target.
+	     * @param fn file name.
+	     * @return true if yes.
+	     */
+	    bool match_autobuild_files(const string& target,const char *fn);
+    };
+
+}
+
+#endif /* __SITECING_CONFIGURATION_H */