ruby-brs 1.3.2 → 1.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 614baececc4a64311bdd172a962cb5f9bc721b2ade99ed84216ab79908f5a0ca
-  data.tar.gz: 88899da83cd343c1217652b7558a6770e43bd7722f3db7e1e3023ad54888bb54
+  metadata.gz: b6acc107214aae47c21bea586f3281f3b16ad01e03a5f13990667603b625ebd3
+  data.tar.gz: 7cf0a0aacb4bb52457f009a1ceffc6a6c9b6fb80bdf289b86efaabeed261de3f
 SHA512:
-  metadata.gz: efb6e0ec7ee97e4d4c6977b6843ee81ae6ec334af2985674634ea31a24ff00373753cc828bbc250ec137700fa721f84e1071fd6486cbbc2db869e4e6850e7255
-  data.tar.gz: 0ad07a2ebbbbbd27ff47a4e2780e90f297f4d02b36107f2877d45863f538b3f9b32b6aab18451a6376f620c6eee50118b6023b405cdb1f7c8079f1b8a295fd82
+  metadata.gz: 703c614f49408c3aeb4203aa6f1a5f6abd341d3e0f88275d6c88d52e66e0f1a2f49e00908675e9a4bebcefd0851b33b3f7a115b7e3577d2718acb90d6d2ae551
+  data.tar.gz: d4984cf3b656386c7ab0dfecaebed8be95e5b2b0a24c48a21413e4908fd50d9862883baf887dddb980378f9604346b3da2bc5a9b09c0b430882247ec72a22a87

data/README.md

@@ -1,14 +1,14 @@
 # Ruby bindings for brotli library
 
-| AppVeyor | Circle | Github actions | Codecov | Gem  |
-| :------: | :----: | :------------: | :-----: | :--: |
-| [![AppVeyor test status](https://ci.appveyor.com/api/projects/status/github/andrew-aladev/ruby-brs?branch=master&svg=true)](https://ci.appveyor.com/project/andrew-aladev/ruby-brs/branch/master) | [![Circle test status](https://circleci.com/gh/andrew-aladev/ruby-brs/tree/master.svg?style=shield)](https://circleci.com/gh/andrew-aladev/ruby-brs/tree/master) | [![Github Actions test status](https://github.com/andrew-aladev/ruby-brs/workflows/test/badge.svg?branch=master)](https://github.com/andrew-aladev/ruby-brs/actions) | [![Codecov](https://codecov.io/gh/andrew-aladev/ruby-brs/branch/master/graph/badge.svg)](https://codecov.io/gh/andrew-aladev/ruby-brs) | [![Gem](https://img.shields.io/gem/v/ruby-brs.svg)](https://rubygems.org/gems/ruby-brs) |
+| AppVeyor | Jenkins | Github actions | Codecov | Gem  |
+| :------: | :-----: | :------------: | :-----: | :--: |
+| [![AppVeyor test status](https://ci.appveyor.com/api/projects/status/github/andrew-aladev/ruby-brs?branch=master&svg=true)](https://ci.appveyor.com/project/andrew-aladev/ruby-brs/branch/master) | [![Jenkins test status](http://37.187.122.190:58182/buildStatus/icon?job=ruby-brs)](http://37.187.122.190:58182/job/ruby-brs) | [![Github Actions test status](https://github.com/andrew-aladev/ruby-brs/workflows/test/badge.svg?branch=master)](https://github.com/andrew-aladev/ruby-brs/actions) | [![Codecov](https://codecov.io/gh/andrew-aladev/ruby-brs/branch/master/graph/badge.svg)](https://codecov.io/gh/andrew-aladev/ruby-brs) | [![Gem](https://img.shields.io/gem/v/ruby-brs.svg)](https://rubygems.org/gems/ruby-brs) |
 
 See [brotli library](https://github.com/google/brotli).
 
 ## Installation
 
-Operating systems: GNU/Linux, FreeBSD, OSX, Windows (MinGW).
+Operating systems: GNU/Linux, FreeBSD, OSX.
 
 Dependencies: [brotli](https://github.com/google/brotli) 1.0.0+ version.
 
@@ -18,7 +18,6 @@ Dependencies: [brotli](https://github.com/google/brotli) 1.0.0+ version.
 | CentOS     | `brotli-devel`            |
 | ArchLinux  | `brotli`                  |
 | OSX        | `brotli`                  |
-| Windows    | `mingw-w64-x86_64-brotli` |
 
 ```sh
 gem install ruby-brs
@@ -133,6 +132,10 @@ Parallel.each large_datas do |large_data|
 end
 ```
 
+# Docs
+
+Please review [rdoc generated docs](https://andrew-aladev.github.io/ruby-brs).
+
 ## Options
 
 | Option                             | Values     | Default    | Description |
@@ -144,8 +147,8 @@ end
 | `quality`                          | 0 - 11     | 11         | compression level |
 | `lgwin`                            | 10 - 24    | 22         | compressor window size |
 | `lgblock`                          | 16 - 24    | nil (auto) | compressor input block size |
-| `npostfix`                         | 0 - 3      | nil (auto) | Recommended number of postfix bits |
-| `ndirect`                          | 0 - 120    | nil (auto) | Recommended number of direct distance codes (step 1 << npostfix, max 15 << npostfix) |
+| `npostfix`                         | 0 - 3      | nil (auto) | recommended number of postfix bits |
+| `ndirect`                          | 0 - 120    | nil (auto) | recommended number of direct distance codes (step 1 << npostfix, max 15 << npostfix) |
 | `disable_literal_context_modeling` | true/false | false      | disables literal context modeling format |
 | `disable_ring_buffer_reallocation` | true/false | false      | disables ring buffer reallocation |
 | `size_hint`                        | 0 - inf    | 0 (auto)   | size of input (if known) |
@@ -292,14 +295,11 @@ Special asynchronous methods missing in `Zlib::GzipWriter`.
 So it is possible to have asynchronous variants for these synchronous methods.
 Behaviour is the same as `IO#write_nonblock` method.
 
-All nonblock operations for file will raise `EBADF` error on Windows.
-Setting file into nonblocking mode is [not available on Windows](https://github.com/ruby/ruby/blob/master/win32/win32.c#L4388).
-
 ```
 #<<(object)
 #print(*objects)
 #printf(*args)
-#putc(object, encoding: ::Encoding::BINARY)
+#putc(object, :encoding => 'ASCII-8BIT')
 #puts(*objects)
 ```
 

data/lib/brs/error.rb

@@ -1,21 +1,26 @@
 # Ruby bindings for brotli library.
 # Copyright (c) 2019 AUTHORS, MIT License.
 
+require "adsp"
+
 module BRS
   class BaseError < ::StandardError; end
 
   class AllocateError < BaseError; end
-  class ValidateError < BaseError; end
 
-  class UsedAfterCloseError              < BaseError; end
   class NotEnoughSourceBufferError       < BaseError; end
   class NotEnoughDestinationBufferError  < BaseError; end
-  class NotEnoughDestinationError        < BaseError; end
   class DecompressorCorruptedSourceError < BaseError; end
 
   class AccessIOError < BaseError; end
   class ReadIOError   < BaseError; end
   class WriteIOError  < BaseError; end
 
-  class UnexpectedError < BaseError; end
+  ValidateError = ADSP::ValidateError
+
+  NotEnoughDestinationError = ADSP::NotEnoughDestinationError
+  UsedAfterCloseError       = ADSP::UsedAfterCloseError
+
+  NotImplementedError = ADSP::NotImplementedError
+  UnexpectedError     = ADSP::UnexpectedError
 end

data/lib/brs/file.rb

@@ -1,50 +1,40 @@
 # Ruby bindings for brotli library.
 # Copyright (c) 2019 AUTHORS, MIT License.
 
+require "adsp/file"
 require "brs_ext"
 
-require_relative "error"
 require_relative "option"
 require_relative "validation"
 
 module BRS
-  module File
-    BUFFER_LENGTH_NAMES = %i[source_buffer_length destination_buffer_length].freeze
-
+  # BRS::File class.
+  class File < ADSP::File
+    # Current option class.
+    Option = BRS::Option
+
+    # Compresses data from +source+ file path to +destination+ file path.
+    # Option: +:source_buffer_length+ source buffer length.
+    # Option: +:destination_buffer_length+ destination buffer length.
+    # Option: +:size_hint+ source bytesize.
     def self.compress(source, destination, options = {})
       Validation.validate_string source
-      Validation.validate_string destination
 
       options = Option.get_compressor_options options, BUFFER_LENGTH_NAMES
 
       options[:size_hint] = ::File.size source
 
-      open_files source, destination do |source_io, destination_io|
-        BRS._native_compress_io source_io, destination_io, options
-      end
-
-      nil
+      super source, destination, options
     end
 
-    def self.decompress(source, destination, options = {})
-      Validation.validate_string source
-      Validation.validate_string destination
-
-      options = Option.get_decompressor_options options, BUFFER_LENGTH_NAMES
-
-      open_files source, destination do |source_io, destination_io|
-        BRS._native_decompress_io source_io, destination_io, options
-      end
-
-      nil
+    # Bypass native compress.
+    def self.native_compress_io(*args)
+      BRS._native_compress_io(*args)
     end
 
-    private_class_method def self.open_files(source, destination, &_block)
-      ::File.open source, "rb" do |source_io|
-        ::File.open destination, "wb" do |destination_io|
-          yield source_io, destination_io
-        end
-      end
+    # Bypass native decompress.
+    def self.native_decompress_io(*args)
+      BRS._native_decompress_io(*args)
     end
   end
 end

data/lib/brs/option.rb

@@ -7,29 +7,58 @@ require_relative "error"
 require_relative "validation"
 
 module BRS
+  # BRS::Option module.
   module Option
+    # Current default buffer length.
     DEFAULT_BUFFER_LENGTH = 0
 
+    # Current compressor defaults.
     COMPRESSOR_DEFAULTS = {
+      # Enables global VM lock where possible.
       :gvl                              => false,
+      # Compressor mode.
       :mode                             => nil,
+      # Compression level.
       :quality                          => nil,
+      # Compressor window size.
       :lgwin                            => nil,
+      # Compressor input block size.
       :lgblock                          => nil,
+      # Recommended number of postfix bits.
       :npostfix                         => nil,
+      # Recommended number of direct distance codes (step 1 << npostfix, max 15 << npostfix).
       :ndirect                          => nil,
+      # Disables literal context modeling format.
       :disable_literal_context_modeling => nil,
+      # Enables large window.
       :large_window                     => nil
     }
     .freeze
 
+    # Current decompressor defaults.
     DECOMPRESSOR_DEFAULTS = {
+      # Enables global VM lock where possible.
       :gvl                              => false,
+      # Disables ring buffer reallocation.
       :disable_ring_buffer_reallocation => nil,
+      # Enables large window.
       :large_window                     => nil
     }
     .freeze
 
+    # Processes compressor +options+ and +buffer_length_names+.
+    # Option: +:source_buffer_length+ source buffer length.
+    # Option: +:destination_buffer_length+ destination buffer length.
+    # Option: +:gvl+ enables global VM lock where possible.
+    # Option: +:mode+ compressor mode.
+    # Option: +:quality+ compression level.
+    # Option: +:lgwin+ compressor window size.
+    # Option: +:lgblock+ compressor input block size.
+    # Option: +:npostfix+ recommended number of postfix bits.
+    # Option: +:ndirect+ recommended number of direct distance codes (step 1 << npostfix, max 15 << npostfix).
+    # Option: +:disable_literal_context_modeling+ Disables literal context modeling format.
+    # Option: +:large_window+ enables large window.
+    # Returns processed compressor options.
     def self.get_compressor_options(options, buffer_length_names)
       Validation.validate_hash options
 
@@ -94,6 +123,13 @@ module BRS
       options
     end
 
+    # Processes decompressor +options+ and +buffer_length_names+.
+    # Option: +:source_buffer_length+ source buffer length.
+    # Option: +:destination_buffer_length+ destination buffer length.
+    # Option: +:gvl+ enables global VM lock where possible.
+    # Option: +:disable_ring_buffer_reallocation+ disables ring buffer reallocation.
+    # Option: +:large_window+ enables large window.
+    # Returns processed decompressor options.
     def self.get_decompressor_options(options, buffer_length_names)
       Validation.validate_hash options
 

data/lib/brs/stream/raw/compressor.rb

@@ -1,97 +1,33 @@
 # Ruby bindings for brotli library.
 # Copyright (c) 2019 AUTHORS, MIT License.
 
+require "adsp/stream/raw/compressor"
 require "brs_ext"
 
-require_relative "abstract"
-require_relative "../../error"
 require_relative "../../option"
 require_relative "../../validation"
 
 module BRS
   module Stream
     module Raw
-      class Compressor < Abstract
-        BUFFER_LENGTH_NAMES = %i[destination_buffer_length].freeze
+      # BRS::Stream::Raw::Compressor class.
+      class Compressor < ADSP::Stream::Raw::Compressor
+        # Current native compressor class.
+        NativeCompressor = Stream::NativeCompressor
 
+        # Current option class.
+        Option = BRS::Option
+
+        # Initializes compressor.
+        # Option: +:destination_buffer_length+ destination buffer length.
+        # Option: +:size_hint+ source bytesize.
         def initialize(options = {})
           options = Option.get_compressor_options options, BUFFER_LENGTH_NAMES
 
           size_hint = options[:size_hint]
           Validation.validate_not_negative_integer size_hint unless size_hint.nil?
 
-          native_stream = NativeCompressor.new options
-
-          super native_stream
-        end
-
-        def write(source, &writer)
-          do_not_use_after_close
-
-          Validation.validate_string source
-          Validation.validate_proc writer
-
-          total_bytes_written = 0
-
-          loop do
-            bytes_written, need_more_destination  = @native_stream.write source
-            total_bytes_written                  += bytes_written
-
-            if need_more_destination
-              source = source.byteslice bytes_written, source.bytesize - bytes_written
-              more_destination(&writer)
-              next
-            end
-
-            unless bytes_written == source.bytesize
-              # :nocov:
-              # Compressor write should eat all provided "source" without remainder.
-              raise UnexpectedError, "unexpected error"
-              # :nocov:
-            end
-
-            break
-          end
-
-          total_bytes_written
-        end
-
-        def flush(&writer)
-          do_not_use_after_close
-
-          Validation.validate_proc writer
-
-          loop do
-            need_more_destination = @native_stream.flush
-
-            if need_more_destination
-              more_destination(&writer)
-              next
-            end
-
-            break
-          end
-
-          super
-        end
-
-        def close(&writer)
-          return nil if closed?
-
-          Validation.validate_proc writer
-
-          loop do
-            need_more_destination = @native_stream.finish
-
-            if need_more_destination
-              more_destination(&writer)
-              next
-            end
-
-            break
-          end
-
-          super
+          super options
         end
       end
     end

data/lib/brs/stream/raw/decompressor.rb

@@ -1,65 +1,21 @@
 # Ruby bindings for brotli library.
 # Copyright (c) 2019 AUTHORS, MIT License.
 
+require "adsp/stream/raw/decompressor"
 require "brs_ext"
 
-require_relative "abstract"
 require_relative "../../option"
-require_relative "../../validation"
 
 module BRS
   module Stream
     module Raw
-      class Decompressor < Abstract
-        BUFFER_LENGTH_NAMES = %i[destination_buffer_length].freeze
+      # BRS::Stream::Raw::Decompressor class.
+      class Decompressor < ADSP::Stream::Raw::Decompressor
+        # Current native decompressor class.
+        NativeDecompressor = Stream::NativeDecompressor
 
-        def initialize(options = {})
-          options       = Option.get_decompressor_options options, BUFFER_LENGTH_NAMES
-          native_stream = NativeDecompressor.new options
-
-          super native_stream
-        end
-
-        def read(source, &writer)
-          do_not_use_after_close
-
-          Validation.validate_string source
-          Validation.validate_proc writer
-
-          total_bytes_read = 0
-
-          loop do
-            bytes_read, need_more_destination  = @native_stream.read source
-            total_bytes_read                  += bytes_read
-
-            if need_more_destination
-              source = source.byteslice bytes_read, source.bytesize - bytes_read
-              more_destination(&writer)
-              next
-            end
-
-            break
-          end
-
-          # Please remember that "total_bytes_read" can not be equal to "source.bytesize".
-          total_bytes_read
-        end
-
-        def flush(&writer)
-          do_not_use_after_close
-
-          Validation.validate_proc writer
-
-          super
-        end
-
-        def close(&writer)
-          return nil if closed?
-
-          Validation.validate_proc writer
-
-          super
-        end
+        # Current option class.
+        Option = BRS::Option
       end
     end
   end

data/lib/brs/stream/reader.rb

@@ -1,195 +1,16 @@
 # Ruby bindings for brotli library.
 # Copyright (c) 2019 AUTHORS, MIT License.
 
-require_relative "abstract"
+require "adsp/stream/reader"
+
 require_relative "raw/decompressor"
-require_relative "reader_helpers"
-require_relative "../validation"
 
 module BRS
   module Stream
-    class Reader < Abstract
-      include ReaderHelpers
-
-      attr_accessor :lineno
-
-      def initialize(source_io, options = {}, *args)
-        @options = options
-
-        super source_io, *args
-
-        initialize_source_buffer_length
-        reset_io_remainder
-        reset_need_to_flush
-
-        @lineno = 0
-      end
-
-      protected def create_raw_stream
-        Raw::Decompressor.new @options
-      end
-
-      protected def initialize_source_buffer_length
-        source_buffer_length = @options[:source_buffer_length]
-        Validation.validate_not_negative_integer source_buffer_length unless source_buffer_length.nil?
-
-        if source_buffer_length.nil? || source_buffer_length.zero?
-          source_buffer_length = Buffer::DEFAULT_SOURCE_BUFFER_LENGTH_FOR_DECOMPRESSOR
-        end
-
-        @source_buffer_length = source_buffer_length
-      end
-
-      protected def reset_io_remainder
-        @io_remainder = ::String.new :encoding => ::Encoding::BINARY
-      end
-
-      protected def reset_need_to_flush
-        @need_to_flush = false
-      end
-
-      # -- synchronous --
-
-      def read(bytes_to_read = nil, out_buffer = nil)
-        Validation.validate_not_negative_integer bytes_to_read unless bytes_to_read.nil?
-        Validation.validate_string out_buffer unless out_buffer.nil?
-
-        raise ValidateError, "io should be responsible to read and eof" unless
-          @io.respond_to?(:read) && @io.respond_to?(:eof?)
-
-        unless bytes_to_read.nil?
-          return ::String.new :encoding => ::Encoding::BINARY if bytes_to_read.zero?
-          return nil if eof?
-
-          append_io_data @io.read(@source_buffer_length) while @buffer.bytesize < bytes_to_read && !@io.eof?
-          flush_io_data if @buffer.bytesize < bytes_to_read
-
-          return read_bytes_from_buffer bytes_to_read, out_buffer
-        end
-
-        append_io_data @io.read(@source_buffer_length) until @io.eof?
-        flush_io_data
-
-        read_buffer out_buffer
-      end
-
-      def rewind
-        raw_wrapper :close
-
-        reset_io_remainder
-        reset_need_to_flush
-
-        super
-      end
-
-      def close
-        raw_wrapper :close
-
-        super
-      end
-
-      def eof?
-        raise ValidateError, "io should be responsible to eof" unless @io.respond_to? :eof?
-
-        empty? && @io.eof?
-      end
-
-      # -- asynchronous --
-
-      def readpartial(bytes_to_read, out_buffer = nil)
-        raise ValidateError, "io should be responsible to readpartial" unless @io.respond_to? :readpartial
-
-        read_more_nonblock(bytes_to_read, out_buffer) { @io.readpartial @source_buffer_length }
-      end
-
-      def read_nonblock(bytes_to_read, out_buffer = nil, *options)
-        raise ValidateError, "io should be responsible to read nonblock" unless @io.respond_to? :read_nonblock
-
-        read_more_nonblock(bytes_to_read, out_buffer) { @io.read_nonblock(@source_buffer_length, *options) }
-      end
-
-      protected def read_more_nonblock(bytes_to_read, out_buffer, &_block)
-        Validation.validate_not_negative_integer bytes_to_read
-        Validation.validate_string out_buffer unless out_buffer.nil?
-
-        return ::String.new :encoding => ::Encoding::BINARY if bytes_to_read.zero?
-
-        io_provided_eof_error = false
-
-        if @buffer.bytesize < bytes_to_read
-          begin
-            append_io_data yield
-          rescue ::EOFError
-            io_provided_eof_error = true
-          end
-        end
-
-        flush_io_data if @buffer.bytesize < bytes_to_read
-        raise ::EOFError if empty? && io_provided_eof_error
-
-        read_bytes_from_buffer bytes_to_read, out_buffer
-      end
-
-      # -- common --
-
-      protected def append_io_data(io_data)
-        io_portion    = @io_remainder + io_data
-        bytes_read    = raw_wrapper :read, io_portion
-        @io_remainder = io_portion.byteslice bytes_read, io_portion.bytesize - bytes_read
-
-        # Even empty io data may require flush.
-        @need_to_flush = true
-      end
-
-      protected def flush_io_data
-        raw_wrapper :flush
-
-        @need_to_flush = false
-      end
-
-      protected def empty?
-        !@need_to_flush && @buffer.bytesize.zero?
-      end
-
-      protected def read_bytes_from_buffer(bytes_to_read, out_buffer)
-        bytes_read = [@buffer.bytesize, bytes_to_read].min
-
-        # Result uses buffer binary encoding.
-        result   = @buffer.byteslice 0, bytes_read
-        @buffer  = @buffer.byteslice bytes_read, @buffer.bytesize - bytes_read
-        @pos    += bytes_read
-
-        result = out_buffer.replace result unless out_buffer.nil?
-        result
-      end
-
-      protected def read_buffer(out_buffer)
-        result = @buffer
-        reset_buffer
-        @pos += result.bytesize
-
-        result.force_encoding @external_encoding unless @external_encoding.nil?
-        result = transcode_to_internal result
-
-        result = out_buffer.replace result unless out_buffer.nil?
-        result
-      end
-
-      protected def transcode_to_internal(data)
-        data = data.encode @internal_encoding, **@transcode_options unless @internal_encoding.nil?
-        data
-      end
-
-      # We should be able to return data back to buffer.
-      # We won't use any transcode options because transcoded data should be backward compatible.
-      protected def transcode_to_external(data)
-        data = data.encode @external_encoding unless @external_encoding.nil?
-        data
-      end
-
-      protected def raw_wrapper(method_name, *args)
-        @raw_stream.send(method_name, *args) { |portion| @buffer << portion }
-      end
+    # BRS::Stream::Reader class.
+    class Reader < ADSP::Stream::Reader
+      # Current raw stream class.
+      RawDecompressor = Raw::Decompressor
     end
   end
 end