ocr

common/src/github.com/couchbaselabs/logg/.gitignore

@@ -0,0 +1,3 @@
+*~
+[#]*[#]
+.\#*

common/src/github.com/couchbaselabs/logg/README.md

@@ -0,0 +1,50 @@
+A lightweight logging utility for Go.
+
+![screnshot](http://cl.ly/image/2l0Q1M123D1c/Screen%20Shot%202013-09-14%20at%2012.28.07%20PM.png)
+
+# Features
+
+* Terminal color coded logs
+* Simple log levels (LOG_LEVEL_NORMAL, LOG_LEVEL_WARNINGS, LOG_LEVEL_PANICS)
+* Keyword based log partitioning.  Eg, define a "REST" keyword for all REST related logs, with easy ability to hide/show these logs.
+* Log Timestamp which includes microseconds
+
+# Quick Start
+
+Import:
+
+```
+import "github.com/couchbaselabs/logg"
+```
+
+Log something:
+
+```
+logg.Log("hello")
+```
+
+Setup keyword based log partitioning:
+
+```
+logg.LogKeys["foo"] = true
+```
+
+Log something to the "foo" channel:
+
+```
+logg.LogTo("foo", "hello foo")
+```
+
+Increase log level to only include panics:
+
+```
+logg.LogLevel = logg.LOG_LEVEL_PANICS
+```
+
+# API docs
+
+The [API Docs](http://godoc.org/github.com/couchbaselabs/logg) are available on godoc.org.
+
+
+
+

common/src/github.com/couchbaselabs/logg/logg.go

@@ -0,0 +1,186 @@
+//  Copyright (c) 2012-2013 Couchbase, Inc.
+//  Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file
+//  except in compliance with the License. You may obtain a copy of the License at
+//    http://www.apache.org/licenses/LICENSE-2.0
+//  Unless required by applicable law or agreed to in writing, software distributed under the
+//  License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+//  either express or implied. See the License for the specific language governing permissions
+//  and limitations under the License.
+
+package logg
+
+import (
+	"fmt"
+	"log"
+	"os"
+	"runtime"
+	"strings"
+)
+
+const (
+	LOG_LEVEL_NORMAL   = 1
+	LOG_LEVEL_WARNINGS = 2
+	LOG_LEVEL_PANICS   = 3
+)
+
+var LogLevel int = LOG_LEVEL_NORMAL
+
+// Set of LogTo() key strings that are enabled.
+var LogKeys map[string]bool
+
+var logger *log.Logger
+
+func init() {
+	logger = log.New(os.Stderr, "", log.Lmicroseconds)
+	LogKeys = make(map[string]bool)
+}
+
+// Disables ANSI color in log output.
+func LogNoColor() {
+	reset, dim, fgRed, fgYellow = "", "", "", ""
+}
+
+func LogNoTime() {
+	logger.SetFlags(logger.Flags() &^ (log.Ldate | log.Ltime | log.Lmicroseconds))
+}
+
+// Parses a comma-separated list of log keys, probably coming from an argv flag.
+// The key "bw" is interpreted as a call to LogNoColor, not a key.
+func ParseLogFlag(flag string) {
+	if flag != "" {
+		ParseLogFlags(strings.Split(flag, ","))
+	}
+}
+
+// Parses an array of log keys, probably coming from a argv flags.
+// The key "bw" is interpreted as a call to LogNoColor, not a key.
+func ParseLogFlags(flags []string) {
+	for _, key := range flags {
+		switch key {
+		case "bw":
+			LogNoColor()
+		case "notime":
+			LogNoTime()
+		default:
+			LogKeys[key] = true
+			for strings.HasSuffix(key, "+") {
+				key = key[0 : len(key)-1]
+				LogKeys[key] = true // "foo+" also enables "foo"
+			}
+		}
+	}
+	Log("Enabling logging: %s", flags)
+}
+
+// Returns a string identifying a function on the call stack.
+// Use depth=1 for the caller of the function that calls GetCallersName, etc.
+func GetCallersName(depth int) string {
+	pc, file, line, ok := runtime.Caller(depth + 1)
+	if !ok {
+		return "???"
+	}
+
+	fnname := ""
+	if fn := runtime.FuncForPC(pc); fn != nil {
+		fnname = fn.Name()
+	}
+
+	return fmt.Sprintf("%s() at %s:%d", lastComponent(fnname), lastComponent(file), line)
+}
+
+// Logs a message to the console, but only if the corresponding key is true in LogKeys.
+func LogTo(key string, format string, args ...interface{}) {
+	if LogLevel <= 1 && LogKeys[key] {
+		logger.Printf(fgYellow+key+": "+reset+format, args...)
+	}
+}
+
+// Logs a message to the console.
+func Log(format string, args ...interface{}) {
+	if LogLevel <= 1 {
+		logger.Printf(format, args...)
+	}
+}
+
+// If the error is not nil, logs its description and the name of the calling function.
+// Returns the input error for easy chaining.
+func LogError(err error) error {
+	if LogLevel <= 2 && err != nil {
+		logWithCaller(fgRed, "ERROR", "%v", err)
+	}
+	return err
+}
+
+// Wrapper around Warn to provide consistent naming
+func LogWarn(format string, args ...interface{}) {
+	Warn(format, args)
+}
+
+// Logs a warning to the console
+func Warn(format string, args ...interface{}) {
+	if LogLevel <= 2 {
+		logWithCaller(fgRed, "WARNING", format, args...)
+	}
+}
+
+// Logs a highlighted message prefixed with "TEMP". This function is intended for
+// temporary logging calls added during development and not to be checked in, hence its
+// distinctive name (which is visible and easy to search for before committing.)
+func TEMP(format string, args ...interface{}) {
+	logWithCaller(fgYellow, "TEMP", format, args...)
+}
+
+// Logs a warning to the console, then panics.
+func LogPanic(format string, args ...interface{}) {
+	logWithCaller(fgRed, "PANIC", format, args...)
+	panic(fmt.Sprintf(format, args...))
+}
+
+// Logs a warning to the console, then exits the process.
+func LogFatal(format string, args ...interface{}) {
+	logWithCaller(fgRed, "FATAL", format, args...)
+	os.Exit(1)
+}
+
+func logWithCaller(color string, prefix string, format string, args ...interface{}) {
+	message := fmt.Sprintf(format, args...)
+	logger.Print(color, prefix, ": ", message, reset,
+		dim, " -- ", GetCallersName(2), reset)
+}
+
+func lastComponent(path string) string {
+	if index := strings.LastIndex(path, "/"); index >= 0 {
+		path = path[index+1:]
+	} else if index = strings.LastIndex(path, "\\"); index >= 0 {
+		path = path[index+1:]
+	}
+	return path
+}
+
+// ANSI color control escape sequences.
+// Shamelessly copied from https://github.com/sqp/godock/blob/master/libs/log/colors.go
+var (
+	reset      = "\x1b[0m"
+	bright     = "\x1b[1m"
+	dim        = "\x1b[2m"
+	underscore = "\x1b[4m"
+	blink      = "\x1b[5m"
+	reverse    = "\x1b[7m"
+	hidden     = "\x1b[8m"
+	fgBlack    = "\x1b[30m"
+	fgRed      = "\x1b[31m"
+	fgGreen    = "\x1b[32m"
+	fgYellow   = "\x1b[33m"
+	fgBlue     = "\x1b[34m"
+	fgMagenta  = "\x1b[35m"
+	fgCyan     = "\x1b[36m"
+	fgWhite    = "\x1b[37m"
+	bgBlack    = "\x1b[40m"
+	bgRed      = "\x1b[41m"
+	bgGreen    = "\x1b[42m"
+	bgYellow   = "\x1b[43m"
+	bgBlue     = "\x1b[44m"
+	bgMagenta  = "\x1b[45m"
+	bgCyan     = "\x1b[46m"
+	bgWhite    = "\x1b[47m"
+)

common/src/github.com/tleyden/open-ocr-client

@@ -0,0 +1 @@
+Subproject commit b0e82eef193817cdaa910caf2662e4dccff4f365