open_string 0.0.2

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NWVkODk0MGIyY2IzNzhiZmZhMmEzYzJiYWIwMWJkYmU2YzFiZTUzYg==
+  data.tar.gz: !binary |-
+    OTg1NjBjODAxY2VjYWI3NzY5NDRmNjJmMDg1OGZkMGRiM2RmNDZkMw==
+SHA512:
+  metadata.gz: !binary |-
+    ZTI5ZDNjMzYxMDdkMjc3N2M1YmM0YTcxMDJhZTAxMGY5N2MzNmFkNzJlOTY3
+    ZWM5NGQzM2E1MzFhYzE5ZGU5ZmU3ZTBjMWI2ZTU4ZmFlYmQwY2I0OGI5YTdh
+    NmFlZGRhY2UwNmRhMTU4NjkzMGNlZjUwODZmMWU1YWY5NzcwODE=
+  data.tar.gz: !binary |-
+    MjBmYWE2ZDI0Yzk4NmM4Yjg4NDZkNWZkZjY4ZTdlZTIxYzJmYTM5NmQ0ZjZl
+    MzRkYjI0YmU0ZTgxMjhkZmY2MTg3ZjkwZjM2Zjg0MWNmYjZmYjcyOWViMWQ5
+    NzgzNmM3YmUwYTlmODEwZTFiZGU1ODlkZDE1MzZhNzQwZjg5MGM=

data/lib/open_string.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+# Public: Provides extension methods for the built-in String class.
+module OpenString
+  # Public: Determines if self has the same sequence of characters as evaluated
+  # from index 0 to self.length and from self.length to 0
+  #
+  # Returns true iff self contains the same sequence of characters forwards as
+  # it does backwards.
+  def palindrome?
+    self == reverse
+  end
+
+  # Methods meant to be members of the String class need to go in here. The
+  # machinery here is a little odd: since the +randomize+ declaration isn't
+  # prefaced with a +self+, it doesn't look static. Once +String+ is set to
+  # +extend OpenInteger::ClassMethods+, this is treated like a static String
+  # method.
+  #
+  # If this inner module wasn't created and, instead, String was set to
+  # +include OpenString+, consumers would need to call static methods via
+  # +OpenString+ like so: +OpenString.randomize(10, CharacterSets.all)+.
+  module ClassMethods
+    # Public: Generates a randomized string of a length specified by +length+.
+    #
+    # +length+::    The number of characters to include in the string
+    # +*charsets+:: Arrays of character sets to use in generating the random
+    #   string. This can take array literals, variables, or constants. Some
+    #   character sets are predefined in test/support/character_sets.rb
+    #
+    # ---
+    # :section: Examples
+    # # Generates a 10-character string using only lowercase letters
+    # str = String.randomize(10, CharacterSets.lowercase)
+    #
+    # # Generates a 5-character string using only ['a', 's', 'd', '1', '2', '3']
+    # str = String.randomize(5, %w(a s d 1 2 3))
+    # ---
+    def randomize(length, *charsets)
+      raise(ArgumentError,
+            'Do not pass nil for length.') if length.nil?
+      raise(ArgumentError,
+            'Length must be a non-zero positive integer.') if length < 1
+      raise(ArgumentError,
+            'Specify a character set.') if charsets.empty?
+
+      Array.new(length) { charsets.flatten.sample }.join
+    end
+  end
+end
+
+# Public: Mixing OpenString extensions into String.
+class String
+  include OpenString
+  extend OpenString::ClassMethods
+end

metadata

@@ -0,0 +1,44 @@
+--- !ruby/object:Gem::Specification
+name: open_string
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Jason Conner
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-06-17 00:00:00.000000000 Z
+dependencies: []
+description: Various extensions for the String class
+email: jason.r.conner@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/open_string.rb
+homepage: http://rubygems.org/gems/open_string
+licenses:
+- MIT
+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.4.5
+signing_key: 
+specification_version: 4
+summary: open_string
+test_files: []