cheap_strings 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: cda4eeb76ca4ad68d5a3e45ebdae9911a2a6c053
+  data.tar.gz: 7f0c49de814d60426f3b516bd030e94c7d98bc4b
+SHA512:
+  metadata.gz: 41878e70b54d735bacc09127dba91c30817b0fa514a053b86f57566e93d0756102db26281c7db91b3a7ac7d9ae18d9c598b521547318f6380dc929d0f9e72d36
+  data.tar.gz: 6f7a819773e70411be259a96a9d3ded5c8b12b786af42d1bdc1f5a24badf82f24a05e8536aa58793d9dea1ed5a876ab760445ac3920bbd8098a768a711b32a77

data/README.md

@@ -0,0 +1,93 @@
+# Cheap Strings
+
+Cheap Strings is a simple gem that makes it convenient to use frozen strings in your code.
+
+Since Ruby strings are mutable, every string literal must allocate a new string whenever it is evaluated. Often this is a waste of time, as most strings in Ruby programs are never mutated.
+
+Cheap Strings freezes your string literals and then reuses the same object every time - making your program faster and reducing GC pressure by not creating huge amounts of objects.
+
+## Benchmark
+
+The benchmarks below use this common setup code:
+
+```ruby
+require "cheap_strings"
+
+module A
+  extend CheapStrings
+
+  def self.create_lots_of_strings
+    1_000_000.times do
+      "hello world"
+    end
+  end
+
+  def self.create_lots_of_cheap_strings
+    1_000_000.times do
+      `hello world`
+    end
+  end
+end
+```
+
+### Time benchmark
+
+```ruby
+require "benchmark"
+
+Benchmark.bmbm do |b|
+  b.report "regular strings" do
+    A.create_lots_of_strings
+  end
+  b.report "cheap strings" do
+    A.create_lots_of_cheap_strings
+  end
+end
+```
+
+**Results:**
+
+```
+Rehearsal ---------------------------------------------------
+regular strings   0.240000   0.000000   0.240000 (  0.242331)
+cheap strings     0.140000   0.000000   0.140000 (  0.135519)
+------------------------------------------ total: 0.380000sec
+
+                      user     system      total        real
+regular strings   0.240000   0.000000   0.240000 (  0.235980)
+cheap strings     0.140000   0.000000   0.140000 (  0.139030)
+```
+
+### Object allocation benchmark
+
+```ruby
+def object_bench(name)
+  before, after = {}, {}
+
+  GC.start
+  GC.disable
+  ObjectSpace.count_objects(before)
+
+  yield
+
+  ObjectSpace.count_objects(after)
+  GC.enable
+
+  printf "%20s %6d -> %6d (+%8d)\n", name, before[:T_STRING], after[:T_STRING], after[:T_STRING] - before[:T_STRING]
+end
+
+object_bench "regular strings" do
+  A.create_lots_of_strings
+end
+
+object_bench "cheap strings" do
+  A.create_lots_of_cheap_strings
+end
+```
+
+**Results:**
+
+```
+     regular strings     5629 ->  1005655 (+ 1000026)
+       cheap strings     5657 ->     5657 (+       0)
+```

data/lib/cheap_strings.rb

@@ -0,0 +1,5 @@
+module CheapStrings
+  def `(str)
+    str
+  end
+end

metadata

@@ -0,0 +1,44 @@
+--- !ruby/object:Gem::Specification
+name: cheap_strings
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Charlie Somerville
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-06-27 00:00:00.000000000 Z
+dependencies: []
+description: Cheap string literals for Ruby
+email: charlie@charliesomerville.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/cheap_strings.rb
+- README.md
+homepage: 
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Cheap string literals for Ruby
+test_files: []