?HAMA

Navigation

Breadcrumbs

/ / proc / thread-self / root / opt / alt / ruby21 / lib64 / ruby / 2.1.0

Create

Create File | Create Folder | Upload Files | Run Command

Edit File Size: 4.02 KB

/proc/thread-self/root/opt/alt/ruby21/lib64/ruby/2.1.0/singleton.rb

Text Base64

require 'thread'

# The Singleton module implements the Singleton pattern.
#
# == Usage
#
# To use Singleton, include the module in your class.
#
#    class Klass
#       include Singleton
#       # ...
#    end
#
# This ensures that only one instance of Klass can be created.
#
#      a,b  = Klass.instance, Klass.instance
#
#      a == b
#      # => true
#
#      Klass.new
#      # => NoMethodError - new is private ...
#
# The instance is created at upon the first call of Klass.instance().
#
#      class OtherKlass
#        include Singleton
#        # ...
#      end
#
#      ObjectSpace.each_object(OtherKlass){}
#      # => 0
#
#      OtherKlass.instance
#      ObjectSpace.each_object(OtherKlass){}
#      # => 1
#
#
# This behavior is preserved under inheritance and cloning.
#
# == Implementation
#
# This above is achieved by:
#
# *  Making Klass.new and Klass.allocate private.
#
# *  Overriding Klass.inherited(sub_klass) and Klass.clone() to ensure that the
#    Singleton properties are kept when inherited and cloned.
#
# *  Providing the Klass.instance() method that returns the same object each
#    time it is called.
#
# *  Overriding Klass._load(str) to call Klass.instance().
#
# *  Overriding Klass#clone and Klass#dup to raise TypeErrors to prevent
#    cloning or duping.
#
# == Singleton and Marshal
#
# By default Singleton's #_dump(depth) returns the empty string. Marshalling by
# default will strip state information, e.g. instance variables and taint
# state, from the instance. Classes using Singleton can provide custom
# _load(str) and _dump(depth) methods to retain some of the previous state of
# the instance.
#
#    require 'singleton'
#
#    class Example
#      include Singleton
#      attr_accessor :keep, :strip
#      def _dump(depth)
#        # this strips the @strip information from the instance
#        Marshal.dump(@keep, depth)
#      end
#
#      def self._load(str)
#        instance.keep = Marshal.load(str)
#        instance
#      end
#    end
#
#    a = Example.instance
#    a.keep = "keep this"
#    a.strip = "get rid of this"
#    a.taint
#
#    stored_state = Marshal.dump(a)
#
#    a.keep = nil
#    a.strip = nil
#    b = Marshal.load(stored_state)
#    p a == b  #  => true
#    p a.keep  #  => "keep this"
#    p a.strip #  => nil
#
module Singleton
  # Raises a TypeError to prevent cloning.
  def clone
    raise TypeError, "can't clone instance of singleton #{self.class}"
  end

# Raises a TypeError to prevent duping.
  def dup
    raise TypeError, "can't dup instance of singleton #{self.class}"
  end

# By default, do not retain any state when marshalling.
  def _dump(depth = -1)
    ''
  end

module SingletonClassMethods # :nodoc:

def clone # :nodoc:
      Singleton.__init__(super)
    end

# By default calls instance(). Override to retain singleton state.
    def _load(str)
      instance
    end

private

def inherited(sub_klass)
      super
      Singleton.__init__(sub_klass)
    end
  end

class << Singleton # :nodoc:
    def __init__(klass) # :nodoc:
      klass.instance_eval {
        @singleton__instance__ = nil
        @singleton__mutex__ = Mutex.new
      }
      def klass.instance # :nodoc:
        return @singleton__instance__ if @singleton__instance__
        @singleton__mutex__.synchronize {
          return @singleton__instance__ if @singleton__instance__
          @singleton__instance__ = new()
        }
        @singleton__instance__
      end
      klass
    end

private

# extending an object with Singleton is a bad idea
    undef_method :extend_object

def append_features(mod)
      #  help out people counting on transitive mixins
      unless mod.instance_of?(Class)
        raise TypeError, "Inclusion of the OO-Singleton module in module #{mod}"
      end
      super
    end

def included(klass)
      super
      klass.private_class_method :new, :allocate
      klass.extend SingletonClassMethods
      Singleton.__init__(klass)
    end
  end

##
  # :singleton-method: _load
  #  By default calls instance(). Override to retain singleton state.
end

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Directory Contents

Dirs: 31 × Files: 77

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
cgi DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
date DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
digest DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
dl DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
drb DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
fiddle DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
io DIR	-	drwxr-xr-x	2024-03-03 22:43:07	Edit Download recursive recursive
irb DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
json DIR	-	drwxr-xr-x	2024-03-03 22:43:07	Edit Download recursive recursive
matrix DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
net DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
openssl DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
optparse DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
psych DIR	-	drwxr-xr-x	2024-03-03 22:43:08	Edit Download recursive recursive
racc DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
rake DIR	-	drwxr-xr-x	2024-03-03 22:53:20	Edit Download recursive recursive
rbconfig DIR	-	drwxr-xr-x	2024-03-03 22:43:11	Edit Download recursive recursive
rdoc DIR	-	drwxr-xr-x	2024-03-03 22:43:10	Edit Download recursive recursive
rexml DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
rinda DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
ripper DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
rss DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
rubygems DIR	-	drwxr-xr-x	2024-03-03 22:43:11	Edit Download recursive recursive
shell DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
syslog DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
test DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
uri DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
webrick DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
x86_64-linux DIR	-	drwxr-xr-x	2024-03-03 22:43:08	Edit Download recursive recursive
xmlrpc DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
yaml DIR	-	drwxr-xr-x	2024-03-03 22:43:05	Edit Download recursive recursive
abbrev.rb	3.31 KB	lrw-r--r--	2013-02-21 17:35:32	Edit Download recursive recursive
base64.rb	2.63 KB	lrw-r--r--	2013-05-19 03:10:21	Edit Download recursive recursive
benchmark.rb	17.95 KB	lrw-r--r--	2013-09-20 16:05:48	Edit Download recursive recursive
cgi.rb	9.84 KB	lrw-r--r--	2013-07-18 13:50:32	Edit Download recursive recursive
cmath.rb	8.93 KB	lrw-r--r--	2015-07-03 09:12:53	Edit Download recursive recursive
complex.rb	380 B	lrw-r--r--	2009-08-16 15:34:35	Edit Download recursive recursive
csv.rb	81.68 KB	lrw-r--r--	2014-09-14 15:25:34	Edit Download recursive recursive
date.rb	946 B	lrw-r--r--	2023-07-26 14:22:11	Edit Download recursive recursive
debug.rb	29.08 KB	lrw-r--r--	2013-12-14 14:48:36	Edit Download recursive recursive
delegate.rb	11.13 KB	lrw-r--r--	2014-02-02 13:46:46	Edit Download recursive recursive
digest.rb	2.34 KB	lrw-r--r--	2023-07-26 14:22:11	Edit Download recursive recursive
dl.rb	280 B	lrw-r--r--	2023-07-26 14:22:11	Edit Download recursive recursive
drb.rb	19 B	lrw-r--r--	2009-10-02 10:45:39	Edit Download recursive recursive
e2mmap.rb	3.89 KB	lrw-r--r--	2013-12-17 11:20:10	Edit Download recursive recursive
English.rb	6.44 KB	lrw-r--r--	2013-02-04 02:50:20	Edit Download recursive recursive
erb.rb	26.07 KB	lrw-r--r--	2014-08-11 14:55:58	Edit Download recursive recursive
expect.rb	2.14 KB	lrw-r--r--	2023-07-26 14:22:11	Edit Download recursive recursive
fiddle.rb	1.65 KB	lrw-r--r--	2023-07-26 14:22:11	Edit Download recursive recursive
fileutils.rb	47.17 KB	lrw-r--r--	2015-04-28 05:16:46	Edit Download recursive recursive
find.rb	2.36 KB	lrw-r--r--	2014-10-15 15:31:03	Edit Download recursive recursive
forwardable.rb	7.86 KB	lrw-r--r--	2013-05-23 21:46:43	Edit Download recursive recursive
getoptlong.rb	15.38 KB	lrw-r--r--	2013-05-19 14:50:47	Edit Download recursive recursive
gserver.rb	8.86 KB	lrw-r--r--	2014-07-06 13:57:45	Edit Download recursive recursive
ipaddr.rb	17.05 KB	lrw-r--r--	2015-10-29 14:36:05	Edit Download recursive recursive
irb.rb	20.03 KB	lrw-r--r--	2016-03-25 08:22:04	Edit Download recursive recursive
json.rb	1.74 KB	lrw-r--r--	2023-07-26 14:22:11	Edit Download recursive recursive
kconv.rb	5.74 KB	lrw-r--r--	2023-07-26 14:22:11	Edit Download recursive recursive
logger.rb	22.37 KB	lrw-r--r--	2016-02-25 11:04:33	Edit Download recursive recursive
mathn.rb	6.52 KB	lrw-r--r--	2011-08-26 22:22:37	Edit Download recursive recursive
matrix.rb	45.43 KB	lrw-r--r--	2014-07-11 14:08:51	Edit Download recursive recursive
mkmf.rb	80.50 KB	lrw-r--r--	2023-07-26 14:19:40	Edit Download recursive recursive
monitor.rb	6.93 KB	lrw-r--r--	2012-11-16 16:55:29	Edit Download recursive recursive
mutex_m.rb	2.00 KB	lrw-r--r--	2013-02-20 02:51:51	Edit Download recursive recursive
observer.rb	5.81 KB	lrw-r--r--	2013-11-21 04:44:45	Edit Download recursive recursive
open-uri.rb	24.27 KB	lrw-r--r--	2014-02-22 08:54:43	Edit Download recursive recursive
open3.rb	20.37 KB	lrw-r--r--	2013-12-01 03:13:11	Edit Download recursive recursive
openssl.rb	528 B	lrw-r--r--	2023-07-26 14:22:11	Edit Download recursive recursive
optparse.rb	50.80 KB	lrw-r--r--	2013-11-28 07:34:15	Edit Download recursive recursive
ostruct.rb	7.70 KB	lrw-r--r--	2013-10-23 15:14:17	Edit Download recursive recursive
pathname.rb	15.30 KB	lrw-r--r--	2023-07-26 14:22:11	Edit Download recursive recursive
pp.rb	14.10 KB	lrw-r--r--	2013-10-22 09:29:53	Edit Download recursive recursive
prettyprint.rb	16.33 KB	lrw-r--r--	2013-05-19 03:10:21	Edit Download recursive recursive
prime.rb	13.20 KB	lrw-r--r--	2013-07-15 04:21:34	Edit Download recursive recursive
profile.rb	205 B	lrw-r--r--	2009-10-02 10:45:39	Edit Download recursive recursive
profiler.rb	4.51 KB	lrw-r--r--	2013-05-19 23:04:36	Edit Download recursive recursive
pstore.rb	14.85 KB	lrw-r--r--	2012-11-11 04:23:04	Edit Download recursive recursive
psych.rb	14.88 KB	lrw-r--r--	2023-07-26 14:22:11	Edit Download recursive recursive
rake.rb	2.12 KB	lrw-r--r--	2013-10-11 21:35:01	Edit Download recursive recursive
rational.rb	308 B	lrw-r--r--	2009-09-24 00:42:23	Edit Download recursive recursive
rdoc.rb	4.92 KB	lrw-r--r--	2013-12-22 10:25:26	Edit Download recursive recursive
resolv-replace.rb	1.73 KB	lrw-r--r--	2013-03-11 13:47:04	Edit Download recursive recursive
resolv.rb	72.31 KB	lrw-r--r--	2015-05-13 05:33:45	Edit Download recursive recursive
ripper.rb	2.53 KB	lrw-r--r--	2023-07-26 14:22:11	Edit Download recursive recursive
rss.rb	2.84 KB	lrw-r--r--	2011-05-11 10:22:16	Edit Download recursive recursive
rubygems.rb	30.97 KB	lrw-r--r--	2023-07-26 14:19:40	Edit Download recursive recursive
scanf.rb	23.54 KB	lrw-r--r--	2013-12-14 02:55:33	Edit Download recursive recursive
securerandom.rb	8.49 KB	lrw-r--r--	2013-11-07 18:04:05	Edit Download recursive recursive
set.rb	18.70 KB	lrw-r--r--	2013-11-22 23:50:06	Edit Download recursive recursive
shell.rb	10.30 KB	lrw-r--r--	2013-05-19 03:10:21	Edit Download recursive recursive
shellwords.rb	5.94 KB	lrw-r--r--	2013-12-14 18:26:59	Edit Download recursive recursive
singleton.rb	4.02 KB	lrw-r--r--	2011-05-18 14:09:38	Edit Download recursive recursive
socket.rb	25.60 KB	lrw-r--r--	2023-07-26 14:22:11	Edit Download recursive recursive
sync.rb	7.25 KB	lrw-r--r--	2013-05-19 03:10:21	Edit Download recursive recursive
tempfile.rb	11.40 KB	lrw-r--r--	2013-11-21 09:28:43	Edit Download recursive recursive
thwait.rb	3.38 KB	lrw-r--r--	2013-11-07 17:02:56	Edit Download recursive recursive
time.rb	21.32 KB	lrw-r--r--	2015-08-17 07:41:58	Edit Download recursive recursive
timeout.rb	3.70 KB	lrw-r--r--	2015-08-17 07:55:26	Edit Download recursive recursive
tmpdir.rb	4.15 KB	lrw-r--r--	2013-05-19 03:10:21	Edit Download recursive recursive
tracer.rb	6.40 KB	lrw-r--r--	2013-07-18 13:50:32	Edit Download recursive recursive
tsort.rb	14.14 KB	lrw-r--r--	2013-10-17 15:59:40	Edit Download recursive recursive
ubygems.rb	268 B	lrw-r--r--	2009-10-02 10:45:39	Edit Download recursive recursive
un.rb	8.87 KB	lrw-r--r--	2013-07-05 13:43:25	Edit Download recursive recursive
uri.rb	3.07 KB	lrw-r--r--	2011-05-13 20:03:21	Edit Download recursive recursive
weakref.rb	3.23 KB	lrw-r--r--	2013-11-09 22:42:20	Edit Download recursive recursive
webrick.rb	6.69 KB	lrw-r--r--	2013-10-05 23:39:32	Edit Download recursive recursive
xmlrpc.rb	8.49 KB	lrw-r--r--	2013-12-12 03:09:19	Edit Download recursive recursive
yaml.rb	2.31 KB	lrw-r--r--	2013-08-12 03:49:50	Edit Download recursive recursive