deeplink 1.1.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a21bbaf6852dc00c19f67b03189a2a93a177d59770d34f9043c938c5c3f0290e
-  data.tar.gz: c84abb94d362c3c570b5f2a1c34f0f46c2baa7b5321fe8778b0abbd9cdb875d3
+  metadata.gz: 5258494e8891ca8dcd0e05f5d19002c981d0d7ec213e96a2a9f446d08e9622e7
+  data.tar.gz: 6d80c29a397aa832ca8618d37b9c67dec410cf977072a1b50928aae9c5766bd1
 SHA512:
-  metadata.gz: '08ddc30e29c89d2060d8094e4f08fb41b49aec4844c8642409fe57bd39c401d953fcdae46577893b4181eaaa580caba32a4f83cbcefe120ee158a239ca72baa7'
-  data.tar.gz: 1365b6073a48203e9da29451758f8c26cca7d09c2c8a8ebd95bcb01047c798db43192a1240ac4a906f8d45637fa15b8ce024f0fc0bbad267b1c66cbeea759493
+  metadata.gz: 897d7c31b35d1614539545155dd0403ce703ea34574868ea1ff55a8882c4fa6f203683f77c045b9a013e002cb98278ef138899a27341875416c57b4c3cdc7ef2
+  data.tar.gz: 58a3790de63fd53b4535c4ef3bdecdf9e70d13cbf2d9fb8477ccb7f51bbf4fb4b23c09a7fd987279601ba09b763963a578a45de57885904f4762eedd15018dc8

data/CHANGELOG.md

@@ -0,0 +1,64 @@
+# Changelog
+
+## 3.0.0 (2026-10-20)
+
+### Breaking changes
+
+- `query` returns decoded values (`a b` instead of `a+b`). Values are encoded only by `to_s`, and
+  query keys are now encoded too.
+- `add_query` with a `nil` value adds a parameter without a value (`?flag`) instead of `flag=`.
+
+### Fixes
+
+- Keep URL fragments (`deep://page#section`), available through `fragment`.
+- Keep query parameters without a value (`?flag`), stored with a `nil` value.
+- Encode query values that are not strings, such as symbols.
+- Parse links without a double slash (`deep:foo`, `deep:/foo`) instead of returning `''`.
+- Parse query values containing `{` or `}` in full.
+
+### Development
+
+- Add `changelog_uri` to the gem metadata and ship `CHANGELOG.md` with the gem.
+
+## 2.0.0 (2026-10-20)
+
+### Breaking changes
+
+- Require Ruby >= 3.2 (was >= 2.5).
+
+### Fixes
+
+- Support Ruby 4.0, which removed the CGI library. Query values are encoded exactly as before.
+- Already encoded query values are no longer double encoded (`?q=hello%20world` used to become
+  `q=hello%2520world`).
+- `remove_query` without keys returns `nil` instead of raising `NoMethodError`.
+
+### Development
+
+- CI tests Ruby 3.2, 3.3, 3.4 and 4.0, and runs RuboCop in a separate job.
+- Add Dependabot for GitHub Actions and Bundler.
+- Update development dependencies (RuboCop 1.92, RSpec 3.13, `debug` and `irb` instead of
+  `pry-byebug`).
+- `rake` runs the specs and RuboCop.
+
+## 1.1.0 (2020-05-01)
+
+- Drop support for Ruby 2.1.
+
+## 1.0.1 (2018-02-13)
+
+- Code style fixes.
+
+## 1.0.0 (2016-05-06)
+
+- First stable release.
+
+## 0.1.4 (2016-04-06)
+
+- Fix `NoMethodError` when parsing query parameters on Ruby < 2.1.
+
+## 0.1.3 (2015-12-11)
+
+- Fix parsing `nil` links.
+- Parse query parameters with unusual characters.
+- Allow removing a list of query parameters.

data/README.md

@@ -1,97 +1,125 @@
-[![Gem Version](https://badge.fury.io/rb/deeplink.svg)](https://badge.fury.io/rb/deeplink) [![Build Status](https://travis-ci.org/rikas/deeplink.svg?branch=master)](https://travis-ci.org/rikas/deeplink)
+[![Gem Version](https://badge.fury.io/rb/deeplink.svg)](https://badge.fury.io/rb/deeplink)
+[![CI](https://github.com/rikas/deeplink/actions/workflows/ci.yml/badge.svg)](https://github.com/rikas/deeplink/actions/workflows/ci.yml)
 
 # Deeplink
 
-Handle deep links in an easy way.
+Parse, inspect and build mobile deep links (`myapp://products/42?ref=email`) in an easy way.
 
-This gem needs ruby version >= 2.1
+Ruby's `URI` treats the first part after `://` as a host, so deep links like `myapp://products/42`
+end up with `products` as the host. This gem reads them the way apps do: a scheme, a path, a query
+and a fragment.
 
-## Installation
+This gem needs Ruby >= 3.2.
 
-Add this line to your application's Gemfile:
+## Installation
 
-```ruby
-gem 'deeplink'
+```sh
+bundle add deeplink
 ```
 
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
+Or install it yourself:
 
-    $ gem install deeplink
+```sh
+gem install deeplink
+```
 
 ## Usage
 
 ### Parsing a deep link
 
-Just call `Deeplink.parse` with a deep link String and then you can read the scheme and path.
+Call `Deeplink.parse` with a deep link string to read its scheme and path.
+
+```ruby
+deeplink = Deeplink.parse('myshop://products/42')
+
+deeplink.scheme # => "myshop"
+deeplink.path   # => "/products/42"
+deeplink.to_s   # => "myshop://products/42"
+```
+
+Links without a double slash are supported too:
 
 ```ruby
-deeplink = Deeplink.parse('foursquare://checkins/12932')
+deeplink = Deeplink.parse('sms:+351910000000?body=hello')
 
-deeplink.scheme # => "foursquare"
-deeplink.path   # => "/checkins/12932"
-deeplink.to_s   # => "foursquare://checkins/12932"
+deeplink.scheme # => "sms"
+deeplink.path   # => "+351910000000"
+deeplink.to_s   # => "sms:+351910000000?body=hello"
 ```
 
 ### Query string
 
-To get the query parameters of a link use `query` method.
+Use `query` to read the query parameters, and `query?` to check whether there are any.
 
 ```ruby
-deeplink = Deeplink.parse('foursquare://checkins/209823?test=true')
+deeplink = Deeplink.parse('myshop://products/42?ref=email')
 
-deeplink.query # => { :test => "true" }
+deeplink.query  # => { ref: "email" }
+deeplink.query? # => true
 ```
 
-#### Adding a query parameter
-
-You can add one or more query parameters sending a Hash to `add_query`.
+Values are stored decoded and only encoded again by `to_s`. Parameters without a value get a `nil`
+value.
 
 ```ruby
-deeplink = Deeplink.parse('foursquare://checkins/20982')
+deeplink = Deeplink.parse('myshop://search?q=running%20shoes&in_stock')
+
+deeplink.query # => { q: "running shoes", in_stock: nil }
+deeplink.to_s  # => "myshop://search?q=running+shoes&in_stock"
+```
+
+#### Adding query parameters
 
-deeplink.add_query(foo: 'bar') # => { :foo => "bar" }
-deeplink.to_s                  # => "foursquare://checkins/20982?foo=bar"
+Send a Hash with one or more parameters to `add_query`. Values are converted to strings.
 
-deeplink = Deeplink.parse('foursquare://checkins/20982')
+```ruby
+deeplink = Deeplink.parse('myshop://cart')
 
-deeplink.add_query(foo: 'bar', biz: 'baz') # => { :foo => "bar", :biz => "baz" }
-deeplink.to_s                              # => "foursquare://checkins/20982?foo=bar&biz=baz"
+deeplink.add_query(coupon: 'SUMMER 10', items: 3) # => { coupon: "SUMMER 10", items: "3" }
+deeplink.to_s                                     # => "myshop://cart?coupon=SUMMER+10&items=3"
 ```
 
-#### Removing a query parameter
+#### Removing query parameters
 
-To remove query parameters call `remove_query` with the key (or list of keys) that you want to
-remove. The method will return the value of the deleted key(s).
+Call `remove_query` with the key (or list of keys) to remove. It returns the value of the deleted
+key(s).
 
 ```ruby
-deeplink = Deeplink.parse('foursquare://checkins/20982?foo=bar')
+deeplink = Deeplink.parse('myshop://products/42?ref=email&utm_source=newsletter')
+
+deeplink.remove_query(:utm_source) # => "newsletter"
+deeplink.to_s                      # => "myshop://products/42?ref=email"
 
-deeplink.remove_query(:foo) # => "bar"
-deeplink.to_s               # => "foursquare://checkins/20982"
+deeplink.remove_query(:ref, :missing) # => ["email", nil]
+deeplink.to_s                         # => "myshop://products/42"
 ```
 
+### Fragment
+
+The fragment is available through `fragment`, and is kept as given (percent-encoded).
+
 ```ruby
-deeplink = Deeplink.parse('foursquare://checkins/20982?foo=bar&fu=baz')
+deeplink = Deeplink.parse('myshop://products/42#reviews')
 
-deeplink.remove_query(:foo, :fu) # => ["bar", "baz"]
-deeplink.to_s                    # => "foursquare://checkins/20982"
+deeplink.fragment # => "reviews"
+deeplink.to_s     # => "myshop://products/42#reviews"
 ```
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bundle exec rake`
+to run the tests and RuboCop. 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).
+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 `CHANGELOG.md`, 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/rikas/deeplink.
 
-
 ## License
 
-The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/deeplink/link.rb

@@ -1,13 +1,21 @@
 # frozen_string_literal: true
 
 require 'uri'
-require 'cgi'
+
+# Ruby 4.0 removed the CGI library; CGI.escape and CGI.unescape now live in cgi/escape.
+if RUBY_VERSION >= '4'
+  require 'cgi/escape'
+else
+  require 'cgi/util'
+end
 
 module Deeplink
   class Link
-    attr_accessor :scheme, :path
+    # The fragment is kept as given, so it should already be percent-encoded.
+    attr_accessor :scheme, :path, :fragment
 
-    # To add and remove items to the query string use #add_query and #remove_query
+    # Query values are stored decoded and only encoded by #to_s. To add and remove items to the
+    # query string use #add_query and #remove_query.
     attr_reader :query
 
     def initialize(uri)
@@ -16,9 +24,12 @@ module Deeplink
       uri = parse(uri)
 
       self.scheme = uri.scheme
-      self.path = uri.path
+      self.fragment = uri.fragment
 
-      @query = sanitize(parse_query(uri.query)) if uri.query
+      # Links without "//" (e.g. "deep:foo?a=1") are opaque, and URI leaves the query in there.
+      self.path, query_string = uri.opaque ? uri.opaque.split('?', 2) : [uri.path, uri.query]
+
+      @query = parse_query(query_string) if query_string
     end
 
     # Add query parameters to the link. You can add one or more parameters since this method
@@ -31,6 +42,8 @@ module Deeplink
     #   deeplink.add_query(lat: 38.7179233, lon: -9.150129)
     #
     #   deeplink.to_s # => "link://directions?lat=38.7179233&lon=-9.150129"
+    #
+    # Values are converted to strings. A nil value adds a parameter without a value ("?flag").
     def add_query(hash)
       @query ||= {}
 
@@ -50,11 +63,9 @@ module Deeplink
     def remove_query(*keys)
       return unless query
 
-      if keys.size > 1
-        keys.map { |key| query.delete(key.to_sym) }
-      else
-        query.delete(keys.first.to_sym)
-      end
+      values = keys.map { |key| query.delete(key.to_sym) }
+
+      keys.size > 1 ? values : values.first
     end
 
     # Returns true if the link has a query string or false otherwise
@@ -80,13 +91,9 @@ module Deeplink
     def to_s
       return '' unless scheme && path
 
-      uri = "#{scheme}:/#{path}"
-
-      if query?
-        query_string = query.map { |key, value| "#{key}=#{value}" }.join('&')
-
-        uri += "?#{query_string}"
-      end
+      uri = @double_slash ? "#{scheme}:/#{path}" : "#{scheme}:#{path}"
+      uri += "?#{query_string}" if query?
+      uri += "##{fragment}" if fragment
 
       uri
     end
@@ -94,34 +101,34 @@ module Deeplink
     private
 
     def parse(original_uri)
+      @double_slash = original_uri.match?(%r{\A[^:/?#]+://})
+
       # Because URI is dumb and thinks that every uri needs to have a host. Adding an extra slash
       # we are basically tricking URI to think that host is nil (and avoid errors).
-      uri = original_uri.sub(%r{://}, ':///')
+      uri = @double_slash ? original_uri.sub('://', ':///') : original_uri
 
       URI.parse(uri)
     end
 
     def sanitize(hash)
-      sanitized = {}
-
-      hash.each_key do |key|
-        value = hash[key].is_a?(String) ? CGI.escape(hash[key]) : hash[key].to_s
-
-        sanitized[key.to_sym] = value
-      end
-
-      sanitized
+      hash.to_h { |key, value| [key.to_sym, value&.to_s] }
     end
 
     def parse_query(query_str)
-      return unless query_str
+      query_str.split('&').each_with_object({}) do |pair, params|
+        key, value = pair.split('=', 2)
+        next if key.nil? || key.empty?
 
-      param_name_value_pairs = query_str.scan(/([^&=]+)=([^&{}#]*)/)
-      param_name_value_pairs.to_h
+        params[CGI.unescape(key).to_sym] = value && CGI.unescape(value)
+      end
     end
 
-    def array_to_h(array)
-      array.respond_to?(:to_h) ? array.to_h : Hash[*array.flatten]
+    def query_string
+      query.map do |key, value|
+        key = CGI.escape(key.to_s)
+
+        value.nil? ? key : "#{key}=#{CGI.escape(value)}"
+      end.join('&')
     end
   end
 end

data/lib/deeplink/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Deeplink
-  VERSION = '1.1.0'
+  VERSION = '3.0.0'
 end

metadata

@@ -1,105 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: deeplink
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Ricardo Otero
-autorequire: 
-bindir: exe
+bindir: bin
 cert_chain: []
-date: 2020-05-01 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.1'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.1'
-- !ruby/object:Gem::Dependency
-  name: pry-byebug
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 3.4.2
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 3.4.2
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 12.3.3
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 12.3.3
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 3.4.0
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 3.4.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 3.4.0
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 3.4.0
-- !ruby/object:Gem::Dependency
-  name: rubocop
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.50'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.50'
-- !ruby/object:Gem::Dependency
-  name: rubocop-rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.20'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.20'
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
 description: It mitigates the lack of support for mobile deep links on the URI module.
 email:
 - oterosantos@gmail.com
@@ -107,26 +16,20 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".rspec"
-- ".rubocop.yml"
-- ".ruby-version"
-- ".travis.yml"
-- Gemfile
+- CHANGELOG.md
 - LICENSE.txt
 - README.md
-- Rakefile
-- bin/console
-- bin/setup
-- deeplink.gemspec
 - lib/deeplink.rb
 - lib/deeplink/link.rb
 - lib/deeplink/version.rb
 homepage: https://github.com/rikas/deeplink
 licenses:
 - MIT
-metadata: {}
-post_install_message: 
+metadata:
+  source_code_uri: https://github.com/rikas/deeplink
+  bug_tracker_uri: https://github.com/rikas/deeplink/issues
+  changelog_uri: https://github.com/rikas/deeplink/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
@@ -134,15 +37,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Gem to manage deep links parsing.
 test_files: []

data/.gitignore

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

data/.rspec

@@ -1,4 +0,0 @@
---format documentation
---order rand
---color
---require spec_helper

data/.rubocop.yml

@@ -1,28 +0,0 @@
-require: rubocop-rspec
-
-# Configuration parameters: AllowURI, URISchemes.
-Metrics/LineLength:
-  Max: 100
-
-Style/Documentation:
-  Enabled: false
-
-# Assignment Branch Condition size.
-Metrics/AbcSize:
-  Max: 25
-
-# Don't force me to write unreadable tests, please.
-RSpec/PredicateMatcher:
-  Enabled: false
-
-# I like to write multiple expectations.
-RSpec/MultipleExpectations:
-  Enabled: false
-
-# Don't care about example length.
-RSpec/ExampleLength:
-  Enabled: false
-
-Metrics/BlockLength:
-  Exclude:
-    - 'spec/**'

data/.ruby-version

@@ -1 +0,0 @@
-2.6.5

data/.travis.yml

@@ -1,8 +0,0 @@
-language: ruby
-rvm:
-  - 2.2.2
-  - 2.3.0
-  - 2.4.3
-  - 2.5.8
-  - 2.6.5
-before_install: gem install bundler -v 1.13.6

data/Gemfile

@@ -1,6 +0,0 @@
-# frozen_string_literal: true
-
-source 'https://rubygems.org'
-
-# Specify your gem's dependencies in deeplink.gemspec
-gemspec

data/Rakefile

@@ -1,8 +0,0 @@
-# frozen_string_literal: true
-
-require 'bundler/gem_tasks'
-require 'rspec/core/rake_task'
-
-RSpec::Core::RakeTask.new(:spec)
-
-task default: :spec

data/bin/console

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-#!/usr/bin/env ruby
-
-require 'bundler/setup'
-require 'deeplink'
-
-require 'pry'
-Pry.start

data/bin/setup

@@ -1,7 +0,0 @@
-#!/bin/bash
-set -euo pipefail
-IFS=$'\n\t'
-
-bundle install
-
-# Do any other automated setup that you need to do here

data/deeplink.gemspec

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-lib = File.expand_path('../lib', __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-
-require 'deeplink/version'
-
-Gem::Specification.new do |spec|
-  spec.name          = 'deeplink'
-  spec.version       = Deeplink::VERSION
-  spec.authors       = ['Ricardo Otero']
-  spec.email         = ['oterosantos@gmail.com']
-
-  spec.summary       = 'Gem to manage deep links parsing.'
-  spec.description   = 'It mitigates the lack of support for mobile deep links on the URI module.'
-  spec.homepage      = 'https://github.com/rikas/deeplink'
-  spec.license       = 'MIT'
-
-  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(spec)/}) }
-  spec.bindir        = 'exe'
-  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ['lib']
-
-  spec.add_development_dependency 'bundler', '~> 2.1'
-  spec.add_development_dependency 'pry-byebug', '~> 3.4.2'
-  spec.add_development_dependency 'rake', '>= 12.3.3'
-  spec.add_development_dependency 'rspec', '~> 3.4.0', '>= 3.4.0'
-  spec.add_development_dependency 'rubocop', '~> 0.50'
-  spec.add_development_dependency 'rubocop-rspec', '~> 1.20'
-end