# FasterPath

This project "WILL BE" a rewrite of Ruby's STDLIB **Pathname** optimized for speed and performance.
I am considering making it a \*nix OS gem, but that may likely just be an early phase.  Windows support
can be added much later.

The primary **GOAL** of this project is to improve performance in the Rails environment as path relation
and file lookup is a huge bottleneck in performance.  As this is the case the path performance updates
will likely not be limited to just changing Pathname but also will be offering changes in related methods
and classes.

Users will have the option to write their apps directly for this library, or they can choose to either
refine or monkeypatch the existing library.  Refinements are narrowed to scope and monkeypatching will
be a sledge hammer ;-)

**NOTE**: Refinements and monkeypatch methods are highly likely to be changed and renamed pre version
0.1.0 so keep that in mind!

## Installation

Add this line to your application's Gemfile:

```ruby
gem 'faster_path'
```

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install faster_path

## Usage

TODO: _(project is too young for usage details)_

## Development

After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).

## Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/danielpclark/faster_path.


## License

[MIT License](http://opensource.org/licenses/MIT) or APACHE 2.0 at your pleasure.