masquerade 0.1.0

data/Manifest

@@ -0,0 +1,4 @@
+Manifest
+README.rdoc
+Rakefile
+lib/masquerade.rb

data/README.rdoc

@@ -0,0 +1,29 @@
+= Masquerade
+
+Run a block of code as another user/group.
+
+== Installation
+
+# gem install masquerade
+
+== Usage
+
+To run a block of code as user "roger" and group "developer":
+  Masquerade.as :user => "roger", :group => "developer" do
+    puts "Hello world"
+  end
+  
+The block of code accepts the user hash as a paramter. So you can do things like:
+  Masquerade.as :user => "roger", :group => "developer" do |user_info|
+    puts "Hello world #user_info[:user]"
+  end
+  
+Both :user and :group params are optional and you can choose to give one or the two or both.
+
+=== Exceptions thrown
+==== Masquerade::PermissionsError
+
+If the user running the script does not have the privileges to masquerade as the given user.
+    
+==== Masquerade::BadUserOrGroupError
+If the given user or group does not exist

data/Rakefile

@@ -0,0 +1,14 @@
+require "rubygems"
+require "rake"
+require "echoe"
+
+Echoe.new("masquerade", "0.1.0") do |p|
+  p.description = "A user/group impersonator"
+  p.summary = "Run a block of code as another user/group."
+  p.url = "http://rubygems.org/gems/masquerade"
+  p.author = "Nitesh Goel"
+  p.email = "nitesh@wikinvest.com"
+  p.ignore_pattern = ["tmp/*", "script/*"]
+end
+
+Dir["#{File.dirname(__FILE__)}/tasks/*.rake"].sort.each { |ext| load ext }

data/lib/masquerade.rb

@@ -0,0 +1,65 @@
+require "etc"
+=begin rdoc
+= Masquerade
+
+Run a block of code as another user/group.
+
+== Installation
+
+# gem install masquerade
+
+== Usage
+
+To run a block of code as user "roger" and group "developer":
+  Masquerade.as :user => "roger", :group => "developer" do
+    puts "Hello world"
+  end
+  
+The block of code accepts the user hash as a paramter. So you can do things like:
+  Masquerade.as :user => "roger", :group => "developer" do |user_info|
+    puts "Hello world #user_info[:user]"
+  end
+  
+Both :user and :group params are optional and you can choose to give one or the two or both.
+
+=== Exceptions thrown
+==== Masquerade::PermissionsError
+
+If the user running the script does not have the privileges to masquerade as the given user.
+    
+==== Masquerade::BadUserOrGroupError
+If the given user or group does not exist
+=end
+module Masquerade
+  def self.as(who, &block)
+    begin
+      current_uid = Process.uid
+      current_gid = Process.gid
+      # get user info by name
+      if who.include?(:user)
+        user_struct = Etc.getpwnam(who[:user])
+        # set the uid of the current process to that of the chosen user
+        Process.uid = user_struct.uid
+      end
+      if who.include?(:group)
+        group_struct = Etc.getgrnam(who[:group])
+        Process.gid = group_struct.gid
+      end
+      # run the block
+      block.call(who)
+      # restore process uid and gid
+      Process.uid = current_uid
+      Process.gid = current_gid
+    rescue Errno::EPERM
+      raise PermissionsError, "You do not have permissions to impersonate this user or group"
+    rescue ArgumentError
+      raise BadUserOrGroupError, "The user or group name does not exist"
+    end
+  end
+  
+  class PermissionsError < StandardError
+  end
+  
+  class BadUserOrGroupError < StandardError
+  end
+end

data/masquerade.gemspec

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{masquerade}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Nitesh Goel"]
+  s.date = %q{2011-04-14}
+  s.description = %q{A user/group impersonator}
+  s.email = %q{nitesh@wikinvest.com}
+  s.extra_rdoc_files = ["README.rdoc", "lib/masquerade.rb"]
+  s.files = ["Manifest", "README.rdoc", "Rakefile", "lib/masquerade.rb", "masquerade.gemspec"]
+  s.homepage = %q{http://rubygems.org/gems/masquerade}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Masquerade", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{masquerade}
+  s.rubygems_version = %q{1.7.2}
+  s.summary = %q{Run a block of code as another user/group.}
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification 
+name: masquerade
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Nitesh Goel
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-04-14 00:00:00 Z
+dependencies: []
+
+description: A user/group impersonator
+email: nitesh@wikinvest.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+- lib/masquerade.rb
+files: 
+- Manifest
+- README.rdoc
+- Rakefile
+- lib/masquerade.rb
+- masquerade.gemspec
+homepage: http://rubygems.org/gems/masquerade
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Masquerade
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 11
+      segments: 
+      - 1
+      - 2
+      version: "1.2"
+requirements: []
+
+rubyforge_project: masquerade
+rubygems_version: 1.7.2
+signing_key: 
+specification_version: 3
+summary: Run a block of code as another user/group.
+test_files: []
+