super 0.0.12 → 0.17.0

data/lib/super/link_builder.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Super
+  class LinkBuilder
+    def initialize(text, href, **options)
+      @text = text
+      @href = href
+      @options = options
+      @requirements = []
+      @requirements += gather_requirements(text)
+      @requirements += gather_requirements(href)
+      @requirements += gather_requirements(options)
+
+      unknown_arguments = @requirements - known_requirements
+      if unknown_arguments.any?
+        raise Error::ArgumentError, "Unknown arguments: #{unknown_arguments.join(", ")}"
+      end
+    end
+
+    attr_reader :requirements
+
+    def to_s(default_options: nil, **kwargs)
+      resolve(**kwargs).to_s(default_options: default_options)
+    end
+
+    def resolve(**kwargs)
+      Link.new(
+        into_value(@text, kwargs),
+        into_value(@href, kwargs),
+        **into_value(@options, kwargs),
+      )
+    end
+
+    private
+
+    def known_requirements
+      %i[params record].freeze
+    end
+
+    def gather_requirements(value_or_proc)
+      return [] if !value_or_proc.is_a?(Proc)
+
+      requirements =
+        value_or_proc
+          .parameters
+          .select { |(kind, name)| kind = :keyreq }
+          .map(&:last)
+    end
+
+    def into_value(value_or_proc, kwargs)
+      if value_or_proc.kind_of?(Proc)
+        value_or_proc.call(**kwargs)
+      else
+        value_or_proc
+      end
+    end
+  end
+end

data/lib/super/navigation.rb

@@ -0,0 +1,164 @@
+# frozen_string_literal: true
+
+module Super
+  class Navigation
+    def initialize
+      @builder = Builder.new
+      @definition = yield @builder
+      if !@definition.is_a?(Array)
+        @definition = [@definition]
+      end
+    end
+
+    def definition
+      return @defs if instance_variable_defined?(:@defs)
+
+      searcher = RouteFormatterButReallySearcher.new
+      inspector = ActionDispatch::Routing::RoutesInspector.new(Rails.application.routes.routes)
+      inspector.format(searcher)
+      all_matches = searcher.matches
+      unused_matches = all_matches.each_with_object({}) { |match, hash| hash[match] = true }
+
+      defs = expand_proc_syntax_sugar(@definition)
+      defs = validate_and_determine_explicit_links(defs, unused_matches)
+      @defs = expand_directives(defs, all_matches, unused_matches.keys)
+    end
+
+    private
+
+    # This expands the syntax sugar that allows `nav.menu("Name")[nav.link(Item)]`
+    def expand_proc_syntax_sugar(definition)
+      definition.map do |link_or_menu_or_rest_or_menuproc|
+        link_or_menu_or_rest =
+          if link_or_menu_or_rest_or_menuproc.is_a?(Proc)
+            link_or_menu_or_rest_or_menuproc.call
+          else
+            link_or_menu_or_rest_or_menuproc
+          end
+
+        if link_or_menu_or_rest.is_a?(Menu)
+          link_or_menu_or_rest.links = link_or_menu_or_rest.links.map do |menu_item|
+            if menu_item.is_a?(Proc)
+              menu_item.call
+            else
+              menu_item
+            end
+          end
+        end
+
+        link_or_menu_or_rest
+      end
+    end
+
+    def validate_and_determine_explicit_links(definition, unused_links)
+      definition.each do |link_or_menu_or_rest|
+        if link_or_menu_or_rest.is_a?(Super::Link)
+          unused_links.delete(link_or_menu_or_rest.href)
+        elsif link_or_menu_or_rest.is_a?(Menu)
+          link_or_menu_or_rest.links.each do |link_or_rest|
+            if link_or_rest.is_a?(Menu)
+              raise Super::Error::ArgumentError, "Navigation menus can't be nested"
+            end
+
+            if link_or_rest.is_a?(Link)
+              unused_links.delete(link_or_rest.href)
+            end
+          end
+        end
+      end
+    end
+
+    def expand_directives(defs, all_hrefs, rest_hrefs)
+      defs.flat_map do |link_or_menu_or_rest|
+        if link_or_menu_or_rest.is_a?(Menu)
+          link_or_menu_or_rest.links = link_or_menu_or_rest.links.flat_map do |link_or_rest|
+            if link_or_rest == ALL
+              linkify_hrefs(all_hrefs)
+            elsif link_or_rest == REST
+              linkify_hrefs(rest_hrefs)
+            else
+              link_or_rest
+            end
+          end
+
+          link_or_menu_or_rest
+        elsif link_or_menu_or_rest == ALL
+          linkify_hrefs(all_hrefs)
+        elsif link_or_menu_or_rest == REST
+          linkify_hrefs(rest_hrefs)
+        else
+          link_or_menu_or_rest
+        end
+      end
+    end
+
+    def linkify_hrefs(hrefs)
+      hrefs.map do |href|
+        Super::Link.new(href.split("/").last.humanize, href)
+      end
+    end
+
+    ALL = Object.new
+    REST = Object.new
+    Menu = Struct.new(:title, :links)
+
+    class Builder
+      def link(model, **kwargs)
+        text = model.model_name.human.pluralize
+        parts = Super::Link.polymorphic_parts(model)
+
+        Super::Link.new(text, parts, **kwargs)
+      end
+
+      def link_to(*args, **kwargs)
+        Super::Link.new(*args, **kwargs)
+      end
+
+      def menu(title, *links)
+        menu = Menu.new(title, links)
+        proc do |*more_links|
+          menu.links += more_links
+          menu
+        end
+      end
+
+      def rest
+        REST
+      end
+
+      def all
+        ALL
+      end
+    end
+
+    class RouteFormatterButReallySearcher
+      def initialize(route_namespace: Super.configuration.path)
+        @route_namespace = route_namespace.strip.gsub(%r{\A/+}, "").gsub(%r{/+\z}, "").strip
+        @route_namespace = "/#{@route_namespace}/"
+        @matches = []
+      end
+
+      def matches
+        @matches.map do |route|
+          route[:path].sub(/\(.*\)\Z/, "")
+        end
+      end
+
+      def section(routes)
+        @matches += routes.select do |route|
+          next false unless route[:verb] == "GET" || route[:verb] == ""
+          next false unless route[:path].start_with?(@route_namespace)
+          next false if route[:path].include?("/:")
+          next false if route[:reqs].end_with?("#new")
+
+          true
+        end
+      end
+
+      def header(routes); end
+      def no_routes(routes, filter); end
+      def result; end
+      def section_title(title); end
+    end
+  end
+end

data/lib/super/pagination.rb

@@ -76,52 +76,10 @@ module Super
     module ControllerMethods
       def index
         super
-        @pagination = controls.initialize_pagination(action: action_inquirer, records: @records, query_params: request.GET)
-        @records = controls.paginate_records(action: action_inquirer, records: @records, pagination: @pagination)
+        @pagination = initialize_pagination
+        @records = paginate_records
         @view.mains.first.parts.push(:@pagination)
       end
     end
   end
-
-  class Controls
-    module Optional
-      # Specifies how many records to show per page
-      #
-      # @param action [ActionInquirer]
-      # @param query_params [Hash]
-      # @return [ActiveRecord::Relation]
-      def records_per_page(action:, query_params:)
-        Super.configuration.index_records_per_page
-      end
-    end
-
-    module Steps
-      # Sets up pagination
-      #
-      # @param action [ActionInquirer]
-      # @param records [ActiveRecord::Relation]
-      # @param query_params [Hash]
-      # @return [Pagination]
-      def initialize_pagination(action:, records:, query_params:)
-        Pagination.new(
-          total_count: records.size,
-          limit: records_per_page(action: action, query_params: query_params),
-          query_params: query_params,
-          page_query_param: :page
-        )
-      end
-
-      # Paginates
-      #
-      # @param action [ActionInquirer]
-      # @param records [ActiveRecord::Relation]
-      # @param pagination [Pagination]
-      # @return [ActiveRecord::Relation]
-      def paginate_records(action:, records:, pagination:)
-        records
-          .limit(pagination.limit)
-          .offset(pagination.offset)
-      end
-    end
-  end
 end

data/lib/super/reset.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Super
+  module Reset
+    extend ActiveSupport::Concern
+
+    included do
+      undef_method :index
+      undef_method :show
+      undef_method :new
+      undef_method :create
+      undef_method :edit
+      undef_method :update
+      undef_method :destroy
+
+      Super::SubstructureController.private_instance_methods(false).each do |imethod|
+        next if imethod == :navigation
+        undef_method imethod
+      end
+    end
+  end
+end

data/lib/super/schema.rb

@@ -42,6 +42,10 @@ module Super
         enum_for(:each)
       end
 
+      def delete(key)
+        @backing.delete(key)
+      end
+
       def replace(other)
         @backing = other
       end

data/lib/super/useful/builder.rb

@@ -6,8 +6,8 @@ module Super
       def builder(method_name)
         alias_method("original_#{method_name}", method_name)
 
-        define_method(method_name) do
-          send("original_#{method_name}")
+        define_method(method_name) do |*args|
+          send("original_#{method_name}", *args)
           self
         end
       end
@@ -15,8 +15,8 @@ module Super
       def builder_with_block(method_name)
         alias_method("original_#{method_name}", method_name)
 
-        define_method(method_name) do |&block|
-          send("original_#{method_name}", &block)
+        define_method(method_name) do |*args, &block|
+          send("original_#{method_name}", *args, &block)
           self
         end
       end

data/lib/super/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Super
-  VERSION = "0.0.12"
+  VERSION = "0.17.0"
 end

data/lib/tasks/super/cheat.rake

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+namespace :super do
+  task :cheat do
+    require "super/cheat"
+    cheat = Super::Cheat.new
+    cheat.controller
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: super
 version: !ruby/object:Gem::Version
-  version: 0.0.12
+  version: 0.17.0
 platform: ruby
 authors:
 - Zach Ahn
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-04-04 00:00:00.000000000 Z
+date: 2021-06-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -220,14 +220,13 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".yardopts"
-- CONTRIBUTING.md
 - LICENSE
 - README.md
-- Rakefile
 - app/assets/config/super_manifest.js
 - app/assets/javascripts/super/application.js
 - app/assets/stylesheets/super/application.css
 - app/controllers/super/application_controller.rb
+- app/controllers/super/substructure_controller.rb
 - app/helpers/super/form_builder_helper.rb
 - app/views/layouts/super/application.html.erb
 - app/views/super/application/_collection_header.html.erb
@@ -236,16 +235,10 @@ files:
 - app/views/super/application/_display_rich_text.html.erb
 - app/views/super/application/_display_show.html.erb
 - app/views/super/application/_filter.html.erb
-- app/views/super/application/_filter_type_select.html.erb
-- app/views/super/application/_filter_type_text.html.erb
-- app/views/super/application/_filter_type_timestamp.html.erb
 - app/views/super/application/_flash.html.erb
 - app/views/super/application/_form.html.erb
+- app/views/super/application/_form_field.html.erb
 - app/views/super/application/_form_field__destroy.html.erb
-- app/views/super/application/_form_field_checkbox.html.erb
-- app/views/super/application/_form_field_rich_text_area.html.erb
-- app/views/super/application/_form_field_select.html.erb
-- app/views/super/application/_form_field_text.html.erb
 - app/views/super/application/_form_fieldset.html.erb
 - app/views/super/application/_form_has_many.html.erb
 - app/views/super/application/_form_has_one.html.erb
@@ -254,6 +247,8 @@ files:
 - app/views/super/application/_pagination.html.erb
 - app/views/super/application/_panel.html.erb
 - app/views/super/application/_query.html.erb
+- app/views/super/application/_site_footer.html.erb
+- app/views/super/application/_site_header.html.erb
 - app/views/super/application/_sort.html.erb
 - app/views/super/application/_sort_expression.html.erb
 - app/views/super/application/edit.html.erb
@@ -262,11 +257,9 @@ files:
 - app/views/super/application/nothing.html.erb
 - app/views/super/application/show.html.erb
 - app/views/super/feather/README.md
-- app/views/super/feather/_chevron_down.html
 - app/views/super/feather/_x.html
 - config/locales/en.yml
 - config/routes.rb
-- docs/cheat.md
 - frontend/super-frontend/dist/application.css
 - frontend/super-frontend/dist/application.js
 - lib/generators/super/action_text/USAGE
@@ -286,13 +279,11 @@ files:
 - lib/super.rb
 - lib/super/action_inquirer.rb
 - lib/super/assets.rb
+- lib/super/badge.rb
+- lib/super/cheat.rb
 - lib/super/client_error.rb
 - lib/super/compatibility.rb
 - lib/super/configuration.rb
-- lib/super/controls.rb
-- lib/super/controls/optional.rb
-- lib/super/controls/steps.rb
-- lib/super/controls/view.rb
 - lib/super/display.rb
 - lib/super/display/guesser.rb
 - lib/super/display/schema_types.rb
@@ -305,19 +296,22 @@ files:
 - lib/super/filter/schema_types.rb
 - lib/super/form.rb
 - lib/super/form/builder.rb
+- lib/super/form/field_transcript.rb
 - lib/super/form/guesser.rb
 - lib/super/form/inline_errors.rb
 - lib/super/form/schema_types.rb
 - lib/super/form/strong_params.rb
 - lib/super/layout.rb
 - lib/super/link.rb
-- lib/super/navigation/automatic.rb
+- lib/super/link_builder.rb
+- lib/super/navigation.rb
 - lib/super/pagination.rb
 - lib/super/panel.rb
 - lib/super/partial.rb
 - lib/super/partial/resolving.rb
 - lib/super/plugin.rb
 - lib/super/query/form_object.rb
+- lib/super/reset.rb
 - lib/super/schema.rb
 - lib/super/schema/common.rb
 - lib/super/schema/guesser.rb
@@ -326,6 +320,7 @@ files:
 - lib/super/useful/enum.rb
 - lib/super/version.rb
 - lib/super/view_helper.rb
+- lib/tasks/super/cheat.rake
 homepage:
 licenses:
 - LGPL-3.0-only
@@ -350,7 +345,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.4
+rubygems_version: 3.0.3.1
 signing_key:
 specification_version: 4
 summary: A simple, powerful, zero dependency Rails admin framework