copypasta 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: da680fd932e9deb4a0a86aeef581b1cf848afc7e00f5fc388a14f29d5e7d8bf1
+  data.tar.gz: 92e6652398bba04ce6acc64d7f517c49b2fb77beb5a1db3a02212b6c71744f3f
+SHA512:
+  metadata.gz: a1461bc7f5f768f78045c768413bf6799019efab52040705a7f4127508d49cc433fa5d4728f4f8205f82aa589a1d331a2ba3ee9451064edafb0c6d7ae3b67322
+  data.tar.gz: 229e739dbfb85005203c58731200b09a14a06b56abbe57089bb853104b3c4f0e7b269cbd39bebad13c55a8eabd2e8fc0c732151043618d227ef8eda7ffb2f05e

data/.gitignore

@@ -0,0 +1,8 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rubocop.yml

@@ -0,0 +1,162 @@
+# Relaxed.Ruby.Style
+## Version 2.1
+
+Style/Alias:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#stylealias
+
+Style/AsciiComments:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#styleasciicomments
+
+Style/BeginBlock:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#stylebeginblock
+
+Style/BlockDelimiters:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#styleblockdelimiters
+
+Style/CommentAnnotation:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#stylecommentannotation
+
+Style/Documentation:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#styledocumentation
+
+Layout/DotPosition:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#layoutdotposition
+
+Style/DoubleNegation:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#styledoublenegation
+
+Style/EndBlock:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#styleendblock
+
+Style/FormatString:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#styleformatstring
+
+Style/IfUnlessModifier:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#styleifunlessmodifier
+
+Style/Lambda:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#stylelambda
+
+Style/ModuleFunction:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#stylemodulefunction
+
+Style/MultilineBlockChain:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#stylemultilineblockchain
+
+Style/NegatedIf:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#stylenegatedif
+
+Style/NegatedWhile:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#stylenegatedwhile
+
+Style/ParallelAssignment:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#styleparallelassignment
+
+Style/PercentLiteralDelimiters:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#stylepercentliteraldelimiters
+
+Style/PerlBackrefs:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#styleperlbackrefs
+
+Style/Semicolon:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#stylesemicolon
+
+Style/SignalException:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#stylesignalexception
+
+Style/SingleLineBlockParams:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#stylesinglelineblockparams
+
+Style/SingleLineMethods:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#stylesinglelinemethods
+
+Layout/SpaceBeforeBlockBraces:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#layoutspacebeforeblockbraces
+
+Layout/SpaceInsideParens:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#layoutspaceinsideparens
+
+Style/SpecialGlobalVars:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#stylespecialglobalvars
+
+Style/StringLiterals:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#stylestringliterals
+
+Style/TrailingCommaInArguments:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#styletrailingcommainarguments
+
+Style/TrailingCommaInLiteral:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#styletrailingcommainliteral
+
+Style/WhileUntilModifier:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#stylewhileuntilmodifier
+
+Style/WordArray:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#stylewordarray
+
+Lint/AmbiguousRegexpLiteral:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#lintambiguousregexpliteral
+
+Lint/AssignmentInCondition:
+  Enabled: false
+  StyleGuide: http://relaxed.ruby.style/#lintassignmentincondition
+
+Metrics/AbcSize:
+  Enabled: false
+
+Metrics/BlockNesting:
+  Enabled: false
+
+Metrics/ClassLength:
+  Enabled: false
+
+Metrics/ModuleLength:
+  Enabled: false
+
+Metrics/CyclomaticComplexity:
+  Enabled: false
+
+Metrics/LineLength:
+  Enabled: false
+
+Metrics/MethodLength:
+  Enabled: false
+
+Metrics/ParameterLists:
+  Enabled: false
+
+Metrics/PerceivedComplexity:
+  Enabled: false
+

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at ed@edropple.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in copypasta.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,36 @@
+PATH
+  remote: .
+  specs:
+    copypasta (0.1.0)
+      cri-scaffold (~> 0.1)
+      highline (~> 1.7)
+      tilt (~> 2.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    coderay (1.1.2)
+    colored (1.2)
+    cri (2.10.1)
+      colored (~> 1.2)
+    cri-scaffold (0.1.1)
+      cri (~> 2.10)
+    highline (1.7.10)
+    method_source (0.9.0)
+    pry (0.11.3)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    rake (10.5.0)
+    tilt (2.0.8)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.16)
+  copypasta!
+  pry
+  rake (~> 10.0)
+
+BUNDLED WITH
+   1.16.1

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 Ed Ropple
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,82 @@
+# Copypasta #
+File generators are cool. Sometimes you need some scaffolding for things! But
+unless you're using Thor (and Thor is also cool) or Rails (and Rails is not
+cool), your options are pretty limited. Sometimes you can hack one together, in
+an awkward way--shout out to anyone who's ever written a bunch of Chef!--but
+there's no unified way that works on a CLI, embedded in your app, or in Chef.
+
+So I decided to thereifixedit the whole thing.
+
+## Usage ##
+Copypasta works on the concept of a `Plan`. A `Plan` is a directory structure
+that mimics the final data structure while offering a DSL that figures out what,
+exactly, should be dropped into the directory. Each directory in your `Plan`
+must have a `_contents.rb` file that will be evaluated with our shiny happy
+Copypasta DSL. `_contents.rb` will define files that live in that directory and
+how they should be built:
+
+- `copy` files are copied directly over; by default, `copy 'foo.txt'` will look
+  for a `foo.txt` at the same level as the `_contents.rb` file. You can specify
+  a specific file with `source:`.
+- `erb` files are processed via Erubi; by default, `erb 'foo.txt'` will look for
+  a `foo.txt.erb` file. The plan's parameters will be passed to the erb file,
+  but additional local variables can be specified with the `parameters:` option.
+  You can specify a specific ERB template with `source:`.
+- `download` fetches a file. `source:` is required.
+- `literal` takes a Ruby string as `data:` and writes a file with the contents
+  of that string out to disk.
+
+All content entries support the following options:
+
+- `only_if`: Takes a `lambda |parameters| {}`; if truthy, writes out the file.
+
+The root of your `Plan` should also contain a `_settings.rb` file which will
+describe what parameters should be passed into the `Plan`. These parameters can
+be retrieved interrogatively or passed in as data.
+
+### `_settings.rb` ###
+- `parameter` declarations require a name (a `Symbol`) and a description (a
+  `String`). They can take the following options:
+  - `postprocess`: if interactively delivered, the string that comes out of
+    HighLine will be run through the specified 1-arity `Proc`. The returned
+    value will be stored in `parameters` as exposed to the runtime.
+
+### `_contents.rb` ###
+
+## Future Work/How You Can Help ##
+- A Git handler for the `plan` content type would be a nice way to expand
+  Copypasta's usability.
+- Parameter validation, both per-parameter and at a higher level (combinations
+  of parameters). The proper answer here is probably to use something like
+  [dry-validation](https://github.com/dry-rb/dry-validation) that can accept
+  Procs.
+
+## Development ##
+
+After checking out the repo, run `bin/setup` to install dependencies. You can
+also run `bin/console` for an interactive prompt that will allow you to
+experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To
+release a new version, update the version number in `version.rb`, and then run
+`bundle exec rake release`, which will create a git tag for the version, push
+git commits and tags, and push the `.gem` file to
+[rubygems.org](https://rubygems.org).
+
+## Contributing ##
+
+Bug reports and pull requests are welcome on GitHub at
+https://github.com/eropple/copypasta. This project is intended to be a safe,
+welcoming space for collaboration, and contributors are expected to adhere to
+the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License ##
+
+The gem is available as open source under the terms of the [MIT
+License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the Copypasta project’s codebases, issue trackers, chat
+rooms and mailing lists is expected to follow the [code of
+conduct](https://github.com/eropple/copypasta/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+task :default => :spec

data/bin/console

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "copypasta"
+
+require "pry"
+Pry.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/copypasta.gemspec

@@ -0,0 +1,30 @@
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "copypasta/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "copypasta"
+  spec.version       = Copypasta::VERSION
+  spec.authors       = ["Ed Ropple"]
+  spec.email         = ["ed@edropple.com"]
+
+  spec.summary       = "A file and directory scaffolder for Ruby."
+  spec.homepage      = "https://github.com/eropple/copypasta"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.16"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "pry"
+
+  spec.add_runtime_dependency "tilt", "~> 2.0"
+  spec.add_runtime_dependency "cri-scaffold", "~> 0.1"
+  spec.add_runtime_dependency "highline", "~> 1.7"
+end

data/example/_contents.rb

@@ -0,0 +1,10 @@
+literal 'myliteral.txt', data: 5
+
+copy 'mycopy.txt'
+copy 'mycopy2.txt', source: 'myrenamed.txt'
+erb 'mytemplate.txt', locals: { a: 10, b: 100 }
+
+download 'my-ip.txt', source: "https://v4.ifconfig.co/ip"
+
+literal 'only-if.txt', data: "the int list had a 2 in it",
+                       only_if: ->(params) { params[:list_of_ints].include?(2) }

data/example/_settings.rb

@@ -0,0 +1,7 @@
+parameter :required, "This parameter is required."
+
+parameter :defaulted, "This integer parameter is required, but defaults to 5.",
+          default: 5
+
+parameter :list_of_ints, "Please provide a comma-separated list of integers.",
+          postprocess: ->(raw) { raw.split(",").map(&:strip).map(&:to_i) }

data/example/mycopy.txt

@@ -0,0 +1 @@
+this file is copied directly

data/example/myrenamed.txt

@@ -0,0 +1 @@
+this file was myrenamed.txt but isn't when deployed.

data/example/mytemplate.txt.erb

@@ -0,0 +1,2 @@
+required: <%= parameters[:required] %>
+defaulted: <%= parameters[:defaulted] %>

data/exe/copypasta

@@ -0,0 +1,4 @@
+#! /usr/bin/env ruby
+
+require "cri/scaffold"
+Cri.scaffold("#{__dir__}/../lib/copypasta").run(ARGV)

data/lib/copypasta.rb

@@ -0,0 +1,24 @@
+require "copypasta/version"
+
+require "copypasta/plan"
+
+module Copypasta
+  def self.apply(plan_directory:, destination_directory:,
+                 parameters:,
+                 interactive: false,
+                 force: false)
+    plan_directory = File.expand_path(plan_directory)
+    destination_directory = File.expand_path(destination_directory)
+
+    plan = Copypasta::Plan.from_directory(plan_directory)
+
+    full_parameters =
+      if interactive
+        plan.interrogate(parameters)
+      else
+        parameters
+      end
+
+    plan.apply(full_parameters, destination_directory, force: force)
+  end
+end

data/lib/copypasta/cli.rb

@@ -0,0 +1,4 @@
+run do |_opts, _args, _cmd|
+  puts cmd.help
+  exit 1
+end

data/lib/copypasta/cli/apply.cli.rb

@@ -0,0 +1,21 @@
+usage "PATH_TO_PLAN [DESTINATION]"
+
+flag :f, :force, "applies plan even to a non-empty directory"
+
+run do |opts, args, cmd|
+  unless (1..2).cover?(args.length)
+    puts cmd.help
+    exit 1
+  end
+
+  plan_directory = args[0]
+  destination_directory = args[1] || "."
+
+  require "copypasta"
+
+  Copypasta.apply(plan_directory: plan_directory,
+                  destination_directory: destination_directory,
+                  parameters: {},
+                  interactive: true,
+                  force: opts[:force])
+end

data/lib/copypasta/contents.rb

@@ -0,0 +1,57 @@
+require "copypasta/entry"
+
+require 'fileutils'
+
+module Copypasta
+  class Contents
+    attr_reader :target_directory
+    attr_accessor :force_create
+    attr_reader :entries
+
+    def initialize(target_directory)
+      @target_directory = target_directory.dup.freeze
+      @force_create = false
+      @entries = []
+    end
+
+    def apply(root, parameters)
+      content_dir = "#{root}/#{target_directory}"
+
+      if should_create?
+        FileUtils.mkdir_p content_dir
+      end
+
+      entries.each do |entry|
+        entry.apply(content_dir, parameters)
+      end
+    end
+
+    def should_create?
+      force_create || !entries.empty?
+    end
+
+    def self.from_tree(root)
+      require "copypasta/contents_dsl"
+
+      raise "#{root} doesn't exist." unless Dir.exist?(root)
+      root = File.expand_path(root)
+
+      items = []
+
+      Dir["#{root}/**/_contents.rb"].each do |f|
+        f = File.expand_path(f)
+        content_dir = File.dirname(f)
+        target_directory = content_dir.sub(root, "").sub(%r!^/!, "")
+
+        contents = Copypasta::Contents.new(target_directory)
+
+        dsl = Copypasta::ContentsDSL.new(contents, content_dir)
+        dsl.instance_eval File.read(f), f
+
+        items << contents unless contents.entries.empty?
+      end
+
+      items
+    end
+  end
+end

data/lib/copypasta/contents_dsl.rb

@@ -0,0 +1,36 @@
+module Copypasta
+  class ContentsDSL
+    attr_reader :contents
+    attr_reader :directory
+
+    def initialize(contents, directory)
+      raise "contents must be a Copypasta::Contents" \
+        unless contents.is_a?(Copypasta::Contents)
+
+      raise "#{directory} doesn't exist." unless Dir.exist?(directory)
+
+      @contents = contents
+      @directory = directory
+    end
+
+    def create_even_if_empty!
+      contents.force_create = true
+    end
+
+    def copy(filename, source: nil, only_if: nil)
+      contents.entries << Copypasta::Entry::Copy.new(filename, directory: @directory, source: source, only_if: only_if).freeze
+    end
+
+    def erb(filename, source: nil, locals: {}, only_if: nil)
+      contents.entries << Copypasta::Entry::ERB.new(filename, directory: @directory, source: source, locals: locals, only_if: only_if).freeze
+    end
+
+    def download(filename, source: nil, only_if: nil)
+      contents.entries << Copypasta::Entry::Download.new(filename, source: source, only_if: only_if).freeze
+    end
+
+    def literal(filename, data:, only_if: nil)
+      contents.entries << Copypasta::Entry::Literal.new(filename, data: data, only_if: only_if).freeze
+    end
+  end
+end

data/lib/copypasta/entry.rb

@@ -0,0 +1 @@
+Dir["#{__dir__}/entry/*.rb"].each { |f| require_relative f }

data/lib/copypasta/entry/base.rb

@@ -0,0 +1,22 @@
+module Copypasta
+  module Entry
+    class Base
+      attr_reader :filename
+
+      def apply(destination_directory, parameters)
+        do_apply(destination_directory, parameters) \
+          if @only_if.nil? || @only_if.call(parameters)
+      end
+
+      private
+
+      def do_apply(_destination_directory, _parameters)
+        raise "#{self.class.name}#do_apply(destination_directory, parameters) must be implemented."
+      end
+
+      def target_file(destination_directory)
+        "#{destination_directory}/#{@filename}"
+      end
+    end
+  end
+end

data/lib/copypasta/entry/copy.rb

@@ -0,0 +1,28 @@
+require "copypasta/entry/base"
+
+require "fileutils"
+
+module Copypasta
+  module Entry
+    class Copy < Copypasta::Entry::Base
+      attr_reader :source
+
+      def initialize(filename, directory:, source: nil, only_if: nil)
+        raise "filename must be a string." unless filename.is_a?(String)
+        raise "only_if must be null or a Proc." if !only_if.nil? && !only_if.is_a?(Proc)
+
+        @filename = filename
+        @directory = directory
+        @only_if = only_if
+
+        @source = source || filename
+      end
+
+      private
+
+      def do_apply(destination, _parameters)
+        FileUtils.cp("#{@directory}/#{@source}", target_file(destination))
+      end
+    end
+  end
+end

data/lib/copypasta/entry/download.rb

@@ -0,0 +1,31 @@
+require "copypasta/entry/base"
+
+require "uri"
+
+module Copypasta
+  module Entry
+    class Download < Copypasta::Entry::Base
+      attr_reader :source
+
+      def initialize(filename, source:, only_if: nil)
+        raise "filename must be a string." unless filename.is_a?(String)
+        raise "source url '#{source}' looks invalid." \
+          unless source =~ URI::DEFAULT_PARSER.make_regexp
+        raise "only_if must be null or a Proc." if !only_if.nil? && !only_if.is_a?(Proc)
+
+        @filename = filename
+        @source = source
+        @only_if = only_if
+      end
+
+      private
+
+      def do_apply(destination, _parameters)
+        require "open-uri"
+
+        download = open(@source)
+        IO.copy_stream(download, target_file(destination))
+      end
+    end
+  end
+end

data/lib/copypasta/entry/erb.rb

@@ -0,0 +1,33 @@
+require "copypasta/entry/base"
+
+require "tilt/erb"
+
+module Copypasta
+  module Entry
+    class ERB < Copypasta::Entry::Base
+      attr_reader :source
+      attr_reader :locals
+
+      def initialize(filename, directory:, locals: {}, source: nil, only_if: nil)
+        raise "filename must be a string." unless filename.is_a?(String)
+        raise "only_if must be null or a Proc." if !only_if.nil? && !only_if.is_a?(Proc)
+        raise "locals must be a Hash." unless locals.is_a?(Hash)
+
+        @filename = filename.dup.freeze
+        @directory = directory.dup.freeze
+        @locals = locals.dup.freeze
+        @source = (source || "#{filename}.erb").dup.freeze
+        @only_if = only_if
+      end
+
+      private
+
+      def do_apply(destination, parameters)
+        template = Tilt::ERBTemplate.new("#{@directory}/#{@source}")
+        output = template.render(Object.new, @locals.merge(parameters: parameters))
+
+        IO.write(target_file(destination), output)
+      end
+    end
+  end
+end

data/lib/copypasta/entry/literal.rb

@@ -0,0 +1,24 @@
+require "copypasta/entry/base"
+
+module Copypasta
+  module Entry
+    class Literal < Copypasta::Entry::Base
+      attr_reader :data
+
+      def initialize(filename, data:, only_if: nil)
+        raise "filename must be a string." unless filename.is_a?(String)
+        raise "only_if must be null or a Proc." if !only_if.nil? && !only_if.is_a?(Proc)
+
+        @filename = filename
+        @data = data
+        @only_if = only_if
+      end
+
+      private
+
+      def do_apply(destination, _parameters)
+        IO.write(target_file(destination), data.to_s)
+      end
+    end
+  end
+end

data/lib/copypasta/parameter_definition.rb

@@ -0,0 +1,24 @@
+module Copypasta
+  class ParameterDefinition
+    attr_reader :name
+    attr_reader :description
+    attr_reader :default
+    attr_reader :postprocess
+
+    def initialize(name, description, default, postprocess)
+      raise "name must be nil or a Symbol." \
+        unless name.is_a?(Symbol) || name.nil?
+      @name = name
+
+      raise "description must be nil or a String." \
+        unless description.is_a?(String) || description.nil?
+      @description = description
+
+      @default = default
+
+      raise "postprocess must be nil or a String." \
+        unless postprocess.is_a?(Proc) || postprocess.nil?
+      @postprocess = postprocess
+    end
+  end
+end

data/lib/copypasta/plan.rb

@@ -0,0 +1,84 @@
+require "copypasta/settings"
+require "copypasta/contents"
+
+module Copypasta
+  class Plan
+    attr_reader :root
+    attr_reader :settings
+    attr_reader :contents
+
+    def initialize(settings:, contents: [])
+      raise "settings must be a Copypasta::Settings" \
+        unless settings.is_a?(Copypasta::Settings)
+
+      raise "'contents' must be an Array of Copypasta::Contents." \
+        unless contents.is_a?(Array) && contents.all? { |c| c.is_a?(Copypasta::Contents) }
+
+      @root = root.dup.freeze
+      @settings = settings.dup.freeze
+      @contents = contents.dup.freeze
+    end
+
+    def interrogate(parameters)
+      raise "#interrogate can only be called when STDOUT is a tty?." \
+        unless STDOUT.tty?
+      # TODO: check to see if the parameter exists; if it doesn't, ask on the
+      #       tty for a value.
+      # TODO: decide whether to notify-and-retry or fail on invalid parameter.
+
+      require "highline"
+      cli = HighLine.new
+
+      missing_parameters =
+        settings.parameter_definitions
+                .values.select { |pd| parameters[pd.name].nil? }
+
+      missing_parameters.each do |pd|
+        puts pd.description
+        answer = cli.ask("#{pd.name}: ") { |q| q.default = pd.default }
+
+        answer = pd.postprocess.call(answer) unless pd.postprocess.nil?
+
+        puts "Received parameter '#{pd.name}': '#{answer}'"
+
+        parameters[pd.name] = answer
+      end
+
+      parameters
+    end
+
+    def parameters_valid?(parameters)
+      ret = @settings.validate(parameters)
+
+      ret.all?(&:empty?)
+    end
+
+    def apply(parameters, destination_directory, force: false)
+      # TODO: validate the parameters, then call all of the entries with the
+      #       parameter set
+
+      raise "parameter set is invalid, check the logs." \
+        unless parameters_valid?(parameters)
+      raise "Directory is dirty. Use force to create anyway." \
+        if !force && !directory_clean?(destination_directory)
+
+      contents.each { |c| c.apply(destination_directory, parameters) }
+    end
+
+    def self.from_directory(root)
+      raise "#{root} doesn't exist." unless Dir.exist?(root)
+      root = File.expand_path(root)
+
+      settings = Copypasta::Settings.from_file("#{root}/_settings.rb")
+      contents = Copypasta::Contents.from_tree(root)
+
+      Copypasta::Plan.new(settings: settings, contents: contents)
+    end
+
+    private
+
+    def directory_clean?(destination)
+      Dir["#{destination}/*"].reject { |f| f == ".." || f == "." }.empty?
+    end
+  end
+end

data/lib/copypasta/settings.rb

@@ -0,0 +1,22 @@
+require "dry/validation"
+
+require "copypasta/parameter_definition"
+
+module Copypasta
+  class Settings
+    attr_reader :parameter_definitions
+
+    def initialize
+      @parameter_definitions = {}
+    end
+
+    def self.from_file(path)
+      require "copypasta/settings_dsl"
+      raise "#{path} doesn't exist." unless File.exist?(path)
+
+      dsl = Copypasta::SettingsDSL.new
+      dsl.instance_eval File.read(path), path
+      dsl.settings
+    end
+  end
+end

data/lib/copypasta/settings_dsl.rb

@@ -0,0 +1,67 @@
+require "yaml"
+require "json"
+
+require "dry/validation"
+
+require "copypasta/settings"
+require "copypasta/parameter_definition"
+
+module Copypasta
+  class SettingsDSL
+    attr_reader :settings
+
+    def initialize(settings = nil)
+      raise "settings must be a Copypasta::Settings." \
+        if !settings.nil? && !settings.is_a?(Copypasta::Settings)
+
+      @settings = settings || Copypasta::Settings.new
+    end
+
+    def parameter(name, description, default: nil, postprocess: nil)
+      name = name.to_sym
+      raise "Duplicate parameter '#{name}' detected." \
+        if settings.parameter_definitions.key?(name)
+
+      param = Copypasta::ParameterDefinition.new(name, description,
+                                                 default,
+                                                 postprocess)
+      param.freeze
+
+      settings.parameter_definitions[name] = param
+    end
+
+    def yaml(name, description)
+      parameter(name, description,
+                postprocess: ->(raw) {
+                  if raw.is_a?(String)
+                    raw
+                  else
+                    YAML.safe_load(raw)
+                  end
+                })
+    end
+
+    def json(name, description)
+      parameter(name, description,
+                postprocess: ->(raw) {
+                  if raw.is_a?(String)
+                    raw
+                  else
+                    JSON.parse(raw)
+                  end
+                })
+    end
+
+    def csv(name, description, postprocess: nil)
+      parameter(name, description,
+                postprocess: ->(raw) {
+                  r = raw.split(",").map(&:strip)
+                  if postprocess
+                    postprocess.call(r)
+                  else
+                    r
+                  end
+                })
+    end
+  end
+end

data/lib/copypasta/version.rb

@@ -0,0 +1,3 @@
+module Copypasta
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,162 @@
+--- !ruby/object:Gem::Specification
+name: copypasta
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ed Ropple
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2018-01-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.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: tilt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: cri-scaffold
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: highline
+  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'
+description: 
+email:
+- ed@edropple.com
+executables:
+- copypasta
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- copypasta.gemspec
+- example/_contents.rb
+- example/_settings.rb
+- example/mycopy.txt
+- example/myrenamed.txt
+- example/mytemplate.txt.erb
+- exe/copypasta
+- lib/copypasta.rb
+- lib/copypasta/cli.rb
+- lib/copypasta/cli/apply.cli.rb
+- lib/copypasta/contents.rb
+- lib/copypasta/contents_dsl.rb
+- lib/copypasta/entry.rb
+- lib/copypasta/entry/base.rb
+- lib/copypasta/entry/copy.rb
+- lib/copypasta/entry/download.rb
+- lib/copypasta/entry/erb.rb
+- lib/copypasta/entry/literal.rb
+- lib/copypasta/parameter_definition.rb
+- lib/copypasta/plan.rb
+- lib/copypasta/settings.rb
+- lib/copypasta/settings_dsl.rb
+- lib/copypasta/version.rb
+homepage: https://github.com/eropple/copypasta
+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.7.3
+signing_key: 
+specification_version: 4
+summary: A file and directory scaffolder for Ruby.
+test_files: []