https://github.com/ess/absolution
A tiny ruby library for detecting/constructing absolute URLs
https://github.com/ess/absolution
Last synced: over 1 year ago
JSON representation
A tiny ruby library for detecting/constructing absolute URLs
- Host: GitHub
- URL: https://github.com/ess/absolution
- Owner: ess
- License: mit
- Created: 2014-05-05T10:51:39.000Z (about 12 years ago)
- Default Branch: develop
- Last Pushed: 2014-05-07T20:45:33.000Z (about 12 years ago)
- Last Synced: 2025-02-04T00:04:26.044Z (over 1 year ago)
- Language: Ruby
- Size: 262 KB
- Stars: 0
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: MIT-LICENSE
Awesome Lists containing this project
README
## Absolution ##
Want to know if a string is an absolute URL? Heck, want to construct an
absolute URL from a base URL and a path? This is your lucky day!
There's not much to this thing, and what's there exists only to serve the
needs that I've had for this sort of thing.
That said, pull requests are totally welcome :)
## Gem Setup ##
```ruby
gem install absolution
# Gemfile
gem 'absolution'
```
## Basic usage (class methods) ##
```ruby
require 'absolution'
Absolution.absolute_url?('blah')
=> false
Absolution.absolute_url?('/blah')
=> false
Absolution.absolute_url?('http://blah')
=> true
Absolution.construct_absolute_url('https://base.url', 'blah')
=> 'https://base.url/blah'
Absolution.construct_absolue_url('http://base.url/path/to/namespace', 'blah')
=> 'http://base.url/path/to/namespace/blah'
```
## Other usage (mixin) ##
Want a class to know how to do this stuff on its own?
```ruby
require 'absolution'
class SomeClass
include Absolution
def absolute_url_to(somefile)
return somefile if absolute_url?(somefile)
construct_absolute_url('http://base.url', somefile)
end
end
```
## Contributing ##
Do you use git-flow? I sure do. Please base anything you do off of
[the develop branch](https://github.com/ess/absolution/tree/develop).
1. Fork it.
2. Perform some BDD magic. Seriously. Be testing.
3. Submit a pull request.
## History ##
* 0.0.6 - Handle path in base URL
* 0.0.5 - Better relative path handling
* 0.0.4 - Query strings are handled properly
* 0.0.2 - Initial release
## License ##
MIT License. Copyright 2014 Dennis Walters