sudo 0.1.1 → 0.3.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8533dcc019e5bf40c31a3a2f0d00fb1ed7799710fbd623e1f35bdc7b3854f8ad
+  data.tar.gz: d21c8cc10c30840bdcd0d6a9c86816ea8123897305c5e4b41b6503301c39e8f6
+SHA512:
+  metadata.gz: 53a797c78535d39c6fd4c123726345cc6ad4a73617f8e835437ab49c86168dbfd83696776ea7c2a1fdb26419e88f9cb6799bf33365447ff42c2a023015c0fc48
+  data.tar.gz: e81deabf36e8a0a4a4bad76e8d94560c0518e25deb8f8dac7184dcbb9befee866f704a2f17716dafc773ad0427329120c7ca88562fb82af21e061234681c5114

data/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Sudo
+
+## 0.3.0 _(July 04, 2023)_
+- Works on ruby 3.2
+
+## 0.2.0 _(November 05, 2018)_
+- Modernized
+- Tests
+- Works on ruby 2.3 - 2.5
+- More robust dependency loading
+
+## 0.0.3 _(October 25, 2010)_
+-
+
+## 0.0.2 _(October 22, 2010)_
+-
+
+## 0.0.1 _(October 22, 2010)_
+-

data/LICENSE

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2010-2023 Guido De Rosa
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,107 @@
+[![Gem Version](https://badge.fury.io/rb/sudo.svg)](https://badge.fury.io/rb/sudo)[![Build Status](https://travis-ci.com/gderosa/rubysu.svg?branch=master)](https://travis-ci.com/gderosa/rubysu)
+[![Maintainability](https://api.codeclimate.com/v1/badges/3fdebfb836bebb531fb3/maintainability)](https://codeclimate.com/github/gderosa/rubysu/maintainability)
+[![Test Coverage](https://api.codeclimate.com/v1/badges/3fdebfb836bebb531fb3/test_coverage)](https://codeclimate.com/github/gderosa/rubysu/test_coverage)
+
+# Ruby Sudo
+
+Give Ruby objects superuser privileges.
+
+Based on [dRuby](http://ruby-doc.org/stdlib-2.5.3/libdoc/drb/rdoc/DRb.html) and [sudo](http://www.sudo.ws/).
+
+Only tested with [MRI](http://en.wikipedia.org/wiki/Ruby_MRI).
+
+## Usage
+
+Your user must be allowed, in `/etc/sudoers`, to run `ruby` and `kill`
+commands as root.
+
+A password may be required from the console, depending on the
+`NOPASSWD` options in `/etc/sudoers`.
+
+Spawns a sudo-ed Ruby process running a
+[DRb](http://ruby-doc.org/stdlib-2.5.3/libdoc/drb/rdoc/DRb.html) server. Communication is
+done via a Unix socket (and, of course, permissions are set to `0600`).
+
+No long-running daemons involved, everything is created on demand.
+
+Access control is entirely delegated to `sudo`.
+
+### Application Code
+
+Let's start with a trivial example:
+
+```ruby
+require 'my_gem/my_class'
+require 'sudo'
+
+obj   = MyGem::MyClass.new
+
+# Now, create a Sudo::Wrapper object:
+sudo  = Sudo::Wrapper.new
+
+# 'mygem/myclass' will be automatically required in the
+# sudo DRb server
+
+# Start the sudo-ed Ruby process:
+sudo.start!
+sudo[obj].my_instance_method
+sudo[MyClass].my_class_method
+
+# Call stop! when finished, otherwise, that will be done
+# when the `sudo` object gets garbage-collected.
+sudo.stop!
+```
+
+A convienient utility for working with sudo is to use the `run` method and pass it a block.
+Run will automatically start and stop the ruby sudo process around the block.
+
+```ruby
+require 'fileutils'
+require 'sudo'
+
+Sudo::Wrapper.run do |sudo|
+  sudo[FileUtils].mkdir_p '/ONLY/ROOT/CAN/DO/THAT'
+end
+# Sockets and processes are closed automatically when the block exits
+```
+
+Both `Sudo::Wrapper.run` and `Sudo::Wrapper.new` take the same named arguments: `ruby_opts` (default: `''` ) and `load_gems` (default: `true`).
+
+If you'd like to pass options to the sudo-spawned ruby process, pass them as a string to `ruby_opts`.
+
+If you'd like to prevent the loading of `gems` currently loaded from the calling program, pass `false` to `load_gems`. This will give your sudo process a unmodifed environment. The only things required via the sudo process are `'drb/drb'`, `'fileutils'`, and of course `'sudo'`.
+
+## Todo
+
+`sudo` has a `-A` option to accept password via an external program (maybe
+graphical): support this feature.
+
+## Credits
+
+### Author and Copyright
+
+Guido De Rosa ([@gderosa](http://github.com/gderosa/)).
+
+See LICENSE.
+
+### Contributors
+
+Dale Stevens ([@voltechs](https://github.com/voltechs))
+
+Robert M. Koch ([@threadmetal](https://github.com/threadmetal))
+
+Wolfgang Teuber ([@wteuber](https://github.com/wteuber))
+
+### Other aknowledgements
+Thanks to Tony Arcieri and Brian Candler for suggestions on 
+[ruby-talk](http://www.ruby-forum.com/topic/262655).
+
+Initially developed by G. D. while working at [@vemarsas](https://github.com/vemarsas).
+
+## Contributing
+
+1. Fork it ( https://github.com/gderosa/rubysu/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/lib/sudo/constants.rb

@@ -1,11 +1,18 @@
+require 'pathname'
+
 module Sudo
 
-  VERSION       = '0.1.1'
-  ROOTDIR       = File.expand_path File.join File.dirname(__FILE__), '../..'
-  LIBDIR        = File.join ROOTDIR, 'lib'
-  SERVER_SCRIPT = File.join ROOTDIR, 'libexec/server.rb'
-  SUDO_CMD = ENV['rvm_path'] ? 'rvmsudo' : 'sudo'
+  VERSION       = '0.3.0'
+
+  def self.root
+    @root ||= Pathname.new(File.expand_path('../../', __dir__))
+  end
+
+  LIBDIR        = root.join('lib')
+  SERVER_SCRIPT = root.join('libexec/server.rb')
+  SUDO_CMD      = `which sudo`.chomp
+  RUBY_CMD      = `which ruby`.chomp
 
-  class RuntimeError  < RuntimeError; end
+  RuntimeError = Class.new(RuntimeError)
 
 end

data/lib/sudo/proxy.rb

@@ -1,4 +1,3 @@
-require 'sudo/support/object'
 
 module Sudo
 
@@ -7,15 +6,28 @@ module Sudo
       @object = object
       @proxy = proxy
     end
-    def method_missing(method=:self, *args, &blk)
+    def method_missing(method=:itself, *args, &blk)
       @proxy.proxy @object, method, *args, &blk
     end
   end
 
   class Proxy
-    def proxy(object, method=:self, *args, &blk) 
+    def proxy(object, method=:itself, *args, &blk)
       object.send method, *args, &blk
     end
+
+    def loaded_specs
+      # Something's weird with this method when called outside
+      Gem.loaded_specs.to_a.to_h
+    end
+
+    def load_path
+      $LOAD_PATH
+    end
+
+    def add_load_path(path)
+      $LOAD_PATH << path
+    end
   end
 
 end

data/lib/sudo/support/kernel.rb

@@ -1,20 +1,12 @@
-module Kernel
-  def wait_for(conf)
-    start = Time.now
-    defaults = {
-      :timeout  => nil,
-      :step     => 0.125
-    }
-    conf = defaults.update conf
-    condition = false
-    loop do
-      condition = yield
+require 'timeout'
 
-      break if    condition
-      break if    conf[:timeout] and Time.now - start > conf[:timeout]
-      
-      sleep       conf[:step]
+module Kernel
+  def wait_for(timeout: nil, step: 0.125)
+    Timeout::timeout(timeout) do
+      condition = false
+      sleep(step) until (condition = yield) and return condition
     end
-    condition 
-  end 
+  rescue Timeout::Error
+    return false
+  end
 end

data/lib/sudo/support/process.rb

@@ -3,12 +3,10 @@ module Process
     # Thanks to:
     # http://stackoverflow.com/questions/141162/how-can-i-determine-if-a-different-process-id-is-running-using-java-or-jruby-on-l
     def exists?(pid)
-      begin
-        Process.getpgid( pid )
-        true
-      rescue Errno::ESRCH
-        false
-      end
+      Process.getpgid( pid )
+      true
+    rescue Errno::ESRCH
+      false
     end
   end
 end

data/lib/sudo/system.rb

@@ -4,31 +4,29 @@ require 'sudo/constants'
 module Sudo
   module System
 
-    class ProcessStillExists  < RuntimeError; end
-    class FileStillExists     < RuntimeError; end
+    ProcessStillExists  = Class.new(RuntimeError)
+    FileStillExists     = Class.new(RuntimeError)
 
     class << self
 
       def kill(pid)
         if pid and Process.exists? pid
-          system "sudo kill     #{pid}"               or
-          system "sudo kill -9  #{pid}"               or
-          raise ProcessStillExists, 
-            "Couldn't kill sudo process (PID=#{pid})" 
+          system "sudo kill     #{pid}" or
+          system "sudo kill -9  #{pid}" or
+          raise ProcessStillExists, "Couldn't kill sudo process (PID=#{pid})"
         end
       end
 
       def unlink(file)
-        if file and File.exists? file
-          system "sudo rm -f #{file}"                 or
-          raise FileStillExists,
-              "Couldn't delete #{file}"
+        if file and File.exist? file
+          system("sudo rm -f #{file}") or
+          raise(FileStillExists, "Couldn't delete #{file}")
         end
       end
 
       # just to check if we can sudo; and we'll receive a sudo token
       def check
-        raise SudoFailed unless system "sudo ruby -e ''"
+        raise SudoFailed unless system "#{SUDO_CMD} -E #{RUBY_CMD} -e ''"
       end
 
     end

data/lib/sudo/wrapper.rb

@@ -6,17 +6,18 @@ require 'sudo/system'
 require 'sudo/proxy'
 
 module Sudo
+
   class Wrapper
 
-    class RuntimeError              < RuntimeError;       end
-    class NotRunning                < RuntimeError;       end
-    class SudoFailed                < RuntimeError;       end
-    class SudoProcessExists         < RuntimeError;       end
-    class SudoProcessAlreadyExists  < SudoProcessExists;  end
-    class NoValidSocket             < RuntimeError;       end
-    class SocketNotFound            < NoValidSocket;      end
-    class NoValidSudoPid            < RuntimeError;       end
-    class SudoProcessNotFound       < NoValidSudoPid;     end
+    RuntimeError             = Class.new(RuntimeError)
+    NotRunning               = Class.new(RuntimeError)
+    SudoFailed               = Class.new(RuntimeError)
+    SudoProcessExists        = Class.new(RuntimeError)
+    SudoProcessAlreadyExists = Class.new(SudoProcessExists)
+    NoValidSocket            = Class.new(RuntimeError)
+    SocketNotFound           = Class.new(NoValidSocket)
+    NoValidSudoPid           = Class.new(RuntimeError)
+    SudoProcessNotFound      = Class.new(NoValidSudoPid)
 
     class << self
 
@@ -24,11 +25,13 @@ module Sudo
       # cleanup when the block exits.
       #
       # ruby_opts:: is passed to Sudo::Wrapper::new .
-      def run(ruby_opts = '') # :yields: sudo
-        sudo = new(ruby_opts).start!
-        retval = yield sudo
+      def run(ruby_opts: '', load_gems: true) # :yields: sudo
+        sudo = new(ruby_opts: ruby_opts, load_gems: load_gems).start!
+        yield sudo
+      rescue Exception => e # Bubble all exceptions...
+        raise e
+      ensure # and ensure sudo stops
         sudo.stop!
-        retval
       end
 
       # Do the actual resources clean-up.
@@ -45,13 +48,12 @@ module Sudo
     # +ruby_opts+ are the command line options to the sudo ruby interpreter;
     # usually you don't need to specify stuff like "-rmygem/mylib", libraries
     # will be sorta "inherited".
-    def initialize(ruby_opts='')
+    def initialize(ruby_opts: '', load_gems: true)
       @proxy            = nil
       @socket           = "/tmp/rubysu-#{Process.pid}-#{object_id}"
       @sudo_pid         = nil
       @ruby_opts        = ruby_opts
-      @loaded_features  = []
-      # @load_path        = [] # currentl unused
+      @load_gems        = load_gems == true
     end
 
     def server_uri; "drbunix:#{@socket}"; end
@@ -61,43 +63,27 @@ module Sudo
       Sudo::System.check
 
       @sudo_pid = spawn(
-"#{SUDO_CMD} ruby -I#{LIBDIR} #{@ruby_opts} #{SERVER_SCRIPT} #{@socket} #{Process.uid}"
+"#{SUDO_CMD} -E #{RUBY_CMD} -I#{LIBDIR} #{@ruby_opts} #{SERVER_SCRIPT} #{@socket} #{Process.uid}"
       )
       Process.detach(@sudo_pid) if @sudo_pid # avoid zombies
-      ObjectSpace.define_finalizer self, Finalizer.new(
-          :pid => @sudo_pid, :socket => @socket
-      )
+      finalizer = Finalizer.new(pid: @sudo_pid, socket: @socket)
+      ObjectSpace.define_finalizer(self, finalizer)
 
-      if wait_for(:timeout => 1){File.exists? @socket}
+      if wait_for(timeout: 1){File.exist? @socket}
         @proxy = DRbObject.new_with_uri(server_uri)
       else
         raise RuntimeError, "Couldn't create DRb socket #{@socket}"
       end
 
-      #set_load_path # apparently, we don't need this
-
-      load_features
+      load!
 
       self
     end
 
-    # Load needed libraries in the DRb server. Usually you don't need
-    # to call this directly.
-    def load_features
-      unless $LOADED_FEATURES == @loaded_features
-        new_features = $LOADED_FEATURES - @loaded_features
-        new_features.each do |feature|
-          @proxy.proxy Kernel, :require, feature
-          @loaded_features << feature
-        end
-        #@loaded_features += new_features
-      end
-    end
-
     def running?
       true if (
         @sudo_pid and Process.exists? @sudo_pid and
-        @socket   and File.exists?    @socket   and
+        @socket   and File.exist?    @socket   and
         @proxy
       )
     end
@@ -106,14 +92,14 @@ module Sudo
     # ruby process and the Unix-domain socket used to communicate
     # to it via ::DRb.
     def stop!
-      self.class.cleanup!(:pid => @sudo_pid, :socket => @socket)
+      self.class.cleanup!(pid: @sudo_pid, socket: @socket)
       @proxy = nil
     end
 
     # Gives a copy of +object+ with root privileges.
     def [](object)
       if running?
-        load_features
+        load!
         MethodProxy.new object, @proxy
       else
         raise NotRunning
@@ -133,5 +119,44 @@ module Sudo
       end
     end
 
+    protected
+
+    def load!
+      load_gems if load_gems?
+    end
+
+    def load_gems?
+      @load_gems == true
+    end
+
+    def prospective_gems
+      (Gem.loaded_specs.keys - @proxy.loaded_specs.keys)
+    end
+
+    # Load needed libraries in the DRb server. Usually you don't need
+    def load_gems
+      load_paths
+      prospective_gems.each do |prospect|
+        gem_name = prospect.dup
+        begin
+          loaded = @proxy.proxy(Kernel, :require, gem_name)
+          # puts "Loading Gem: #{gem_name} => #{loaded}"
+        rescue LoadError, NameError => e
+          old_gem_name = gem_name.dup
+          gem_name.gsub!('-', '/')
+          retry if old_gem_name != gem_name
+        end
+      end
+    end
+
+    def load_paths
+      host_paths = $LOAD_PATH
+      proxy_paths = @proxy.load_path
+      diff_paths = host_paths - proxy_paths
+      diff_paths.each do |path|
+        @proxy.add_load_path(path)
+      end
+    end
+
   end
 end

metadata

@@ -1,70 +1,113 @@
 --- !ruby/object:Gem::Specification
 name: sudo
 version: !ruby/object:Gem::Version
-  version: 0.1.1
-  prerelease: 
+  version: 0.3.0
 platform: ruby
 authors:
 - Guido De Rosa
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2013-01-06 00:00:00.000000000 Z
-dependencies: []
-description: ! 'Give Ruby objects superuser privileges.
-
-
+date: 2023-07-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: |
+  Give Ruby objects superuser privileges.
   Based on dRuby and sudo (the Unix program).
-
-'
-email: guido.derosa@vemarsas.it
+email:
+- guidoderosa@gmail.com
 executables: []
 extensions: []
-extra_rdoc_files:
-- README.rdoc
+extra_rdoc_files: []
 files:
-- examples/block.rb
-- examples/dsl.rb
-- examples/new.rb
-- examples/writable_root.rb
-- examples/lib/writable_root.rb
-- libexec/server.rb
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/sudo.rb
 - lib/sudo/constants.rb
-- lib/sudo/dsl.rb
 - lib/sudo/proxy.rb
-- lib/sudo.rb
 - lib/sudo/support/kernel.rb
-- lib/sudo/support/object.rb
 - lib/sudo/support/process.rb
 - lib/sudo/system.rb
 - lib/sudo/wrapper.rb
-- MANIFEST
-- README.rdoc
-homepage: http://github.com/gderosa/rubysu
-licenses: []
-post_install_message: 
-rdoc_options:
-- --charset=UTF-8
-- --main
-- README.rdoc
+- libexec/server.rb
+homepage: https://github.com/TwilightCoders/rubysu
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+post_install_message:
+rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 1.8.11
-signing_key: 
-specification_version: 3
+rubygems_version: 3.1.6
+signing_key:
+specification_version: 4
 summary: Give Ruby objects superuser privileges
 test_files: []

data/MANIFEST

@@ -1,17 +0,0 @@
-examples/block.rb
-examples/dsl.rb
-examples/new.rb
-examples/writable_root.rb
-examples/lib/writable_root.rb
-libexec/server.rb
-lib/sudo/constants.rb
-lib/sudo/dsl.rb
-lib/sudo/proxy.rb
-lib/sudo.rb
-lib/sudo/support/kernel.rb
-lib/sudo/support/object.rb
-lib/sudo/support/process.rb
-lib/sudo/system.rb
-lib/sudo/wrapper.rb
-MANIFEST
-README.rdoc

data/README.rdoc

@@ -1,119 +0,0 @@
-= Ruby \Sudo
-
-Give Ruby objects superuser privileges.
-
-Based on dRuby[http://ruby-doc.org/ruby-1.9/classes/DRb.html] and 
-sudo[http://www.sudo.ws/].
-
-Only tested with {MRI 1.9}[http://en.wikipedia.org/wiki/Ruby_MRI] .
-
-== REQUIREMENTS
-
-Your user must be allowed, in +/etc/sudoers+, to run +ruby+ and +kill+
-commands as root.
-
-A password will be required from the console, or not, depending on
-the +NOPASSWD+ options in +/etc/sudoers+.
-
-== USAGE
-
-Let's start with a trivial example:
-
-  require 'mygem/myclass'
-  require 'sudo'
-
-  obj   = MyGem::MyClass.new
-
-
-Now, create a Sudo::Wrapper object:
-
-  sudo  = Sudo::Wrapper.new
-
-
-Start the sudo-ed Ruby process:
-
-  # 'mygem/myclass' will be automatically required in the 
-  # sudo DRb server 
-
-  sudo.start! 
-
-
-Use it!
-
-  sudo[obj].my_instance_method 
-  sudo[MyClass].my_class_method
-
-
-When you've done, +stop!+ it. Otherwise, that will be done (only) when 
-the +sudo+ object gets garbage-collected.
-
-  sudo.stop!
-
-=== With a block
-
-Use Sudo::Wrapper::run in this case.
-
-  require 'fileutils'
-  require 'sudo'
-
-  Sudo::Wrapper.run do |sudo|
-    sudo[FileUtils].mkdir_p '/ONLY/ROOT/CAN/DO/THAT'
-  end
-  # Sockets and processes are closed automatically when the block exits
-
-== PRINCIPLES OF OPERATION
-
-Spawns a sudo-ed Ruby process running a 
-DRb[http://ruby-doc.org/ruby-1.9/classes/DRb.html] server. Communication is
-done via a Unix socket (and, of course, permissions are set to +0600+).
-
-No long-running daemons involved, everything is created on demand.
-
-Access control is entirely delegated to +sudo+.
-
-== TODO
-
-+sudo+ has a +-A+ option to accept password via an external program
-(maybe graphical): support this feature.
-
-== CREDITS 
-
-=== AUTHOR
-
-{Guido De Rosa}[http://github.com/gderosa/].
-
-Sponsored by {VEMAR s.a.s.}[http://www.vemarsas.it/]
-
-=== CONTRIBUTORS
-
-{Robert M. Koch}[http://github.com/threadmetal/].
-
-=== THANKS
-
-Thanks to Tony Arcieri and Brian Candler for suggestions on 
-ruby-talk[http://www.ruby-forum.com/topic/262655].
-
-=== COPYRIGHT
-
-(The MIT License)
-
-Copyright (c) 2010, 2011, 2012, 2013 Guido De Rosa
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-'Software'), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
-CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
-TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
-SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/examples/block.rb

@@ -1,18 +0,0 @@
-require 'fileutils'
-require 'sudo'
-
-Sudo::Wrapper.run do |su|
-
-  su[File].open '/TEST', 'w' do |f|
-    f.puts "Hello from UID=#{su[Process].uid}!"
-  end
-
-  su[FileUtils].cp '/etc/shadow', '/etc/shadow2'
-
-end
-
-
-
-
-
-

data/examples/dsl.rb

@@ -1,14 +0,0 @@
-=begin
-require 'sudo/dsl'
-
-include Sudo::DSL
-
-sudo_start "-rfileutils"
-
-puts sudo(File).read '/etc/shadow'
-
-sudo(FileUtils).mkdir_p '/TEST_DIR/SUB_DIR'
-
-#sudo_stop # automatic clenup, when out of scope, if not explicit
-
-=end

data/examples/lib/writable_root.rb

@@ -1,7 +0,0 @@
-class WritableRoot
-  def check
-    puts "As uid = #{Process.uid}, writable root = #{File.writable? '/'} (object_id=#{object_id})"
-  end
-end
-
-

data/examples/new.rb

@@ -1,28 +0,0 @@
-require 'fileutils'
-autoload :IPAddr, 'ipaddr'
-require 'sudo'
-
-# Requires and autoloads are inherited by the sudo process.
-
-su = Sudo::Wrapper.new
-
-su.start!
-
-su[File].open '/TEST', 'w' do |f|
-  f.puts "Hello from UID=#{su[Process].uid}!"
-  f.puts "#{su[IPAddr].new}"
-end
-
-su[FileUtils].cp '/etc/shadow', '/etc/shadow2'
-
-# If you don't call stop! explicitly, the corresponding process and file
-# cleanup will be done when su gets garbage-collected.
-#
-su.stop!
-
-
-
-
-
-
-

data/examples/writable_root.rb

@@ -1,52 +0,0 @@
-require 'sudo'
-
-
-t0 = Time.now 
-su = Sudo::Wrapper.new.start!
-t1 =  Time.now
-
-writable_root                 = su[File].writable? '/'
-t2 = Time.now
-writable_root_by_normal_user  = File.writable? '/'
-
-puts
-puts "writable_root                                 = #{writable_root}"
-puts "writable_root_by_normal_user                  = #{writable_root_by_normal_user}"
-puts "Starting Sudo::Wrapper object took              #{t1-t0} seconds"
-puts "Using it, as in  su[File].writable? '/', took   #{t2-t1} seconds"
-
-puts
-puts "Now trying on an instance of WritableRoot custom class:"
-
-$LOAD_PATH.unshift "#{File.dirname(__FILE__)}/lib"
-require 'writable_root'
-
-wr1 = WritableRoot.new
-wr2 = WritableRoot.new
-
-wr1.check
-su[wr2].check
-
-puts
-puts "Hit ENTER to stop the Sudo::Wrapper object"
-puts "(in the meantime, you can look at the ruby sudo-ed process with ps)" 
-gets
-
-# Optional (it will be stopped automatically as soon as 'su' object gets out of scope).
-su.stop!
-
-puts "Now trying with a block (Sudo::Wrapper.run):"
-writable_root = Sudo::Wrapper.run do |sudo| 
-  print "As uid=#{ sudo[Process].uid  }, "
-  sudo[File].writable? '/'
-end
-puts "writable_root = #{writable_root.inspect}"
-
-
-
-
-
-
-
-
-

data/lib/sudo/dsl.rb

@@ -1,27 +0,0 @@
-=begin
-  DEPRECATED
-
-  It's not clear what the scope of __default_sudo_wrapper should be:
-  local, instance, class? global? and what about thread-safety?
-
-=end
-
-=begin
-require 'sudo/wrapper'
-
-module Sudo
-
-  module DSL
-    def sudo_start(*args, &blk)
-      @__default_sudo_wrapper = Sudo::Wrapper.new(*args, &blk).start!
-    end
-    def sudo_stop
-      @__default_sudo_wrapper.stop!
-    end
-    def sudo(object)
-      @__default_sudo_wrapper[object]
-    end
-  end
-
-end
-=end

data/lib/sudo/support/object.rb

@@ -1,5 +0,0 @@
-class Object
-  def self
-    self
-  end
-end