blackstack-core 1.2.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7efdde4423249a891ed69c8536964164a3c1a5beae6702c2a8f9934fea8621d3
+  data.tar.gz: 716de4195b3455be7be4bfbe015a3377eb5aa64363244401e66560a2e82a0094
+SHA512:
+  metadata.gz: 81d3a16c625325255e499cf65f493960c98fc55aa342526674568c1295eb93a15c9b7634a592dfdbec54bc650b1947ad55c926f6c14e7651297b8a9537002720
+  data.tar.gz: 6b838f8b586488013f4d50c059f96f98ae147b374579271beeb4c4ca32379f7d9ff1c3558428dd3d6bb0d1bcacc6f75cd1fb75c60cfc2e3d377146c6267c2502

data/examples/example01.rb

@@ -0,0 +1,300 @@
+require_relative '../lib/blackstack-core'
+
+# returns true if the string meets all the security requirements for a password
+puts ""
+puts "Passwords"
+a = ['Hello', 'HelloWorld12$3']
+a.each { |s|
+  print "'#{s}'.password?... "
+  puts s.password?.to_s  
+}
+
+# returns true if the string match with the regex of a GUID
+puts ""
+puts "GUIDs"
+a = [
+  '{{331a92c3-5fe1-47a2-a31b-cfa439b5b4f9}',
+  '{331a92c3-5fe1-47a2-a31b-cfa439b5b4f9}',
+  '331a92c3-5fe1-47a2-a31b-cfa439b5b4f9',
+  '{331A92C3-5FE1-47A2-A31B-CFA439B5B4F9}',
+  '{331A92C3-5FE1-47A2-A31B-CFA439B5B4F9}}',
+  '331A92C3-5FE1-47A2-A31B-CFA439B5B4F9',
+  '331A92C3-5FE1-47A2-A31B-CFA439B5B4F9-fgf',
+  '331A92C35FE147A2A31BCFA439B5B4F9',
+]
+a.each { |s|
+  print "'#{s}'.guid?... "
+  puts s.guid?.to_s  
+}
+
+# returns true if the string match with the regex of a filename
+puts ""
+puts "Filenames"
+a = [
+  'c:\filename.txt',
+  'c:/filename.txt',
+  'filename_1.txt',
+  'filename-1.txt',
+  'filename+1.txt',
+  'filename?1.txt',
+  'filename*1.txt',
+  'filename.txt',
+  'filename',
+  'filename.txt.rar',
+]
+a.each { |s|
+  print "'#{s}'.filename?... "
+  puts s.filename?.to_s
+}
+
+# returns true if the string match with the regex of an email
+puts ""
+puts "Emails"
+a = [
+  'tango@expandedventure.com',
+  'tango@expandedventure.com.ar',
+  'tango',
+  'tango@',
+]
+a.each { |s|
+  print "'#{s}'.email?... "
+  puts s.email?.to_s
+}
+
+# returns true if the string match with the regex of a domain
+puts ""
+puts "Domains"
+a = [
+  'tango',
+  'tango@expandedventure',
+  'tango@expandedventure.com',
+  'tango@expandedventure.com.ar',
+  'expandedventure.com',
+  'expandedventure.com.ar',
+  'https://expandedventure.com.ar',
+  'www.expandedventure.com.ar',
+  'https://www.expandedventure.com.ar',
+]
+a.each { |s|
+  print "'#{s}'.domain?... "
+  puts s.domain?.to_s
+}
+
+# returns true if the string match with the regex of a phone number
+puts ""
+puts "Domains"
+a = [
+  '+54 9 11 5061 2148',
+  '545-5561-2148',
+  '545-561-2148',
+  '545 561 2148',
+  '54 545 561 2148',
+  '+54 545 561 2148',
+  '+54 545-561-2148',
+  '+54-545-561-2148',
+]
+a.each { |s|
+  print "'#{s}'.domain?... "
+  puts s.phone?.to_s
+}
+
+# returns true if the string match with the regex of a URL
+puts ""
+puts "URLs"
+a = [
+  'tango',
+  'tango@expandedventure',
+  'tango@expandedventure.com',
+  'tango@expandedventure.com.ar',
+  'expandedventure.com',
+  'expandedventure.com.ar',
+  'https://expandedventure.com.ar',
+  'www.expandedventure.com.ar',
+  'https://www.expandedventure.com.ar',
+]
+a.each { |s|
+  print "'#{s}'.url?... "
+  puts s.url?.to_s
+}
+
+# returns true if the string match with the regex of a number
+puts ""
+puts "Fixnums"
+a = [
+  '5',
+  '5.5',
+  '5,5',
+  '5000',
+  '5,000',
+  '5.000',
+]
+a.each { |s|
+  print "'#{s.to_s}'.fixnum?... "
+  puts s.fixnum?.to_s
+}
+
+# returns true if the string match with the regex of a datetime used in the BlackStack's API
+puts ""
+puts "SQL DateTimes"
+a = [
+  '20191106215030',
+  '20191106',
+  '2019-11-06',
+  '2019-11-06 21:50:30',
+  '2019-13-06 21:50:30', # invalid month
+  '2019-11-06 25:50:30', # invalid hour
+  '2019-11-06 21:70:30', # invalid minute
+  '2019-11-06 21:50:70', # invalid second
+]
+a.each { |s|
+  print "'#{s.to_s}'.sql_datetime?... "
+  puts s.sql_datetime?.to_s
+}
+
+#
+puts ""
+puts "API DateTimes"
+a = [
+  '20191106215030',
+  '20191106',
+  '2019-11-06',
+  '2019-11-06 21:50:30',
+  '20191306215030', # invalid month
+  '20191106255030', # invalid hour
+  '20191106217030', # invalid minute
+  '20191106215070', # invalid second
+]
+a.each { |s|
+  print "'#{s.to_s}'.api_datetime?... "
+  puts s.api_datetime?.to_s
+}
+
+# Convierte un string con formato sql-datatime a un string con formato sql-datetime.
+puts ""
+puts "SQL DateTime -> API DateTime"
+a = [
+  '2019-11-06 21:50:30',
+]
+a.each { |s|
+  print "'#{s.to_s}'.sql_to_api_datetime... "
+  puts s.sql_to_api_datetime.to_s
+}
+
+# Convierte un string con formato api-datatime (yyyymmddhhmmss) a un string con formato sql-datetime (yyyy-mm-dd hh:mm:ss).
+puts ""
+puts "API DateTime -> SQL DateTime"
+a = [
+  '20191106215030',
+]
+a.each { |s|
+  print "'#{s.to_s}'.api_to_sql_datetime... "
+  puts s.api_to_sql_datetime.to_s
+}
+
+# Rewrite a GUID as a standard (normalized) format.
+puts ""
+puts "Any GUID -> Normalized Guid"
+a = [
+  '{331a92c3-5fe1-47a2-a31b-cfa439b5b4f9}',
+  '331a92c3-5fe1-47a2-a31b-cfa439b5b4f9',
+  '{331A92C3-5FE1-47A2-A31B-CFA439B5B4F9}',
+  '331A92C3-5FE1-47A2-A31B-CFA439B5B4F9',
+]
+a.each { |s|
+  print "'#{s}'.to_guid... "
+  puts s.to_guid.to_s  
+}
+
+# Escape simple-quotes too add the string into literal-string of a dynamic query build into the Ruby code.
+# Example: "I'm BlackStack" -> "I''m BlackStack" 
+puts ""
+puts "Any String -> String with Escaped Quotes"
+a = [
+  "I'm BlackStack",
+  "Hello World!",
+]
+a.each { |s|
+  print "'#{s}'.to_sql... "
+  puts s.to_sql.to_s  
+}
+
+# 
+puts ""
+puts "Spintax"
+a = [
+  "I'm BlackStack",
+  "Hello World!",
+  "{Hello|Hi} World!",
+  "{Hello|Hi|Good {Morning|Afternoon}} World!", # Nexted spintax. Not supported.
+  "{Hello|Hi World!", # wrong syntax.
+]
+a.each { |s|
+  print "'#{s}'.spintax?... "
+  puts s.spintax?.to_s  
+}
+
+# Returns a random spin from a spintax
+puts ""
+puts "Spin"
+a = [
+  "{Hello|Hi|Good Morning|Good Afternoon} World!",
+  "{Hello|Hi|Good Morning|Good Afternoon} World!",
+  "{Hello|Hi|Good Morning|Good Afternoon} World!",
+  "{Hello|Hi|Good Morning|Good Afternoon} World!",
+]
+a.each { |s|
+  print "'#{s}'.spin... "
+  puts s.spin  
+}
+
+# Converts a time object to an SQL friendy string
+puts ""
+puts "Time object -> SQL"
+a = [
+  Time.new(2019,11,6,15,25,55),
+  DateTime.new(2019,11,6,15,25,55),
+]
+a.each { |o|
+  print "'#{o.to_s}'.to_sql... "
+  puts o.to_sql  
+}
+
+# Converts number to a string with a format like xx,xxx,xxx.xxxx 
+puts ""
+puts "Fixnum & Floats -> Screen Friendly Text"
+a = [
+  64443,
+  64443.5454,
+]
+a.each { |i|
+  print "'#{i.to_s}'.to_label... "
+  puts i.to_label
+}
+
+# Converts number to a string with a format like xx,xxx,xxx.xxxx 
+puts ""
+puts "Fixnum Minutes -> Time Spent (days, hours, minutes)"
+a = [
+  59,
+  60,
+  61,
+  600,
+  601,
+  1440,
+  1441,
+  1500,
+  1501,
+]
+a.each { |i|
+  print "Minutes '#{i.to_s}'.to_time_spent... "
+  puts i.to_time_spent
+}
+
+
+=begin # TODO: Pending
+encode_string
+encode_html
+encode_exception
+encode_period
+encode_javascript
+=end

data/examples/example02.rb

@@ -0,0 +1,3 @@
+require_relative '../lib/blackstack-core'
+
+BlackStack::Netting::api_call('https://connectionsphere.com/api1.3/pampa/ping.json')

data/lib/blackstack-core.rb

@@ -0,0 +1,26 @@
+require 'pry'
+require 'content_spinning'
+require 'uri'
+require 'json'
+require 'net/http'
+require 'openssl'
+require 'time'
+=begin
+require 'html_to_plain_text'
+require "RedCloth"
+require 'cgi'
+require 'httpclient'
+require 'open-uri'
+require 'date'
+require 'rest-client'
+require 'net/ssh'
+require 'digest/md5'
+require 'domainatrix'
+=end
+require_relative './functions'
+require_relative './extend_string'
+require_relative './extend_time'
+require_relative './extend_datetime'
+require_relative './extend_fixnum'
+require_relative './extend_float'
+require_relative './extend_exception'

data/lib/extend_datetime.rb

@@ -0,0 +1,6 @@
+class DateTime
+  # Converts a time object to an SQL friendy string
+  def to_sql()
+    BlackStack::DateTime::Encoding::datetime_to_sql(self)
+  end
+end # class DateTime

data/lib/extend_exception.rb

@@ -0,0 +1,11 @@
+class Exception
+	def to_html(include_backtrace=true)
+		BlackStack::Strings::Encoding.encode_exception(self, include_backtrace)
+	end
+
+  def to_console(include_backtrace=true)
+    ret = self.to_s 
+    ret += "\r\n" + self.backtrace.join("\r\n") if (include_backtrace == true)
+    ret
+  end # to_console
+end

data/lib/extend_fixnum.rb

@@ -0,0 +1,14 @@
+class Fixnum
+  # Converts number to a string with a format like xx,xxx,xxx.xxxx 
+  def to_label()
+    BlackStack::Number::Encoding::format_with_separator(self)
+  end
+
+  # Convierte una cantidad de minutos a una leyenda legible por el usuario.
+  # Ejemplo: "2 days, 5 hours"
+  # Ejemplo: "4 hours, 30 minutes"
+  # Ejemplo: "3 days, 4 hour"
+  def to_time_spent()
+    BlackStack::Number::Encoding::encode_minutes(self)
+  end
+end # class String

data/lib/extend_float.rb

@@ -0,0 +1,6 @@
+class Float
+  # Converts number to a string with a format like xx,xxx,xxx.xxxx 
+  def to_label()
+    BlackStack::Number::Encoding::format_with_separator(self)
+  end
+end # class String

data/lib/extend_string.rb

@@ -0,0 +1,143 @@
+class String
+  # returns true if the string meets all the security requirements for a password
+  def password?
+    return true if self.to_s =~ /^#{BlackStack::Strings::MATCH_PASSWORD}$/
+    return false
+  end
+
+  # returns true if the string match with the regex of a GUID
+  def guid?
+    return true if self.to_s =~ /^#{BlackStack::Strings::MATCH_GUID}$/
+    return false
+  end
+
+  # returns true if the string match with the regex of a filename
+  def filename?
+    return true if self.to_s =~ /^#{BlackStack::Strings::MATCH_FILENAME}$/
+    return false
+  end
+
+  # returns true if the string match with the regex of an email
+  def email?
+    return true if self.to_s =~ /^#{BlackStack::Strings::MATCH_EMAIL}$/
+    return false
+  end
+
+  # returns true if the string match with the regex of a domain
+  def domain?
+    return true if self.to_s =~ /^#{BlackStack::Strings::MATCH_DOMAIN}$/  
+    return false
+  end
+
+  # returns true if the string match with the regex of a phone number
+  def phone?
+    return true if self.to_s =~ /^#{BlackStack::Strings::MATCH_PHONE}$/
+    return false
+  end
+
+  # returns true if the string match with the regex of a URL
+  def url?
+    return true if self.to_s =~ /^#{BlackStack::Strings::MATCH_URL}$/
+    return false
+  end
+
+  # returns true if the string match with the regex of a number
+  def fixnum?
+    return true if self.to_s =~ /^#{BlackStack::Strings::MATCH_FIXNUM}$/    
+    return false
+  end
+
+  # returns true if the string match with the regex of a datetime used in the BlackStack's API
+  def api_datetime?
+    BlackStack::Strings::DateTime::datetime_api_check(self.to_s)        
+  end
+
+  #
+  def sql_datetime?
+    BlackStack::Strings::DateTime::datetime_sql_check(self.to_s)            
+  end
+
+  # Convierte un string con formato sql-datatime a un string con formato sql-datetime.
+  def sql_to_api_datetime
+    BlackStack::Strings::DateTime::datetime_sql_to_api(self.to_s)    
+  end
+
+  # Convierte un string con formato api-datatime (yyyymmddhhmmss) a un string con formato sql-datetime (yyyy-mm-dd hh:mm:ss).
+  def api_to_sql_datetime
+    BlackStack::Strings::DateTime::datetime_api_to_sql(self.to_s)
+  end
+
+  # Rewrite a GUID as a standard format.
+  # Example: {331a92c3-5fe1-47a2-a31b-cfa439b5b4f9} -> 331A92C3-5FE1-47A2-A31B-CFA439B5B4F9
+  def to_guid
+    BlackStack::Strings::Encoding::encode_guid(self.to_s)
+  end
+  
+  # Escape simple-quotes too add the string into literal-string of a dynamic query build into the Ruby code.
+  # Example: "I'm BlackStack" -> "I''m BlackStack" 
+  def to_sql
+    BlackStack::Strings::SQL::string_to_sql_string(self.to_s)
+  end
+  
+  # 
+  def spintax?
+    BlackStack::Strings::Spinning::spintax?(self.to_s)
+  end
+
+  # 
+  def spintax?
+    BlackStack::Strings::Spinning::valid_spinning_syntax?(self.to_s) &&
+    BlackStack::Strings::Spinning::spintax?(self.to_s)
+  end
+  
+  # Returns a random spin from a spintax
+  def spin
+    BlackStack::Strings::Spinning::random_spinning_variation(self.to_s)
+  end
+  
+  # Then it makes it compatible with UTF-8.
+  # More details here: https://bitbucket.org/leandro_sardi/blackstack/issues/961  
+  def encode_string()
+    BlackStack::Strings::Encoding::encode_string(self.to_s)
+  end
+  
+  # Escape the string to be shown into an HTML screen.
+  # Then it makes it compatible with UTF-8.
+  # More details here: https://bitbucket.org/leandro_sardi/blackstack/issues/961  
+  def encode_html()
+    BlackStack::Strings::Encoding::encode_html(self.to_s)    
+  end
+  
+  # Escapes carriage returns and single and double quotes for JavaScript segments.
+  # reference: https://api.rubyonrails.org/classes/ActionView/Helpers/JavaScriptHelper.html
+  #
+  # Example: 
+  # <%
+  # s = 'Hello World!'
+  # %>
+  # text = "<%=s.escape_javascript%>"
+  # 
+  # Never use single-quotation marks, because this method is not supporting it.
+  # <%
+  # s = 'Hello World!'
+  # %>
+  # text = '<%=s.escape_javascript%>'
+  # 
+  def escape_javascript
+    s = self.dup
+	  js_escape_map = { 
+      '\\' => '\\\\', 
+      "</" => '<\/', 
+      "\r\n" => '\n', 
+      "\n" => '\n', 
+      "\r" => '\n', 
+      '"' => '\\"', 
+      "'" => "\'", 
+      "`" => "\`", 
+      "$" => "\\$", 
+    }
+	  js_escape_map.each { | x, y | s.gsub!(x,y) }
+	  s
+  end
+  
+end # class String

data/lib/extend_time.rb

@@ -0,0 +1,11 @@
+class Time
+  # Converts a time object to an SQL friendy string: YYYY-MM-DD HH:mm:ss
+  def to_sql()
+    BlackStack::DateTime::Encoding::datetime_to_sql(self)
+  end
+  
+  # Converts a time object to an API friendy string: YYYYMMDDHHmmss
+  def to_api()
+    BlackStack::Strings::DateTime::datetime_sql_to_api(self.to_sql)
+  end
+end # class DateTime