string-utility 2.7.2 → 2.7.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6e462553b6a77784d686ffad8ffbfc7ccd9b1959
-  data.tar.gz: 28208aab108398aefb3bbd5ac5c10fd05e144776
+  metadata.gz: 4a2b5e87c8eacc1c8298288a863648479d79a92b
+  data.tar.gz: ea2d2bfdfefea83ff19aaa28ff851ee037377e85
 SHA512:
-  metadata.gz: 85f2d11d7b1428287c9a0ed6f15b58313d876bd152f29b261b02084325848f95aa6e682792eecf2d4653ca4a89e5e369d9afd4d32942fe2eb0ddab390253a6d3
-  data.tar.gz: 119bd520fdac35064f8a5756016b42815680937bbca8c3f3a20dba34e0136c1a6a30bf8d58d823b1d6f425ca9d43c611b5dddc2719d160020fd3c37246d3cae4
+  metadata.gz: 6dad12d0aa07187cc0c682b1c9d6242dd89b1494dbf5eeaac50451563044cc4e300c0f7c44eeac2e8be0697e3adf1353f125a31dd2f874133dc86a0152ae90d7
+  data.tar.gz: f786694beb1eba79692b5b1676169d253504ee84dbbd128b1ddae01e738e03af19f7320f65336246e33b31cc3bb86115b62464fe3e606b09689f18fd378b968d

data/CHANGELOG.md

@@ -1,5 +1,8 @@
 # Changelog
 ## Version 2
+### Version 2.7.3
+* Optimize underscorify and spacify with native extensions written in Rust, utilizing the ruru crate. These methods are now 2-5x faster. I did attempt to write a Rust extension for random_line, the slowest function in this library, but the performance increase was insignificant.
+
 ### Version 2.7.2
 * No longer include tests in gem package.
 * License as MIT

data/ext/Cargo.toml

@@ -0,0 +1,16 @@
+[package]
+name = "string-utility-rb-native"
+version = "1.0.0"
+authors = ["Eli Clemente Gordillo Foster <elifosterwy@gmail.com>"]
+homepage = "https://rubygems.org/gems/string-utility"
+repository = "https://github.com/elifoster/String-Utility-Ruby"
+readme = "README.md"
+license = "MIT"
+description = "The Rust native extension for the StringUtility Ruby gem."
+
+[lib]
+name = "stringutility"
+crate-type = ["dylib"]
+
+[dependencies]
+ruru = "0.7"

data/ext/Makefile

@@ -0,0 +1,7 @@
+all:
+	cargo build --release
+
+clean:
+	rm -rf target
+
+install: ;

data/ext/extconf.rb

@@ -0,0 +1 @@
+fail 'You have to install Rust with Cargo (https://www.rust-lang.org/)' if !system('cargo --version') || !system('rustc --version')

data/ext/src/lib.rs

@@ -0,0 +1,29 @@
+#[macro_use]
+extern crate ruru;
+
+use ruru::{AnyObject, Class, RString, VM};
+use ruru::types::{Argc, Value};
+use ruru::traits::Object;
+
+class!(StringUtility);
+
+methods!(
+    RString,
+    itself,
+    
+    fn underscorify() -> RString {
+        RString::new(&str::replace(&itself.to_string(), " ", "_"))
+    }
+    
+    fn spacify() -> RString {
+        RString::new(&str::replace(&itself.to_string(), "_", " "))
+    }
+);
+
+#[no_mangle]
+pub extern fn initialize_me() {
+    Class::from_existing("String").define(|itself| {
+        itself.def("underscorify", underscorify);
+        itself.def("spacify", spacify);
+    });
+}

data/lib/utils.rb

@@ -1,4 +1,9 @@
+require 'fiddle'
+
+LIBRARY = Fiddle.dlopen("#{File.dirname(__FILE__)}/../ext/target/release/libstringutility.dylib")
+
 module StringUtility
+  Fiddle::Function.new(LIBRARY['initialize_me'], [], Fiddle::TYPE_VOIDP).call
   refine String do
     # Separates the string by another string. Useful for converting integers
     #   into human-readable numbers.
@@ -18,18 +23,6 @@ module StringUtility
       safely_gsub!(/\D/, '').to_i
     end
 
-    # Replaces all whitespace with underscores.
-    # @return [String] The string with replaced whitespace.
-    def underscorify
-      safely_gsub!(/\s/, '_')
-    end
-
-    # Replaces all underscores with whitespace.
-    # @return [String] The string with replaced underscores.
-    def spacify
-      safely_gsub!('_', ' ')
-    end
-
     # Readable shorthand for the only safe, fast way to use gsub! using || operators. Unlike gsub!, safely_gsub! will
     # NEVER return nil. This method should not be used instead of gsub! when the string replacement is predictable, as
     # this method is somewhat slower than gsub! (see spec/benchmark).
@@ -77,3 +70,14 @@ module StringUtility
     str
   end
 end
+
+# A module that contains stub methods for the Rust native extension methods.
+module StringUtilityNativeExtensionDocumentationStubs
+  # Replaces all whitespace with underscores.
+  # @return [String] The string with replaced whitespace.
+  def underscorify; end
+
+  # Replaces all underscores with whitespace.
+  # @return [String] The string with replaced underscores.
+  def spacify; end
+end

metadata

@@ -1,22 +1,27 @@
 --- !ruby/object:Gem::Specification
 name: string-utility
 version: !ruby/object:Gem::Version
-  version: 2.7.2
+  version: 2.7.3
 platform: ruby
 authors:
 - Eli Foster
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-03-23 00:00:00.000000000 Z
+date: 2016-05-16 00:00:00.000000000 Z
 dependencies: []
 description: "    Some simple but handy methods to interact with string objects.\n"
 email: elifosterwy@gmail.com
 executables: []
-extensions: []
+extensions:
+- ext/extconf.rb
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
+- ext/Cargo.toml
+- ext/Makefile
+- ext/extconf.rb
+- ext/src/lib.rs
 - lib/string-utility.rb
 - lib/utils.rb
 homepage: https://github.com/elifoster/string-utility-ruby