activeadmin-rails 1.7.0

data/CONTRIBUTING.md

@@ -0,0 +1,190 @@
+## Contributing
+
+This is probably not a beginner friendly project: it has a long history, complex functionality, 
+and too much cleverness, eg. metaprogramming.
+
+If you are using, or intending to use this project in production it would be great to hear about that in the discussions area.
+Fixes are welcome, if you have ideas for improvements reach out to the maintainer first.
+
+Translations and documentation tweaks are welcome, but not a priority, don't expect a quick response.
+
+Linting has become very popular in recent years, eg. rubocop, but depending on the team or project it can quickly
+become a couterproductive distraction.  By all means make suggestions, but don't expect a quick response.
+
+### 1. Where do I go from here?
+
+If you've noticed a bug or have a question that doesn't belong on the
+[mailing list][] or [Stack Overflow][], [search the issue tracker][] to see if
+someone else in the community has already created a ticket. If not, go ahead and
+[make one][new issue]!
+
+### 2. Fork & create a branch
+
+If this is something you think you can fix, then [fork Active Admin][] and
+create a branch with a descriptive name.
+
+A good branch name would be (where issue #325 is the ticket you're working on):
+
+```sh
+git checkout -b 325-add-japanese-translations
+```
+
+### 3. Get the test suite running
+
+Make sure you're using a recent ruby and have the `bundler` gem installed.
+
+Select the Gemfile for your preferred Rails version, preferably the latest:
+
+```sh
+export BUNDLE_GEMFILE=gemfiles/rails_71.gemfile
+```
+
+Now install the development dependencies:
+
+```sh
+bundle install
+```
+
+Now you should be able to run the entire suite using:
+
+```sh
+bundle exec rake
+```
+
+The test run will generate a sample Rails application in `spec/rails` to run the
+tests against.
+
+If your tests are passing locally but they're failing on GitHub, reset your test
+environment:
+
+```sh
+rm -rf spec/rails && bundle update
+```
+
+### 4. Did you find a bug?
+
+* **Ensure the bug was not already reported** by [searching all issues][].
+
+* If you're unable to find an open issue addressing the problem,
+  [open a new one][new issue]. Be sure to include a **title and clear
+  description**, as much relevant information as possible, and a **code sample**
+  or an **executable test case** demonstrating the expected behavior that is not
+  occurring.
+
+* If possible, use the relevant bug report templates to create the issue.
+  Simply copy the content of the appropriate template into a .rb file, make the
+  necessary changes to demonstrate the issue, and **paste the content into the
+  issue description**:
+  * [**ActiveAdmin** main issues][main template]
+
+### 5. Implement your fix or feature
+
+At this point, you're ready to make your changes! Feel free to ask for help.
+
+### 6. View your changes in a Rails application
+
+Active Admin is meant to be used by humans, not cucumbers. So make sure to take
+a look at your changes in a browser.
+
+To boot up a test Rails app:
+
+```sh
+bundle exec rake local server
+```
+
+This will automatically create a Rails app if none already exists, and store it
+in the `.test-rails-apps` folder.
+
+You should now be able to open <http://localhost:3000/admin> in your browser.
+You can log in using:
+
+*User*: admin@example.com
+*Password*: password
+
+If you need to perform any other commands on the test application, just pass
+them to the `local` rake task. For example, to boot the rails console:
+
+```sh
+bundle exec rake local console
+```
+
+Or to migrate the database:
+
+```sh
+bundle exec rake local db:migrate
+```
+
+### 7. Get the style right
+
+Your patch should follow the same conventions & pass the same code quality
+checks as the rest of the project. [Codeclimate][codeclimate] will give you
+feedback in this regard. You can check & fix codeclimate's feedback by running
+it locally using [Codeclimate's CLI][codeclimate cli], via `codeclimate analyze`.
+
+### 8. Make a Pull Request
+
+At this point, you should switch back to your main branch and make sure it's
+up to date with Active Admin's main branch:
+
+```sh
+git remote add upstream git@github.com:activeadmin/activeadmin.git
+git checkout main
+git pull upstream main
+```
+
+Then update your feature branch from your local copy of main, and push it!
+
+```sh
+git checkout 325-add-japanese-translations
+git rebase main
+git push --set-upstream origin 325-add-japanese-translations
+```
+
+Finally, go to GitHub and [make a Pull Request][] :D
+
+Travis CI will run our test suite against all supported Rails versions. We care
+about quality, so your PR won't be merged until all tests pass. It's unlikely,
+but it's possible that your changes pass tests in one Rails version but fail in
+another. In that case, you'll have to setup your development environment (as
+explained in step 3) to use the problematic Rails version, and investigate
+what's going on!
+
+### 8. Keeping your Pull Request updated
+
+If a maintainer asks you to "rebase" your PR, they're saying that a lot of code
+has changed, and that you need to update your branch so it's easier to merge.
+
+To learn more about rebasing in Git, there are a lot of [good][git rebasing]
+[resources][interactive rebase] but here's the suggested workflow:
+
+```sh
+git checkout 325-add-japanese-translations
+git pull --rebase upstream main
+git push --force-with-lease 325-add-japanese-translations
+```
+
+### 10. Merging a PR (maintainers only)
+
+A PR can only be merged into main by a maintainer if:
+
+* It is passing CI.
+* It has been approved by at least two maintainers. If it was a maintainer who
+  opened the PR, only one extra approval is needed.
+* It has no requested changes.
+* It is up to date with current main.
+
+Any maintainer is allowed to merge a PR if all of these conditions are
+met.
+
+[mailing list]: http://groups.google.com/group/activeadmin
+[Stack Overflow]: http://stackoverflow.com/questions/tagged/activeadmin
+[search the issue tracker]: https://github.com/activeadmin/activeadmin/issues?q=something
+[new issue]: https://github.com/activeadmin/activeadmin/issues/new
+[fork Active Admin]: https://help.github.com/articles/fork-a-repo
+[searching all issues]: https://github.com/activeadmin/activeadmin/issues?q=
+[main template]: https://github.com/varyonic/activeadmin/blob/main/lib/bug_report_templates/active_admin_main.rb
+[codeclimate]: https://codeclimate.com
+[codeclimate cli]: https://github.com/codeclimate/codeclimate
+[make a pull request]: https://help.github.com/articles/creating-a-pull-request
+[git rebasing]: http://git-scm.com/book/en/Git-Branching-Rebasing
+[interactive rebase]: https://help.github.com/articles/interactive-rebase

data/Gemfile

@@ -0,0 +1,51 @@
+source 'https://rubygems.org'
+
+gem 'arbo'
+
+# Optional dependencies
+gem 'cancan'
+gem 'pundit'
+gem 'jruby-openssl', '~> 0.10.1', platforms: :jruby
+
+# Utility gems used in both development & test environments
+gem 'rake'
+gem 'parallel_tests'
+
+# Debugging
+gem 'pry' # Easily debug from your console with `binding.pry`
+
+# Code style
+gem 'rubocop', '0.51.0'
+gem 'mdl', '0.4.0'
+
+# Translations
+gem 'i18n-tasks'
+
+# Documentation
+gem 'yard'                        # Documentation generator
+gem 'kramdown'                    # Markdown implementation (for yard)
+gem 'rexml'
+
+group :development, :test do
+  # Debugging
+  gem 'better_errors' # Web UI to debug exceptions. Go to /__better_errors to access the latest one
+
+  gem 'binding_of_caller', platforms: :mri # Retrieve the binding of a method's caller
+
+  # Performance
+  gem 'rack-mini-profiler' # Inline app profiler. See ?pp=help for options.
+end
+
+group :test do
+  gem 'cuprite'
+  gem 'capybara'
+  gem 'simplecov', require: false # Test coverage generator. Go to /coverage/ after running tests
+  gem 'codecov', require: false # Test coverage website. Go to https://codecov.io
+  gem 'cucumber-rails', github: 'cucumber/cucumber-rails', require: false
+  gem 'cucumber'
+  gem 'database_cleaner'
+  gem 'jasmine'
+  gem 'launchy'
+  gem 'rspec-rails'
+  gem 'i18n-spec'
+end

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) Greg Bell, VersaPay Corporation
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,84 @@
+# Active Admin for Rails Developers
+
+[Active Admin](https://www.activeadmin.org) is a Ruby on Rails framework for creating elegant backends for website administration.
+
+This is a significant fork of the original Active Admin project
+starting in 2018 with v1.3.1 and abandoning v2.0.0.alpha started one year earlier.
+
+This fork aims to make it simpler and more Rails-like without dropping the
+rich functionality that made Active Admin a leading choice for a decade.
+See [CHANGELOG] for more details.
+
+Active Admin is open source software, [free as in puppy].
+As of writing this software is in production with at least one mid-size business,
+but Varyonic has no plans to provide commercial support - let us know if you do.
+
+[![Version         ][rubygems_badge]][rubygems]
+[![Github Actions  ][actions_badge]][actions]
+[![Quality         ][codeclimate_badge]][codeclimate]
+[![Coverage        ][codecov_badge]][codecov]
+[![Inch CI         ][inch_badge]][inch]
+
+## Goals
+
+1. Enable developers to quickly create good-looking administration interfaces.
+2. Follow Rails conventions that make the framework easy to understand and customize.
+
+## Getting started
+
+* Check out [the docs][docs].
+* Try the [live demo][demo].
+* The [wiki] includes links to tutorials, articles and sample projects.
+
+## Need help?
+
+Please use [StackOverflow][stackoverflow] for help requests and how-to questions.
+
+Please open GitHub issues for bugs and enhancements only, not general help requests.
+Please search previous issues (and Google and StackOverflow) before creating a new issue.
+
+Google Groups, IRC #activeadmin and Gitter are not actively monitored.
+
+## Want to contribute?
+
+The [contributing guide][contributing]
+is a good place to start. If you have questions, feel free to ask.
+
+## Dependencies
+
+We try not to reinvent the wheel, so Active Admin is built with other open source projects:
+
+Tool                  | Description
+--------------------- | -----------
+[Arbo]                | HTML Views in Ruby.
+[Devise]              | Powerful, extensible user authentication
+[Formtastic]          | A Rails form builder plugin with semantically rich and accessible markup
+[Inherited Resources] | Simplifies controllers with pre-built RESTful controller actions
+[Kaminari]            | Elegant pagination for any sort of collection
+[Ransack]             | Provides a simple search API to query your data
+
+[Arbo]: https://github.com/varyonic/arbo
+[Devise]: https://github.com/plataformatec/devise
+[Formtastic]: https://github.com/justinfrench/formtastic
+[Inherited Resources]: https://github.com/activeadmin/inherited_resources
+[Kaminari]: https://github.com/kaminari/kaminari
+[Ransack]: https://github.com/activerecord-hackery/ransack
+
+[rubygems_badge]: http://img.shields.io/gem/v/activeadmin-rails.svg
+[rubygems]: https://rubygems.org/gems/activeadmin-rails
+[actions_badge]: https://github.com/varyonic/activeadmin/workflows/ci/badge.svg
+[actions]: https://github.com/varyonic/activeadmin/actions
+[codeclimate_badge]: https://api.codeclimate.com/v1/badges/1698787497cc7d4c7c88/maintainability
+[codeclimate]: https://codeclimate.com/github/varyonic/activeadmin/maintainability
+[codecov_badge]: https://codecov.io/gh/varyonic/activeadmin/branch/main/graph/badge.svg
+[codecov]: https://codecov.io/gh/varyonic/activeadmin
+[inch_badge]: http://inch-ci.org/github/varyonic/activeadmin.svg?branch=main
+[inch]: http://inch-ci.org/github/varyonic/activeadmin
+
+[docs]: http://activeadmin.org/0-installation.html
+[demo]: http://demo.activeadmin.org/admin
+[wiki]: https://github.com/varyonic/activeadmin/wiki
+[stackoverflow]: http://stackoverflow.com/questions/tagged/activeadmin
+[CHANGELOG]: https://github.com/varyonic/activeadmin/blob/main/CHANGELOG.md
+[contributing]: https://github.com/varyonic/activeadmin/blob/main/CONTRIBUTING.md
+[free as in puppy]: https://www.zdnet.com/article/open-source-free-as-in-beer-puppy-or-mattress/

data/Rakefile

@@ -0,0 +1,56 @@
+require 'bundler/gem_tasks'
+
+desc 'Creates a test rails app for the specs to run against'
+task :setup, [:parallel, :dir, :template] do |_t, opts|
+  require 'rails/version'
+
+  base_dir = opts[:dir] || 'spec/rails'
+  app_dir = "#{base_dir}/rails-#{Rails::VERSION::STRING}"
+  template = opts[:template] || 'rails_template'
+
+  if File.exist? app_dir
+    puts "test app #{app_dir} already exists; skipping"
+  else
+    system "mkdir -p #{base_dir}"
+    args = %W(
+      -m spec/support/#{template}.rb
+      --skip-bundle
+      --skip-listen
+      --skip-test-unit
+      --skip-coffee
+    )
+    args << "--skip-turbolinks" unless ENV['BUNDLE_GEMFILE'] =~ /turbolinks/
+    args << "--skip-hotwire" unless ENV['BUNDLE_GEMFILE'] =~ /hotwire/
+
+    command = ['bundle', 'exec', 'rails', 'new', app_dir, *args].join(' ')
+
+    env = { 'BUNDLE_GEMFILE' => ENV['BUNDLE_GEMFILE'] }
+    env['INSTALL_PARALLEL'] = 'yes' if opts[:parallel]
+
+    Bundler.with_unbundled_env { Kernel.exec(env, command) }
+
+    Rake::Task['parallel:after_setup_hook'].invoke if opts[:parallel]
+  end
+end
+
+# Import all our rake tasks
+FileList['tasks/**/*.rake'].each { |task| import task }
+
+task default: :test
+
+begin
+  require 'jasmine'
+  load 'jasmine/tasks/jasmine.rake'
+rescue LoadError
+  task :jasmine do
+    abort 'Jasmine is not available. In order to run jasmine, you must: (sudo) gem install jasmine'
+  end
+end
+
+task :console do
+  require 'irb'
+  require 'irb/completion'
+
+  ARGV.clear
+  IRB.start
+end

data/activeadmin-rails.gemspec

@@ -0,0 +1,39 @@
+require File.join(File.dirname(__FILE__), "lib", "active_admin", "version")
+
+Gem::Specification.new do |s|
+  s.name          = 'activeadmin-rails'
+  s.license       = 'MIT'
+  s.version       = ActiveAdmin::VERSION
+  s.homepage      = 'http://activeadmin.org'
+  s.authors       = ['Piers Chambers, Greg Bell']
+  s.email         = ['piers@varyonic.com']
+  s.description   = 'A rapid development framework for Ruby on Rails.'
+  s.summary       = 'A rapid development framework for Ruby on Rails.'
+
+  s.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(spec|features)/})
+  end
+
+  s.test_files = `git ls-files -- {spec,features}/*`.split("\n")
+
+  s.metadata = {
+    "bug_tracker_uri" => "https://github.com/varyonic/activeadmin-rails/issues",
+    "changelog_uri" => "https://github.com/varyonic/activeadmin-rails/blob/main/CHANGELOG.md",
+    "source_code_uri" => "https://github.com/varyonic/activeadmin-rails",
+  }
+
+  s.required_ruby_version = '>= 2.5'
+
+  s.add_dependency 'arbo'
+  s.add_dependency 'formtastic'
+  s.add_dependency 'formtastic_i18n'
+  s.add_dependency 'inherited_resources', '>= 1.13.1'
+  s.add_dependency 'jquery-rails', '>= 4.2.0'
+  s.add_dependency 'jquery-ui-rails', '~> 6.0'
+  s.add_dependency 'kaminari', '>= 1.0.1'
+  s.add_dependency 'railties', '>= 5.0'
+  s.add_dependency 'ransack', '>= 1.8.7'
+  s.add_dependency 'sass-rails'
+  s.add_dependency 'sprockets'
+  s.add_dependency 'sprockets-es6', '>= 0.9.2'
+end

data/app/assets/javascripts/active_admin/base.es6

@@ -0,0 +1,23 @@
+//= require jquery3
+//= require jquery-ui/widgets/datepicker
+//= require jquery-ui/widgets/dialog
+//= require jquery-ui/widgets/sortable
+//= require jquery-ui/widgets/tabs
+//= require jquery-ui/widget
+//= require jquery_ujs
+//= require_self
+//= require ./ext/jquery
+//= require ./ext/jquery-ui
+//= require ./lib/active_admin
+//= require ./lib/batch_actions
+//= require ./lib/dropdown-menu
+//= require ./lib/has_many
+//= require ./lib/modal_dialog
+//= require ./lib/per_page
+//= require ./lib/checkbox-toggler
+//= require ./lib/table-checkbox-toggler
+//= require ./initializers/datepicker
+//= require ./initializers/filters
+//= require ./initializers/tabs
+
+window.ActiveAdmin = {}

data/app/assets/javascripts/active_admin/ext/jquery-ui.es6

@@ -0,0 +1,7 @@
+// Short-circuits `_focusTabbable` to focus on the modal itself instead of
+// elements inside the modal. Without this, if a datepicker is the first input,
+// it'll immediately pop up when the modal opens.
+// See this ticket for more info: http://bugs.jqueryui.com/ticket/4731
+$.ui.dialog.prototype._focusTabbable = function() {
+  this.uiDialog.focus();
+};

data/app/assets/javascripts/active_admin/ext/jquery.es6

@@ -0,0 +1,9 @@
+// `serializeArray` generates => [{ name: 'foo', value: 'bar' }]
+// This function remaps it to => { foo: 'bar' }
+$.fn.serializeObject = function() {
+  return this.serializeArray()
+    .reduce((obj, item) => {
+      obj[item.name] = item.value
+      return obj
+    }, {});
+};

data/app/assets/javascripts/active_admin/initializers/datepicker.es6

@@ -0,0 +1,16 @@
+(($) => {
+
+  $(document)
+    .on('focus', 'input.datepicker:not(.hasDatepicker)', function() {
+      const input = $(this);
+
+      // Only create datepickers in compatible browsers
+      if (input[0].type === 'date') { return; }
+
+      const defaults = { dateFormat: 'yy-mm-dd' };
+      const options  = input.data('datepicker-options');
+
+      input.datepicker($.extend(defaults, options));
+    });
+
+})(jQuery);

data/app/assets/javascripts/active_admin/initializers/filters.es6

@@ -0,0 +1,45 @@
+(($, ActiveAdmin) => {
+
+  class Filters {
+
+    static _clearForm(event) {
+      const regex = /^(q\[|q%5B|q%5b|page|utf8|commit)/;
+      const params = ActiveAdmin
+        .queryStringToParams()
+        .filter(({name}) => !name.match(regex));
+
+      event.preventDefault();
+
+      if (ActiveAdmin.turbolinks) {
+        ActiveAdmin.turbolinksVisit(params);
+      } else {
+        window.location.search = ActiveAdmin.toQueryString(params);
+      }
+    }
+
+    static _disableEmptyInputFields(event) {
+      const params = $(this)
+        .find(':input')
+        .filter((i, input) => input.value === '')
+        .prop({ disabled: true })
+        .end()
+        .serializeArray();
+
+      if (ActiveAdmin.turbolinks) {
+        event.preventDefault();
+        ActiveAdmin.turbolinksVisit(params);
+      }
+    }
+
+    static _setSearchType() {
+      $(this).siblings('input').prop({name: `q[${this.value}]`});
+    }
+
+  }
+
+  $(document).
+    on('click', '.clear_filters_btn', Filters._clearForm).
+    on('submit', '.filter_form', Filters._disableEmptyInputFields).
+    on('change', '.filter_form_field.select_and_search select', Filters._setSearchType);
+
+})(jQuery, window.activeadmin);

data/app/assets/javascripts/active_admin/initializers/tabs.es6

@@ -0,0 +1,6 @@
+let onDOMReady = () =>
+  $('#active_admin_content .tabs').tabs()
+
+$(document).
+  ready(onDOMReady).
+  on('page:load turbolinks:load turbo:load', onDOMReady)

data/app/assets/javascripts/active_admin/lib/active_admin.es6

@@ -0,0 +1,41 @@
+((window, $) => {
+
+  class ActiveAdmin {
+
+    static get turbolinks() {
+      return (typeof Turbolinks !== 'undefined' && Turbolinks.supported);
+    }
+
+    static turbolinksVisit(params) {
+      const path = [window.location.pathname, '?', this.toQueryString(params)].join('')
+      Turbolinks.visit(path);
+    }
+
+    static queryString() {
+      return (window.location.search || '').replace(/^\?/, '');
+    }
+
+    static queryStringToParams() {
+      const decode = (value) => decodeURIComponent((value || '').replace(/\+/g, '%20'));
+
+      return this.queryString()
+        .split("&")
+        .map(pair => pair.split("="))
+        .map(([key, value]) => {
+          return { name: decode(key), value: decode(value) }
+        });
+    }
+
+    static toQueryString(params) {
+      const encode = (value) => encodeURIComponent(value || '');
+
+      return params
+        .map(({name, value}) => [ encode(name), encode(value) ])
+        .map(pair => pair.join('='))
+        .join('&')
+    }
+  }
+
+  window.activeadmin = ActiveAdmin
+
+})(window, jQuery);

data/app/assets/javascripts/active_admin/lib/batch_actions.es6

@@ -0,0 +1,59 @@
+const onDOMReady = function() {
+  // Detach any previously attached handlers before re-attaching them.
+  // This avoids double-registered handlers when Turbolinks is enabled
+  $('.batch_actions_selector li a').off('click confirm:complete');
+
+  //
+  // Use ActiveAdmin.modal_dialog to prompt user if
+  // confirmation is required for current Batch Action
+  //
+  $('.batch_actions_selector li a').on('click', function(event){
+    let message;
+    event.stopPropagation(); // prevent Rails UJS click event
+    event.preventDefault();
+    if ((message = $(this).data('confirm'))) {
+      ActiveAdmin.modal_dialog(message, $(this).data('inputs'), inputs => {
+        $(this).trigger('confirm:complete', inputs);
+      });
+    } else {
+      $(this).trigger('confirm:complete');
+    }
+  });
+
+  $('.batch_actions_selector li a').on('confirm:complete', function(event, inputs){
+    let val;
+    if ((val = JSON.stringify(inputs))) {
+      $('#batch_action_inputs').removeAttr('disabled').val(val);
+    } else {
+      $('#batch_action_inputs').attr('disabled', 'disabled');
+    }
+
+    $('#batch_action').val($(this).data('action'));
+    $('#collection_selection').submit();
+  });
+
+  //
+  // Add checkbox selection to resource tables and lists if batch actions are enabled
+  //
+
+  if ($(".batch_actions_selector").length && $(":checkbox.toggle_all").length) {
+
+    if ($(".paginated_collection table.index_table").length) {
+      $(".paginated_collection table.index_table").tableCheckboxToggler();
+    } else {
+      $(".paginated_collection").checkboxToggler();
+    }
+
+    $(document).on('change', '.paginated_collection :checkbox', function() {
+      if ($(".paginated_collection :checkbox:checked").length) {
+        $(".batch_actions_selector").each(function() { $(this).aaDropdownMenu("enable"); });
+      } else {
+        $(".batch_actions_selector").each(function() { $(this).aaDropdownMenu("disable"); });
+      }
+    });
+  }
+};
+
+$(document).
+  ready(onDOMReady).
+  on('page:load turbolinks:load turbo:load', onDOMReady);