d2dbb8c963
* cli: initial work on debug; server-status target * debug: add metrics capture target (#7376) * check against DR secondary * debug: add compression * refactor check into preflight func * debug: set short test time on tests, fix exit code bug * debug: use temp dir for output on tests * debug: use mholt/archiver for compression * first pass on adding pprof * use logger for output * refactor polling target capture logic * debug: poll and collect replication status * debug: poll and collect host-info; rename output files and collection refactor * fix comments * add archive test; fix bugs found * rename flag name to singular target * add target output test; scaffold other tests cases * debug/test: add pprof and index file tests * debug/test: add min timing check tests * debug: fix index gen race and collection goroutine race * debug: extend archive tests, handle race between program exit and polling goroutines * update docstring * debug: correctly add to pollingWg * debug: add config target support * debug: don't wait on interrupt shutdown; add file exists unit tests * move pprof bits into its goroutine * debug: skip empty metrics and some pprof file creation if permission denied, add matching unit test * address comments and feedback * Vault debug using run.Group (#7658) * debug: switch to use oklog/run.Group * debug: use context to cancel requests and interrupt rungroups. * debug: trigger the first interval properly * debug: metrics collection should use metrics interval * debug: add missing continue on metrics error * debug: remove the use of buffered chan to trigger first interval * debug: don't shadow BaseCommand's client, properly block on interval capture failures * debug: actually use c.cachedClient everywhere * go mod vendor * debug: run all pprof in goroutines; bump pprof timings in tests to reduce flakiness * debug: update help text
75 lines
2.4 KiB
Go
75 lines
2.4 KiB
Go
// Copyright 2015, Joe Tsai. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style
|
|
// license that can be found in the LICENSE.md file.
|
|
|
|
// Package compress is a collection of compression libraries.
|
|
package compress
|
|
|
|
import (
|
|
"bufio"
|
|
"io"
|
|
|
|
"github.com/dsnet/compress/internal/errors"
|
|
)
|
|
|
|
// The Error interface identifies all compression related errors.
|
|
type Error interface {
|
|
error
|
|
CompressError()
|
|
|
|
// IsDeprecated reports the use of a deprecated and unsupported feature.
|
|
IsDeprecated() bool
|
|
|
|
// IsCorrupted reports whether the input stream was corrupted.
|
|
IsCorrupted() bool
|
|
}
|
|
|
|
var _ Error = errors.Error{}
|
|
|
|
// ByteReader is an interface accepted by all decompression Readers.
|
|
// It guarantees that the decompressor never reads more data than is necessary
|
|
// from the underlying io.Reader.
|
|
type ByteReader interface {
|
|
io.Reader
|
|
io.ByteReader
|
|
}
|
|
|
|
var _ ByteReader = (*bufio.Reader)(nil)
|
|
|
|
// BufferedReader is an interface accepted by all decompression Readers.
|
|
// It guarantees that the decompressor never reads more data than is necessary
|
|
// from the underlying io.Reader. Since BufferedReader allows a decompressor
|
|
// to peek at bytes further along in the stream without advancing the read
|
|
// pointer, decompression can experience a significant performance gain when
|
|
// provided a reader that satisfies this interface. Thus, a decompressor will
|
|
// prefer this interface over ByteReader for performance reasons.
|
|
//
|
|
// The bufio.Reader satisfies this interface.
|
|
type BufferedReader interface {
|
|
io.Reader
|
|
|
|
// Buffered returns the number of bytes currently buffered.
|
|
//
|
|
// This value becomes invalid following the next Read/Discard operation.
|
|
Buffered() int
|
|
|
|
// Peek returns the next n bytes without advancing the reader.
|
|
//
|
|
// If Peek returns fewer than n bytes, it also returns an error explaining
|
|
// why the peek is short. Peek must support peeking of at least 8 bytes.
|
|
// If 0 <= n <= Buffered(), Peek is guaranteed to succeed without reading
|
|
// from the underlying io.Reader.
|
|
//
|
|
// This result becomes invalid following the next Read/Discard operation.
|
|
Peek(n int) ([]byte, error)
|
|
|
|
// Discard skips the next n bytes, returning the number of bytes discarded.
|
|
//
|
|
// If Discard skips fewer than n bytes, it also returns an error.
|
|
// If 0 <= n <= Buffered(), Discard is guaranteed to succeed without reading
|
|
// from the underlying io.Reader.
|
|
Discard(n int) (int, error)
|
|
}
|
|
|
|
var _ BufferedReader = (*bufio.Reader)(nil)
|