absolutely 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d9b505d4787ad0998d9d275e566fe601dc553657
+  data.tar.gz: 4665126a8c9960502979c5d4dac82040eefc30a2
+SHA512:
+  metadata.gz: 9c7cbe7389db5618cb519b0c5791d75fce293c0f0ce36aa2954d1d391736fb32fcdea2d55a290e637153b74d6eb2bd5cd87993d1e3151bd0e021cc2077bdc9ac
+  data.tar.gz: 48c62d0900071f7cdbfa3e99c62c09d49cc7fd4bdea43bf77d23f2a2430ba5053c6bbdd1856f5ce2190febfe88d187d409b0f824196d150acb1d79281bfab5a7

data/.editorconfig

@@ -0,0 +1,14 @@
+# EditorConfig is awesome: http://EditorConfig.org
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_size = 2
+indent_style = space
+trim_trailing_whitespace = true
+
+[*.md]
+indent_size = 4
+indent_style = tab

data/.gitignore

@@ -0,0 +1,34 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+# Used by dotenv library to load environment variables.
+# .env
+
+# Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+# Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/.rspec

@@ -0,0 +1,2 @@
+--order random
+--require spec_helper

data/.rubocop

@@ -0,0 +1,3 @@
+--display-style-guide
+--extra-details
+--parallel

data/.rubocop.yml

@@ -0,0 +1,15 @@
+require:
+  - rubocop-rspec
+
+Metrics/BlockLength:
+  Exclude:
+    - spec/**/*.rb
+
+Metrics/LineLength:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+Style/FrozenStringLiteralComment:
+  Enabled: false

data/.ruby-version

@@ -0,0 +1 @@
+2.4.4

data/.simplecov

@@ -0,0 +1,11 @@
+require 'simplecov-console'
+
+formatters = [SimpleCov::Formatter::HTMLFormatter]
+
+if RSpec.configuration.files_to_run.length > 1
+  formatters << SimpleCov::Formatter::Console
+end
+
+SimpleCov.start do
+  formatter SimpleCov::Formatter::MultiFormatter.new(formatters)
+end

data/.travis.yml

@@ -0,0 +1,19 @@
+language: ruby
+rvm:
+  - 2.4.4
+  - 2.5.1
+cache: bundler
+before_script:
+  - curl -L https://codeclimate.com/downloads/test-reporter/test-reporter-latest-linux-amd64 > ./cc-test-reporter
+  - chmod +x ./cc-test-reporter
+  - ./cc-test-reporter before-build
+script:
+  - bundle exec rubocop
+  - bundle exec rake
+after_script:
+  - ./cc-test-reporter after-build --exit-code $TRAVIS_TEST_RESULT
+notifications:
+  email: false
+  slack:
+    rooms:
+      secure: HoydkS7DVdZ/qnOEZq1IhavrwpHaSMhGAUnWY1Vzrlb7szKukDQC5DVR0VfWfluJay/oNStdaJLeO026rCtUeI7mR+gi6kwWg71Bp/WnqNBpXU1e6NxgtenuYJyStY92lGOXQW8Ikz+FYs5Q48v4N2SjTHWw1F4TliN/MLx9Pw7TE3EOUmH7g75m3/DBsAkNqGPjGN5QaKZhTJS+o1TWkyYAswhwUeByQOPcPgx+QBhcAaCB/N75NkxPXcCWHY17BVYw4I1YZEtx+uyfq/+h1CtxyASZ7UP2uy/ZjVrqLEYbRLRKb+SgFRkt8yOk93BhmdpaizNicnvjZmWdbfKQ9GGYNo7pw5r7PbeqDIbU/dGsR4ZLUuBXrBWFd9XkK+DADt94aUp3WB4meXqwqeB5bHNAVoD8UqXfQ92Iy2UFcQcPIZ8OsQbrtSiFfJSVlbdhsA4MUAOQtbcoR6so7uuPuzvUGQQbq+YAPRAcVqnAtDc3b78hN1vCFn/napXVfa1kPnQdWh5VgYjXIhWaY3bLyg3/oetXz+9ExkBopoTsap37/uYweUqVC4T0gQSonRfpJnGVnqsqnZyqa0XxhUK/QmbcQC27rUx6OuzFLdJa3HEq1+jPW14qq4lsmD2uNG9x9ZWWuTzVpbjpziLZLXIX2nmy3R3Yh+n7Kq9YTIX50B8=

data/CONTRIBUTING.md

@@ -0,0 +1,37 @@
+# Contributing to Absolutely
+
+There are a couple ways you can help improve Absolutely:
+
+1. Fix an existing [issue][issues] and submit a [pull request][pulls].
+1. Review open [pull requests][pulls].
+1. Report a new [issue][issues]. _Only do this after you've made sure the behavior or problem you're observing isn't already documented in an open issue._
+
+## Getting Started
+
+Absolutely is developed using Ruby 2.4.4 and is additionally tested against Ruby 2.5.1 using [Travis CI](https://travis-ci.com/jgarber623/absolutely).
+
+Before making changes to Absolutely, you'll want to install Ruby 2.4.4. It's recommended that you use a Ruby version managment tool like [rbenv](https://github.com/rbenv/rbenv), [chruby](https://github.com/postmodern/chruby), or [rvm](https://github.com/rvm/rvm). Once you've installed Ruby 2.4.4 using your method of choice, install the project's gems by running:
+
+```sh
+bundle install
+```
+
+## Making Changes
+
+1. Fork and clone the project's repo.
+1. Install development dependencies as outlined above.
+1. Create a feature branch for the code changes you're looking to make: `git checkout -b my-new-feature`.
+1. _Write some code!_
+1. If your changes would benefit from testing, add the necessary tests and verify everything passes by running `bundle exec rspec`.
+1. Commit your changes: `git commit -am 'Add some new feature or fix some issue'`. _(See [this excellent article](https://chris.beams.io/posts/git-commit/) for tips on writing useful Git commit messages.)_
+1. Push the branch to your fork: `git push -u origin my-new-feature`.
+1. Create a new [pull request][pulls] and we'll review your changes.
+
+## Code Style
+
+Code formatting conventions are defined in the `.editorconfig` file which uses the [EditorConfig](http://editorconfig.org) syntax. There are [plugins for a variety of editors](http://editorconfig.org/#download) that utilize the settings in the `.editorconfig` file. We recommended you install the EditorConfig plugin for your editor of choice.
+
+Your bug fix or feature addition won't be rejected if it runs afoul of any (or all) of these guidelines, but following the guidelines will definitely make everyone's lives a little easier.
+
+[issues]: https://github.com/jgarber623/absolutely/issues
+[pulls]: https://github.com/jgarber623/absolutely/pulls

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Jason Garber
+
+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,97 @@
+# Absolutely
+
+**A Ruby gem for converting relative paths to absolute URIs.**
+
+[![Gem](https://img.shields.io/gem/v/absolutely.svg?style=for-the-badge)](https://rubygems.org/gems/absolutely)
+[![Downloads](https://img.shields.io/gem/dt/absolutely.svg?style=for-the-badge)](https://rubygems.org/gems/absolutely)
+[![Build](https://img.shields.io/travis/com/jgarber623/absolutely/master.svg?style=for-the-badge)](https://travis-ci.com/jgarber623/absolutely)
+[![Dependencies](https://img.shields.io/depfu/jgarber623/absolutely.svg?style=for-the-badge)](https://depfu.com/github/jgarber623/absolutely)
+[![Maintainability](https://img.shields.io/codeclimate/maintainability/jgarber623/absolutely.svg?style=for-the-badge)](https://codeclimate.com/github/jgarber623/absolutely)
+[![Coverage](https://img.shields.io/codeclimate/c/jgarber623/absolutely.svg?style=for-the-badge)](https://codeclimate.com/github/jgarber623/absolutely/code)
+
+## Key Features
+
+- Uses the [Addressable](https://github.com/sporkmonger/addressable) Ruby gem for improved URI parsing.
+- Supports Ruby 2.4 and newer.
+
+## Getting Started
+
+Before installing and using Absolutely, you'll want to have [Ruby](https://www.ruby-lang.org) 2.4 (or newer) installed. It's recommended that you use a Ruby version managment tool like [rbenv](https://github.com/rbenv/rbenv), [chruby](https://github.com/postmodern/chruby), or [rvm](https://github.com/rvm/rvm).
+
+Absolutely is developed using Ruby 2.4.4 and is additionally tested against Ruby 2.5.1 using [Travis CI](https://travis-ci.com/jgarber623/absolutely).
+
+## Installation
+
+If you're using [Bundler](https://bundler.io), add Absolutely to your project's `Gemfile`:
+
+```ruby
+source 'https://rubygems.org'
+
+gem 'absolutely'
+```
+
+…and hop over to your command prompt and run…
+
+```sh
+$ bundle install
+```
+
+## Usage
+
+### Basic Usage
+
+With Absolutely added to your project's `Gemfile` and installed, you may convert relative URIs to absolute URIs by doing:
+
+```ruby
+require 'absolutely'
+
+uri = Absolutely.uri(base: 'https://example.com', relative: '/foo').to_absolute_uri
+
+puts uri # returns String: 'https://example.com/foo'
+```
+
+This example combines the supplied `base` value (`https://example.com`) and combines it with the supplied `relative` value (`/foo`), returning the string `https://example.com/foo`.
+
+You may obtain the same results using this slightly shorter version:
+
+```ruby
+require 'absolutely'
+
+uri = Absolutely.to_absolute_uri(base: 'https://example.com', relative: '/foo')
+
+puts uri # returns String: 'https://example.com/foo'
+```
+
+### Advanced Usage
+
+Should the need arise, you may work directly with the `Absolutely::URI` class:
+
+```ruby
+require 'absolutely'
+
+uri = Absolutely::URI.new(base: 'https://example.com', relative: '/foo')
+
+puts uri                 # returns Absolutely::URI
+
+puts uri.base            # returns String: 'https://example.com'
+puts uri.relative        # returns String: '/foo'
+
+puts uri.base_uri        # returns Addressable::URI
+puts uri.relative_uri    # returns Addressable::URI
+
+puts uri.to_absolute_uri # returns String: 'https://example.com/foo'
+```
+
+The `base_uri` and `relative_uri` methods return instances of `Addressable::URI` for convenience. For more on this class' available methods, see [the Addressable Ruby gem's source code](https://github.com/sporkmonger/addressable).
+
+## Contributing
+
+Interested in helping improve Absolutely? Awesome! Your help is greatly appreciated. See [CONTRIBUTING.md](https://github.com/jgarber623/absolutely/blob/master/CONTRIBUTING.md) for details.
+
+## Acknowledgments
+
+Absolutely is written and maintained by [Jason Garber](https://sixtwothree.org).
+
+## License
+
+Absolutely is freely available under the [MIT License](https://opensource.org/licenses/MIT). Use it, learn from it, fork it, improve it, change it, tailor it to your needs.

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new
+
+task default: :spec

data/absolutely.gemspec

@@ -0,0 +1,32 @@
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'absolutely/version'
+
+Gem::Specification.new do |spec|
+  spec.required_ruby_version = ['>= 2.4', '< 2.6']
+
+  spec.name          = 'absolutely'
+  spec.version       = Absolutely::VERSION
+  spec.authors       = ['Jason Garber']
+  spec.email         = ['jason@sixtwothree.org']
+
+  spec.summary       = 'Convert relative paths to absolute URIs.'
+  spec.description   = spec.summary
+  spec.homepage      = 'https://github.com/jgarber623/absolutely'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(bin|spec)/}) }
+
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.16', '>= 1.16.2'
+  spec.add_development_dependency 'rake', '~> 12.3', '>= 12.3.1'
+  spec.add_development_dependency 'rspec', '~> 3.7'
+  spec.add_development_dependency 'rubocop', '~> 0.57.2'
+  spec.add_development_dependency 'rubocop-rspec', '~> 1.27'
+  spec.add_development_dependency 'simplecov', '~> 0.16.1'
+  spec.add_development_dependency 'simplecov-console', '~> 0.4.2'
+
+  spec.add_runtime_dependency 'addressable', '~> 2.5', '>= 2.5.2'
+end

data/lib/absolutely.rb

@@ -0,0 +1,17 @@
+require 'addressable/uri'
+
+require 'absolutely/version'
+require 'absolutely/error'
+require 'absolutely/uri'
+
+module Absolutely
+  class << self
+    def to_absolute_uri(base:, relative:)
+      uri(base: base, relative: relative).to_absolute_uri
+    end
+
+    def uri(base:, relative:)
+      URI.new(base: base, relative: relative)
+    end
+  end
+end

data/lib/absolutely/error.rb

@@ -0,0 +1,7 @@
+module Absolutely
+  class Error < StandardError; end
+
+  class ArgumentError < Error; end
+
+  class InvalidURIError < Error; end
+end

data/lib/absolutely/uri.rb

@@ -0,0 +1,32 @@
+module Absolutely
+  class URI
+    attr_accessor :base, :relative
+
+    def initialize(base:, relative:)
+      raise ArgumentError, "base must be a String (given #{base.class.name})" unless base.is_a?(String)
+      raise ArgumentError, "relative must be a String (given #{relative.class.name})" unless relative.is_a?(String)
+
+      @base = base
+      @relative = relative
+
+      raise ArgumentError, 'base must be an absolute URI (e.g. https://example.com)' unless base_uri.absolute?
+      raise ArgumentError, 'relative must be a relative URI (e.g. /example)' unless relative_uri.relative?
+    end
+
+    def base_uri
+      @base_uri ||= Addressable::URI.parse(base)
+    rescue Addressable::URI::InvalidURIError => error
+      raise InvalidURIError, error
+    end
+
+    def relative_uri
+      @relative_uri ||= Addressable::URI.parse(relative)
+    rescue Addressable::URI::InvalidURIError => error
+      raise InvalidURIError, error
+    end
+
+    def to_absolute_uri
+      (base_uri + relative_uri).to_s
+    end
+  end
+end

data/lib/absolutely/version.rb

@@ -0,0 +1,3 @@
+module Absolutely
+  VERSION = '0.1.0'.freeze
+end

metadata

@@ -0,0 +1,195 @@
+--- !ruby/object:Gem::Specification
+name: absolutely
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jason Garber
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-07-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.16'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.16.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.16.2
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 12.3.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 12.3.1
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.57.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.57.2
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.27'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.27'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.16.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.16.1
+- !ruby/object:Gem::Dependency
+  name: simplecov-console
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.2
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.5.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.5.2
+description: Convert relative paths to absolute URIs.
+email:
+- jason@sixtwothree.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".editorconfig"
+- ".gitignore"
+- ".rspec"
+- ".rubocop"
+- ".rubocop.yml"
+- ".ruby-version"
+- ".simplecov"
+- ".travis.yml"
+- CONTRIBUTING.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- absolutely.gemspec
+- lib/absolutely.rb
+- lib/absolutely/error.rb
+- lib/absolutely/uri.rb
+- lib/absolutely/version.rb
+homepage: https://github.com/jgarber623/absolutely
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.4'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: '2.6'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.14.1
+signing_key: 
+specification_version: 4
+summary: Convert relative paths to absolute URIs.
+test_files: []