administrate 0.0.2

data/lib/administrate/pages/base.rb

@@ -0,0 +1,28 @@
+module Administrate
+  module Page
+    class Base
+      def initialize(dashboard)
+        @dashboard = dashboard
+      end
+
+      def resource_name
+        @resource_name ||=
+          dashboard.class.to_s.scan(/(.+)Dashboard/).first.first.underscore
+      end
+
+      protected
+
+      def attribute_field(dashboard, resource, attribute_name, page)
+        value = resource.public_send(attribute_name)
+
+        dashboard.
+          field_class(attribute_name).
+          new(attribute_name, value, page)
+      end
+
+      protected
+
+      attr_reader :dashboard
+    end
+  end
+end

data/lib/administrate/pages/form.rb

@@ -0,0 +1,28 @@
+require_relative "base"
+
+module Administrate
+  module Page
+    class Form < Page::Base
+      def initialize(dashboard, resource)
+        super(dashboard)
+        @resource = resource
+      end
+
+      attr_reader :resource
+
+      def attributes
+        dashboard.form_attributes.map do |attribute|
+          attribute_field(dashboard, resource, attribute, :form)
+        end
+      end
+
+      def page_title
+        resource.to_s
+      end
+
+      protected
+
+      attr_reader :dashboard
+    end
+  end
+end

data/lib/administrate/pages/show.rb

@@ -0,0 +1,24 @@
+require_relative "base"
+
+module Administrate
+  module Page
+    class Show < Page::Base
+      def initialize(dashboard, resource)
+        super(dashboard)
+        @resource = resource
+      end
+
+      attr_reader :resource
+
+      def page_title
+        resource.to_s
+      end
+
+      def attributes
+        dashboard.show_page_attributes.map do |attr_name|
+          attribute_field(dashboard, resource, attr_name, :show)
+        end
+      end
+    end
+  end
+end

data/lib/administrate/pages/table.rb

@@ -0,0 +1,21 @@
+require_relative "base"
+
+module Administrate
+  module Page
+    class Table < Page::Base
+      def attribute_names
+        dashboard.table_attributes
+      end
+
+      def attributes_for(resource)
+        attribute_names.map do |attr_name|
+          attribute_field(dashboard, resource, attr_name, :index)
+        end
+      end
+
+      def to_partial_path
+        "/dashboard/table"
+      end
+    end
+  end
+end

data/lib/administrate/version.rb

@@ -0,0 +1,3 @@
+module Administrate
+  VERSION = "0.0.2"
+end

data/lib/generators/administrate/dashboard/USAGE

@@ -0,0 +1,9 @@
+Description:
+    Generates a Dashboard object for a model,
+    pulling the attributes from database columns.
+
+Example:
+    rails generate dashboard FooBar
+
+    This will create:
+        app/dashboards/foo_bar_dashboard.rb

data/lib/generators/administrate/dashboard/dashboard_generator.rb

@@ -0,0 +1,44 @@
+require "rails/generators/named_base"
+
+module Administrate
+  module Generators
+    class DashboardGenerator < Rails::Generators::NamedBase
+      source_root File.expand_path("../templates", __FILE__)
+
+      def create_dashboard_definition
+        template "dashboard.rb.erb", "app/dashboards/#{file_name}_dashboard.rb"
+      end
+
+      def create_resource_controller
+        template(
+          "controller.rb.erb",
+          "app/controllers/admin/#{file_name.pluralize}_controller.rb"
+        )
+      end
+
+      private
+
+      def attributes
+        klass.attribute_names + klass.reflections.keys
+      end
+
+      def field_type(attribute)
+        klass.type_for_attribute(attribute).type ||
+          association_type(attribute)
+      end
+
+      def association_type(attribute)
+        reflection = klass.reflections[attribute.to_s]
+        if reflection.collection?
+          :has_many
+        else
+          :belongs_to
+        end
+      end
+
+      def klass
+        @klass ||= Object.const_get(class_name)
+      end
+    end
+  end
+end

data/lib/generators/administrate/dashboard/templates/controller.rb.erb

@@ -0,0 +1,12 @@
+class Admin::<%= class_name.pluralize %>Controller < Admin::ApplicationController
+  # To customize the behavior of this controller,
+  # simply overwrite any of the RESTful actions. For example:
+  #
+  # def index
+  #   super
+  #   @resources = <%= class_name %>.all.paginate(10, params[:page])
+  # end
+
+  # See https://administrate-docs.herokuapp.com/customizing_controller_actions
+  # for more information
+end

data/lib/generators/administrate/dashboard/templates/dashboard.rb.erb

@@ -0,0 +1,50 @@
+require "administrate/base_dashboard"
+
+class <%= class_name %>Dashboard < Administrate::BaseDashboard
+
+  # This method returns a hash
+  # that describes the type of each of the model's fields.
+  #
+  # Each different type represents an Administrate::Field object,
+  # which determines how the attribute is displayed
+  # on pages throughout the dashboard.
+  def attribute_types
+    {<% attributes.each do |attr| %>
+      <%= attr %>: :<%= field_type(attr) %>,<% end %>
+    }
+  end
+
+  # This method returns an array of attributes
+  # that will be displayed on the model's index page.
+  def table_attributes
+    attributes
+  end
+
+  # This method returns an array of attributes
+  # that will be displayed on the model's show page
+  def show_page_attributes
+    attributes
+  end
+
+  # This method returns an array of attributes
+  # that will be displayed on the model's form pages (`new` and `edit`)
+  def form_attributes
+    attributes - read_only_attributes
+  end
+
+  private
+
+  def attributes
+    [<% attributes.each do |attribute| %>
+      :<%= attribute %>,<% end %>
+    ]
+  end
+
+  def read_only_attributes
+    [
+      :id,
+      :created_at,
+      :updated_at,
+    ]
+  end
+end

data/lib/generators/administrate/install/install_generator.rb

@@ -0,0 +1,52 @@
+Rails.application.eager_load!
+require "rails/generators/base"
+
+module Administrate
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("../templates", __FILE__)
+
+      def create_dashboard_controller
+        copy_file(
+          "application_controller.rb",
+          "app/controllers/admin/application_controller.rb"
+        )
+      end
+
+      def create_dashboard_manifest
+        template(
+          "dashboard_manifest.rb.erb",
+          "app/dashboards/dashboard_manifest.rb"
+        )
+      end
+
+      def insert_dashboard_routes
+        route(dashboard_routes)
+      end
+
+      private
+
+      def dashboard_resources
+        valid_dashboard_models.map do |model|
+          model.to_s.pluralize.underscore
+        end
+      end
+
+      def valid_dashboard_models
+        database_models.reject { |model| model.to_s.include?("::") }
+      end
+
+      def database_models
+        ActiveRecord::Base.descendants
+      end
+
+      def dashboard_routes
+        File.read(routes_file_path)
+      end
+
+      def routes_file_path
+        File.expand_path(find_in_source_paths("routes.rb"))
+      end
+    end
+  end
+end

data/lib/generators/administrate/install/templates/application_controller.rb

@@ -0,0 +1,13 @@
+# All Administrate controllers inherit from this `ApplicationController`,
+# making it the ideal place to put authentication logic or other
+# before_filters.
+#
+# If you want to add pagination or other controller-level concerns,
+# you're free to overwrite the RESTful controller actions.
+class Admin::ApplicationController < Administrate::ApplicationController
+  before_filter :authenticate_admin
+
+  def authenticate_admin
+    # TODO Add authentication logic here.
+  end
+end

data/lib/generators/administrate/install/templates/dashboard_manifest.rb.erb

@@ -0,0 +1,29 @@
+# DashboardManifest tells Administrate which dashboards to display
+class DashboardManifest
+  # `#dashboards`
+  # Returns a list of dashboards to display in the side navigation menu
+  #
+  # These are all of the rails models that we found in your database
+  # at the time you installed Administrate.
+  #
+  # To show or hide dashboards, add or remove the model name from this list.
+  # Dashboards returned from this method must be Rails models for Administrate
+  # to work correctly.
+  def dashboards
+    [
+<% dashboard_resources.each do |model| -%>
+      :<%= model %>,
+<% end -%>
+    ]
+  end
+
+  # `#root_dashboard`
+  # Returns the name of the dashboard that will be displayed
+  # at "http://your_site.com/admin"
+  #
+  # This dashboard will likely be the first page that admins see
+  # when they log into the dashboard.
+  def root_dashboard
+    dashboards.first
+  end
+end

data/lib/generators/administrate/install/templates/routes.rb

@@ -0,0 +1,7 @@
+namespace :admin do
+    DashboardManifest.new.dashboards.each do |dashboard_resource|
+      resources dashboard_resource
+    end
+
+    root controller: DashboardManifest.new.root_dashboard, action: :index
+  end

data/lib/tasks/administrate_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :administrate do
+#   # Task goes here
+# end

metadata

@@ -0,0 +1,179 @@
+--- !ruby/object:Gem::Specification
+name: administrate
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Grayson Wright
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-06-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+- !ruby/object:Gem::Dependency
+  name: neat
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: normalize-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: |
+  Administrate is heavily inspired by projects like Rails Admin and ActiveAdmin,
+  but aims to provide a better user experience for site admins,
+  and to be easier for developers to customize.
+
+  To do that, we're following a few simple rules:
+
+  - No DSLs (domain-specific languages)
+  - Support the simplest use cases,
+    and let the user override defaults with standard tools
+    such as plain Rails controllers and views.
+  - Break up the library into core components and plugins,
+    so each component stays small and easy to maintain.
+email:
+- grayson@thoughtbot.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- Rakefile
+- app/assets/javascripts/administrate/application.js
+- app/assets/javascripts/administrate/components/table.js
+- app/assets/stylesheets/administrate/_show.sass
+- app/assets/stylesheets/administrate/_sidebar.scss
+- app/assets/stylesheets/administrate/application.scss
+- app/assets/stylesheets/administrate/base/_base.scss
+- app/assets/stylesheets/administrate/base/_buttons.scss
+- app/assets/stylesheets/administrate/base/_forms.scss
+- app/assets/stylesheets/administrate/base/_grid-settings.scss
+- app/assets/stylesheets/administrate/base/_lists.scss
+- app/assets/stylesheets/administrate/base/_tables.scss
+- app/assets/stylesheets/administrate/base/_typography.scss
+- app/assets/stylesheets/administrate/base/_variables.scss
+- app/assets/stylesheets/administrate/base/extends/_button.scss
+- app/assets/stylesheets/administrate/base/extends/_clearfix.scss
+- app/assets/stylesheets/administrate/base/extends/_errors.scss
+- app/assets/stylesheets/administrate/base/extends/_flashes.scss
+- app/assets/stylesheets/administrate/base/extends/_hide-text.scss
+- app/assets/stylesheets/administrate/components/_components.scss
+- app/assets/stylesheets/administrate/components/_form.scss
+- app/assets/stylesheets/administrate/components/_header.scss
+- app/assets/stylesheets/administrate/components/_table.scss
+- app/assets/stylesheets/administrate/layout.scss
+- app/assets/stylesheets/administrate/mixins/_mixins.scss
+- app/assets/stylesheets/administrate/mixins/_shadow.scss
+- app/controllers/administrate/application_controller.rb
+- app/helpers/administrate/application_helper.rb
+- app/views/administrate/application/_flashes.html.erb
+- app/views/administrate/application/_form.html.erb
+- app/views/administrate/application/_javascript.html.erb
+- app/views/administrate/application/_sidebar.html.erb
+- app/views/administrate/application/_table.html.erb
+- app/views/administrate/application/edit.html.erb
+- app/views/administrate/application/index.html.erb
+- app/views/administrate/application/new.html.erb
+- app/views/administrate/application/show.html.erb
+- app/views/fields/form/_belongs_to.html.erb
+- app/views/fields/form/_email.html.erb
+- app/views/fields/form/_has_many.html.erb
+- app/views/fields/form/_image.html.erb
+- app/views/fields/form/_string.html.erb
+- app/views/fields/index/_belongs_to.html.erb
+- app/views/fields/index/_email.html.erb
+- app/views/fields/index/_has_many.html.erb
+- app/views/fields/index/_image.html.erb
+- app/views/fields/index/_string.html.erb
+- app/views/fields/show/_belongs_to.html.erb
+- app/views/fields/show/_email.html.erb
+- app/views/fields/show/_has_many.html.erb
+- app/views/fields/show/_image.html.erb
+- app/views/fields/show/_string.html.erb
+- app/views/layouts/administrate/application.html.erb
+- config/locales/administrate.en.yml
+- config/routes.rb
+- lib/administrate.rb
+- lib/administrate/base_dashboard.rb
+- lib/administrate/engine.rb
+- lib/administrate/fields/base.rb
+- lib/administrate/fields/belongs_to.rb
+- lib/administrate/fields/email.rb
+- lib/administrate/fields/has_many.rb
+- lib/administrate/fields/image.rb
+- lib/administrate/fields/string.rb
+- lib/administrate/namespace.rb
+- lib/administrate/pages/base.rb
+- lib/administrate/pages/form.rb
+- lib/administrate/pages/show.rb
+- lib/administrate/pages/table.rb
+- lib/administrate/version.rb
+- lib/generators/administrate/dashboard/USAGE
+- lib/generators/administrate/dashboard/dashboard_generator.rb
+- lib/generators/administrate/dashboard/templates/controller.rb.erb
+- lib/generators/administrate/dashboard/templates/dashboard.rb.erb
+- lib/generators/administrate/install/install_generator.rb
+- lib/generators/administrate/install/templates/application_controller.rb
+- lib/generators/administrate/install/templates/dashboard_manifest.rb.erb
+- lib/generators/administrate/install/templates/routes.rb
+- lib/tasks/administrate_tasks.rake
+homepage: https://administrate-docs.herokuapp.com/
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: A Rails engine for creating super-flexible admin dashboards
+test_files: []
+has_rdoc: