godmin 1.5.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 0a7bcd5f755d209ec853fc0ce1464aa52041367b
-  data.tar.gz: 63b8a83f08ef476be9e328d361776a327f4077e5
+SHA256:
+  metadata.gz: 67092da8f88553787c49e63ffee072d0a6c3a726c8daec0f36b1f9e85db399b9
+  data.tar.gz: 04ed7ef417dbf573a0d882395a92cb8af1cf969a562c82b1b9d03710c23ad75d
 SHA512:
-  metadata.gz: f9dd7fec83fba49b6dddb6378c77a82c94c6d0ecd5e5b1ada53e9456207cbd5156380c446226deeeb14435dce61cb4bdfa6f65a8666c7dcd0d965ed332aac998
-  data.tar.gz: 4ab047ea311a45c24857b6ca5a71f6741705917892c58ca76016a37653501d752626400703a74ec8ae1c36d8e9415ed181eb74132e90a123cee324e59acf90b0
+  metadata.gz: d65bdb37843317f059d2ff74fc240e64fbfa91f8670f2c1a47982abcd6bc2d6598f51dbe80b245ff6d195c7bd388eda6db901c4c99ef986d37036c11aa089df7
+  data.tar.gz: 30b1c04eda1aa9990c2f6279db72de486f32787cea0ed2ce1d35e94b5b3c66a577e1b87b4beaba222c4066a5b12043ecf56547d28f1cf96b5341191e70dcbb90

data/.gitignore

@@ -23,6 +23,7 @@ config/initializers/secret_token.rb
 /test/dummy/log/*
 /test/dummy/tmp/*
 /test/dummy/db/*.sqlite3
+/test/tmp/*
 Gemfile.lock
 .tags
 gemfiles/.bundle

data/.travis.yml

@@ -4,17 +4,20 @@ script: "bundle exec rake test"
 sudo: false
 
 rvm:
-  - 2.1.0
-  - 2.3.1
+  - 2.2.2
+  - 2.3.5
+  - 2.5.1
 
 gemfile:
-  - gemfiles/rails_4.gemfile
   - gemfiles/rails_5.gemfile
+  - gemfiles/rails_6.gemfile
 
 matrix:
   exclude:
-    - rvm: 2.1.0
-      gemfile: gemfiles/rails_5.gemfile
+    - rvm: 2.2.2
+      gemfile: gemfiles/rails_6.gemfile
+    - rvm: 2.3.5
+      gemfile: gemfiles/rails_6.gemfile
 
 addons:
   code_climate:

data/Appraisals

@@ -1,7 +1,7 @@
-appraise "rails-4" do
-  gem "rails", "4.2.0"
-end
-
 appraise "rails-5" do
   gem "rails", "~> 5.0"
 end
+
+appraise "rails-6" do
+  gem "rails", "~> 6.0"
+end

data/CHANGELOG.md

@@ -1,10 +1,33 @@
 # Changelog
 
+### 2.0.0 - 2019-12-06
+
+Features
+- Allow skipping authorization per action (https://github.com/varvet/godmin/pull/231)
+
+Bug fixes
+- Support namespaced models when generating resources (https://github.com/varvet/godmin/issues/181)
+
+Other
+- Drop support for Rails 4 (https://github.com/varvet/godmin/pull/239)
+- Better policy lookups for namespaced models (https://github.com/varvet/godmin/pull/180)
+- Use Pundit for authorization (https://github.com/varvet/godmin/pull/180)
+- Rails 6 support (https://github.com/varvet/godmin/pull/248) and (https://github.com/varvet/godmin/pull/250)
+
+In order to upgrade
+- Upgrade to at least Rails 5 and Ruby 2.2.2
+- If using an admin engine, create a namespaced model for every resource, inheriting from the main app model
+- Replace any `authenticate_admin_user` with `authenticate`
+- Replace any `skip_before_action :authenticate_admin_user` with `prepend_before_action :disable_authentication`
+- Replace any `rescue_from NotAuthorizedError` with `rescue_from Pundit::NotAuthorizedError`
+
 ### 1.5.0 - 2017-02-17
+
 Features
 - Support for nested resources (https://github.com/varvet/godmin/pull/189)
 
 ### 1.4.0 - 2017-02-15
+
 Features
 - Support group queries in scopes and filters (https://github.com/varvet/godmin/pull/208)
 - Change color of remove buttons, so they're not grabbing all the attention (https://github.com/varvet/godmin/pull/212)
@@ -17,6 +40,7 @@ Other
 - Add table caption for tests (https://github.com/varvet/godmin/pull/187)
 
 ### 1.3.1 - 2016-09-27
+
 Bug fixes
 - Fix FileSystemResolver issue (https://github.com/varvet/godmin/pull/202)
 
@@ -24,6 +48,7 @@ Other
 - Update template for Rails 5 (https://github.com/varvet/godmin/commit/95e0a7917dd9767d77c3bfc876ebbf0a6036f347)
 
 ### 1.3.0 - 2016-07-11
+
 Features
 - Increased batch action checkbox click area (https://github.com/varvet/godmin/pull/183)
 - Adds titles to action links (https://github.com/varvet/godmin/pull/185)
@@ -39,6 +64,7 @@ Other
 - Adds caching partial overrides to increase table rendering speed (https://github.com/varvet/godmin/pull/184)
 
 ### 1.2.0 - 2016-02-02
+
 Features
 - Adds support for custom ordering of columns (https://github.com/varvet/godmin/pull/168)
 - Adds passing of options to association form helper (https://github.com/varvet/godmin/pull/172)
@@ -48,6 +74,7 @@ Bug fixes
 - Fixes an issue with the template resolver and Rails 4.2.5.1 (https://github.com/varvet/godmin/pull/175)
 
 ### 1.1.0 - 2015-12-08
+
 Features
 - Adds locale for pt-BR (Brazilian Portuguese) (https://github.com/varvet/godmin/pull/141)
 - New sandbox template with with more examples (https://github.com/varvet/godmin/pull/135)
@@ -60,22 +87,27 @@ Bug fixes
 - Fixes a namespace issue with the authentication generator (https://github.com/varvet/godmin/pull/150)
 
 ### 1.0.0 - 2015-11-13
+
 Release of 1.0.0 :tada:
 
 ### 0.12.4 - 2015-10-21
+
 Bug fixes
 - Fixes a bug which made it impossible to override the datetimepicker locale (https://github.com/varvet/godmin/issues/132)
 
 ### 0.12.3 - 2015-09-18
+
 Bug fixes
 - Adds support for plural engines (https://github.com/varvet/godmin/pull/128)
 - Remove turbolinks from application.js if present (https://github.com/varvet/godmin/issues/129)
 
 ### 0.12.2 - 2015-09-07
+
 Bug fixes
 - Fixes broken sign in page
 
 ### 0.12.1 - 2015-09-07
+
 Bug fixes
 - Fixes issue where column ordering on index table didn't work (https://github.com/varvet/godmin/issues/124)
 
@@ -83,17 +115,18 @@ Other
 - Adds integration tests
 - Removes the namespace config in `initializers/godmin.rb`
 
-In order to upgrade:
+In order to upgrade
 - Remove the `initializers/godmin.rb` file
 
 ### 0.12.0 - 2015-06-30
+
 Features
 - Adds new navigation helpers for building a custom navbar (https://github.com/varvet/godmin/issues/54)
 
 Other
 - Removes the godmin router method
 
-In order to upgrade:
+In order to upgrade
 - Remove the `godmin do` block from the `config/routes.rb` file
 - Specify a root route if there is none already
 - Create a `shared/_navigation.html.erb` partial if there is none already
@@ -102,10 +135,12 @@ Bug fixes
 - Fixes issue with authentication generator not modifying the application controller
 
 ### 0.11.2 - 2015-06-22
+
 Bug fixes
 - Fixes broken collection select helper
 
 ### 0.11.1 - 2015-05-20
+
 Features
 - Adds `destroy_resource` method to `ResourceService`
 - Adds query param to authorize
@@ -119,6 +154,7 @@ Bug fixes
 - Fixes a regression where filter labels were not translated
 
 ### 0.11.0 - 2015-04-13
+
 Other
 - Split resources into controllers and service objects (https://github.com/varvet/godmin/pull/79)
 - Renames the following modules:
@@ -127,18 +163,22 @@ Other
   - Godmin::Sessions -> Godmin::SessionsController
 
 ### 0.10.3 - 2015-02-18
+
 Bug fixes
 - Adds the possibility to pass options to the `date_field` and `datetime_field` form helpers
 
 ### 0.10.2 - 2015-02-16
+
 Bug fixes
 - Fixes standard resource params for multi-word models
 
 ### 0.10.1 - 2015-02-13
+
 Bug fixes
 - Fixes multi-select selectize issue (https://github.com/varvet/godmin/issues/71)
 
 ### 0.10.0 - 2015-02-11
+
 Features
 - Shows the number of items in each scope in the scope tab (https://github.com/varvet/godmin/issues/16)
 - Two new overridable methods for resources: `build_resource` and `find_resource`
@@ -155,21 +195,25 @@ Other
 - Restructured the locale files a bit
 
 ### 0.9.9 - 2015-01-23
+
 Features
 - Bump bootstrap to 3.3.3
 - Extracted button actions partial
 
 ### 0.9.8 - 2015-01-12
+
 Bug fixes
 - Created resources are now properly scoped by `resources_relation`
 - Fixes broken signin form
 
 ### 0.9.7 - 2015-01-07
+
 Features
 - Support for Rails 4.2
 - New form system (https://github.com/varvet/godmin/pull/50)
 
 ### 0.9.6 - 2014-12-18
+
 Features
 - Bundled [datetimepicker](https://github.com/Eonasdan/bootstrap-datetimepicker/)
 - Exposed JavaScript API
@@ -179,18 +223,22 @@ Notes
 - You can no longer use the `select-tag` class to initialize a select box
 
 ### 0.9.5 - 2014-12-15
+
 Bug fixes
 - Fixes Godmin::FormBuilder issue
 
 ### 0.9.4 - 2014-12-15
+
 Features
 - Added Godmin::FormBuilder
 
 ### 0.9.3 - 2014-12-10
+
 Bug fixes
 - Pagination offset fix
 
 ### 0.9.2 - 2014-12-09
+
 Features
 - Replaces select2 with [selectize](http://brianreavis.github.io/selectize.js/)
 - Adds flash messages (https://github.com/varvet/godmin/issues/26)
@@ -203,6 +251,7 @@ Bug fixes
 - Fixes default permitted params to work with multiword models.
 
 ### 0.9.1 - 2014-11-18
+
 Bug fixes
 - Removed rails executable from /bin folder.
 

data/Gemfile

@@ -12,4 +12,4 @@ gemspec
 
 # The dummy app loads whatever is specified in this gemfile, therefore
 # we add the admin engine used by the dummy app here
-gem "admin", path: "test/dummy/admin", group: [:test, :development]
+gem "admin", path: "test/dummy/admin", group: %i[test development]

data/README.md

@@ -4,7 +4,9 @@
 [![Build Status](https://img.shields.io/travis/varvet/godmin/master.svg)](https://travis-ci.org/varvet/godmin)
 [![Code Climate](https://img.shields.io/codeclimate/github/varvet/godmin.svg)](https://codeclimate.com/github/varvet/godmin)
 
-Godmin is an admin framework for Rails 4+. Use it to build dedicated admin sections for your apps, or stand alone admin apps such as internal tools. It has support for common features such as scoping, filtering and performing batch actions on your models. Check out the [demo app](http://godmin-sandbox.herokuapp.com) and its [source code](https://github.com/varvet/godmin-sandbox) to get a feel for how it works.
+**If you are looking for the current stable version, which is Rails 4+ compatible, see the [v1.5](https://github.com/varvet/godmin/tree/v1.5) branch**
+
+Godmin is an admin framework for Rails 5+. Use it to build dedicated admin sections for your apps, or stand alone admin apps such as internal tools. It has support for common features such as scoping, filtering and performing batch actions on your models. Check out the [demo app](http://godmin-sandbox.herokuapp.com) and its [source code](https://github.com/varvet/godmin-sandbox) to get a feel for how it works.
 
 Godmin differs from tools like [ActiveAdmin](http://activeadmin.info/) and [RailsAdmin](https://github.com/sferik/rails_admin) in how admin sections are created. Rather than being DSL-based, Godmin is a set of opt-in modules and helpers that can be applied to regular Rails apps and engines. An admin section built with Godmin is just that, a regular Rails app or Rails engine, with regular routes, controllers and views. That means there is less to learn, because you already know most of it, and fewer constraints on what you can do. After all, administrators are users too, and what better way to provide them with a tailor made experience than building them a Rails app?
 
@@ -143,6 +145,15 @@ It inserts a `navbar_item` in the `app/views/shared/_navigation.html.erb` partia
 <%= navbar_item Article %>
 ```
 
+If Godmin was installed inside an engine, it creates a model class:
+
+```ruby
+module Admin
+  class Article < ::Article
+  end
+end
+```
+
 It creates a controller:
 
 ```ruby
@@ -740,9 +751,19 @@ end
 
 The admin section is now authenticated using Devise.
 
+### Disable authentication
+
+If you want to disable authentication for a single controller or controller action, use the following `before_action`:
+
+```ruby
+class ArticlesController < ApplicationController
+  prepend_before_action :disable_authentication
+end
+```
+
 ## Authorization
 
-In order to enable authorization, authentication must first be enabled. See the previous section. The Godmin authorization system is heavily inspired by [Pundit](https://github.com/elabs/pundit) and implements the same interface.
+In order to enable authorization, authentication must first be enabled. See the previous section. The Godmin authorization system uses [Pundit](https://github.com/elabs/pundit).
 
 Add the authorization module to the application controller:
 
@@ -802,8 +823,8 @@ end
 That is, everyone can list and view articles, only editors can create them, and only unpublished articles can be updated and destroyed.
 
 ### Handle unauthorized access
-When a user is not authorized to access a resource, a `NotAuthorizedError` is raised. By default this error is rescued by Godmin and turned into a status code `403 Forbidden` response.
-If you want to change this behaviour you can rescue the error yourself in the appropriate `ApplicationController`:
+
+When a user is not authorized to access a resource, a `Pundit::NotAuthorizedError` is raised. By default this error is rescued by Godmin and turned into a status code `403 Forbidden` response. If you want to change this behaviour you can rescue the error yourself in the appropriate `ApplicationController`:
 
 ```ruby
 class ApplicationController < ActionController::Base
@@ -812,13 +833,14 @@ class ApplicationController < ActionController::Base
   include Godmin::Authorization
 
   # Renders 404 page and returns status code 404.
-  rescue_from NotAuthorizedError do
+  rescue_from Pundit::NotAuthorizedError do
     render file: "#{Rails.root}/public/404.html", status: 404, layout: false
   end
 end
 ```
 
 ### Override policy object
+
 If you wish to specify what policy to use manually, override the following method in your model. It does not have to be an ActiveRecord object, but any object will do.
 
 ```ruby
@@ -830,6 +852,7 @@ end
 ```
 
 ### Batch action authorization
+
 Batch actions must be authorized in your policy if you are using Godmin's built in authorization functionality. The policy method is called with the relation containing all records to be processed.
 
 ```ruby
@@ -840,6 +863,16 @@ class ArticlePolicy < Godmin::Authorization::Policy
 end
 ```
 
+### Disable authorization
+
+If you want to disable authorization for a single controller or controller action, use the following `before_action`:
+
+```ruby
+class ArticlesController < ApplicationController
+  prepend_before_action :disable_authorization
+end
+```
+
 ## Localization
 
 Godmin supports localization out of the box. For a list of translatable strings, [look here](https://github.com/varvet/godmin/blob/master/config/locales/en.yml).

data/Rakefile

@@ -39,11 +39,11 @@ namespace :sandbox do
     Bundler.with_clean_env do
       Dir.mktmpdir do |dir|
         Dir.chdir(dir)
-        system("git clone git@github.com:varvet/godmin-sandbox.git")
+        system("git clone https://github.com/varvet/godmin-sandbox.git")
         if $CHILD_STATUS.success?
           Dir.chdir("godmin-sandbox")
           system("rm -rf *")
-          system("rails new . -d postgresql -m #{template_path} --without-engine")
+          system("rails new . -d postgresql -m #{template_path} --without-engine --skip-spring")
           if $CHILD_STATUS.success?
             system("git add --all")
             system("git commit -m '#{message}'")

data/gemfiles/rails_5.gemfile

@@ -2,7 +2,7 @@
 
 source "https://rubygems.org"
 
-gem "admin", :path => "../test/dummy/admin", :group => [:test, :development]
+gem "admin", path: "../test/dummy/admin", group: [:test, :development]
 gem "rails", "~> 5.0"
 
-gemspec :path => "../"
+gemspec path: "../"

data/gemfiles/rails_6.gemfile

@@ -0,0 +1,8 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "admin", path: "../test/dummy/admin", group: [:test, :development]
+gem "rails", "~> 6.0"
+
+gemspec path: "../"

data/godmin.gemspec

@@ -10,8 +10,8 @@ Gem::Specification.new do |gem|
   gem.authors     = ["Jens Ljungblad", "Linus Pettersson", "Varvet"]
   gem.email       = ["info@varvet.se"]
   gem.homepage    = "https://github.com/varvet/godmin"
-  gem.summary     = "Godmin is an admin framework for Rails 4+"
-  gem.description = "Godmin is an admin framework for Rails 4+. Use it to build dedicated admin sections for your apps, or stand alone admin apps such as internal tools."
+  gem.summary     = "Godmin is an admin framework for Rails 5+"
+  gem.description = "Godmin is an admin framework for Rails 5+. Use it to build dedicated admin sections for your apps, or stand alone admin apps such as internal tools."
   gem.license     = "MIT"
 
   gem.files         = `git ls-files`.split($/)
@@ -19,22 +19,25 @@ Gem::Specification.new do |gem|
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.require_paths = ["lib"]
 
-  gem.add_dependency "bcrypt", "~> 3.1"
-  gem.add_dependency "bootstrap_form", "~> 2.4"
+  gem.add_dependency "bcrypt", [">= 3.0", "< 4.0"]
   gem.add_dependency "bootstrap-sass", "~> 3.3"
-  gem.add_dependency "coffee-rails", [">= 4.0", "< 6.0"]
+  gem.add_dependency "bootstrap_form", "~> 2.4"
   gem.add_dependency "csv_builder", "~> 2.1"
-  gem.add_dependency "jquery-rails", [">= 3.0", "< 5.0"]
+  gem.add_dependency "jquery-rails", [">= 4.0", "< 5.0"]
   gem.add_dependency "momentjs-rails", "~> 2.8"
-  gem.add_dependency "rails", [">= 4.2.0", "< 6.0"]
-  gem.add_dependency "sass-rails", [">= 4.0", "< 6.0"]
+  gem.add_dependency "pundit", [">= 1.1", "< 2.0"]
+  gem.add_dependency "rails", [">= 5.0", "< 7.0"]
+  gem.add_dependency "sass-rails", [">= 5.0", "< 7.0"]
   gem.add_dependency "selectize-rails", "~> 0.12"
 
-  gem.add_development_dependency "appraisal", "~> 0"
-  gem.add_development_dependency "capybara", "~> 0"
-  gem.add_development_dependency "minitest-reporters", "~> 0"
-  gem.add_development_dependency "minitest", "~> 0"
-  gem.add_development_dependency "poltergeist", "~> 0"
-  gem.add_development_dependency "pry", "~> 0"
-  gem.add_development_dependency "sqlite3", "~> 0"
+  gem.add_development_dependency "appraisal"
+  gem.add_development_dependency "bootsnap"
+  gem.add_development_dependency "byebug"
+  gem.add_development_dependency "capybara"
+  gem.add_development_dependency "minitest"
+  gem.add_development_dependency "minitest-reporters"
+  gem.add_development_dependency "poltergeist"
+  gem.add_development_dependency "pry"
+  gem.add_development_dependency "puma"
+  gem.add_development_dependency "sqlite3"
 end