File: BufferedReader.go

package info (click to toggle)
golang-github-shenwei356-breader 0.0~git20170924.21f0a70-2
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 80 kB
  • sloc: makefile: 7
file content (237 lines) | stat: -rw-r--r-- 5,120 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
/*Package breader (Buffered File Reader), asynchronous parsing and pre-processing while
reading file. Safe cancellation is also supported.

Detail: https://github.com/shenwei356/breader

*/
package breader

import (
	"errors"
	"runtime"
	"sort"
	"strings"
	"sync"

	"github.com/cznic/sortutil"
	"github.com/shenwei356/xopen"
)

// Chunk is a struct compossing with slice of data and error as status
type Chunk struct {
	ID   uint64 // useful for keeping the order of chunk in downstream process
	Data []interface{}
	Err  error
}

// chunk is chunk of lines
type linesChunk struct {
	ID   uint64 // useful for keeping the order of chunk in downstream process
	Data []string
}

// BufferedReader is BufferedReader
type BufferedReader struct {
	reader      *xopen.Reader
	BufferSize  int
	ChunkSize   int
	ProcessFunc func(string) (interface{}, bool, error)

	Ch        chan Chunk
	done      chan struct{}
	finished  bool
	cancelled bool
}

// NewDefaultBufferedReader creates BufferedReader with default parameter
func NewDefaultBufferedReader(file string) (*BufferedReader, error) {
	reader, err := initBufferedReader(file, runtime.NumCPU(), 100, DefaultFunc)
	if err != nil {
		return reader, err
	}
	reader.run()
	return reader, nil
}

// NewBufferedReader is the constructor of BufferedReader with full parameters
func NewBufferedReader(file string, bufferSize int, chunkSize int, fn func(line string) (interface{}, bool, error)) (*BufferedReader, error) {
	reader, err := initBufferedReader(file, bufferSize, chunkSize, fn)
	if err != nil {
		return reader, err
	}
	reader.run()
	return reader, nil
}

// DefaultFunc just trim the new line symbol
var DefaultFunc = func(line string) (interface{}, bool, error) {
	line = strings.TrimRight(line, "\r\n")
	return line, true, nil
}

func initBufferedReader(file string, bufferSize int, chunkSize int, fn func(line string) (interface{}, bool, error)) (*BufferedReader, error) {
	if bufferSize < 1 {
		bufferSize = 1
	}
	if chunkSize < 1 {
		chunkSize = 1
	}

	reader := new(BufferedReader)
	fh, err := xopen.Ropen(file)
	if err != nil {
		return nil, err
	}
	reader.reader = fh

	reader.BufferSize = bufferSize
	reader.ChunkSize = chunkSize
	reader.ProcessFunc = fn
	reader.Ch = make(chan Chunk, bufferSize)
	reader.done = make(chan struct{})

	reader.finished = false
	reader.cancelled = false
	return reader, nil
}

// ErrorCanceled means that the reading process is canceled
var ErrorCanceled = errors.New("reading canceled")

func (reader *BufferedReader) run() {
	ch2 := make(chan Chunk, reader.BufferSize)

	// receive processed chunks and return them in order
	go func() {
		var id uint64
		chunks := make(map[uint64]Chunk)

		for chunk := range ch2 {
			if chunk.Err != nil {
				reader.Ch <- chunk
				close(reader.Ch)
				return
			}
			if chunk.ID == id {
				reader.Ch <- chunk
				id++
			} else { // check bufferd result
				for true {
					if chunk1, ok := chunks[id]; ok {
						reader.Ch <- chunk1
						delete(chunks, chunk1.ID)
						id++
					} else {
						break
					}
				}
				chunks[chunk.ID] = chunk
			}
		}
		if len(chunks) > 0 {
			ids := make(sortutil.Uint64Slice, len(chunks))
			i := 0
			for id := range chunks {
				ids[i] = id
				i++
			}
			sort.Sort(ids)
			for _, id := range ids {
				chunk := chunks[id]
				reader.Ch <- chunk
			}
		}
		close(reader.Ch)
	}()

	// receive lines and process with ProcessFunc
	ch := make(chan linesChunk, reader.BufferSize)
	go func() {
		defer close(ch2)

		var wg sync.WaitGroup
		tokens := make(chan int, reader.BufferSize)
		errDetectedCh := make(chan int)
		var once sync.Once
		for chunk := range ch {
			tokens <- 1
			wg.Add(1)

			go func(chunk linesChunk) {
				defer func() {
					wg.Done()
					<-tokens
				}()

				var chunkData []interface{}
				for _, line := range chunk.Data {
					result, ok, err := reader.ProcessFunc(line)
					if err != nil {
						select {
						case <-errDetectedCh:
						default:
							ch2 <- Chunk{chunk.ID, chunkData, err}
							once.Do(func() { close(errDetectedCh) })
						}
						return
					}
					if ok {
						chunkData = append(chunkData, result)
					}
				}
				ch2 <- Chunk{chunk.ID, chunkData, nil}
			}(chunk)
		}
		wg.Wait()
	}()

	// read lines
	go func() {
		var (
			i    int
			id   uint64
			line string
			err  error
		)
		chunkData := make([]string, reader.ChunkSize)
		for {
			select {
			case <-reader.done:
				if !reader.finished {
					reader.finished = true
					reader.reader.Close()
					close(ch)
					return
				}
			default:
			}
			line, err = reader.reader.ReadString('\n')
			if err != nil {
				chunkData[i] = line
				i++
				ch <- linesChunk{id, chunkData[0:i]}

				reader.finished = true
				reader.reader.Close()
				close(ch)
				return
			}
			chunkData[i] = line
			i++
			if i == reader.ChunkSize {
				ch <- linesChunk{id, chunkData[0:i]}
				id++
				chunkData = make([]string, reader.ChunkSize)
				i = 0
			}
		}
	}()
}

// Cancel method cancel the reading process
func (reader *BufferedReader) Cancel() {
	if !reader.finished && !reader.cancelled {
		close(reader.done)
		reader.cancelled = true
	}
}