trick_bag 0.67.0 → 0.68.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7f8d5b7a9f77fdc75d8672b5947fd8075cca1ab5
-  data.tar.gz: e61fd4ec8b3d7dc55023e2323e7cf75f853d9389
+  metadata.gz: 59ec06de448c4ccb3f3cd3966fcdc855cb602ac5
+  data.tar.gz: 67da903f678ed62aae6d7e0ba4d84441fe6a837a
 SHA512:
-  metadata.gz: 50b8e5a3407f1b725598a1f22de963682b5e68f154f575989af03e6a84f4e18c39e17c4975978eb8ea2e32c0f705f05fecd41701619524e7e20c40571342d7b6
-  data.tar.gz: edf428cd0e32c8f282ae0f80c84ba5a274d481e6973ba065ba4f1adeb3ebb5e2a43c70f40ccdde6ac5cfc98741faeab7b8b109519ea0b7bc0725c36129699561
+  metadata.gz: b8919fe6998b064c515dd6440474327691558c72c0755e93337d1e6c066fce99a6436610fe15651a71e6964ceb94b1daf785f225eaf3c2f38cb7dcb45f4c6906
+  data.tar.gz: a488a53c4369a98e6adf563e07b8f60d758726f7299aed2e6da47b6366caed364e4fbc57d7c059d9db499a09c36b4338aa71e8247852ac04fcc742116e364dcb

data/README.md

@@ -2,8 +2,8 @@
 
 # TrickBag
 
-This gem is a collection of useful classes and modules for Ruby development.
-
+Assorted Ruby classes, modules, and methods to simplify and enhance your code.
+ 
 
 ## Installation
 

data/RELEASE_NOTES.md

@@ -1,3 +1,8 @@
+## v0.68.0
+
+* Add Filesystem.running_as_script?
+
+
 ## v0.67.0
 
 * Move Functional methods into Functional module.

data/lib/trick_bag/filesystem/filesystem.rb

@@ -0,0 +1,43 @@
+module TrickBag
+module Filesystem
+
+  module_function
+
+  # @return true if the passed file is being run as a script, else false
+  # @param __file__ - !!! __FILE__ must be passed as the __file__ argument for this to work correctly !!!
+  #
+  # Sometimes we want to see if a given file is being run as a script, as opposed to loaded
+  # by other Ruby code. For example, the script at https://github.com/keithrbennett/macwifi/blob/master/bin/mac-wifi
+  # is normally run as a script (either by running the file directly, or by running the executable's
+  # binstub installed by the gem), but it can also be loaded so that the model can be used by custom code.
+  #
+  # When the file's behavior needs to differ when running as a script and _not_ running as a script,
+  # this method can be called to report which of the two states it is.
+  #
+  # An example of differing behavior is also in the case of `mac-wifi`. When run as a script,
+  # it parses the command line and executes a task, sending text to stdout.
+  def running_as_script?(__file__)
+
+    # Here is some sample state, when running a file as a gem executable:
+    # __FILE__ = /Users/kbennett/.rvm/gems/ruby-2.4.0/gems/mac-wifi-1.0.0/bin/mac-wifi
+    # $0 =       /Users/kbennett/.rvm/gems/ruby-2.4.0/bin/mac-wifi
+    # GEM_PATH = /Users/kbennett/.rvm/gems/ruby-2.4.0:/Users/kbennett/.rvm/gems/ruby-2.4.0@global
+
+    # Please enable this code and report its output if you report any issues with this method:
+    # puts "__file__ = #{__file__}"
+    # puts "$0 =       #{$0}"
+    # puts "GEM_PATH = #{ENV['GEM_PATH']}"
+
+    return true if __file__ == $0
+    return false if File.basename(__file__) != File.basename($0)
+
+    # If here, then filespecs are different but have the same basename.
+    gem_paths = ENV['GEM_PATH'].split(File::PATH_SEPARATOR)
+    basename = File.basename($0)
+    gem_paths.any? do |path|
+      ($0 == File.join(path, 'bin', basename)) \
+        && (path == File.expand_path(File.join(__file__, '..', '..', '..', '..')))
+    end
+  end
+end
+end

data/lib/trick_bag/version.rb

@@ -1,3 +1,3 @@
 module TrickBag
-  VERSION = '0.67.0'
+  VERSION = '0.68.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trick_bag
 version: !ruby/object:Gem::Version
-  version: 0.67.0
+  version: 0.68.0
 platform: ruby
 authors:
 - Keith Bennett
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-09-25 00:00:00.000000000 Z
+date: 2017-10-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: os
@@ -146,6 +146,7 @@ files:
 - lib/trick_bag/enumerables/endless_last_enumerable.rb
 - lib/trick_bag/enumerables/file_line_reader.rb
 - lib/trick_bag/enumerables/filtered_enumerable.rb
+- lib/trick_bag/filesystem/filesystem.rb
 - lib/trick_bag/formatters/binary_to_hex_and_ascii.rb
 - lib/trick_bag/formatters/erb_renderer.rb
 - lib/trick_bag/formatters/formatters.rb