bwrap 1.0.0.pre.alpha5 → 1.0.0.pre.beta1

data/lib/bwrap.rb

@@ -1,81 +1,28 @@
 # frozen_string_literal: true
 
-require "optimist"
-
-#require "deep-cover" if ENV["DEEP_COVER"]
-
-require "bwrap/version"
-require "bwrap/args/construct"
-require "bwrap/config"
-require "bwrap/execution"
-
-# Executes bwrap command using given configuration.
-class Bwrap::Bwrap
-  include Bwrap::Execution
-
-  def initialize config
-    @config = config
-  end
-
-  # Parses command line arguments given to caller script.
-  def parse_command_line_arguments
-    options = parse_options
-
-    Bwrap::Output.handle_output_options options
-  end
-
-  # Runs given command inside bwrap.
-  #
-  # @param command [String, Array] Command, with necessary arguments, to be executed inside bwrap
-  def run command
-    construct = Bwrap::Args::Construct.new
-    construct.command = command
-    construct.config = @config
-    bwrap_args = construct.construct_bwrap_args
-
-    exec_command = [ "bwrap" ]
-    exec_command += bwrap_args
-    exec_command.append command
-    exec_command += @cli_args if @cli_args
-
-    execute exec_command
-
-    construct.cleanup
-  end
-
-  # Parses global bwrap flags using Optimist.
-  #
-  # Sets instance variable `@cli_args`.
-  #
-  # @return [Hash] options parsed by {Optimist.options}
-  private def parse_options
-    options = Optimist.options do
-      version ::Bwrap::VERSION
-
-      banner "Usage:"
-      banner "  #{$PROGRAM_NAME} [global options]\n \n"
-      banner "Global options:"
-      opt :verbose,
-          "Show verbose output",
-          short: "v"
-      opt :debug,
-          "Show debug output (useful when debugging a problem)",
-          short: "d"
-      opt :trace,
-          "Show trace output (noisiest, probably not useful for most of time)",
-          short: :none
-      opt :version,
-          "Print version and exit",
-          short: "V"
-      opt :help,
-          "Show help message",
-          short: "h"
-
-      educate_on_error
-    end
-
-    @cli_args = ARGV.dup
-
-    options
-  end
+require "bwrap/bwrap"
+
+# ruby-bwrap provides easy-to-use interface to run complex programs in sandboxes created with
+# {https://github.com/containers/bubblewrap bubblewrap}.
+#
+# To run a program inside bubblewrap, a wrapper executable can be created. For example:
+#
+#     require "bwrap"
+#
+#     config = Bwrap::Config.new
+#     config.user = "dummy_user"
+#     config.full_system_mounts = true
+#     config.binaries_from = %w{
+#       /bin
+#       /usr/bin
+#     }
+#
+#     bwrap = Bwrap::Bwrap.new config
+#     bwrap.parse_command_line_arguments
+#     bwrap.run "/bin/true"
+#
+# There also are few generic utilities, {Bwrap::Output} for handling output of scripts and
+# {Bwrap::Execution} to run executables.
+module Bwrap
+  # Empty module.
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bwrap
 version: !ruby/object:Gem::Version
-  version: 1.0.0.pre.alpha5
+  version: 1.0.0.pre.beta1
 platform: ruby
 authors:
 - Samu Voutilainen
@@ -34,22 +34,8 @@ cert_chain:
   X4ioQwEn1/9tHs19VO1CLF58451HgEo1BXd7eWLmV1V5cqw0YWok1ly4L/Su/Phf
   MRxVMHiVAqY=
   -----END CERTIFICATE-----
-date: 2021-11-29 00:00:00.000000000 Z
+date: 2021-12-12 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: optimist
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -134,14 +120,19 @@ files:
 - lib/bwrap.rb
 - lib/bwrap/args/args.rb
 - lib/bwrap/args/bind.rb
+- lib/bwrap/args/bind/library.rb
+- lib/bwrap/args/bind/mime.rb
 - lib/bwrap/args/construct.rb
 - lib/bwrap/args/environment.rb
 - lib/bwrap/args/features.rb
 - lib/bwrap/args/library.rb
 - lib/bwrap/args/machine_id.rb
 - lib/bwrap/args/mount.rb
+- lib/bwrap/bwrap.rb
 - lib/bwrap/config.rb
+- lib/bwrap/config/features.rb
 - lib/bwrap/execution.rb
+- lib/bwrap/execution/exceptions.rb
 - lib/bwrap/execution/execute.rb
 - lib/bwrap/execution/execution.rb
 - lib/bwrap/execution/labels.rb
@@ -150,7 +141,7 @@ files:
 - lib/bwrap/output/colors.rb
 - lib/bwrap/output/levels.rb
 - lib/bwrap/output/log.rb
-- lib/bwrap/output/output.rb
+- lib/bwrap/output/output_impl.rb
 - lib/bwrap/version.rb
 homepage: https://git.sr.ht/~smar/ruby-bwrap
 licenses:

data/lib/bwrap/output/output.rb

@@ -1,8 +0,0 @@
-# frozen_string_literal: true
-
-require "bwrap/version"
-
-# Outputting utilities.
-module Bwrap::Output
-  # Nya.
-end