uri_query_merger 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7dd1e01235f93b54b8de110e67c0e30f084ec198
+  data.tar.gz: 1125f9072f87cb77a226c6bf63ee9228bd31440f
+SHA512:
+  metadata.gz: efaef9b30289bd3d832d91c7b8ee7efb5f149b429b5b5856cd29c1bc49832055a9a0747fce8148fff9d006381b74a4ed01b08172e36249bcb8cb65d00ebcbef3
+  data.tar.gz: c7c2ec2c08fd08d3c09660bad22e98d12572f8bbddb7b13b28dbfc6c0a527f018a36a480b4c14e252f15bb321021aa89394d62ede0dbc8ddc503d163c5db3184

data/README.md

@@ -0,0 +1,63 @@
+# Rails Sort
+
+This gem provides some view helpers and a model for performing basic sorts on ActiveRecord models.
+
+This is just for consistency - so a consistent set of parameters are used for sorting. There's also a bunch of sorcery done so that the sort will remember search parameters and not clobber anything.
+
+## Usage
+
+Include a reference in your Gemfile:
+
+```ruby
+gem 'rails_sort', github: "thefrontiergroup/rails_sort"
+```
+
+In your view you can create a sortable heading that will provide a link to toggle the sorting options. Sorting is in the following recurring order:
+
+1. None
+2. Asc
+3. Desc
+
+The link that is returned will have a class attached to it indicating direction (none, "asc", or "desc"). You can use this to style the link appropriately (EG: up/down arrows)
+
+If you were on the index action for Users and you wanted to sort by email:
+
+```haml
+%table
+  %thead
+    %th= sortable_heading_for(:email, "Email")
+```
+
+Which will generate the following link:
+
+```
+<a href="http://localhost:3000?sort_attribute=email&sort_direction=asc">Email</a>
+```
+
+Clicking that link will pass the sort parameters through to your index action.
+
+You can use the RailsSort model to sort your collection. EG:
+
+```ruby
+def index
+  @users = User.all
+  @users = RailSort.sort(@users, params)
+end
+```
+
+You can pass through some default sort options that will be used if no sorting has been indicated by the user.
+
+```ruby
+def index
+  @users = User.all
+  @users = RailSort.sort(@users, params, {name: :asc})
+end
+```
+
+We also provide an ActiveRecord monkey patch that allows you to call sort directly on a collection:
+
+```ruby
+def index
+  @users = User.sort(params)
+end
+```

data/lib/uri_query_merger.rb

@@ -0,0 +1,24 @@
+class UriQueryMerger
+
+  attr_reader :params, :uri
+
+  def initialize(uri, params)
+    @params = params
+    @uri    = uri
+  end
+
+  def merge
+    new_uri = URI.parse(uri)
+    new_uri.query = merged_query
+    new_uri.to_s
+  end
+
+private
+
+  def merged_query
+    new_query = params.stringify_keys
+    new_query = new_query.reverse_merge(CGI.parse(URI.parse(uri).query)) if URI.parse(uri).query.present?
+    URI.encode_www_form(new_query.to_a)
+  end
+
+end

metadata

@@ -0,0 +1,61 @@
+--- !ruby/object:Gem::Specification
+name: uri_query_merger
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Jordan Maguire
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-12-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+description: Small class for merging a URL with existing params with a given set of
+  params
+email:
+- jordan@thefrontiergroup.com.au
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/uri_query_merger.rb
+homepage: https://github.com/jordanmaguire/uri_query_merger
+licenses:
+- WTFPL
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: Merge params into an existing URL easily
+test_files: []