decko 0.10.0 → 0.11.0

data/LICENSE

@@ -1,16 +0,0 @@
-Wagn
-Copyright (C) 2013 Grass Commons
-
-This program is free software; you can redistribute it and/or
-modify it under the terms of the GNU General Public License
-as published by the Free Software Foundation; either version 2
-of the License, or (at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with this program; if not, write to the Free Software
-Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.

data/README.rdoc

@@ -1,151 +0,0 @@
-=Decko: you hold the cards
-
-{<img src="https://semaphoreci.com/api/v1/ethan/decko/branches/master/shields_badge.svg" />}[https://semaphoreci.com/ethan/decko]
-{<img src="https://badge.fury.io/rb/decko.svg" alt="Gem Version" />}[https://badge.fury.io/rb/decko]
-{<img src="https://codeclimate.com/repos/56548cb6fafb98574e013c39/badges/be88db3f72d0fd06ace3/gpa.svg" />}[https://codeclimate.com/repos/56548cb6fafb98574e013c39/feed]
-
-==Basics
-
-Decko (formerly known as "Wagn") makes serious web development fun.
-
-"Deckers" have used Decko to create open community sites, private knowledge management sites, public proposal submission sites with private back-ends for review, project management systems, wikis, blogs, journals, forums, and more.
-
-Install Decko, open a webpage, and get started. With Decko's wiki-inspired building blocks, you can collaborate from day one on content, design, and structure create elegant web systems on the fly.  And ruby developers can take these creations even further with Decko's development framework. Decko's innovative Mods API supports boundless creativity while integrating seamlessly with structures created on the site.
-
-Try it out!
-
-
-==System Requirements
-
-
-==Installation
-
-===1. install dependencies
-
-Ruby[http://www.ruby-lang.org/en/]:: version 2.5 or higher
-Bundler[http://gembundler.com/]:: version 1.0 or higher
-ImageMagick[http://www.imagemagick.org/]::
-A database engine:: Either MySQL[http://www.mysql.com/] or PostgreSQL[http://www.postgresql.org/]
-A JavaScript runtime::  Node.js[https://nodejs.org/] or other[https://github.com/sstephenson/execjs]
-
-===2. install the gem
-
-    gem install decko
-
-Watch carefully for errors!
-
-
-===3. create a new deck
-
-    decko new MY_DECK
-
-Options:
-    -f, [--force]                            # Overwrite files that already exist
-    -p, [--pretend], [--no-pretend]          # Run but do not make any changes
-    -q, [--quiet], [--no-quiet]              # Suppress status output
-    -s, [--skip], [--no-skip]                # Skip files that already exist
-    -m, [--mod-dev], [--no-mod-dev]          # Prepare deck for mod development
-    -c, [--core-dev], [--no-core-dev]        # Prepare deck for core development
-    -g, [--gem-path=GEM-PATH]                # Path to local decko repository (Default, use env DECKO_GEM_PATH)
-    -i, [--interactive], [--no-interactive]  # Prompt with dynamic installation options
-
-===4. create / seed database
-
-Edit the config/database.yml file as necessary. More about database configuration at https://www.decko.org/database_configuration.
-
-Then run
-
-      cd MY_DECK
-      decko seed
-
-..to create and seed the database
-
-Options:
-    -p, --production                 decko:seed production database (default)
-    -t, --test                       decko:seed test database
-    -d, --development                decko:seed development database
-    -a, --all                        decko:seed production, test, and development database
-
-
-===4. start your server
-
-To fire up the default, built-in WEBrick server, just run:
-
-  decko server
-
-...and point your browser to http://localhost:3000 (unless otherwise configured).
-
-Options:
-  -p, [--port=port]                        # Runs Decko on the specified port - defaults to 3000.
-  -b, [--binding=IP]                       # Binds Decko to the specified IP - defaults to 'localhost' in development and '0.0.0.0' in other environments'.
-  -c, [--config=file]                      # Uses a custom rackup configuration. (default: config.ru)
-  -d, [--daemon], [--no-daemon]            # Runs server as a Daemon.
-  -e, [--environment=name]                 # Specifies the environment to run this server under (development/test/production).
-  -P, [--pid=PID]                          # Specifies the PID file. (efault: tmp/pids/server.pid)
-      [--early-hints], [--no-early-hints]  # Enables HTTP/2 early hints.
-
-For more information, see https://decko.org/get_started.
-
-
-
-==Upgrading
-
-===Standard Upgrade
-
-====1. Backups
-Always back up your database and uploaded files.
-
-====2. Update Libraries
-
-From your decko root directory run:
-
-  bundle update
-
-====3. Update Database
-
-Run the following:
-
-  decko update
-
-====4. Restart your server.
-
-===Upgrade to Decko from Wagn
-
-====1. update references to "wagn" in file content
-In your decko's root directory, edit Gemfile, config/application.rb, and config/routes.rb, and script/wagn,
-replacing "wagn" with "decko". (Keep the same capitalization pattern.)
-
-====2. update references to "wagn" in file names.
-From your decko root directory run:
-
-  mv script/wagn script/decko
-
-====3. continue as with Standard Upgrade
-See above.
-
-===Upgrade pre-gem Wagn site
-
-First check the Wagn/Decko version of your existing site.
-
-====Version 1.10 or newer
-
-1. Create a new deck using steps 1 and 2 from the installation section above.
-2. Copy config/database.yml from the old site to the new one.
-3. Copy the old local/files contents to the new "files" directory.
-4. If you have edited wagn.yml in your old site, make the corresponding changes to the new config/application.rb file.
-5. Follow the standard upgrade procedure above.
-
-====Older than Version 1.10
-
-First update your Wagn to version 1.10 via the old update mechanisms, and then follow the directions above.
-
-
-==More Resources
-
-If you're new to Decko, you'll find lots more info at https://decko.org
-
-Installation problems? Installation: https://decko.org/installation
-
-If you're looking to go deep into the code, start with http://www.rubydoc.info/gems/card
-
-Thinking about contributing to Decko? here[link:CONTRIBUTING.md]

data/lib/decko/generators/decko/decko_generator.rb

@@ -1,263 +0,0 @@
-require "rails/generators/app_base"
-
-class DeckoGenerator < Rails::Generators::AppBase
-  # class DeckoGenerator < Rails::Generators::AppGenerator
-
-  source_root File.expand_path("../templates", __FILE__)
-
-  class_option "mod-dev",
-               type: :boolean, aliases: "-m", default: false, group: :runtime,
-               desc: "Prepare deck for mod development"
-
-  class_option "core-dev",
-               type: :boolean, aliases: "-c", default: false, group: :runtime,
-               desc: "Prepare deck for core development"
-
-  class_option "gem-path",
-               type: :string, aliases: "-g", default: "", group: :runtime,
-               desc: "Path to local decko repository " \
-                     "(Default, use env DECKO_GEM_PATH)"
-
-  class_option :database,
-               type: :string, aliases: "-d", default: "mysql",
-               desc: "Preconfigure for selected database " \
-                     "(options: #{DATABASES.join('/')})"
-
-  class_option "interactive",
-               type: :boolean, aliases: "-i", default: false, group: :runtime,
-               desc: "Prompt with dynamic installation options"
-
-  public_task :set_default_accessors!
-  public_task :create_root
-
-  ## should probably eventually use rails-like AppBuilder approach,
-  # but this is a first step.
-  def dev_setup
-    determine_gemfile_gem_path
-    @include_jasmine_engine = false
-    if options["core-dev"]
-      core_dev_setup
-    elsif options["mod-dev"]
-      mod_dev_setup
-    end
-  end
-
-  def rakefile
-    template "Rakefile"
-  end
-
-  #  def readme
-  #    copy_file "README", "README.rdoc"
-  #  end
-
-  def mod
-    empty_directory_with_keep_file "mod"
-  end
-
-  def log
-    empty_directory_with_keep_file "log"
-  end
-
-  def files
-    empty_directory_with_keep_file "files"
-  end
-
-  def tmp
-    empty_directory "tmp"
-  end
-
-  def gemfile
-    template "Gemfile"
-  end
-
-  def configru
-    template "config.ru"
-  end
-
-  def gitignore
-    copy_file "gitignore", ".gitignore"
-  end
-
-  def config
-    empty_directory "config"
-
-    inside "config" do
-      template "application.rb"
-      template "routes.erb", "routes.rb"
-      template "environment.rb"
-      template "boot.rb"
-      template "databases/#{options[:database]}.yml", "database.yml"
-      template "cucumber.yml" if options["core-dev"]
-      template "initializers/cypress_on_rails.rb" if options["core-dev"]
-    end
-  end
-
-  def public
-    empty_directory "public"
-
-    inside "public" do
-      template "robots.txt"
-      empty_directory "files"
-
-      inside "files" do
-        template "htaccess", ".htaccess"
-      end
-    end
-  end
-
-  def script
-    directory "script" do |content|
-      "#{shebang}\n" + content
-    end
-    chmod "script", 0755 & ~File.umask, verbose: false
-  end
-
-  public_task :run_bundle
-
-  def seed_data
-    if options["interactive"]
-      Interactive.new(options, destination_root).run
-    else
-      puts "Now:
-1. Run `cd #{File.basename(destination_root)}` to move your new deck directory
-2. Run `decko seed` to seed your database (see db configuration in config/database.yml).
-3. Run `decko server` to start your server"
-    end
-  end
-
-  def database_gemfile_entry
-    return [] if options[:skip_active_record]
-    gem_name, gem_version = gem_for_database
-    msg = "Use #{options[:database]} as the database for Active Record"
-    GemfileEntry.version gem_name, gem_version, msg
-  end
-
-  def self.banner
-    "decko new #{arguments.map(&:usage).join(' ')} [options]"
-  end
-
-  protected
-
-  def determine_gemfile_gem_path
-    # TODO: rename or split, gem_path points to the source repo,
-    # card and decko gems are subdirs
-    if (env_gem_path = ENV["DECKO_GEM_PATH"]).present?
-      @gemfile_gem_path = %q(#{ENV['DECKO_GEM_PATH']})
-      @gem_path = env_gem_path
-    else
-      @gemfile_gem_path = @gem_path = options["gem-path"]
-    end
-  end
-
-  def core_dev_setup
-    prompt_for_gem_path
-    @include_jasmine_engine = true
-    @spec_path = @gem_path
-    @spec_helper_path = File.join @spec_path, "card", "spec", "spec_helper"
-
-    # ending slash is important in order to load support and step folders
-    @features_path = File.join @gem_path, "decko/features/"
-    @simplecov_config = "card_core_dev_simplecov_filters"
-    shared_dev_setup
-    javascript_spec_setup "decko_jasmine"
-  end
-
-  def prompt_for_gem_path
-    return if @gem_path.present?
-    @gemfile_gem_path =
-      @gem_path = ask("Enter the path to your local decko gem installation: ")
-  end
-
-  def mod_dev_setup
-    @spec_path = "mod/"
-    @spec_helper_path = "./spec/spec_helper"
-    @simplecov_config = "card_simplecov_filters"
-    shared_dev_setup
-    inside("spec") { template "spec_helper.rb" }
-    javascript_spec_setup "deck_jasmine"
-  end
-
-  def javascript_spec_setup jasmine_prefix
-    inside "spec" do
-      template File.join("javascripts", "support", "#{jasmine_prefix}.yml"),
-               File.join("javascripts", "support", "jasmine.yml")
-    end
-  end
-
-  def shared_dev_setup
-    @cardio_gem_root = File.join @gem_path, "card"
-    @decko_gem_root = File.join @gem_path, "decko"
-    empty_directory "spec"
-    inside "config" do
-      template "puma.rb"
-    end
-    template "rspec", ".rspec"
-    template "simplecov", ".simplecov"
-    empty_directory "bin"
-    inside "bin" do
-      template "spring"
-    end
-  end
-
-  def mysql_socket
-    @mysql_socket ||= [
-      "/tmp/mysql.sock",                        # default
-      "/var/run/mysqld/mysqld.sock",            # debian/gentoo
-      "/var/tmp/mysql.sock",                    # freebsd
-      "/var/lib/mysql/mysql.sock",              # fedora
-      "/opt/local/lib/mysql/mysql.sock",        # fedora
-      "/opt/local/var/run/mysqld/mysqld.sock",  # mac + darwinports + mysql
-      "/opt/local/var/run/mysql4/mysqld.sock",  # mac + darwinports + mysql4
-      "/opt/local/var/run/mysql5/mysqld.sock",  # mac + darwinports + mysql5
-      "/opt/lampp/var/mysql/mysql.sock"         # xampp for linux
-    ].find { |f| File.exist?(f) } unless RbConfig::CONFIG["host_os"] =~ /mswin|mingw/
-  end
-
-  ### the following is straight from rails and is focused on checking
-  # the validity of the app name.needs decko-specific tuning
-
-  def app_name
-    @app_name ||= if defined_app_const_base?
-                    defined_app_name
-                  else
-                    File.basename(destination_root)
-                  end
-  end
-
-  def defined_app_name
-    defined_app_const_base.underscore
-  end
-
-  def defined_app_const_base
-    Rails.respond_to?(:application) && defined?(Rails::Application) &&
-      Decko.application.is_a?(Rails::Application) &&
-      Decko.application.class.name.sub(/::Application$/, "")
-  end
-
-  alias defined_app_const_base? defined_app_const_base
-
-  def app_const_base
-    @app_const_base ||= defined_app_const_base ||
-                        app_name.gsub(/\W/, "_").squeeze("_").camelize
-  end
-
-  alias camelized app_const_base
-
-  def app_const
-    @app_const ||= "#{app_const_base}::Application"
-  end
-
-  def valid_const?
-    if app_const =~ /^\d/
-      raise Thor::Error, "Invalid application name #{app_name}. " \
-                   "Please give a name which does not start with numbers."
-    #    elsif RESERVED_NAMES.include?(app_name)
-    #      raise Error, "Invalid application name #{app_name}." \
-    # "Please give a name which does not match one of the reserved rails words."
-    elsif Object.const_defined?(app_const_base)
-      raise Thor::Error, "Invalid application name #{app_name}, " \
-                   "constant #{app_const_base} is already in use. " \
-                   "Please choose another application name."
-    end
-  end
-end