lx 1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d4c0434d776d126749bc25f0261862ef735b77ac115e65fa53b81c4d37910e0b
+  data.tar.gz: 327b023d673ed23f7281d61d85001b9a2c1e577ed2b0c5ba571f245c4b8d1883
+SHA512:
+  metadata.gz: d46c1fd25072f59cb72eff63d3b323c86749cdb522ac17c225509397227be60f2fc9e92ac695467866170244f6318128c2b744394b1e755f0f25ffb7ce440838
+  data.tar.gz: 35bbb8fb3bd0a20c9eaae80685bf255ebb3374950230c28771e5a7a1bdff0b9cccffc46938af062990d2d52359a3d813281e5051947eda274fcc7bcac136e424

data/README.md

@@ -0,0 +1,34 @@
+# LX
+
+OK, let's just be honest here. These are some cool little utilities I cooked up
+for myself. I think they're the coolest thing since sliced bread. You probably
+won't agree. That's how we programmers are, always besmirching each other's work
+because it doesn't meet our individual ideas of what constitutes making the
+world a better place.
+
+Mainly, I'm posting this library on RubyGems because I use it in some other
+libraries that I'm going to upload.
+
+## Install
+
+The usual:
+
+``
+gem install lx
+``
+
+## Author
+
+Mike O'Sullivan
+mike@idocs.com
+
+## Name
+
+"LX" doesn't mean anything in particular. It's concise and it was available on
+rubygems.rb.
+
+## History
+
+| version | date         | notes                         |
+|---------|--------------|-------------------------------|
+| 1.0     | May 29, 2020 | Initial upload.               |

data/lib/lx.rb

@@ -0,0 +1,197 @@
+#===============================================================================
+# LX
+#
+
+# The LX module is the home for utilities that don't particularly fit in one
+# class. For now, it only contains the randstr method.
+module LX
+	# version '1.0'
+	VERSION = '1.0'
+	
+	#---------------------------------------------------------------------------
+	# verbose
+	# @verbose = true
+	#
+	# def self.verbose
+	#	return @verbose
+	# end
+	#
+	# def self.verbose=(bool)
+	#	return @verbose = bool ? true : false
+	# end
+	#
+	# verbose
+	#---------------------------------------------------------------------------
+
+
+	#---------------------------------------------------------------------------
+	# randstr
+	#
+	
+	# characters for random string
+	@@RAND_CHARS = %w(
+		b c d f h m p q r s t v w x z
+		B C D F H M P Q R S T V W X Z
+		2 3 4 5 7 8 9
+	)
+	
+	# length of random character string
+	@@RND_CHARS_MAX = @@RAND_CHARS.length - 1
+	
+	# target length
+	@@RND_PK_LENGTH = 20
+	
+	# Returns a random string of characters. The optional single param is the
+	# length of the string to return. By default, the string is 20 characters
+	# long.
+	def self.randstr(len=@@RND_PK_LENGTH)
+		# intialize rv
+		rv = ''
+		
+		# build return string
+		len.times do
+			rv += @@RAND_CHARS[rand 0 .. @@RND_CHARS_MAX]
+		end
+		
+		# freeze return value
+		rv.freeze
+		
+		# return
+		return rv
+	end
+	#
+	# randstr
+	#---------------------------------------------------------------------------
+end
+#
+# LX
+#===============================================================================
+
+
+#===============================================================================
+# Array
+#
+
+# Adds a single method to the Array class. This is the only method that is
+# added to the Array class itself. Access LX utilities through the array's new
+# +lx+ method.
+#
+# For example, the use the move method, call the method like this:
+#  arr = ['a', 'b', 'c']
+#  arr.lx.move 1, 2
+class Array
+	# Creates a LX::Array object and returns it.
+	def lx
+		return LX::Array.new(self)
+	end
+end
+
+# A helper class to add methods to the Array class. When you use the Array::lx
+# you're creating an instance of LX::Array.
+class LX::Array
+	# Initialize a LX::Array object. The only param is the array itself.
+	def initialize(p_arr)
+		@arr = p_arr
+	end
+	
+	# Moves an array element from the old index to the new index.
+	#  arr = ['a', 'b', 'c']
+	#  arr.lx.move 1, 2 # => ["a", "c", "b"]
+	def move(old_idx, new_idx)
+		@arr.insert new_idx, @arr.slice!(1)
+	end
+	
+	# Splits an array into an array of arrays. The param is the delimiter.
+	#  arr = ['Fred', 'George', ':', 'Mary', 'Frank']
+	#  arr.lx.split ':' # => [["Fred", "George"], ["Mary", "Frank"]]
+	def split(exp)
+		# $tm.hrm
+		rv = []
+		current = nil
+		
+		# loop through array looking for delimiter
+		@arr.each do |el|
+			if el == exp
+				if current
+					rv.push current
+					current = nil
+				end
+			else
+				current ||= []
+				current.push el
+			end
+		end
+		
+		# add last current
+		if current
+			rv.push current
+		end
+		
+		# return
+		return rv
+	end
+end
+#
+# Array
+#===============================================================================
+
+
+#===============================================================================
+# String
+#
+
+# Adds the +lx+ method to the String class. To call LX utilities on the string,
+# call its lx method. For example, call +collapse+ like this:
+#  str = ' Whatever  Dude  '
+#  str.lx.collapse # => "Whatever Dude"
+class String
+	# Creates and returns an LX::String object.
+	def lx
+		return LX::String.new(self)
+	end
+end
+
+# Utilities for strings.
+class LX::String
+	#---------------------------------------------------------------------------
+	# initialize
+	#
+	
+	# Initializes a LX::String object, The single param is the string with which
+	# the object will be associated.
+	def initialize(p_str)
+		@str = p_str
+	end
+	#
+	# initialize
+	#---------------------------------------------------------------------------
+	
+	
+	#---------------------------------------------------------------------------
+	# collapse
+	#
+	
+	# Returns a new string in which leading and trailing whitespace have been
+	# removed, and multiple internal whitespaces are collapsed into into single
+	# spaces.
+	#  str = ' Whatever  Dude  '
+	#  str.lx.collapse # => "Whatever Dude"
+	def collapse()
+		rv = @str.dup
+		rv.lx.collapse!
+		return rv
+	end
+	
+	# Performs a collapse on the string itself.
+	def collapse!()
+		@str.sub!(/\A[^[:graph:]]+/mu, '')
+		@str.sub!(/[^[:graph:]]+\z/mu, '')
+		@str.gsub!(/[^[:graph:]]+/mu, ' ')
+	end
+	#
+	# collapse
+	#---------------------------------------------------------------------------
+end
+#
+# String
+#===============================================================================

metadata

@@ -0,0 +1,45 @@
+--- !ruby/object:Gem::Specification
+name: lx
+version: !ruby/object:Gem::Version
+  version: '1.0'
+platform: ruby
+authors:
+- Mike O'Sullivan
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-05-29 00:00:00.000000000 Z
+dependencies: []
+description: Misc utilities for strings and arrays
+email: mike@idocs.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/lx.rb
+homepage: https://rubygems.org/gems/lx
+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.7.6
+signing_key: 
+specification_version: 4
+summary: Misc utilities
+test_files: []