super 0.0.9 → 0.0.14

data/CONTRIBUTING.md

@@ -1,56 +0,0 @@
-# Contributing
-
-Thank you for thinking about contributing to Super!
-
-
-## General guidelines
-
-There are a few ground rules that to adhere to:
-
-* be friendly and patient,
-* be welcoming,
-* be considerate,
-* be respectful,
-* be careful in the words that you choose and be kind to others,
-* when we disagree, try to understand why.
-
-This isn't an exhaustive list of things that you can't do. Rather, take it in
-the spirit in which it's intended - a guide to make it easier to communicate and
-participate in the community.
-
-This applies to all spaces managed by the Super project.
-
-If you believe someone is violating the code of conduct, we ask that you report
-it by emailing: super+conduct at zachahn.com
-
-Offenders may be banned, asked to apologize, etc.
-
-(These guidelines are based on the [FreeBSD CoC][FreeBSD CoC], which in turn is
-based on [LLVM Project's draft CoC][LLVM CoC], which in turn is based on the
-[Django Project Code of Conduct][Django CoC], which is in turn based on wording
-from the Speak Up! project.)
-
-
-## Bug reports / issues
-
-1. Please tell us what version of Super, Ruby, and Rails you are using
-1. Please search the issues before posting your problem
-1. Please ask questions in a public place to benefit all Super users
-1. Please email security-related problems to super+security [at] zachahn.com
-
-
-## Feature requests / pull requests
-
-Contributors will need to sign a CLA. This isn't set up yet, so I won't be able
-to accept contributions.
-
-1. Please note that pull requests may be closed/denied for any reason.
-   Your feature may be better as its own repository. If so, I will link to your
-   project from the README!
-1. Please allow Super's contributors to modify your PR before merging.
-   It might make the process a bit smoother, but this isn't a necessity.
-
-
-[FreeBSD CoC]: https://www.freebsd.org/internal/code-of-conduct.html
-[LLVM CoC]: https://llvm.org/docs/CodeOfConduct.html
-[Django CoC]: https://www.djangoproject.com/conduct/

data/Rakefile

@@ -1,34 +0,0 @@
-begin
-  require 'bundler/setup'
-rescue LoadError
-  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
-end
-
-require 'rdoc/task'
-
-RDoc::Task.new(:rdoc) do |rdoc|
-  rdoc.rdoc_dir = 'rdoc'
-  rdoc.title    = 'Super'
-  rdoc.options << '--line-numbers'
-  rdoc.rdoc_files.include('README.md')
-  rdoc.rdoc_files.include('lib/**/*.rb')
-end
-
-require_relative "dummy_path"
-
-APP_RAKEFILE = File.expand_path("#{SUPER_DUMMY_PATH}/Rakefile", __dir__)
-load 'rails/tasks/engine.rake'
-
-load 'rails/tasks/statistics.rake'
-
-require 'bundler/gem_tasks'
-
-require 'rake/testtask'
-
-Rake::TestTask.new(:test) do |t|
-  t.libs << 'test'
-  t.pattern = 'test/**/*_test.rb'
-  t.verbose = false
-end
-
-task default: :test

data/STABILITY.md

@@ -1,50 +0,0 @@
-# Stability
-
-The table below shows the current progress towards API stability and the release
-of version 1.0.
-
-Note though that it is neither a comprehensive list nor a guarantee of
-stability.
-
-
-<table>
-<thead>
-<tr><th>Feature</th><th>Status</th></tr>
-</thead>
-<tbody>
-<tr><td>UI</td>                                             <td>❌</td></tr>
-<tr><td>Frontend JS</td>                                    <td>❌</td></tr>
-<tr><td><code>Super::ActionInquirer</code></td>             <td>✅</td></tr>
-<tr><td><code>Super::ApplicationController</code></td>      <td>✅</td></tr>
-<tr><td><code>Super::Assets</code></td>                     <td>🚧</td></tr>
-<tr><td><code>Super::ClientError</code></td>                <td>✅</td></tr>
-<tr><td><code>Super::Compatability</code></td>              <td>🙈</td></tr>
-<tr><td><code>Super::Configuration</code></td>              <td>🚧</td></tr>
-<tr><td><code>Super::Controls::Optional</code></td>         <td>✅</td></tr>
-<tr><td><code>Super::Controls::Required</code></td>         <td>✅</td></tr>
-<tr><td><code>Super::Controls::Steps</code></td>            <td>🚧</td></tr>
-<tr><td><code>Super::Controls</code></td>                   <td>✅</td></tr>
-<tr><td><code>Super::Display</code></td>                    <td>🤔</td></tr>
-<tr><td><code>Super::Engine</code></td>                     <td>🙈</td></tr>
-<tr><td><code>Super::Error</code></td>                      <td>✅</td></tr>
-<tr><td><code>Super::Filter</code></td>                     <td>❌</td></tr>
-<tr><td><code>Super::Form</code></td>                       <td>🤔</td></tr>
-<tr><td><code>Super::Layout</code></td>                     <td>🤔</td></tr>
-<tr><td><code>Super::Link</code></td>                       <td>✅</td></tr>
-<tr><td><code>Super::Navigation</code></td>                 <td>🤔</td></tr>
-<tr><td><code>Super::Pagination</code></td>                 <td>🤔</td></tr>
-<tr><td><code>Super::Panel</code></td>                      <td>🤔</td></tr>
-<tr><td><code>Super::Partial</code></td>                    <td>🤔</td></tr>
-<tr><td><code>Super::Plugin</code></td>                     <td>✅</td></tr>
-<tr><td><code>Super::ViewHelper</code></td>                 <td>❌</td></tr>
-</tbody>
-</table>
-
-
-### Legend
-
-* ✅ Tentatively stable. Further changes will probably be additive
-* 🚧 Likely upcoming breaking changes
-* ❌ Planned upcoming breaking changes
-* 🤔 Undecided
-* 🙈 Private API

data/app/views/super/application/_form_field_generic.html.erb

@@ -1,19 +0,0 @@
-<% if !local_assigns[:ungrouped] %>
-  <div class="super-field-group">
-<% end %>
-  <% if !local_assigns[:hide_label] %>
-    <%= form.label(column, class: "block") %>
-  <% end %>
-  <div class="<%= Super::ViewHelper.classes(["mt-1", !local_assigns[:hide_label]]) %>">
-    <%= form.public_send(
-      local_assigns.fetch(:form_builder_method),
-      column,
-      class: "super-input w-full"
-    ) %>
-    <% if !local_assigns[:hide_form_inline_errors] %>
-      <%= render "form_inline_errors", form: form, column: column %>
-    <% end %>
-  </div>
-<% if !local_assigns[:ungrouped] %>
-  </div>
-<% end %>

data/app/views/super/application/_form_inline_errors.html.erb

@@ -1,10 +0,0 @@
-<% if form.object %>
-  <% Super::ViewHelper.errors_accounting_for_reflections(form.object, column).each do |error_message| %>
-    <p class="text-red-400 text-xs italic pt-1"><%= error_message %></p>
-  <% end %>
-<% else %>
-  <p class="text-red-400 text-xs italic pt-1">
-    This form doesn't have an object, so something is probably wrong.
-    Maybe <code>accepts_nested_attributes_for</code> isn't set up?
-  </p>
-<% end %>

data/app/views/super/application/_super_schema_display_show.html.erb

@@ -1,8 +0,0 @@
-<table class="max-w-full mt-4">
-  <% super_schema_display_show.each_attribute_name do |attribute_name| %>
-    <tr>
-      <th class="py-1 align-baseline text-right px-4"><%= controls.model.human_attribute_name(attribute_name) %></th>
-      <td class="py-1 align-baseline"><%= super_schema_display_show.render_field(template: self, record: @record, column: attribute_name) %></td>
-    </tr>
-  <% end %>
-</table>

data/app/views/super/application/_super_schema_form.html.erb

@@ -1,15 +0,0 @@
-<%= form_for(Super.configuration.path_parts(@record), builder: Super::Form::Builder) do |f| %>
-  <div class="max-w-3xl">
-    <% super_schema_form.each_attribute do |field, type| %>
-      <%= render(
-        type,
-        form: f,
-        column: field
-      ) %>
-    <% end %>
-
-    <div>
-      <%= f.submit class: "super-button super-button--fill-blue mt-2" %>
-    </div>
-  </div>
-<% end %>

data/docs/README.md

@@ -1,8 +0,0 @@
-# Docs
-
-* [Quick Start](./quick_start.md)
-* [Installation](./installation.md)
-* [Webpacker](./webpacker.md)
-* [ActionText](./action_text.md)
-* [Cheat sheet](./cheat.md)
-* [FAQ](./faq.md)

data/docs/action_text.md

@@ -1,48 +0,0 @@
-<!--
-# @title ActionText
--->
-
-# Using ActionText with Super
-
-Super has some basic support for editing and viewing ActionText. Since
-ActionText only works with Webpacker, you'll have to set up Webpacker for your
-application. You can optionally set up [Super to use Webpacker](./webpacker.md).
-
-Once you've set that up, ActionText should be relatively simple. The following
-command will copy over the necessary JS and CSS into your application:
-
-```bash
-bundle exec rails generate super:action_text
-```
-
-As an example, let's say we're making admin pages for a blog. We'll keep this
-example simple and work with a `Post` model with just a `#title` column and
-a rich text `#content` field.
-
-```ruby
-class Post < ApplicationRecord
-  has_rich_text :content
-end
-```
-
-We'll need to configure the `#form_schema` and `#display_schema` methods.
-
-```ruby
-class Controls < Super::Controls
-  # ...
-
-  def form_schema(action:)
-    Super::Form.new do |fields, type|
-      fields[:title] = type.text
-      fields[:content] = type.rich_text_area
-    end
-  end
-
-  def display_schema(action:)
-    Super::Display.new(action: action) do |fields, type|
-      fields[:title] = type.text
-      fields[:content] = type.rich_text
-    end
-  end
-end
-```

data/docs/faq.md

@@ -1,44 +0,0 @@
-<!--
-# @title FAQ
--->
-
-# FAQ
-
-## How do I handle authorization?
-
-Assuming you already have authentication set up, it should only require defining
-a `Controls#initialize` that accepts an authenticated user. From there, you can
-customize `Controls#scope` to have the required behavior.
-
-```ruby
-class PostsController < AdminController
-  def new_controls
-    Controls.new(current_user)
-  end
-
-  class Controls < Super::Controls
-    def initialize(current_user)
-      @current_user = current_user
-    end
-
-    def model
-      Post
-    end
-
-    def scope(action:)
-      # Example: admins can read and write; others can only read
-      if @current_user.admin?
-        return model.all
-      end
-
-      if action.read?
-        return model.all
-      end
-
-      raise Super::ClientError::Forbidden
-    end
-
-    # ...
-  end
-end
-```

data/docs/installation.md

@@ -1,21 +0,0 @@
-<!--
-# @title Installation
--->
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-```ruby
-gem "super"
-```
-
-And then execute:
-
-```bash
-bundle install
-bundle exec rails generate super:install # check out the `--help` option!
-```
-
-If you prefer, you can configure Super to use Webpacker instead of Sprockets.
-Check out the [Webpacker guide](./webpacker.md).

data/docs/quick_start.md

@@ -1,30 +0,0 @@
-<!--
-# @title Quick start
--->
-
-# Quick start
-
-See [Installation](./installation.md) for the installation guide.
-
-
-## Usage
-
-### Creating new admin pages
-
-```bash
-bundle exec rails generate super:resource Thing # check out the `--help` option!
-```
-
-The example above will create a controller called `Admin::ThingsController`. It
-generates a `Controls` class inside the controller as well; it's where most
-configuration lives. See the documentation on [Controls](./controls.md) for more
-info.
-
-You'll have to manually update your routes file. It'll probably look something
-like the following:
-
-```ruby
-namespace :admin do
-  resources :things
-end
-```

data/docs/webpacker.md

@@ -1,25 +0,0 @@
-<!--
-# @title Webpacker
--->
-
-# Installation with Webpacker
-
-Super supports using Webpacker instead of Sprockets. You'll first need to set up
-Webpacker to handle ERB templates.
-
-After installing Super (see the [Installation guide](./installation.md)), run
-one the following:
-
-## Webpacker 4 and 5
-
-```bash
-bundle exec rails webpacker:install:erb # if you haven't already
-bundle exec rails generate super:webpacker
-```
-
-## Webpacker 6
-
-```bash
-yarn add rails-erb-loader # if you haven't already
-bundle exec rails generate super:webpacker
-```

data/docs/yard_customizations.rb

@@ -1,41 +0,0 @@
-require "yard"
-
-module FixRelativeLinks
-  def resolve_links(html)
-    html = html.gsub(%r{<a href="([^"]+)">([^<]+)</a>}) do
-      resolve_link_to_docs_subdir(full_match: $&, href: $1, content: $2)
-    end
-
-    html = html.gsub(%r{(<pre[^<]+)?<code[^>]*>([^<]+)</code>}) do
-      resolve_link_to_code(full_match: $&, pre: $1, code: $2)
-    end
-
-    super(html)
-  end
-
-  def resolve_link_to_docs_subdir(full_match:, href:, content:)
-    if href =~ /\bdocs\b/
-      %({file:#{href} #{content}})
-    else
-      full_match
-    end
-  end
-
-  def resolve_link_to_code(full_match:, pre:, code:)
-    if pre
-      return full_match
-    end
-
-    if code.include?("\n")
-      return full_match
-    end
-
-    if !code.start_with?("Super::")
-      return full_match
-    end
-
-    "{#{code}}"
-  end
-end
-
-YARD::Templates::Template.extra_includes << FixRelativeLinks

data/frontend/super-frontend/build.js

@@ -1,36 +0,0 @@
-const Bundler = require("parcel-bundler");
-const fs = require("fs");
-const path = require("path");
-
-const entryFiles = [
-  "src/stylesheets/super/application.css",
-  "src/javascripts/super/application.js",
-];
-
-const options = {
-  outDir: "../../app/assets",
-  watch: process.argv.includes("--watch"),
-  cacheDir: "tmp/parcel/cache",
-  global: "Super",
-  contentHash: false,
-  minify: false,
-  sourceMaps: false,
-  hmr: false,
-};
-
-const bundler = new Bundler(entryFiles, options);
-
-bundler.on("bundled", function(bundle) {
-  bundle.childBundles.forEach(function(childBundle) {
-    var basename = path.basename(childBundle.name);
-    var destDir = path.join(__dirname, "dist");
-    var destPath = path.join(destDir, basename);
-
-    console.log(destPath);
-    fs.copyFileSync(childBundle.name, destPath);
-  });
-  console.log();
-  console.log();
-});
-
-bundler.bundle();