pleasant_path 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d6e26d3eb1ea19b636f25d9920be3aeb772175ce
+  data.tar.gz: 46c754d3523b1436d029fe0a0877e70a508becf7
+SHA512:
+  metadata.gz: 35f15a1f476b2dc68a1979fe72df5feed7b7cf41949eb98391379a36d92a40d1a3d6c72ea193965401796fa59b3e9021e70448321c6c7c7573c3d19d65ad563a
+  data.tar.gz: 69be2fb1dcfa1362aac1d56fedc5558b7800506ab1b5ae58c5b3e573cbc39188c0641323a0f1cdbe7f2396b6ecf67aca76d867169cecfb3c05ba28000ef8ac25

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.2.5
+before_install: gem install bundler -v 1.13.5

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in pleasant_path.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Jonathan Hefner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,79 @@
+# pleasant_path
+
+A [fluent API] for pleasant file IO, written as extensions to core Ruby
+objects.  See method listing below or browse the [full documentation].
+
+[fluent API]: https://en.wikipedia.org/wiki/Fluent_interface
+[full documentation]: http://www.rubydoc.info/gems/pleasant_path/
+
+
+## Examples
+
+```ruby
+# Dedup lines in a file
+"line_items.txt".path.edit_lines(&:uniq)
+
+# Filter lines across multiple files
+"logs/*.txt".glob.each do |log|
+  log.read_lines.grep(/Error/).append_to_file('errors.txt')
+end
+```
+
+
+## API Methods
+
+- Pathname
+  - [^](http://www.rubydoc.info/gems/pleasant_path/Pathname%3A%5E)
+  - [append_file](http://www.rubydoc.info/gems/pleasant_path/Pathname%3Aappend_file)
+  - [append_lines](http://www.rubydoc.info/gems/pleasant_path/Pathname%3Aappend_lines)
+  - [append_text](http://www.rubydoc.info/gems/pleasant_path/Pathname%3Aappend_text)
+  - [delete!](http://www.rubydoc.info/gems/pleasant_path/Pathname%3Adelete%21)
+  - [dir_empty?](http://www.rubydoc.info/gems/pleasant_path/Pathname%3Adir_empty%3F)
+  - [dirs](http://www.rubydoc.info/gems/pleasant_path/Pathname%3Adirs)
+  - [dirs_r](http://www.rubydoc.info/gems/pleasant_path/Pathname%3Adirs_r)
+  - [edit_lines](http://www.rubydoc.info/gems/pleasant_path/Pathname%3Aedit_lines)
+  - [edit_text](http://www.rubydoc.info/gems/pleasant_path/Pathname%3Aedit_text)
+  - [files](http://www.rubydoc.info/gems/pleasant_path/Pathname%3Afiles)
+  - [files_r](http://www.rubydoc.info/gems/pleasant_path/Pathname%3Afiles_r)
+  - [make_dir](http://www.rubydoc.info/gems/pleasant_path/Pathname%3Amake_dir)
+  - [make_dirname](http://www.rubydoc.info/gems/pleasant_path/Pathname%3Amake_dirname)
+  - [move](http://www.rubydoc.info/gems/pleasant_path/Pathname%3Amove)
+  - [move_into](http://www.rubydoc.info/gems/pleasant_path/Pathname%3Amove_into)
+  - [parentname](http://www.rubydoc.info/gems/pleasant_path/Pathname%3Aparentname)
+  - [read_lines](http://www.rubydoc.info/gems/pleasant_path/Pathname%3Aread_lines)
+  - [to_pathname](http://www.rubydoc.info/gems/pleasant_path/Pathname%3Ato_pathname)
+  - [touch_file](http://www.rubydoc.info/gems/pleasant_path/Pathname%3Atouch_file)
+  - [write_lines](http://www.rubydoc.info/gems/pleasant_path/Pathname%3Awrite_lines)
+  - [write_text](http://www.rubydoc.info/gems/pleasant_path/Pathname%3Awrite_text)
+- String
+  - [/](http://www.rubydoc.info/gems/pleasant_path/String%3A%2F)
+  - [^](http://www.rubydoc.info/gems/pleasant_path/String%3A%5E)
+  - [append_to_file](http://www.rubydoc.info/gems/pleasant_path/String%3Aappend_to_file)
+  - [glob](http://www.rubydoc.info/gems/pleasant_path/String%3Aglob)
+  - [to_pathname](http://www.rubydoc.info/gems/pleasant_path/String%3Ato_pathname)
+  - [write_to_file](http://www.rubydoc.info/gems/pleasant_path/String%3Awrite_to_file)
+- Array
+  - [append_to_file](http://www.rubydoc.info/gems/pleasant_path/Array%3Aappend_to_file)
+  - [write_to_file](http://www.rubydoc.info/gems/pleasant_path/Array%3Awrite_to_file)
+- File
+  - [edit_lines](http://www.rubydoc.info/gems/pleasant_path/File.edit_lines)
+  - [edit_text](http://www.rubydoc.info/gems/pleasant_path/File.edit_text)
+- IO
+  - [read_lines](http://www.rubydoc.info/gems/pleasant_path/IO%3Aread_lines)
+  - [write_lines](http://www.rubydoc.info/gems/pleasant_path/IO%3Awrite_lines)
+
+
+## Installation
+
+    $ gem install pleasant_path
+
+
+## Development
+
+Run `rake test` to run the tests.  You can also run `rake irb` for an
+interactive prompt that pre-loads the project code.
+
+
+## License
+
+[MIT License](http://opensource.org/licenses/MIT)

data/Rakefile

@@ -0,0 +1,23 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+require "yard"
+
+
+YARD::Rake::YardocTask.new(:doc) do |t|
+end
+
+desc "Launch IRB with this gem pre-loaded"
+task :irb do
+  require "pleasant_path"
+  require "irb"
+  ARGV.clear
+  IRB.start
+end
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task :default => :test

data/lib/pleasant_path.rb

@@ -0,0 +1,7 @@
+require 'pathname'
+require 'pleasant_path/version'
+require 'pleasant_path/array'
+require 'pleasant_path/file'
+require 'pleasant_path/io'
+require 'pleasant_path/pathname'
+require 'pleasant_path/string'

data/lib/pleasant_path/array.rb

@@ -0,0 +1,27 @@
+class Array
+
+  # Writes the array as lines to the given file, and returns the array.
+  # A new line character (<code>$/</code>) is written after each line.
+  # The file is overwritten if it already exists.  Any necessary parent
+  # directories are created if they do not exist.
+  #
+  # @param file [String, Pathname]
+  # @return [Array]
+  def write_to_file(file)
+    file.to_pathname.write_lines(self)
+    self
+  end
+
+  # Appends the array as lines to the given file, and returns the array.
+  # A new line character (<code>$/</code>) is written after each line.
+  # The file is created if it does not exist.  Any necessary parent
+  # directories are created if they do not exist.
+  #
+  # @param file [String, Pathname]
+  # @return [Array]
+  def append_to_file(file)
+    file.to_pathname.append_lines(self)
+    self
+  end
+
+end

data/lib/pleasant_path/file.rb

@@ -0,0 +1,42 @@
+class File
+
+  # Reads from the specified file its contents as a string, and yields
+  # the string to the given block for editing.  Writes the return value
+  # of the block back to the file, overwriting previous contents.
+  # Returns the file's new contents.
+  #
+  # @param filename [String, Pathname]
+  # @yield [text] edits current file contents
+  # @yieldparam text [String] current contents
+  # @yieldreturn [String] new contents
+  # @return [String]
+  def self.edit_text(filename)
+    self.open(filename, 'r+') do |f|
+      text = yield f.read
+      f.seek(0, IO::SEEK_SET)
+      f.write(text)
+      text
+    end
+  end
+
+  # Reads from the specified file its contents as an array of lines, and
+  # yields the array to the given block for editing.  Writes the return
+  # value of the block back to the file, overwriting previous contents.
+  # The <code>$/</code> global string specifies what end-of-line
+  # characters to use for both reading and writing.  Returns the array
+  # of lines that comprises the file's new contents.
+  #
+  # @param filename [String, Pathname]
+  # @yield [lines] edits current file contents
+  # @yieldparam lines [Array<String>] current contents
+  # @yieldreturn [Array<String>] new contents
+  # @return [Array<String>]
+  def self.edit_lines(filename)
+    self.open(filename, 'r+') do |f|
+      lines = yield f.read_lines
+      f.seek(0, IO::SEEK_SET)
+      f.write_lines(lines)
+    end
+  end
+
+end

data/lib/pleasant_path/io.rb

@@ -0,0 +1,29 @@
+class IO
+
+  # Writes each string plus a succeeding new line character
+  # (<code>$/</code>) to the IO.  Returns the lines unmodified.
+  #
+  # @param lines [Array<String>]
+  # @return [Array<String>]
+  def write_lines(lines)
+    lines.each do |line|
+      self.write(line)
+      self.write($/)
+    end
+    self.write('') # write something even if no lines
+    lines
+  end
+
+  # Reads from the IO all lines, and returns them as an array,
+  # end-of-line characters excluded.  The <code>$/</code> global string
+  # specifies what end-of-line characters to look for.
+  #
+  # (Not to be confused with +IO#readlines+ which retains end-of-line
+  # characters in every string it returns.)
+  #
+  # @return [Array<String>]
+  def read_lines
+    self.readlines.each(&:chomp!)
+  end
+
+end

data/lib/pleasant_path/pathname.rb

@@ -0,0 +1,261 @@
+class Pathname
+
+  # Returns the Pathname unmodified.  Exists for parity with
+  # +String#to_pathname+.
+  #
+  # @return [Pathname]
+  def to_pathname
+    self
+  end
+
+  # Joins the parent (+dirname+) of the Pathname with the argument.  The
+  # mnenomic for this operator is that the resultant path goes up one
+  # directory level from the original, then goes down to the directory
+  # specified by the argument.
+  #
+  # @example
+  #   (Pathname.new("path/to/file1") ^ "file2").to_s #=> "path/to/file2"
+  #
+  # @param sibling [Pathname, String]
+  # @return [Pathname]
+  def ^(sibling)
+    self.dirname / sibling
+  end
+
+  # Returns the +basename+ of the Pathname's parent directory.
+  #
+  # @example
+  #   Pathname.new("path/to/file").parentname.to_s #=> "to"
+  #
+  # @return [Pathname]
+  def parentname
+    self.dirname.basename
+  end
+
+  # Alias of +Pathname#directory?+.
+  #
+  # @return [Boolean]
+  alias :dir? :directory?
+
+  # True if the directory indicated by the Pathname contains no other
+  # directories or files.
+  #
+  # @return [Boolean]
+  def dir_empty?
+    self.children(false).empty?
+  end
+
+  # Returns the immediate (non-recursive) child directories of the
+  # directory indicated by the Pathname.  Returned Pathnames are
+  # prefixed by the original Pathname.
+  #
+  # @return [Array<Pathname>]
+  def dirs
+    self.children.tap{|c| c.select!(&:dir?) }
+  end
+
+  # Returns the recursively descended child directories of the
+  # directory indicated by the Pathname.  Returned Pathnames are
+  # prefixed by the original Pathname.
+  #
+  # @return [Array<Pathname>]
+  def dirs_r
+    self.find.select(&:dir?).tap(&:shift)
+  end
+
+  # Returns the immediate (non-recursive) child files of the directory
+  # indicated by the Pathname.  Returned Pathnames are prefixed by the
+  # original Pathname.
+  #
+  # @return [Array<Pathname>]
+  def files
+    self.children.tap{|c| c.select!(&:file?) }
+  end
+
+  # Returns the recursively descended child files of the directory
+  # indicated by the Pathname.  Returned Pathnames are prefixed by the
+  # original Pathname.
+  #
+  # @return [Array<Pathname>]
+  def files_r
+    self.find.select(&:file?)
+  end
+
+  # Alias of +Pathname#mkpath+, but this method returns the Pathname.
+  #
+  # @return [Pathname]
+  def make_dir
+    self.mkpath
+    self
+  end
+
+  # Creates the parent (+dirname+) directories of the Pathname if they
+  # do not exist, and returns the Pathname.
+  #
+  # @return [Pathname]
+  def make_dirname
+    self.dirname.make_dir
+    self
+  end
+
+  # Updates the modification time (mtime) and access time (atime) of the
+  # file indicated by the Pathname, and returns the Pathname.  Creates
+  # the file and any necessary parent directories if they do not exist.
+  # See also +FileUtils.touch+.
+  #
+  # @return [Pathname]
+  def touch_file
+    self.make_dirname
+    FileUtils.touch(self)
+    self
+  end
+
+  # Recursively deletes the directory or file indicated by the Pathname,
+  # and returns the Pathname.  Similar to +Pathname#rmtree+, but does
+  # not raise an exception if the file does not exist.
+  #
+  # @return [Pathname]
+  def delete!
+    self.rmtree if self.exist?
+    self
+  end
+
+  # Moves the file indicated by Pathname to the given destination, and
+  # returns that destination as a Pathname.  Creates any necessary
+  # parent directories if they do not exist.
+  #
+  # @param destination [Pathname, String]
+  # @return [Pathname]
+  def move(destination)
+    destination = destination.to_pathname
+    destination.make_dirname
+    self.rename(destination)
+    destination
+  end
+
+  # Moves the file indicated by Pathname into the given directory, and
+  # returns the resultant path to the file as a Pathname.  Creates any
+  # necessary parent directories if they do not exist.
+  #
+  # @param directory [Pathname, String]
+  # @return [Pathname]
+  def move_into(directory)
+    self.move(directory / self.basename)
+  end
+
+  # Writes given text to the file indicated by the Pathname, and returns
+  # the Pathname.  The file is overwritten if it already exists.  Any
+  # necessary parent directories are created if they do not exist.
+  #
+  # @param text [String]
+  # @return [Pathname]
+  def write_text(text)
+    self.make_dirname.open('w'){|f| f.write(text) }
+    self
+  end
+
+  # Appends given text to the file indicated by the Pathname, and
+  # returns the Pathname.  The file is created if it does not exist.
+  # Any necessary parent directories are created if they do not exist.
+  #
+  # @param text [String]
+  # @return [Pathname]
+  def append_text(text)
+    self.make_dirname.open('a'){|f| f.write(text) }
+    self
+  end
+
+  # Writes given lines of text to the file indicated by the Pathname,
+  # and returns the Pathname.  A new line character (<code>$/</code>) is
+  # written after each line.  The file is overwritten if it already
+  # exists.  Any necessary parent directories are created if they do not
+  # exist.
+  #
+  # @param lines [Array<String>]
+  # @return [Pathname]
+  def write_lines(lines)
+    self.make_dirname.open('w'){|f| f.write_lines(lines) }
+    self
+  end
+
+  # Appends given lines of text to the file indicated by the Pathname,
+  # and returns the Pathname.  A new line character (<code>$/</code>) is
+  # written after each line.  The file is created if it does not exist.
+  # Any necessary parent directories are created if they do not exist.
+  #
+  # @param lines [Array<String>]
+  # @return [Pathname]
+  def append_lines(lines)
+    self.make_dirname.open('a'){|f| f.write_lines(lines) }
+    self
+  end
+
+  # Alias of +Pathname#read+.
+  #
+  # @return [String]
+  alias :read_text :read
+
+  # Reads from the file indicated by the Pathname all lines, and returns
+  # them as an array, end-of-line characters excluded.  The
+  # <code>$/</code> global string specifies what end-of-line characters
+  # to look for.  See also +IO#read_lines+.
+  #
+  # (Not to be confused with +Pathname#readlines+ which retains
+  # end-of-line characters in every string it returns.)
+  #
+  # @return [Array<String>]
+  def read_lines
+    self.open('r'){|f| f.read_lines }
+  end
+
+  # Reads the contents of the file indicated by the Pathname into memory
+  # as a string, and yields the string to the given block for editing.
+  # Writes the return value of the block back to the file, overwriting
+  # previous contents.  Returns the file's new contents.  See also
+  # +File.edit_text+.
+  #
+  # @example Update YAML data file
+  #   path.edit_text do |text|
+  #     data = YAML.load(text)
+  #     data['deeply']['nested']['key'] = 'new value'
+  #     data.to_yaml
+  #   end
+  #
+  # @yield [text] edits current file contents
+  # @yieldparam text [String] current contents
+  # @yieldreturn [String] new contents
+  # @return [String]
+  def edit_text(&block)
+    File.edit_text(self, &block)
+  end
+
+  # Reads the contents of the file indicated by the Pathname into memory
+  # as an array of lines, and yields the array to the given block for
+  # editing.  Writes the return value of the block back to the file,
+  # overwriting previous contents.  The <code>$/</code> global string
+  # specifies what end-of-line characters to use for both reading and
+  # writing.  Returns the array of lines that comprises the file's new
+  # contents.  See also +File.edit_lines+.
+  #
+  # @example Dedup lines of file
+  #   path.edit_lines(&:uniq)
+  #
+  # @yield [lines] edits current file contents
+  # @yieldparam lines [Array<String>] current contents
+  # @yieldreturn [Array<String>] new contents
+  # @return [Array<String>]
+  def edit_lines(&block)
+    File.edit_lines(self, &block)
+  end
+
+  # Appends the contents of another file to the destination indicated by
+  # Pathname.  Returns the destination Pathname.
+  #
+  # @param source [String, Pathname]
+  # @return [Pathname]
+  def append_file(source)
+    self.open('a'){|destination| IO::copy_stream(source, destination) }
+    self
+  end
+
+end

data/lib/pleasant_path/string.rb

@@ -0,0 +1,73 @@
+class String
+
+  # Converts the string to a +Pathname+ object.
+  #
+  # @return [Pathname]
+  def to_pathname
+    Pathname.new(self)
+  end
+
+  # Alias of +String#to_pathname+.
+  #
+  # @return [Pathname]
+  alias :path :to_pathname
+
+  # Joins the string and the argument with a directory separator (a la
+  # +File.join+) and returns the result as a +Pathname+ object.
+  #
+  # @example
+  #   ("path/to" / "file").to_s #=> "path/to/file"
+  #
+  # @param child [String]
+  # @return [Pathname]
+  def /(child)
+    self.path / child
+  end
+
+  # Treating the string as a path, joins the parent (+dirname+) of the
+  # path with the argument, and returns the result as a +Pathname+
+  # object.  The mnenomic for this operator is that the resultant path
+  # goes up one directory level from the original, then goes down to the
+  # directory specified by the argument.  See also +Pathname#^+.
+  #
+  # @example
+  #   ("path/to/file1" ^ "file2").to_s #=> "path/to/file2"
+  #
+  # @param sibling [Pathname, String]
+  # @return [Pathname]
+  def ^(sibling)
+    self.path ^ sibling
+  end
+
+  # Treats the string as a filename pattern, and expands the pattern
+  # into matching paths as +Pathname+ objects.  See also +Dir.glob+ and
+  # +Pathname.glob+.
+  #
+  # @return [Array<Pathname>]
+  def glob
+    Pathname.glob(self)
+  end
+
+  # Writes the string to the given file, and returns the string.  The
+  # file is overwritten if it already exists.  Any necessary parent
+  # directories are created if they do not exist.
+  #
+  # @param file [String, Pathname]
+  # @return [String]
+  def write_to_file(file)
+    file.to_pathname.write_text(self)
+    self
+  end
+
+  # Appends the string to the given file, and returns the string.  The
+  # file is created if it does not exist.  Any necessary parent
+  # directories are created if they do not exist.
+  #
+  # @param file [String, Pathname]
+  # @return [String]
+  def append_to_file(file)
+    file.to_pathname.append_text(self)
+    self
+  end
+
+end

data/lib/pleasant_path/version.rb

@@ -0,0 +1,3 @@
+module PleasantPath
+  VERSION = "1.0.0"
+end

data/pleasant_path.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'pleasant_path/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "pleasant_path"
+  spec.version       = PleasantPath::VERSION
+  spec.authors       = ["Jonathan Hefner"]
+  spec.email         = ["jonathan.hefner@gmail.com"]
+
+  spec.summary       = %q{A fluent API for pleasant file IO.}
+  spec.homepage      = "https://github.com/jonathanhefner/pleasant_path"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.13"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "minitest", "~> 5.0"
+  spec.add_development_dependency "yard", "~> 0.9"
+end

metadata

@@ -0,0 +1,114 @@
+--- !ruby/object:Gem::Specification
+name: pleasant_path
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Jonathan Hefner
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-11-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: 
+email:
+- jonathan.hefner@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/pleasant_path.rb
+- lib/pleasant_path/array.rb
+- lib/pleasant_path/file.rb
+- lib/pleasant_path/io.rb
+- lib/pleasant_path/pathname.rb
+- lib/pleasant_path/string.rb
+- lib/pleasant_path/version.rb
+- pleasant_path.gemspec
+homepage: https://github.com/jonathanhefner/pleasant_path
+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.8
+signing_key: 
+specification_version: 4
+summary: A fluent API for pleasant file IO.
+test_files: []