base62.go

@@ -112,6 +112,10 @@ func fastDecodeBase62(dst []byte, src []byte) error {
 	const srcBase = 62
 	const dstBase = 4294967296
 
+	// This line helps BCE (Bounds Check Elimination).
+	// It may be safely removed.
+	_ = src[26]
+
 	parts := [27]byte{
 		base62Value(src[0]),
 		base62Value(src[1]),

cmd/ksuid/main.go

@@ -5,10 +5,10 @@ import (
 	"encoding/hex"
 	"flag"
 	"fmt"
-	"html/template"
 	"io"
 	"os"
 	"strings"
+	"text/template"
 	"time"
 
 	"github.com/segmentio/ksuid"

go.mod

@@ -0,0 +1,3 @@
+module github.com/segmentio/ksuid
+
+go 1.12

ksuid.go

@@ -91,7 +91,7 @@ func (i KSUID) Bytes() []byte {
 	return i[:]
 }
 
-// Returns true if this is a "nil" KSUID
+// IsNil returns true if this is a "nil" KSUID
 func (i KSUID) IsNil() bool {
 	return i == Nil
 }
@@ -173,7 +173,7 @@ func (i *KSUID) scan(b []byte) error {
 	}
 }
 
-// Decodes a string-encoded representation of a KSUID object
+// Parse decodes a string-encoded representation of a KSUID object
 func Parse(s string) (KSUID, error) {
 	if len(s) != stringEncodedLength {
 		return Nil, errStrSize
@@ -285,7 +285,7 @@ func Sort(ids []KSUID) {
 	quickSort(ids, 0, len(ids)-1)
 }
 
-// Checks whether a slice of KSUIDs is sorted
+// IsSorted checks whether a slice of KSUIDs is sorted
 func IsSorted(ids []KSUID) bool {
 	if len(ids) != 0 {
 		min := ids[0]

ksuid_test.go

@@ -304,6 +304,16 @@ func TestPrevNext(t *testing.T) {
 	}
 }
 
+func TestGetTimestamp(t *testing.T) {
+	nowTime := time.Now()
+	x, _ := NewRandomWithTime(nowTime)
+	xTime := int64(x.Timestamp())
+	unix := nowTime.Unix()
+	if xTime != unix - epochStamp {
+		t.Fatal(xTime, "!=", unix)
+	}
+}
+
 func testPrevNext(t *testing.T, id, prev, next KSUID) {
 	id1 := id.Prev()
 	id2 := id.Next()