array2hash 0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f3ff053477da70e0c4c1bb5122de7dc9bca8694d
+  data.tar.gz: a67a4d838a3a96d486805d868661608b9a9d78e1
+SHA512:
+  metadata.gz: a3c28bd1975af4860747569c57991b3c266688c2aa002633e7358ac5bd1e74509fa4bf1bf4c0991a9cd019f72ab912fbfc0f98b9522c59e46cae04e961c94640
+  data.tar.gz: 9144eeb575f9e798aaaab975fab0c9984ef351bb26f135c8f1c432c1ee6e8227440d040b58d258591dc7e085643674cea7e565373a0387bf980956adc9ed3a13

data/.gitignore

@@ -0,0 +1,50 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+# Used by dotenv library to load environment variables.
+# .env
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+*.bridgesupport
+build-iPhoneOS/
+build-iPhoneSimulator/
+
+## Specific to RubyMotion (use of CocoaPods):
+#
+# We recommend against adding the Pods directory to your .gitignore. However
+# you should judge for yourself, the pros and cons are mentioned at:
+# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
+#
+# vendor/Pods/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/Gemfile.lock

@@ -0,0 +1,26 @@
+PATH
+  remote: .
+  specs:
+    array2hash (0.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    racc (1.4.14)
+    rake (11.3.0)
+    rake-compiler (1.0.4)
+      rake
+    rubex (0.1)
+      racc (~> 1.4.14)
+      rake-compiler (~> 1.0.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  array2hash!
+  rake (~> 11.2)
+  rubex (~> 0.1)
+
+BUNDLED WITH
+   1.15.3

data/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2017, Sameer Deshmukh
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the copyright holder nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,65 @@
+# array2hash
+Efficient conversion of a Ruby Array to a lookup table-like Hash written in Rubex.
+
+This Ruby gem is a C extension written in [Rubex]() that can convert a Ruby Array to a Hash lookup table. Basically the following Array:
+``` ruby
+["1", 2, :three, "4"]
+```
+...will be converted into a Hash that looks like this:
+``` ruby
+{
+  "1" => 0,
+   2 => 1,
+   :three => 2,
+   "4" => 3
+}
+```
+
+The reason for making this gem is mainly speed. The conventional way of the above conversion would be as follows:
+``` ruby
+a = ["1", 2, :three, "4"]
+a.each_with_index.to_h 
+```
+
+This extension makes the above process upto 50% faster with a C extension. Here is the benchmarking code:
+``` ruby
+require 'benchmark/ips'
+a = (1..1000).to_a.map(&:to_s)
+Benchmark.ips do |x|
+  x.report("convert") do
+    Array2Hash.convert a
+  end
+
+  x.report("each_with_index.to_h") do
+    a.each_with_index.to_h
+  end
+
+  x.compare!
+end
+```
+
+The results are as follows:
+```
+Warming up --------------------------------------
+             convert   368.000  i/100ms
+each_with_index.to_h   236.000  i/100ms
+Calculating -------------------------------------
+             convert      3.488k (± 9.8%) i/s -     17.296k in   5.012260s
+each_with_index.to_h      2.192k (± 8.3%) i/s -     11.092k in   5.097432s
+
+Comparison:
+             convert:     3487.8 i/s
+each_with_index.to_h:     2192.3 i/s - 1.59x  slower
+```
+
+# Usage
+
+Install with `gem install array2hash`.
+
+The use with the `convert` class method:
+``` ruby
+require 'array2hash'
+
+a = (1..1000).to_a.map(:&to_s)
+Array2Hash.convert a
+```

data/Rakefile

@@ -0,0 +1,3 @@
+require 'rubex/rake_task'
+
+Rubex::RakeTask.new('array2hash')

data/array2hash.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+$:.unshift File.expand_path("../lib", __FILE__)
+
+require 'array2hash/version.rb'
+
+Array2Hash::DESCRIPTION = <<MSG
+Efficient conversion of a Ruby Array to a lookup table-like Hash written in Rubex via a C extension.
+MSG
+
+Gem::Specification.new do |spec|
+  spec.name          = 'array2hash'
+  spec.version       = Array2Hash::VERSION
+  spec.authors       = ['Sameer Deshmukh']
+  spec.email         = ['sameer.deshmukh93@gmail.com']
+  spec.summary       = Array2Hash::DESCRIPTION
+  spec.description   = Array2Hash::DESCRIPTION
+  spec.homepage      = "http://github.com/v0dro/array2hash"
+  spec.license       = 'BSD-3-Clause'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+  spec.extensions    = ['ext/array2hash/extconf.rb']
+
+  spec.add_development_dependency 'rubex', '~> 0.1'
+  spec.add_development_dependency 'rake', '~> 11.2'
+end

data/ext/array2hash/array2hash.c

@@ -0,0 +1,73 @@
+/* C extension for array2hash.
+This file in generated by Rubex::Compiler. Do not change!
+File generation time: 2017-08-29 00:01:30 +0530.*/
+
+#include <ruby.h>
+#include <stdint.h>
+#include <stdbool.h>
+#include <ruby.h>
+
+#define __rubex_INT2BOOL(arg) (arg ? Qtrue : Qfalse)
+
+
+VALUE rb_cObject;
+VALUE __rubex_rb_cls_Array2Hash;
+static VALUE __rubex_rb_f_Array2Hash_convert (int argc,VALUE* argv,VALUE __rubex_arg_self);
+
+VALUE __rubex_char2rubystr(char ch);
+VALUE __rubex_char2rubystr(char ch)
+{
+  char s[2];
+  s[0] = ch;
+  s[1] = '\0';
+  return rb_str_new2(s);
+}
+
+
+static VALUE __rubex_rb_f_Array2Hash_convert (int argc,VALUE* argv,VALUE __rubex_arg_self)
+{
+  VALUE __rubex_arg_a;
+  long int __rubex_v_i;
+  long int __rubex_v_j;
+  VALUE __rubex_v_result;
+  VALUE __rubex_temp_1;
+  if (argc < 1)
+  {
+    rb_raise(rb_eArgError, "Need 1 args, not %d", argc);
+  }
+
+  __rubex_arg_a=argv[0];
+  __rubex_v_i = NUM2LONG(rb_funcall(__rubex_arg_a, rb_intern("size"), 0, NULL));
+  __rubex_v_j = 0;
+
+  /* Rubex file location: /home/sameer/gitrepos/array2hash/ext/array2hash/array2hash.rubex:10 */
+  __rubex_temp_1 = rb_hash_new();
+  __rubex_v_result = __rubex_temp_1;
+  __rubex_temp_1 = 0;
+  __rubex_temp_1 = 0;
+  while (( __rubex_v_j < __rubex_v_i ))
+  {
+
+    /* Rubex file location: /home/sameer/gitrepos/array2hash/ext/array2hash/array2hash.rubex:13 */
+    rb_hash_aset(__rubex_v_result,RARRAY_AREF(__rubex_arg_a,__rubex_v_j),LONG2NUM(__rubex_v_j));
+
+    /* Rubex file location: /home/sameer/gitrepos/array2hash/ext/array2hash/array2hash.rubex:14 */
+    __rubex_v_j = ( __rubex_v_j + 1 );
+  }
+
+
+  /* Rubex file location: /home/sameer/gitrepos/array2hash/ext/array2hash/array2hash.rubex:17 */
+  return __rubex_v_result;
+}
+
+
+void Init_array2hash ();
+void Init_array2hash ()
+{
+  VALUE __rubex_rb_cls_Array2Hash;
+
+  __rubex_rb_cls_Array2Hash = rb_define_class("Array2Hash", rb_cObject);
+
+  rb_define_singleton_method(__rubex_rb_cls_Array2Hash ,"convert", __rubex_rb_f_Array2Hash_convert, -1);
+}
+

data/ext/array2hash/array2hash.rubex

@@ -0,0 +1,19 @@
+lib "<ruby.h>"
+  object rb_hash_aset(object, object, object)
+  object RARRAY_AREF(object, long int)
+end
+
+class Array2Hash
+  def self.convert(a)
+    long int i = a.size
+    long int j = 0
+    result = {}
+
+    while j < i do
+      rb_hash_aset(result, RARRAY_AREF(a, j), j)
+      j += 1
+    end
+
+    return result
+  end
+end

data/ext/array2hash/extconf.rb

@@ -0,0 +1,3 @@
+require 'mkmf'
+$libs += " "
+create_makefile('ext/array2hash/array2hash')

data/lib/array2hash.rb

@@ -0,0 +1 @@
+require 'array2hash.so'

data/lib/array2hash/version.rb

@@ -0,0 +1,3 @@
+class Array2Hash
+  VERSION = "0.1".freeze
+end

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification
+name: array2hash
+version: !ruby/object:Gem::Version
+  version: '0.1'
+platform: ruby
+authors:
+- Sameer Deshmukh
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-08-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rubex
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11.2'
+description: 'Efficient conversion of a Ruby Array to a lookup table-like Hash written
+  in Rubex via a C extension.
+
+'
+email:
+- sameer.deshmukh93@gmail.com
+executables: []
+extensions:
+- ext/array2hash/extconf.rb
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- array2hash.gemspec
+- ext/array2hash/array2hash.c
+- ext/array2hash/array2hash.rubex
+- ext/array2hash/extconf.rb
+- lib/array2hash.rb
+- lib/array2hash.so
+- lib/array2hash/version.rb
+homepage: http://github.com/v0dro/array2hash
+licenses:
+- BSD-3-Clause
+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.5.2
+signing_key: 
+specification_version: 4
+summary: Efficient conversion of a Ruby Array to a lookup table-like Hash written
+  in Rubex via a C extension.
+test_files: []