super 0.0.0 → 0.0.5

data/lib/super/navigation/automatic.rb

@@ -0,0 +1,71 @@
+module Super
+  class Navigation
+    # Traverses the defined Rails Routes and attempts to build a list of links.
+    # This is used for building the nav bar on each admin page.
+    class Automatic
+      def initialize(route_namespace:)
+        route_namespace = route_namespace.to_s
+
+        if route_namespace.include?("/")
+          raise "Can't be nested namespace"
+        end
+
+        @route_namespace = route_namespace
+      end
+
+      def each
+        if !block_given?
+          return enum_for(:each)
+        end
+
+        navigable_namespace_routes = Rails.application.routes.routes.select do |route|
+          path_spec = route.path.spec
+
+          next if route.verb != "GET"
+          next if !path_spec.respond_to?(:right)
+          next if path_spec.right.left.to_s != @route_namespace
+          next if route.required_parts.any?
+          next if route.defaults.empty?
+
+          true
+        end
+
+        navigable_defaults = navigable_namespace_routes.map do |route|
+          controller_name = route.defaults[:controller] + "_controller"
+          _controller =
+            begin
+              controller_name.camelize.constantize
+            rescue NameError
+              warn("[super] Couldn't find controller: #{controller_name}")
+              next
+            end
+
+          route.defaults
+        end
+
+        grouped_navigable_defaults =
+          navigable_defaults.compact.uniq.group_by { |d| d[:controller] }
+
+        grouped_navigable_defaults.each do |controller, defaults|
+          actions = defaults.map { |d| [d[:action], d[:action]] }.to_h
+          action = actions["index"] || actions["show"]
+
+          next if action.nil?
+
+          path =
+            begin
+              Rails.application.routes.url_for(
+                controller: controller,
+                action: action,
+                only_path: true
+              )
+            rescue ActionController::UrlGenerationError
+              next
+            end
+
+          yield(controller.split("/").last.humanize, path)
+        end
+      end
+    end
+  end
+end

data/lib/super/pagination.rb

@@ -0,0 +1,70 @@
+module Super
+  class Pagination
+    include Enumerable
+
+    attr_reader :current_pageno
+    attr_reader :limit
+
+    def initialize(total_count:, limit:, query_params:, page_query_param:)
+      @total_count = total_count.to_i
+      @limit = limit.to_i
+      @query_params = query_params
+      @page_query_param = page_query_param
+
+      self.current_pageno = query_params[page_query_param]
+    end
+
+    def offset
+      limit * (current_pageno - 1)
+    end
+
+    def current_pageno=(pageno)
+      pageno = pageno.to_i
+
+      @current_pageno =
+        if pageno.zero?
+          1
+        else
+          pageno
+        end
+    end
+
+    def necessary?
+      pages > 1
+    end
+
+    def each
+      if !block_given?
+        return enum_for(:each)
+      end
+
+      (1..pages).each do |pageno|
+        is_current_page = pageno == current_pageno
+        display = pageno.to_s
+        page_query_params = @query_params.dup
+        if pageno == 1
+          page_query_params.delete(:page)
+        else
+          page_query_params[@page_query_param] = pageno
+        end
+
+        yield(page_query_params, is_current_page, display)
+      end
+    end
+
+    private
+
+    def pages
+      @pages ||=
+        begin
+          quotient, remainder = @total_count.divmod(@limit)
+
+          if remainder.zero?
+            quotient
+          else
+            quotient + 1
+          end
+        end
+    end
+  end
+end

data/lib/super/panel.rb

@@ -0,0 +1,17 @@
+module Super
+  class Panel
+    def initialize(*parts)
+      if block_given?
+        @parts = Array.new(yield)
+      end
+
+      @parts = parts
+    end
+
+    attr_reader :parts
+
+    def to_partial_path
+      "super_panel"
+    end
+  end
+end

data/lib/super/partial.rb

@@ -0,0 +1,11 @@
+module Super
+  class Partial
+    def initialize(path, locals: {})
+      @to_partial_path = path
+      @locals = locals
+    end
+
+    attr_reader :to_partial_path
+    attr_reader :locals
+  end
+end

data/lib/super/plugin.rb

@@ -0,0 +1,89 @@
+module Super
+  class Pluggable < Module
+    def initialize(registry_name)
+      @registry_name = registry_name
+    end
+
+    def included(base)
+      super
+
+      PluginRegistry.base_set(@registry_name, base)
+
+      plugins = PluginRegistry.plugins_for(@registry_name)
+
+      plugins.each do |klass, method_name|
+        base.public_send(method_name, klass)
+      end
+    end
+  end
+
+  class PluginRegistry
+    class << self
+      def include_to(name, klass)
+        plugin_push(name.to_sym, :include, klass)
+      end
+
+      def prepend_to(name, klass)
+        plugin_push(name.to_sym, :prepend, klass)
+      end
+
+      def plugins_for(name)
+        name = name.to_sym
+
+        plugins.fetch(name) { {} }
+      end
+
+      def base_set(name, klass)
+        name = name.to_sym
+
+        if !klass.kind_of?(Class)
+          raise Error::InvalidPluginArgument,
+            "Received `#{klass}` which must be a class"
+        end
+
+        bases[name] = klass
+
+        true
+      end
+
+      def base_get(name)
+        name = name.to_sym
+
+        bases[name]
+      end
+
+      private
+
+      def plugin_push(name, method_name, klass)
+        if ![:include, :prepend].include?(method_name)
+          raise Error::InvalidPluginArgument,
+            "Received `#{method_name.inspect}`, must be either :include or :prepend"
+        end
+
+        if !klass.kind_of?(Module)
+          raise Error::InvalidPluginArgument,
+            "Received `#{klass}` which must be a module"
+        end
+
+        plugins[name] ||= {}
+        plugins[name][klass] = method_name
+
+        base = base_get(name)
+
+        if base
+          base.public_send(method_name, klass)
+        end
+
+        true
+      end
+
+      def plugins
+        @plugins ||= {}
+      end
+
+      def bases
+        @bases ||= {}
+      end
+    end
+  end
+end

data/lib/super/schema.rb

@@ -0,0 +1,73 @@
+module Super
+  # The Schema is a general purpose container for describing the "schema"
+  # for various purposes. It primarily exists to provide a cohesive user-facing
+  # API for defining schemas.
+  #
+  # The various "schema types" are likely of more interest
+  class Schema
+    # @param schema_type [Display::SchemaTypes, Form::SchemaTypes]
+    def initialize(schema_type)
+      @schema_type = schema_type
+      @fields = Fields.new
+
+      if @schema_type.respond_to?(:setup)
+        @schema_type.setup(fields: @fields)
+      end
+
+      if block_given?
+        yield(@fields, @schema_type)
+      end
+    end
+
+    attr_reader :fields
+
+    def field_keys
+      fields.keys
+    end
+
+    class Fields
+      include Enumerable
+
+      def initialize
+        @backing = {}
+      end
+
+      def [](key)
+        @backing[key]
+      end
+
+      def []=(key, value)
+        @backing[key] = value
+      end
+
+      def keys
+        @backing.keys
+      end
+
+      def each
+        if block_given?
+          return @backing.each(&Proc.new)
+        end
+
+        enum_for(:each)
+      end
+
+      def replace(other)
+        @backing = other
+      end
+
+      def to_h
+        @backing
+      end
+
+      def nested
+        outside = @backing
+        inside = {}
+        @backing = inside
+        yield
+        @backing = outside
+        inside
+      end
+    end
+  end
+end

data/lib/super/step.rb

@@ -0,0 +1,36 @@
+module Super
+  module Step
+    module_function
+
+    def load_resources(controls, _params, action_inquirer)
+      controls.scope(action: action_inquirer)
+    end
+
+    def initialize_pagination(resources, query_params, limit: Super.configuration.index_resources_per_page)
+      Pagination.new(
+        total_count: resources.size,
+        limit: limit,
+        query_params: query_params,
+        page_query_param: :page
+      )
+    end
+
+    def paginate_resources(resources, pagination)
+      resources
+        .limit(pagination.limit)
+        .offset(pagination.offset)
+    end
+
+    def load_resource(controls, params, action_inquirer)
+      controls.scope(action: action_inquirer).find(params[:id])
+    end
+
+    def build_resource(controls, action_inquirer)
+      controls.scope(action: action_inquirer).build
+    end
+
+    def build_resource_with_params(controls, action_inquirer, create_permitted_params)
+      controls.scope(action: action_inquirer).build(create_permitted_params)
+    end
+  end
+end

data/lib/super/version.rb

@@ -1,3 +1,3 @@
 module Super
-  VERSION = '0.0.0'
+  VERSION = "0.0.5"
 end

data/lib/super/view_helper.rb

@@ -0,0 +1,43 @@
+module Super
+  module ViewHelper
+    module_function
+
+    # For example, calling `classes("always", ["sometimes", condition])` would
+    # return the string "always sometimes" or "always"
+    def classes(*list)
+      result = list.map do |c|
+        case c
+        when String
+          c
+        when Array
+          if c.size != 2
+            raise %(Expected exactly two elements (["class", some_condition]), got: #{c.inspect})
+          end
+
+          c if c.last
+        end
+      end
+
+      result.compact.join(" ")
+    end
+
+    def errors_accounting_for_reflections(model_instance, column_or_association)
+      errable_fields(model_instance, column_or_association)
+        .flat_map { |field| Compatability.rails_50_errable_fields(field) }
+        .flat_map { |field| model_instance.errors.full_messages_for(field) }
+        .uniq
+    end
+
+    def errable_fields(model_instance, column_or_association)
+      column_or_association = column_or_association.to_s
+      reflection = model_instance.class.reflect_on_association(column_or_association)
+      reflection ||= model_instance.class.reflections.values.find { |r| r.foreign_key == column_or_association }
+
+      if reflection
+        [reflection.name.to_s, reflection.foreign_key.to_s]
+      else
+        [column_or_association]
+      end
+    end
+  end
+end

metadata

@@ -1,43 +1,169 @@
 --- !ruby/object:Gem::Specification
 name: super
 version: !ruby/object:Gem::Version
-  version: 0.0.0
+  version: 0.0.5
 platform: ruby
 authors:
 - Zach Ahn
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-05-12 00:00:00.000000000 Z
+date: 2020-06-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 5.2.2
+        version: '5.0'
   type: :runtime
   prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: capybara
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+  type: :development
+  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.2.2
+        version: '3.18'
 - !ruby/object:Gem::Dependency
-  name: sqlite3
+  name: selenium-webdriver
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.142'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.142'
+- !ruby/object:Gem::Dependency
+  name: webdrivers
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.6
+        version: '4.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.6
+        version: '4.3'
+- !ruby/object:Gem::Dependency
+  name: puma
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest-ci
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: appraisal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: 
 email:
 - engineering@zachahn.com
@@ -45,18 +171,94 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- LICENSE.txt
+- ".yardopts"
+- 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/helpers/super/application_helper.rb
+- app/views/layouts/super/application.html.erb
+- app/views/super/application/_flash.html.erb
+- app/views/super/application/_form.html.erb
+- app/views/super/application/_form_field__destroy.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
+- app/views/super/application/_form_inline_errors.html.erb
+- app/views/super/application/_index.html.erb
+- app/views/super/application/_resource_header.html.erb
+- app/views/super/application/_resources_header.html.erb
+- app/views/super/application/_show.html.erb
+- app/views/super/application/_super_layout.html.erb
+- app/views/super/application/_super_panel.html.erb
+- app/views/super/application/edit.html.erb
+- app/views/super/application/index.html.erb
+- app/views/super/application/new.html.erb
+- 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.svg
 - config/routes.rb
+- docs/README.md
+- docs/controls.md
+- docs/faq.md
+- docs/quick_start.md
+- docs/webpacker.md
+- docs/yard_customizations.rb
+- frontend/super-frontend/build.js
+- frontend/super-frontend/dist/application.css
+- frontend/super-frontend/dist/application.js
+- frontend/super-frontend/package.json
+- frontend/super-frontend/postcss.config.js
+- frontend/super-frontend/src/javascripts/super/application.ts
+- frontend/super-frontend/src/javascripts/super/apply_template_controller.ts
+- frontend/super-frontend/src/javascripts/super/rails__ujs.d.ts
+- frontend/super-frontend/src/javascripts/super/toggle_pending_destruction_controller.ts
+- frontend/super-frontend/src/stylesheets/super/application.css
+- frontend/super-frontend/tailwind.config.js
+- frontend/super-frontend/tsconfig.json
+- frontend/super-frontend/yarn.lock
+- lib/generators/super/install/USAGE
+- lib/generators/super/install/install_generator.rb
+- lib/generators/super/install/templates/base_controller.rb.tt
+- lib/generators/super/install/templates/initializer.rb.tt
+- lib/generators/super/resource/USAGE
+- lib/generators/super/resource/resource_generator.rb
+- lib/generators/super/resource/templates/resources_controller.rb.tt
+- lib/generators/super/webpacker/USAGE
+- lib/generators/super/webpacker/templates/pack_super_application.js.erb.tt
+- lib/generators/super/webpacker/webpacker_generator.rb
 - lib/super.rb
+- lib/super/action_inquirer.rb
+- lib/super/assets.rb
+- lib/super/compatibility.rb
+- lib/super/configuration.rb
+- lib/super/controls.rb
+- lib/super/display.rb
+- lib/super/display/schema_types.rb
 - lib/super/engine.rb
+- lib/super/error.rb
+- lib/super/form/schema_types.rb
+- lib/super/layout.rb
+- lib/super/link.rb
+- lib/super/navigation/automatic.rb
+- lib/super/pagination.rb
+- lib/super/panel.rb
+- lib/super/partial.rb
+- lib/super/plugin.rb
+- lib/super/schema.rb
+- lib/super/step.rb
 - lib/super/version.rb
+- lib/super/view_helper.rb
 - lib/tasks/super_tasks.rake
 homepage: 
 licenses:
-- Fair Source 5
+- LGPL-3.0-only
 metadata: {}
 post_install_message: 
 rdoc_options: []
@@ -66,16 +268,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.1.3
 signing_key: 
 specification_version: 4
-summary: A simple, powerful, zero* dependency Rails admin framework
+summary: A simple, powerful, zero dependency Rails admin framework
 test_files: []