README.md

Furi

Furi is a Friendly URI parsing library. Furi's philosophy is to make any operation possible in ONE LINE OF CODE.

If there is an operation that takes more than one line of code to do with Furi, this is considered a terrible bug and you should create an issue.

Installation

Add this line to your application's Gemfile:

gem 'furi'

And then execute:

$ bundle

Or install it yourself as:

$ gem install furi

Usage

I'll say it again: any operation should take exacly one line of code! Here are basic:

Utility Methods

Parsing the URI fragments:

Furi.host("http://gusiev.com") # => "gusiev.com"
Furi.port("http://gusiev.com") # => nil
Furi.port!("http://gusiev.com") # => 80

Updating the URI parts:

Furi.update("http://gusiev.com", protocol: '') # => "//gusiev.com"
Furi.update("http://gusiev.com?source=google", query: {email: "[email protected]"})
    # => "http://gusiev.com?source=google&[email protected]"
Furi.replace("http://gusiev.com?source=google", query: {email: "[email protected]"})
    # => "http://[email protected]"

Furi.defaults("http://gusiev.com", subdomain: 'www') # => "http://www.gusiev.com"
Furi.defaults("http://blog.gusiev.com", subdomain: 'www') # => "http://blog.gusiev.com"

Building an URI from initial parts:

Furi.build(protocol: '//', host: 'gusiev.com', path: '/assets/application.js')
    # => "//gusiev.com/assets/application.js"

Furi.build(
  location: 'https://calendar.google.com',
  path: '/calendar/render',
  query: {
    action: 'TEMPLATE',
    text: 'Seven Figure Club Meeting',
    dates: [Time.now + 2.hours, Time.now + 3.hours].map do |t|
      t.strftime("%Y%m%dT%H%M%SZ")
    end.join('/'),
    details: 'Seven Figure Club invites to the discussion with other founders to one of the topics you have expressed your interest to.',
    add: ["[email protected]", "[email protected]"].join(',')
  }
)

Working with Object

uri = Furi.parse("gusiev.com")
    # => #<Furi::Uri "gusiev.com">

uri.port     # => nil
uri.port!    # => 80
uri.path     # => nil
uri.path!    # => '/'
uri.subdomain ||= 'www'
uri.protocol = "//" # protocol abstract URL

Processing Query String

uri = Furi.parse("/?person[first_name]=Bogdan&person[last_name]=Gusiev")

uri.query_string # => "person[first_name]=Bogdan&person[last_name]=Gusiev"
uri.query_tokens # => [person[first_name]=Bogdan, person[last_name]=Gusiev]
uri.query # => {person: {first_name: Bogdan, last_name: 'Gusiev'}}

uri.merge_query(person: {email: '[email protected]'})
    # => {person: {email: '[email protected]', first_name: Bogdan, last_name: 'Gusiev'}}

uri.merge_query(person: {email: '[email protected]'})
    # => {person: {email: '[email protected]', first_name: Bogdan, last_name: 'Gusiev'}}

Reference

                location                                            resource
                    |                                                ___|___
             _______|_______                                        /       \
            /               \                                      /         \
           /             authority                             request        \
          /        __________|_________                           |            \
         /        /                    \                    ______|______       \
        /    userinfo                hostinfo              /             \       \
       /       __|___                ___|___              /               \       \
      /       /      \              /       \            /                 \       \
     /   username  password       host      port       path               query   anchor
    /      __|___   __|__    ______|______   |  _________|__________     ____|____   |
   /      /      \ /     \  /             \ / \/                    \   /         \ / \
   http://username:[email protected]:80/hello/world/article.html?name=bogdan#info
    \_/                     \_/  \___/  \_/    \__________/\     /  \_/
     |                       |     |     |           |      \___/    |
  protocol             subdomain   | domainzone  directory    |   extension
                                   |     |                 filename  |
                             domainname  /                     \_____/
                                    \___/                         |
                                      |                          file
                                    domain

Originated from URI.js parsing library. Giving credit...

TODO

• Improve URI.join algorithm to match the one used in Addressable library
• Implement filename
• Encoding/Decoding special characters:
  • path
  • query
  • fragment

Contributing

Contribute in the way you want. Branch names and other bla-bla-bla do not matter.

License