cheap_random 0.9.2 → 0.9.3

data/.gitignore

@@ -1,4 +1,13 @@
 *.gem
 doc/
 random/
-
+examples2/
+!examples2/cr.c
+!examples2/rpb.c
+!examples2/chex_pipe.rb
+!examples2/crf.rb
+!examples2/the.seed
+!examples2/pet_cat.png
+!examples2/crx
+!examples2/crxs
+!examples2/make_seed

data/README.md

@@ -11,15 +11,15 @@ Simple and powerful: The **CheapRandom algorithm** is fast, fast enough to be pr
 
 Version
 -------
-v0.9.1 with comprehensive tests, developed using ruby 1.9.3 and rspec 2.10.0.
+v0.9.3 with comprehensive tests, developed using ruby 1.9.3 and rspec 2.10.0 is the same as v0.9.1 (gem v0.9.2) aside from the addition of the **examples2** directory.
 
 Installation
 ------------
-Clone the repository. Create a directory called **random** in the repository root. Use **examples/make\_seed.rb** to make a **the.seed** file - (a 256 byte permutation file) from arbitrary data using the **CheapRandom default seed**.
+Get the v0.9.3 gem or clone the repository. Create a directory called **random** in the repository root. Use **examples/make\_seed.rb** to make a **the.seed** file - (a 256 byte permutation file) from arbitrary data using the **CheapRandom default seed**.
 
 Usage and documentation
 -----------------------
-Study the programs in the **examples** and **spec** directories and use the **.rb** files in the **lib** directory. See below for more information.
+Study the programs in the **examples** and **spec** directories and use the **.rb** files in the **lib** directory. See below for more information. Additionally, the **examples2** directory contains tools for the **crx** bash script, using the c programs **cr** and **rpb**, for a very convenient way of working with cheap random files.
 
 License
 -------
@@ -83,3 +83,19 @@ Other possible uses of CheapRandom
 ----------------------------------
 There are a number of intriguing possible uses for the **CheapRandom algorithm** and the **CheapRandom seed** properties beyond random number generation.
 
+Additional Examples - C code and In Place File Processing
+---------------------------------------------------------
+The **examples2** directory contains examples related to **example2/cr.c** These examples are designed to be on the PATH and require the use of a C compiler.
+
+cr.c Cheap Random Filter and Friends
+------------------------------------
+**gcc -Wall cr.c -o cr** creates the **cr** cheap random filter. Running **cr h** writes out some help text. **cr <somefile >some_file.random** and **cr u <somefile.random >somefile** are the most basic use of **cr**. **the.seed** is hard coded into **cr**. To see how, use **chex\_pipe.rb <the.seed** and compare the console output to the definition of SEED in **cr.c**. **the.seed** was generated by running the bash script **make_seed pet\_cat.png**
+
+
+crf.rb Cheap Random File, In Place File Processing 
+--------------------------------------------------
+**crf.rb somefile** => **somefile.random** - somefile over-written in place, **somefile.the.seed**, **somefile.new.seed**. **crf.rb somefile.random** => **somefile** - somefile.random over-written in place, **somefile.random.the.seed**, **somefile.random.new.seed**. The seed used by **crf.rb** is a file designated by the environmental variable CR\_SEED if defined, otherwise **crf.rb** any one file located in **~/.cheap\_random**. If the designated file is a **.seed** file it will be used directly, otherwise a seed will be generated internally from the designated file. **~/.cheap\_random/pet_cat.png** can serve as a seed file for **crf.rb**.
+
+crx and crxs Cheap Random File, In Place File Processing 
+--------------------------------------------------------
+**gcc -Wall rpb.c -o rpb**, **rpb** makes in place file processing possible for the bash scripts **crx** and **crxs**. **crx somefile** => **somefile.random** - somefile over-written in place. **crx somefile.random** => **somefile** - somefile.random over-written in place. **crxs** behaves like **crx** with the addition of the creation of the seed files **the.seed** and **new.seed**.

data/cheap_random.gemspec

@@ -1,7 +1,7 @@
 Gem::Specification.new do |s|
   s.name = 'cheap_random'
-  s.version = '0.9.2'
-  s.date = '2012-06-12'
+  s.version = '0.9.3'
+  s.date = '2012-06-26'
   s.summary = 'pseudo random number generation from arbitrary data'
   s.description = <<-EOT
     **CheapRandom** is a set of tools for pseudo random number generation from arbitrary data. The properties of the **CheapRandom seed** make convenient random number generation possible -- useful for easily repeatable software testing. The **CheapRandom algorithm** is information conserving and generally appears to produce lower chi-squared statistics than **Kernel::rand** i.e. it appears to be more random. The **CheapRandom algorithm**, an original work by Bardi Einarsson, has been in use for 6 years.
@@ -21,6 +21,15 @@ examples/cb.rb
 examples/chi_squared.rb
 examples/cr.rb
 examples/make_seed.rb
+examples2/chex_pipe.rb
+examples2/cr.c
+examples2/crf.rb
+examples2/crx
+examples2/crxs
+examples2/make_seed
+examples2/pet_cat.png
+examples2/rpb.c
+examples2/the.seed
 lib/cheap_big_file.rb
 lib/cheap_bits.rb
 lib/cheap_byte_count.rb

data/lib/cheap_random/version.rb

@@ -1,4 +1,4 @@
 module CheapRandom
-  VERSION = '0.9.1'
+  VERSION = '0.9.3'
 end
 

metadata

@@ -1,32 +1,32 @@
 --- !ruby/object:Gem::Specification
 name: cheap_random
 version: !ruby/object:Gem::Version
-  version: 0.9.2
-  prerelease: 
+  prerelease:
+  version: 0.9.3
 platform: ruby
 authors:
 - Bardi Einarsson
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2012-06-12 00:00:00.000000000 Z
+date: 2012-06-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    none: false
+  version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '2.2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
     none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '2.2'
+    none: false
+  prerelease: false
+  type: :development
 description: ! '    **CheapRandom** is a set of tools for pseudo random number generation
   from arbitrary data. The properties of the **CheapRandom seed** make convenient
   random number generation possible -- useful for easily repeatable software testing.
@@ -35,7 +35,7 @@ description: ! '    **CheapRandom** is a set of tools for pseudo random number g
   more random. The **CheapRandom algorithm**, an original work by Bardi Einarsson,
   has been in use for 6 years.
 
-'
+  '
 email:
 - bardi_e@hotmail.com
 executables: []
@@ -50,6 +50,15 @@ files:
 - examples/chi_squared.rb
 - examples/cr.rb
 - examples/make_seed.rb
+- examples2/chex_pipe.rb
+- examples2/cr.c
+- examples2/crf.rb
+- examples2/crx
+- examples2/crxs
+- examples2/make_seed
+- examples2/pet_cat.png
+- examples2/rpb.c
+- examples2/the.seed
 - lib/cheap_big_file.rb
 - lib/cheap_bits.rb
 - lib/cheap_byte_count.rb
@@ -64,26 +73,28 @@ files:
 - spec/using_cheap_bits_cheap_random_spec.rb
 homepage: https://github.com/bardibardi/cheap_random
 licenses: []
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: 1.9.2
-required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
+required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
-      version: '0'
+      version: !binary |-
+        MA==
+  none: false
 requirements: []
-rubyforge_project: 
-rubygems_version: 1.8.23
-signing_key: 
+rubyforge_project:
+rubygems_version: 1.8.24
+signing_key:
 specification_version: 3
 summary: pseudo random number generation from arbitrary data
 test_files: []
+...