Add bin and edit workflow

bin/gems/facets-3.1.0/demo/core/dir/ascend.md

@@ -0,0 +1,24 @@
+## Dir#ascend
+
+    require 'facets/dir/ascend'
+
+    path = 'A/B/C'
+
+    tmp = []
+
+    Dir.ascend(path) do |d|
+      tmp << d
+    end
+
+    tmp.assert == %w{A/B/C A/B A}
+
+Exclude current path.
+
+    tmp = []
+
+    Dir.ascend(path, false) do |d|
+      tmp << d
+    end
+    
+    tmp.assert == %w{A/B A}
+

bin/gems/facets-3.1.0/demo/core/dir/descend.md

@@ -0,0 +1,16 @@
+## Dir#descend
+
+    require 'facets/dir/descend'
+
+Descend thru a file path.
+
+    path = 'A/B/C'
+
+    tmp = []
+
+    Dir.descend(path) do |d|
+      tmp << d
+    end
+
+    tmp.assert == %w{A A/B A/B/C}
+

bin/gems/facets-3.1.0/demo/core/dir/multiglob.md

@@ -0,0 +1,41 @@
+## Dir#multiglob
+
+Dir#multglob is like Dir#glob but it can handle more than one match
+parameter at a time.
+
+Given a directory 'multiglob' containing:
+
+    A.txt
+    A/B.txt
+    A/B/C.txt
+
+We can use #multglob to find multiple matches.
+
+    require 'facets/dir/multiglob'
+
+    x = %w{
+      multiglob/A
+      multiglob/A.txt
+    }
+
+    r = Dir.multiglob('multiglob/A', 'multiglob/A.*').sort
+
+    r.assert == x
+
+## Dir#multiglob_r
+
+Dir#multiglob_r is like #multiglob but automatically searches
+directories recrusively.
+
+    x = %w{
+      multiglob/A 
+      multiglob/A/B
+      multiglob/A.txt
+      multiglob/A/B.txt
+      multiglob/A/B/C.txt
+    }.sort
+
+    r = Dir.multiglob_r('multiglob/*').sort
+
+    r.assert == x
+

bin/gems/facets-3.1.0/demo/core/dir/parent.md

@@ -0,0 +1,6 @@
+## Dir#parent
+
+    require 'facets/dir/parent'
+
+    Dir.assert.parent?("a/b/c", "a/b/c/d")
+

bin/gems/facets-3.1.0/demo/core/dir/recurse.md

@@ -0,0 +1,41 @@
+## Dir#recurse
+
+Given a directory 'recurse' containing:
+
+    A.txt
+    A/B.txt
+    A/B/C.txt
+
+We can use #recurse to gather a complete recursive
+list of all the entries.
+
+    require 'facets/dir/recurse'
+
+    x = %w{
+      recurse/A
+      recurse/A.txt
+      recurse/A/B
+      recurse/A/B.txt
+      recurse/A/B/C.txt
+    }.sort
+
+    r = Dir.recurse('recurse').sort
+
+    r.assert == x
+
+## Dir#ls_r
+
+Dir#ls_r is an alias for #recurse which can also be used to gather
+a complete recursive list of all the entries.
+
+    x = %w{
+      recurse/A
+      recurse/A.txt
+      recurse/A/B
+      recurse/A/B.txt
+      recurse/A/B/C.txt
+    }.sort
+
+    r = Dir.ls_r('recurse').sort
+
+    r.assert == x