rmemlimit 0.1

data/CHANGELOG

@@ -0,0 +1 @@
+v0.1. Proof of concept

data/Manifest

@@ -0,0 +1,6 @@
+CHANGELOG
+README.md
+Rakefile
+lib/rmemlimit.rb
+test/test_all.rb
+Manifest

data/README.md

@@ -0,0 +1,37 @@
+
+## Rmemlimit gem
+
+The garbage collector in Ruby 1.x is blocking, and runs whenever there is a
+need to allocate more memory for new objects.
+
+In a large application (eg. Rails) it runs many times per second, saving
+memory but hurting performance.
+
+#### Run GC less often
+
+To increase performance, you can use this gem to run the GC once per second
+instead, in a background thread.
+
+    gem 'rmemlimit' # in your Gemfile
+
+
+#### Set a memory limit for GC (requires linux /proc)
+
+If you know roughly how much RAM you want your app to use, you can set that
+and GC will run whenever it is exceeded.  Resident Set Size is checked once
+per second. Example to limit to 500MB:
+
+    Rmemlimit.gc_mb = 500
+
+(Or you can use the RUBY_GC_MB environment variable). 
+
+
+#### Set a hard memory limit for Ruby
+
+If your application sometimes eats too much memory and you'd rather have it
+kill itself when it passes a threshold, you can do limit to say 1000MB:
+
+    Rmemlimit.kill_mb = 1000
+
+(Or you can use the RUBY_KILL_MB environment variable)
+

data/Rakefile

@@ -0,0 +1,8 @@
+require 'echoe'
+
+Echoe.new("rmemlimit") do |p|
+  p.author = "Andrew Snow"
+  p.email = 'andrew@modulus.org'
+  p.summary = "Slow down garbage collector & limit ruby process memory"
+  p.url = "https://github.com/andys/rmemlimit"
+end

data/lib/rmemlimit.rb

@@ -0,0 +1,55 @@
+
+class Rmemlimit
+
+  class << self
+    attr_accessor :gc_mb, :kill_mb
+    
+    def gcthread
+      @gcthread ||= Thread.new do
+        loop do
+          mb = rss_mb
+          if kill_mb && mb > kill_mb
+            STDERR.puts "#{self}: Exceeded kill memory limit (#{mb} > #{kill_Mb} MB)"
+            Process.kill(9, $$)
+          elsif gc_mb && mb > gc_mb
+            run_gc
+          elsif mb == 0 || !gc_mb || !kill_mb
+            run_gc
+          end
+          sleep 1
+        end
+      end
+    end
+    
+    def run_gc
+      GC.enable
+      GC.start
+      GC.disable
+    end
+  
+    def pagesize
+      4096
+    end
+    
+    def rss_mb
+      rss_kb >> 10
+    end
+    
+    def rss_kb
+      pagesize * (File.read("/proc/#{$$}/statm").split(' ')[1].to_i rescue 0) >> 10
+    end
+    
+    def setup
+      self.gc_mb = ENV['RUBY_GC_MB'].to_i if ENV['RUBY_GC_MB']
+      if ENV['RUBY_KILL_MB']
+        self.kill_mb = ENV['RUBY_KILL_MB'].to_i 
+        self.kill_mb = nil unless Rmemlimit.kill_mb > 1
+      end
+      GC.disable
+      self.gcthread
+    end
+  end
+
+end
+
+Rmemlimit.setup

data/rmemlimit.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "rmemlimit"
+  s.version = "0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Andrew Snow"]
+  s.date = "2012-12-28"
+  s.description = "Slow down garbage collector & limit ruby process memory"
+  s.email = "andrew@modulus.org"
+  s.extra_rdoc_files = ["CHANGELOG", "README.md", "lib/rmemlimit.rb"]
+  s.files = ["CHANGELOG", "README.md", "Rakefile", "lib/rmemlimit.rb", "test/test_all.rb", "Manifest", "rmemlimit.gemspec"]
+  s.homepage = "https://github.com/andys/rmemlimit"
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Rmemlimit", "--main", "README.md"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = "rmemlimit"
+  s.rubygems_version = "1.8.24"
+  s.summary = "Slow down garbage collector & limit ruby process memory"
+  s.test_files = ["test/test_all.rb"]
+
+  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

data/test/test_all.rb

@@ -0,0 +1,28 @@
+require "#{File.dirname(__FILE__)}/../lib/rmemlimit"
+require 'test/unit'
+
+class TestRmemlimit < Test::Unit::TestCase
+
+  def test_rss_kb
+    kb = Rmemlimit.rss_kb
+    assert(kb > 0)
+    
+    assert_equal "VmRSS:\t%8d kB\n" % kb,
+                 File.read("/proc/#{$$}/status").lines.grep(/VmRSS/).first
+  end
+  
+  def test_run_gc
+    gccount = GC.stat[:count] + 1
+    sleep 1.1
+    assert_equal gccount, GC.stat[:count]
+  end
+  
+  def test_gc_mb
+    Rmemlimit.gc_mb = Rmemlimit.rss_mb
+    gccount = GC.stat[:count] + 1
+    flibble = 'x' * 1024 * 1024
+    sleep 1.1
+    assert_equal gccount, GC.stat[:count]
+  end
+
+end

metadata

@@ -0,0 +1,61 @@
+--- !ruby/object:Gem::Specification
+name: rmemlimit
+version: !ruby/object:Gem::Version
+  prerelease: 
+  version: '0.1'
+platform: ruby
+authors:
+- Andrew Snow
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-12-28 00:00:00.000000000 Z
+dependencies: []
+description: Slow down garbage collector & limit ruby process memory
+email: andrew@modulus.org
+executables: []
+extensions: []
+extra_rdoc_files:
+- CHANGELOG
+- README.md
+- lib/rmemlimit.rb
+files:
+- CHANGELOG
+- README.md
+- Rakefile
+- lib/rmemlimit.rb
+- test/test_all.rb
+- Manifest
+- rmemlimit.gemspec
+homepage: https://github.com/andys/rmemlimit
+licenses: []
+post_install_message: 
+rdoc_options:
+- --line-numbers
+- --inline-source
+- --title
+- Rmemlimit
+- --main
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+  none: false
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '1.2'
+  none: false
+requirements: []
+rubyforge_project: rmemlimit
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Slow down garbage collector & limit ruby process memory
+test_files:
+- test/test_all.rb