Co-authored-by: Janos Guljas <janos@resenje.org> Co-authored-by: Balint Gabor <balint.g@gmail.com> Co-authored-by: Anton Evangelatov <anton.evangelatov@gmail.com> Co-authored-by: Viktor Trón <viktor.tron@gmail.com>
		
			
				
	
	
		
			110 lines
		
	
	
		
			2.9 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
			
		
		
	
	
			110 lines
		
	
	
		
			2.9 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
// Copyright 2018 The go-ethereum Authors
 | 
						|
// This file is part of the go-ethereum library.
 | 
						|
//
 | 
						|
// The go-ethereum library is free software: you can redistribute it and/or modify
 | 
						|
// it under the terms of the GNU Lesser General Public License as published by
 | 
						|
// the Free Software Foundation, either version 3 of the License, or
 | 
						|
// (at your option) any later version.
 | 
						|
//
 | 
						|
// The go-ethereum library is distributed in the hope that it will be useful,
 | 
						|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
 | 
						|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 | 
						|
// GNU Lesser General Public License for more details.
 | 
						|
//
 | 
						|
// You should have received a copy of the GNU Lesser General Public License
 | 
						|
// along with the go-ethereum library. If not, see <http://www.gnu.org/licenses/>.
 | 
						|
 | 
						|
// package priority_queue implement a channel based priority queue
 | 
						|
// over arbitrary types. It provides an
 | 
						|
// an autopop loop applying a function to the items always respecting
 | 
						|
// their priority. The structure is only quasi consistent ie., if a lower
 | 
						|
// priority item is autopopped, it is guaranteed that there was a point
 | 
						|
// when no higher priority item was present, ie. it is not guaranteed
 | 
						|
// that there was any point where the lower priority item was present
 | 
						|
// but the higher was not
 | 
						|
 | 
						|
package priorityqueue
 | 
						|
 | 
						|
import (
 | 
						|
	"context"
 | 
						|
	"errors"
 | 
						|
 | 
						|
	"github.com/ethereum/go-ethereum/log"
 | 
						|
)
 | 
						|
 | 
						|
var (
 | 
						|
	ErrContention = errors.New("contention")
 | 
						|
 | 
						|
	errBadPriority = errors.New("bad priority")
 | 
						|
 | 
						|
	wakey = struct{}{}
 | 
						|
)
 | 
						|
 | 
						|
// PriorityQueue is the basic structure
 | 
						|
type PriorityQueue struct {
 | 
						|
	Queues []chan interface{}
 | 
						|
	wakeup chan struct{}
 | 
						|
}
 | 
						|
 | 
						|
// New is the constructor for PriorityQueue
 | 
						|
func New(n int, l int) *PriorityQueue {
 | 
						|
	var queues = make([]chan interface{}, n)
 | 
						|
	for i := range queues {
 | 
						|
		queues[i] = make(chan interface{}, l)
 | 
						|
	}
 | 
						|
	return &PriorityQueue{
 | 
						|
		Queues: queues,
 | 
						|
		wakeup: make(chan struct{}, 1),
 | 
						|
	}
 | 
						|
}
 | 
						|
 | 
						|
// Run is a forever loop popping items from the queues
 | 
						|
func (pq *PriorityQueue) Run(ctx context.Context, f func(interface{})) {
 | 
						|
	top := len(pq.Queues) - 1
 | 
						|
	p := top
 | 
						|
READ:
 | 
						|
	for {
 | 
						|
		q := pq.Queues[p]
 | 
						|
		select {
 | 
						|
		case <-ctx.Done():
 | 
						|
			return
 | 
						|
		case x := <-q:
 | 
						|
			log.Trace("priority.queue f(x)", "p", p, "len(Queues[p])", len(pq.Queues[p]))
 | 
						|
			f(x)
 | 
						|
			p = top
 | 
						|
		default:
 | 
						|
			if p > 0 {
 | 
						|
				p--
 | 
						|
				log.Trace("priority.queue p > 0", "p", p)
 | 
						|
				continue READ
 | 
						|
			}
 | 
						|
			p = top
 | 
						|
			select {
 | 
						|
			case <-ctx.Done():
 | 
						|
				return
 | 
						|
			case <-pq.wakeup:
 | 
						|
				log.Trace("priority.queue wakeup", "p", p)
 | 
						|
			}
 | 
						|
		}
 | 
						|
	}
 | 
						|
}
 | 
						|
 | 
						|
// Push pushes an item to the appropriate queue specified in the priority argument
 | 
						|
// if context is given it waits until either the item is pushed or the Context aborts
 | 
						|
func (pq *PriorityQueue) Push(x interface{}, p int) error {
 | 
						|
	if p < 0 || p >= len(pq.Queues) {
 | 
						|
		return errBadPriority
 | 
						|
	}
 | 
						|
	log.Trace("priority.queue push", "p", p, "len(Queues[p])", len(pq.Queues[p]))
 | 
						|
	select {
 | 
						|
	case pq.Queues[p] <- x:
 | 
						|
	default:
 | 
						|
		return ErrContention
 | 
						|
	}
 | 
						|
	select {
 | 
						|
	case pq.wakeup <- wakey:
 | 
						|
	default:
 | 
						|
	}
 | 
						|
	return nil
 | 
						|
}
 |