reader.go 2.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100
  1. // Copyright 2014-2022 Ulrich Kunitz. All rights reserved.
  2. // Use of this source code is governed by a BSD-style
  3. // license that can be found in the LICENSE file.
  4. // Package lzma supports the decoding and encoding of LZMA streams.
  5. // Reader and Writer support the classic LZMA format. Reader2 and
  6. // Writer2 support the decoding and encoding of LZMA2 streams.
  7. //
  8. // The package is written completely in Go and doesn't rely on any external
  9. // library.
  10. package lzma
  11. import (
  12. "errors"
  13. "io"
  14. )
  15. // ReaderConfig stores the parameters for the reader of the classic LZMA
  16. // format.
  17. type ReaderConfig struct {
  18. DictCap int
  19. }
  20. // fill converts the zero values of the configuration to the default values.
  21. func (c *ReaderConfig) fill() {
  22. if c.DictCap == 0 {
  23. c.DictCap = 8 * 1024 * 1024
  24. }
  25. }
  26. // Verify checks the reader configuration for errors. Zero values will
  27. // be replaced by default values.
  28. func (c *ReaderConfig) Verify() error {
  29. c.fill()
  30. if !(MinDictCap <= c.DictCap && int64(c.DictCap) <= MaxDictCap) {
  31. return errors.New("lzma: dictionary capacity is out of range")
  32. }
  33. return nil
  34. }
  35. // Reader provides a reader for LZMA files or streams.
  36. type Reader struct {
  37. lzma io.Reader
  38. h header
  39. d *decoder
  40. }
  41. // NewReader creates a new reader for an LZMA stream using the classic
  42. // format. NewReader reads and checks the header of the LZMA stream.
  43. func NewReader(lzma io.Reader) (r *Reader, err error) {
  44. return ReaderConfig{}.NewReader(lzma)
  45. }
  46. // NewReader creates a new reader for an LZMA stream in the classic
  47. // format. The function reads and verifies the the header of the LZMA
  48. // stream.
  49. func (c ReaderConfig) NewReader(lzma io.Reader) (r *Reader, err error) {
  50. if err = c.Verify(); err != nil {
  51. return nil, err
  52. }
  53. data := make([]byte, HeaderLen)
  54. if _, err := io.ReadFull(lzma, data); err != nil {
  55. if err == io.EOF {
  56. return nil, errors.New("lzma: unexpected EOF")
  57. }
  58. return nil, err
  59. }
  60. r = &Reader{lzma: lzma}
  61. if err = r.h.unmarshalBinary(data); err != nil {
  62. return nil, err
  63. }
  64. if r.h.dictCap < MinDictCap {
  65. r.h.dictCap = MinDictCap
  66. }
  67. dictCap := r.h.dictCap
  68. if c.DictCap > dictCap {
  69. dictCap = c.DictCap
  70. }
  71. state := newState(r.h.properties)
  72. dict, err := newDecoderDict(dictCap)
  73. if err != nil {
  74. return nil, err
  75. }
  76. r.d, err = newDecoder(ByteReader(lzma), state, dict, r.h.size)
  77. if err != nil {
  78. return nil, err
  79. }
  80. return r, nil
  81. }
  82. // EOSMarker indicates that an EOS marker has been encountered.
  83. func (r *Reader) EOSMarker() bool {
  84. return r.d.eosMarker
  85. }
  86. // Read returns uncompressed data.
  87. func (r *Reader) Read(p []byte) (n int, err error) {
  88. return r.d.Read(p)
  89. }