Environment redesign and test/examples review. English API revisions
[anna.git] / source / core / util / Environment.cpp
1 // ANNA - Anna is Not 'N' Anymore
2 //
3 // (c) Copyright 2005-2014 Eduardo Ramos Testillano & Francisco Ruiz Rayo
4 //
5 // https://bitbucket.org/testillano/anna
6 //
7 // Redistribution and use in source and binary forms, with or without
8 // modification, are permitted provided that the following conditions
9 // are met:
10 //
11 //     * Redistributions of source code must retain the above copyright
12 // notice, this list of conditions and the following disclaimer.
13 //     * Redistributions in binary form must reproduce the above
14 // copyright notice, this list of conditions and the following disclaimer
15 // in the documentation and/or other materials provided with the
16 // distribution.
17 //     * Neither the name of Google Inc. nor the names of its
18 // contributors may be used to endorse or promote products derived from
19 // this software without specific prior written permission.
20 //
21 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22 // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23 // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
24 // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
25 // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
26 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
27 // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29 // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
31 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32 //
33 // Authors: eduardo.ramos.testillano@gmail.com
34 //          cisco.tierra@gmail.com
35
36
37 #include <anna/core/util/Environment.hpp>
38
39 #include <anna/config/defines.hpp>
40 #include <anna/core/tracing/Logger.hpp>
41 #include <anna/core/tracing/TraceMethod.hpp>
42 #include <anna/core/functions.hpp>
43
44 #include <stdlib.h> // getenv / setenv
45 #include <string>
46
47
48
49 using namespace std;
50 using namespace anna;
51
52 extern int errno;
53
54 void Environment::initialize(char **envp) throw() {
55   LOGMETHOD(TraceMethod tm("Environment", "initialize", ANNA_FILE_LOCATION));
56   // clear data
57   a_vars.clear();
58   if (!envp) return;
59
60   // register data
61   std::string assignment, var, val;
62   while (*envp) {
63     assignment = *envp; 
64     std::size_t equalPos = assignment.find("=");
65     if (equalPos !=  string::npos) { // protection
66       var = assignment.substr(0, equalPos - 1);
67       val = assignment.substr(equalPos, assignment.size() - 1);
68       a_vars[var] = val;
69     }
70     envp++;
71   }
72 }
73
74 std::string Environment::getValue(const char* variableName, bool exceptionIfMissing) throw(RuntimeException) {
75   if(!variableName)
76     throw RuntimeException("Invalid NULL variable name!", ANNA_FILE_LOCATION);
77
78   std::string var = variableName;
79
80   return getValue(var, exceptionIfMissing);
81 }
82
83 std::string Environment::getValue(const std::string &variableName, bool exceptionIfMissing) throw(RuntimeException) {
84   std::string result = "";
85
86   std::map<std::string, std::string>::const_iterator it = a_vars.find(variableName);
87
88   if(it == a_vars.end()) {
89     char *current = getenv (variableName.c_str());
90     if (!current) {
91       std::string msg = "The variable '";
92       msg += variableName;
93       msg += "' is not defined in the environment.";
94       LOGDEBUG(Logger::debug(msg, ANNA_FILE_LOCATION));
95
96       if(exceptionIfMissing) throw RuntimeException(msg, ANNA_FILE_LOCATION);
97     }
98     else {
99       // assignment
100       a_vars[variableName] = current;
101       result = current;
102     }
103   }
104   else {
105     result = it->second;
106   }
107
108   return result;
109 }
110
111
112 void Environment::setVariable(const std::string &name, const std::string &value, bool overwrite) throw(RuntimeException) {
113
114   if (name == "") throw RuntimeException("Must provide non-empty variable name", ANNA_FILE_LOCATION);
115
116   if(setenv(name.c_str(), value.c_str(), overwrite ? 1:0) != 0) {
117     std::string msg = "Cannot set the environment variable '";
118     msg += name;
119     msg += "=\"";
120     msg += value;
121     msg += "\"'. The errno is ";
122     msg += anna::functions::asString(errno);
123
124     throw RuntimeException(msg, ANNA_FILE_LOCATION);
125   }
126
127   // optimization
128   if (overwrite) 
129     a_vars[name] = value;
130 }
131
132
133 void Environment::unsetVariable(const std::string &name) throw(RuntimeException) {
134
135   if (name == "") throw RuntimeException("Must provide non-empty variable name", ANNA_FILE_LOCATION);
136
137   if(unsetenv(name.c_str()) != 0) {
138     std::string msg = "Cannot unset the environment variable named '";
139     msg += name;
140     msg += "'. The errno is ";
141     msg += anna::functions::asString(errno);
142
143     throw RuntimeException(msg, ANNA_FILE_LOCATION);
144   }
145
146   std::map<std::string, std::string>::iterator it = a_vars.find(name);
147   if(it != a_vars.end()) a_vars.erase(it);
148 }
149