colouringcode-passenger 0.1

data/ext/common/StaticString.h

@@ -0,0 +1,148 @@
+/*
+ *  Phusion Passenger - http://www.modrails.com/
+ *  Copyright (c) 2009 Phusion
+ *
+ *  "Phusion Passenger" is a trademark of Hongli Lai & Ninh Bui.
+ *
+ *  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.
+ */
+#ifndef _PASSENGER_STATIC_STRING_H_
+#define _PASSENGER_STATIC_STRING_H_
+
+#include <string>
+#include <cstring>
+
+namespace Passenger {
+
+using namespace std;
+
+/**
+ * An immutable, static byte buffer. This class will never copy data:
+ * it just holds a pointer to the data. So a StaticString will become unusable
+ * once the data it refers to has been freed.
+ *
+ * StaticString will never modify the data.
+ */
+class StaticString {
+private:
+	const char *content;
+	string::size_type len;
+	
+public:
+	StaticString() {
+		content = "";
+		len = 0;
+	}
+	
+	StaticString(const StaticString &b) {
+		content = b.content;
+		len = b.len;
+	}
+	
+	StaticString(const string &s) {
+		content = s.data();
+		len = s.size();
+	}
+	
+	StaticString(const char *data) {
+		content = data;
+		len = strlen(data);
+	}
+	
+	StaticString(const char *data, string::size_type len) {
+		content = data;
+		this->len = len;
+	}
+	
+	bool empty() const {
+		return len == 0;
+	}
+	
+	string::size_type size() const {
+		return len;
+	}
+	
+	const char *c_str() const {
+		return content;
+	}
+	
+	const char *data() const {
+		return content;
+	}
+	
+	bool equals(const StaticString &other) const {
+		return len == other.len && memcmp(content, other.content, len) == 0;
+	}
+	
+	bool equals(const string &other) const {
+		return len == other.size() && memcmp(content, other.data(), len) == 0;
+	}
+	
+	bool operator==(const StaticString &other) const {
+		return len == other.len && memcmp(content, other.content, len) == 0;
+	}
+	
+	bool operator==(const char *other) const {
+		return memcmp(content, other, strlen(other)) == 0;
+	}
+	
+	bool operator!=(const StaticString &other) const {
+		return len == other.len && memcmp(content, other.content, len) != 0;
+	}
+	
+	bool operator!=(const char *other) const {
+		return memcmp(content, other, strlen(other)) != 0;
+	}
+	
+	bool operator<(const StaticString &other) const {
+		size_t size = (len < other.size()) ? len : other.size();
+		int result = memcmp(content, other.data(), size);
+		if (result == 0) {
+			return len < other.size();
+		} else {
+			return result < 0;
+		}
+	}
+	
+	bool operator<(const char *other) const {
+		return *this < StaticString(other);
+	}
+	
+	string operator+(const char *other) const {
+		return string(content, len) + other;
+	}
+	
+	string operator+(const string &other) const {
+		return string(content, len) + other;
+	}
+	
+	string operator+(const StaticString &other) const {
+		string result(content, len);
+		result.append(other.data(), other.size());
+		return result;
+	}
+	
+	operator string() const {
+		return string(content, len);
+	}
+};
+
+} // namespace Passenger
+
+#endif /* _PASSENGER_STATIC_STRING_H_ */

data/ext/common/StringListCreator.h

@@ -0,0 +1,83 @@
+/*
+ *  Phusion Passenger - http://www.modrails.com/
+ *  Copyright (c) 2009 Phusion
+ *
+ *  "Phusion Passenger" is a trademark of Hongli Lai & Ninh Bui.
+ *
+ *  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.
+ */
+#ifndef _PASSENGER_STRING_LIST_CREATOR_H_
+#define _PASSENGER_STRING_LIST_CREATOR_H_
+
+#include <string>
+#include <vector>
+#include <boost/shared_ptr.hpp>
+#include "Base64.h"
+#include "Utils.h"
+
+namespace Passenger {
+
+using namespace std;
+using namespace boost;
+
+typedef vector<string> StringList;
+typedef shared_ptr<StringList> StringListPtr;
+
+
+class StringListCreator {
+public:
+	virtual ~StringListCreator() {}
+	
+	/** May throw arbitrary exceptions. */
+	virtual const StringListPtr getItems() const = 0;
+};
+
+typedef shared_ptr<StringListCreator> StringListCreatorPtr;
+
+class SimpleStringListCreator: public StringListCreator {
+public:
+	StringListPtr items;
+	
+	SimpleStringListCreator() {
+		items = ptr(new StringList());
+	}
+	
+	SimpleStringListCreator(const StaticString &data) {
+		items = ptr(new StringList());
+		string buffer = Base64::decode(data);
+		if (!buffer.empty()) {
+			string::size_type start = 0, pos;
+			const string &const_buffer(buffer);
+			while ((pos = const_buffer.find('\0', start)) != string::npos) {
+				items->push_back(const_buffer.substr(start, pos - start));
+				start = pos + 1;
+			}
+		}
+	}
+	
+	virtual const StringListPtr getItems() const {
+		return items;
+	}
+};
+
+typedef shared_ptr<SimpleStringListCreator> SimpleStringListCreatorPtr;
+
+} // namespace Passenger
+
+#endif /* _PASSENGER_STRING_LIST_CREATOR_H_ */

data/ext/common/SystemTime.cpp

@@ -0,0 +1,33 @@
+/*
+ *  Phusion Passenger - http://www.modrails.com/
+ *  Copyright (c) 2009 Phusion
+ *
+ *  "Phusion Passenger" is a trademark of Hongli Lai & Ninh Bui.
+ *
+ *  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.
+ */
+
+#include <time.h>
+
+namespace Passenger {
+	namespace SystemTimeData {
+		bool hasForcedValue = false;
+		time_t forcedValue = 0;
+	}
+}

data/ext/common/SystemTime.h

@@ -0,0 +1,88 @@
+/*
+ *  Phusion Passenger - http://www.modrails.com/
+ *  Copyright (c) 2009 Phusion
+ *
+ *  "Phusion Passenger" is a trademark of Hongli Lai & Ninh Bui.
+ *
+ *  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.
+ */
+#ifndef _PASSENGER_SYSTEM_TIME_H_
+#define _PASSENGER_SYSTEM_TIME_H_
+
+#include <boost/thread.hpp>
+#include <oxt/system_calls.hpp>
+#include "Exceptions.h"
+
+namespace Passenger {
+
+using namespace oxt;
+
+namespace SystemTimeData {
+	extern bool hasForcedValue;
+	extern time_t forcedValue;
+}
+
+/**
+ * This class allows one to obtain the system time, similar to time(). Unlike
+ * time(), it is possible to force a certain time to be returned, which is
+ * useful for testing code that depends on the system time.
+ */
+class SystemTime {
+public:
+	/**
+	 * Returns the time since the Epoch, measured in seconds. Or, if a time
+	 * was forced, then the forced time is returned instead.
+	 *
+	 * @throws TimeRetrievalException Something went wrong while retrieving the time.
+	 * @throws boost::thread_interrupted
+	 */
+	static time_t get() {
+		if (SystemTimeData::hasForcedValue) {
+			return SystemTimeData::forcedValue;
+		} else {
+			time_t ret = syscalls::time(NULL);
+			if (ret == -1) {
+				throw TimeRetrievalException(
+					"Unable to retrieve the system time",
+					errno);
+			}
+			return ret;
+		}
+	}
+
+	/**
+	 * Force get() to return the given value.
+	 */
+	static void force(time_t value) {
+		SystemTimeData::hasForcedValue = true;
+		SystemTimeData::forcedValue = value;
+	}
+
+	/**
+	 * Release the previously forced value, so that get()
+	 * returns the system time once again.
+	 */
+	static void release() {
+		SystemTimeData::hasForcedValue = false;
+	}
+};
+
+} // namespace Passenger
+
+#endif /* _PASSENGER_SYSTEM_TIME_H_ */

data/ext/common/Timer.h

@@ -0,0 +1,90 @@
+/*
+ *  Phusion Passenger - http://www.modrails.com/
+ *  Copyright (c) 2008, 2009 Phusion
+ *
+ *  "Phusion Passenger" is a trademark of Hongli Lai & Ninh Bui.
+ *
+ *  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.
+ */
+#ifndef _PASSENGER_TIMER_H_
+#define _PASSENGER_TIMER_H_
+
+#include <sys/time.h>
+
+namespace Passenger {
+
+/**
+ * A Timer which one can use to check how much time has elapsed since the timer started.
+ * This timer support microseconds-resolution, but the exact resolution depends on the OS
+ * and the hardware.
+ *
+ * @code
+ * Timer timer;
+ * sleep(10);
+ * timer.elapsed();   // => about 10000 (msec)
+ * @endcode
+ */
+class Timer {
+private:
+	struct timeval startTime;
+public:
+	/**
+	 * Creates a new Timer object.
+	 *
+	 * @param startNow Whether the timer should be started immediately.
+	 */
+	Timer(bool startNow = true) {
+		if (startNow) {
+			start();
+		} else {
+			startTime.tv_sec = 0;
+			startTime.tv_usec = 0;
+		}
+	}
+	
+	/**
+	 * Start the timer. If the timer was already started, then this will
+	 * restart the timer.
+	 */
+	void start() {
+		// TODO: We really use should clock_gettime() and the monotonic
+		// clock whenever possible, instead of gettimeofday()...
+		gettimeofday(&startTime, NULL);
+	}
+	
+	/**
+	 * Checks how much time has elapsed since the timer was last started.
+	 *
+	 * @pre The timer must have been started.
+	 * @return The elapsed time, in miliseconds.
+	 */
+	unsigned long long elapsed() const {
+		struct timeval t;
+		unsigned long long now, beginning;
+		
+		gettimeofday(&t, NULL);
+		now = (unsigned long long) t.tv_sec * 1000 + t.tv_usec / 1000;
+		beginning = (unsigned long long) startTime.tv_sec * 1000 + startTime.tv_usec / 1000;
+		return now - beginning;
+	}
+};
+
+} // namespace Passenger
+
+#endif /* _PASSENGER_TIMER_H_ */