utility 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7146d6516db0a0b290e4570b5e9d5d97623ff10e
-  data.tar.gz: d847d69e41dbce10df764aba51e92e22d3104d35
+  metadata.gz: 1d2ce37f67cff412377ef436b8cf7a930622a844
+  data.tar.gz: e325ade3a0e62e6c220fac485fdd32ac0d70dde5
 SHA512:
-  metadata.gz: 6be1be7251b66c04f4edde21136d0c98dde378ffef63f4e7293d6f0df639dbc785208e6c45c7f003b58dd38c3ce83d38504d0903e7acc768600da8381bc68a1e
-  data.tar.gz: f64610245f2f557b4a73882959cd51db7003021e9abdd964771788ed3e536b967b60613cc00e5d56caad5b7c31c4cdb77079b825ae67b89c579f45ee5900ed1a
+  metadata.gz: e53b0dfae235814a63256647838f14ecf73e7b782cae2283b22a37b3fb4b90bb3b3ffac459b4a236ae9e8f2aa27d7ca0335f39111ffeedca323f79e945a161c2
+  data.tar.gz: 65b139f0818e279778355ebe3e6d6dd825bf49f1c2ce3ab498226f9f074ee27256c5ee4a09e2c47207724ea96eb86266f65180445af53047c9acec1f6b41d2d9

data/README.md

@@ -1,6 +1,6 @@
 ## Utility ##
 
-The useful utilities which made in ruby ways.
+A number of ruby useful utilities.
 
 
 ### Installation ###
@@ -30,11 +30,49 @@ Utility.base64decode "dXRpbGl0eQ=="  #=> utility
 Utility.base64decode "5Lit5paH"      #=> 中文
 ```
 
-### TODO ###
-- Add md5
-- Add sha1
-- Add sha256
-- Add random numbers/chars
+#### md5/rmd/sha ####
+```ruby
+Utility.md5 "ruby"     #=> "58e53d1324eef6265fdb97b08ed9aadf"
+Utility.rmd160 "ruby"  #=> "29d9b710bc50866fa2399c3061cd02c0c8ffa197"
+Utility.sha1 "ruby"    #=> "18e40e1401eef67e1ae69efab09afb71f87ffb81"
+Utility.sha256 "ruby"  #=> "b9138194ffe9e7c8bb6d79d1ed56259553d18d9cb60b66e3ba5aa2e5b078055a"
+Utility.sha384 "ruby"  #=> "635365ef93ebf2c7a4e40b0b497da727ab8c2914eb9f052e6be40476f95d3daf44786790f5f0e843fab419b43022e069"
+Utility.sha512 "ruby"  #=> "423408d7723a3d80baefa804bd50b61a89667efec1713386a7b8efe28e5d13968307a908778cad210d7aa2dfe7db9a2aa86895f9fc1eeefcc99814310b207a6b"
+```
+
+#### hmc ####
+```ruby
+Utility.hmac "sha1", "key", "the data"    #=> "ac5b94c09a6033e3aca1a02116ebf48722b155e0"
+Utility.hmac "sha256", "key", "the data"  #=> "00644ab9e7ce1b772c5fcd9b460b1a4fa78de4a55c162590ac506f2f76d62a40"
+```
+
+#### params parse ####
+```ruby
+# full url
+Utility.parse_query "http://example.com/?param1=value1&param2=value2&param3=value3"
+#=> {"param1"=>["value1"], "param2"=>["value2"], "param3"=>["value3"]}
+
+# only query params
+Utility.parse_query "param1=value1&param2=value2&param3=value3"
+#=> {"param1"=>["value1"], "param2"=>["value2"], "param3"=>["value3"]}
+```
+### computer info ###
+```ruby
+# get hostname
+Utility.get_hostname #=> "Charles"
+
+# get ip address
+Utility.get_ip #=> "192.168.12.26"
+
+#get mac address
+Utility.get_mac #=> "c8:60:00:10:ec:ee"
+
+#get os
+Utility.get_os #=> "linux"
+
+#get os arch
+Utility.get_arch #=> 64
+```
 
 ### License ###
 Released under the [MIT](http://opensource.org/licenses/MIT) license. See LICENSE file for details.

data/lib/utility/{atob.rb → base64.rb}

@@ -1,4 +1,4 @@
-module Utility::Atob
+module Utility::Base64
 
   # Base64 convert in ruby way
   # Usually, we use Base64 module to handle everything of base64 with `require 'base64'`

data/lib/utility/computer.rb

@@ -0,0 +1,31 @@
+require 'socket'
+require 'macaddr'
+require 'rubygems'
+
+module Utility::Computer
+  def get_ip
+    ip = Socket.ip_address_list.detect do |intf|
+      intf.ipv4? &&
+      !intf.ipv4_loopback? &&
+      !intf.ipv4_multicast? &&
+      !intf.ipv4_private?
+    end
+    ip.nil?? "IP address not found" : ip.ip_address
+  end
+
+  def get_mac
+    Mac.addr.list rescue Mac.address
+  end
+
+  def get_hostname
+    Socket.gethostname
+  end
+
+  def get_os
+    Gem::Platform.local.os
+  end
+
+  def get_arch
+    1226.size * 8
+  end
+end

data/lib/utility/digest.rb

@@ -0,0 +1,11 @@
+require 'digest'
+
+module Utility::Digest
+
+  %w[md5 sha1 sha256 sha384 sha512 rmd160].each do |method_name|
+    define_method method_name do |str = nil|
+      Digest.const_get(method_name.upcase).hexdigest str.to_s
+    end
+  end
+
+end

data/lib/utility/hmac.rb

@@ -0,0 +1,9 @@
+require "openssl"
+
+module Utility::HMAC
+
+  def hmac(sha, key, data)
+    OpenSSL::HMAC.hexdigest sha, key, data
+  end
+
+end

data/lib/utility/url.rb

@@ -0,0 +1,12 @@
+require 'cgi'
+require 'uri'
+
+module Utility::URL
+  def parse_query(url)
+    if url =~ URI::regexp
+      CGI.parse URI.parse(url).query
+    else
+      CGI.parse url
+    end
+  end
+end

data/lib/utility/version.rb

@@ -1,3 +1,3 @@
 module Utility
-  VERSION = "0.1.2"
+  VERSION = "0.1.3"
 end

data/lib/utility.rb

@@ -1,6 +1,9 @@
-require_relative "utility/version"
-require_relative "utility/atob"
+Dir[File.dirname(__FILE__) + '/utility/*.rb'].each {|file| require file }
 
 module Utility
-  extend Atob
+  extend Base64
+  extend Digest
+  extend HMAC
+  extend URL
+  extend Computer
 end

data/utility.gemspec

@@ -9,8 +9,8 @@ Gem::Specification.new do |spec|
   spec.authors       = ["Cenxky"]
   spec.email         = ["cenxky@gmail.com"]
 
-  spec.summary       = %q{The useful utilities which made in ruby ways.}
-  spec.description   = %q{The useful utilities which made in ruby ways.}
+  spec.summary       = %q{A number of ruby useful utilities.}
+  spec.description   = %q{A number of ruby useful utilities.}
   spec.homepage      = "https://github.com/cenxky/utility"
   spec.license       = "MIT"
 
@@ -21,6 +21,7 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
+  spec.add_dependency "macaddr", "~> 1.0"
   spec.add_development_dependency "bundler", "~> 1.14"
   spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "rspec", "~> 3.0"

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: utility
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Cenxky
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-07-31 00:00:00.000000000 Z
+date: 2017-08-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: macaddr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -52,7 +66,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
-description: The useful utilities which made in ruby ways.
+description: A number of ruby useful utilities.
 email:
 - cenxky@gmail.com
 executables: []
@@ -69,7 +83,11 @@ files:
 - bin/console
 - bin/setup
 - lib/utility.rb
-- lib/utility/atob.rb
+- lib/utility/base64.rb
+- lib/utility/computer.rb
+- lib/utility/digest.rb
+- lib/utility/hmac.rb
+- lib/utility/url.rb
 - lib/utility/version.rb
 - utility.gemspec
 homepage: https://github.com/cenxky/utility
@@ -95,5 +113,5 @@ rubyforge_project:
 rubygems_version: 2.6.6
 signing_key: 
 specification_version: 4
-summary: The useful utilities which made in ruby ways.
+summary: A number of ruby useful utilities.
 test_files: []