Merge with upstream, apply PR Workiva#163

Author: Tony Lambiris

queue/queue.go

@@ -164,6 +164,25 @@ func (items *items) getMatch(checker func(item interface{}) bool) []interface{}
 	return returnItems
 }
 
+func (items *items) getMatch(checker func(item interface{}) bool) []interface{} {
+	length := len(*items)
+
+	if len(*items) == 0 {
+		// returning nil here actually wraps that nil in a list
+		// of interfaces... thanks go
+		return []interface{}{}
+	}
+
+	returnItems := make([]interface{}, 0, length)
+	for _, item := range *items {
+		if !checker(item) {
+			returnItems = append(returnItems, item)
+		}
+	}
+
+	return returnItems
+}
+
 type sema struct {
 	ready    chan bool
 	response *sync.WaitGroup
@@ -369,6 +388,51 @@ func (q *Queue) Search(checker func(item interface{}) bool) []interface{} {
 	return result
 }
 
+// GetItem returns one item without deleting in this queue.
+func (q *Queue) GetItem(pos int) (interface{}, bool) {
+	q.lock.Lock()
+	defer q.lock.Unlock()
+	if len(q.items) > pos {
+		return q.items[pos], true
+	}
+	return nil, false
+}
+
+// GetItems returns items in this queue.
+func (q *Queue) Clear(hint int64) {
+	q.lock.Lock()
+	defer q.lock.Unlock()
+	q.items = make([]interface{}, 0, hint)
+}
+
+// GetItems returns items in this queue.
+func (q *Queue) GetItems() []interface{} {
+	q.lock.Lock()
+	defer q.lock.Unlock()
+
+	return q.items
+}
+
+// Search takes a function and returns a list of items that
+// match the checker.  This does not wait and remove items.
+func (q *Queue) Search(checker func(item interface{}) bool) ([]interface{}) {
+	if checker == nil {
+		return nil
+	}
+
+	q.lock.Lock()
+
+	if q.disposed {
+		q.lock.Unlock()
+		return nil
+	}
+
+	result := q.items.getMatch(checker)
+	q.lock.Unlock()
+	return result
+}
+
+
 // GetItem returns one item without deleting in this queue.
 func (q *Queue) GetItem(pos int) (interface{}, bool) {
 	q.lock.Lock()

queue/queue_test.go

@@ -190,6 +190,57 @@ func TestGetEmpty(t *testing.T) {
 	assert.Equal(t, `a`, result[0])
 }
 
+func TestGetItems(t *testing.T) {
+	q := New(10)
+
+	q.Put(`a`)
+
+	result := q.GetItems()
+
+	assert.Len(t, result, 1)
+	assert.Equal(t, `a`, result[0])
+}
+
+func TestSearch(t *testing.T) {
+	q := New(10)
+
+	q.Put(`a`)
+	q.Put(`b`)
+	q.Put(`c`)
+
+	result := q.Search(func(item interface{}) bool {
+		return item != `b`
+	})
+
+	assert.Len(t, result, 1)
+	assert.Equal(t, `b`, result[0])
+}
+
+func TestGetItem(t *testing.T) {
+	q := New(10)
+
+	q.Put(`a`)
+
+	result, ok := q.GetItem(0)
+	if !assert.Equal(t, ok, true) {
+		return
+	}
+
+	assert.Equal(t, `a`, result)
+}
+
+func TestClear(t *testing.T) {
+	q := New(10)
+
+	q.Put(`a`)
+
+	result := q.GetItems()
+	assert.Len(t, result, 1)
+	q.Clear(10)
+	result = q.GetItems()
+	assert.Len(t, result, 0)
+}
+
 func TestMultipleGetEmpty(t *testing.T) {
 	q := New(10)
 	var wg sync.WaitGroup