human_routes 0.0.6 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 599c1d4f7022f37dd7a8c87f89e01480c95ea8f04d89137034139d87beabd8a5
-  data.tar.gz: e26db1816cc2b383938b5f2adf7e5d6c1955c8d25996c0913a2bb7def1c8f61e
+  metadata.gz: b141f9a399978068f28f1756d0a575a893aaeb48d998ce3aecb641bb0648fb57
+  data.tar.gz: cf69b4906f02fad6d251ec3210e902961f27cea5e9f1e1757a947d8aca34ae9f
 SHA512:
-  metadata.gz: af48d012d17e2c1525a524c68e14e6a72f8626fd4804d9a9252b923850547bf39eefcfe54966410ef5fe1619f3c510d92cd0271691e9e29c43ad6c4a02193849
-  data.tar.gz: 789d18466d195a4afb4490567a38ad8c72d0f489b9485ffbb3a9c3cbcd2b09f63a58f49a5968b366ea07a28fca126ca191b663f5d1a43768c1d20b4fd08371c7
+  metadata.gz: 4023dccdbcfbd1be66d10124df81e4b1f75fb3daf354d309ce391b90fd4762701e33a28baa18a930bd0a56617729b656d020fad65d045828691f3e4d95913ac1
+  data.tar.gz: 4f4708fe090019fff8a630aa403b76a66d38480feccb26856cfb21559b3cda61a7fdced5d077cd896bdd0aaf48c9044d1d5c0bd0115bf149b119c29facd3c680

data/README.md

@@ -120,6 +120,7 @@ Rails.application.routes.draw do
   # This will generate the following routes:
   #
   # GET  /profile         profile_path
+  # GET  /profile/new     new_profile_path
   # POST /profile/new
   # GET  /profile/edit    edit_profile_path
   # POST /profile/edit
@@ -128,6 +129,21 @@ Rails.application.routes.draw do
   route "profile" do
     all
   end
+
+  # You can use `resource: true` when you want a plural route but need a
+  # singular resource.
+  #
+  # GET  /settings         settings_path
+  # GET  /settings/new     new_settings_path
+  # POST /settings/new
+  # GET  /settings/edit    edit_settings_path
+  # POST /settings/edit
+  # GET  /settings/remove  remove_settings_path
+  # POST /settings/remove
+  #
+  route "settings", resource: true do
+    all
+  end
 end
 ```
 
@@ -159,7 +175,7 @@ Rails.application.routes.draw do
 end
 ```
 
-For nested paths, you can use `:parent`:
+For nested paths, you can use `:prefix`:
 
 ```ruby
 Rails.application.routes.draw do
@@ -167,7 +183,7 @@ Rails.application.routes.draw do
     all
   end
 
-  route :comments, parent: "posts/:post_id" do
+  route :comments, prefix: "posts/:post_id" do
     remove #=> /posts/:post_id/comments/:id/remove
     list   #=> /posts/:post_id/comments
 
@@ -177,6 +193,21 @@ Rails.application.routes.draw do
 end
 ```
 
+If you need to change the url path, but point to a different controller, then
+use `:path_name`:
+
+```ruby
+Rails.application.routes.draw do
+  route :blogs do
+    all
+  end
+
+  route :blog_comments, path: "blogs/:blog_id", path_name: "comments" do
+    all
+  end
+end
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run

data/lib/human_routes/context.rb

@@ -16,11 +16,19 @@ module HumanRoutes
     end
 
     def singular_controller_name
-      @singular_controller_name ||= controller_name.singularize
+      @singular_controller_name ||= if options[:resource]
+                                      controller_name
+                                    else
+                                      controller_name.singularize
+                                    end
     end
 
     def resource?
-      controller_name == singular_controller_name
+      options[:resource] || controller_name == singular_controller_name
+    end
+
+    def path_name
+      options[:path_name] || controller_name
     end
 
     def routes
@@ -129,7 +137,7 @@ module HumanRoutes
       update
       remove
       show
-      list unless controller_name == controller_name.singularize
+      list unless resource?
     end
 
     def get(action, *args)
@@ -182,7 +190,7 @@ module HumanRoutes
       path = args.first || path_for(segment, route_options)
 
       path = [
-        route_options[:parent].to_s.split("/"),
+        route_options[:prefix].to_s.split("/"),
         path.to_s.split("/")
       ].flatten.compact
 
@@ -192,7 +200,12 @@ module HumanRoutes
 
       name = route_options.delete(:as) { default_name.underscore.tr("/", "_") }
 
-      route_options.delete(:bare)
+      %i[
+        bare
+        prefix
+        path_name
+        resource
+      ].each {|key| route_options.delete(key) }
 
       [path, name, route_options]
     end
@@ -216,7 +229,7 @@ module HumanRoutes
     end
 
     private def resource_segments(segment, _param, options)
-      segments = [controller_name]
+      segments = [path_name]
       segments << segment unless options[:bare]
       segments
     end
@@ -224,13 +237,13 @@ module HumanRoutes
     private def resources_segments(segment, param, _options)
       case segment
       when :list
-        [controller_name]
+        [path_name]
       when :new
-        [controller_name, segment]
+        [path_name, segment]
       when :show
-        [controller_name, ":#{param}"]
+        [path_name, ":#{param}"]
       else
-        [controller_name, ":#{param}", segment]
+        [path_name, ":#{param}", segment]
       end
     end
   end

data/lib/human_routes/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module HumanRoutes
-  VERSION = "0.0.6"
+  VERSION = "0.0.7"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: human_routes
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.7
 platform: ruby
 authors:
 - Nando Vieira
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-07-18 00:00:00.000000000 Z
+date: 2022-07-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails