stephendolan/spark

A set of CLI utilities to facilitate advanced application setup and building.

Spark

Installation

Add the dependency to your shard.yml:

dependencies:
  spark:
    github: stephendolan/spark

Run shards install

Library usage

Require the shard:

require "spark"

Then, use any of the fully documented modules below to interact with your user:

• ⚡️   Spark
  • .indent - Increase indentation for all Spark output by one level
  • .outdent - Decrease indentation for all Spark output by one level
  • .reset_indentation - Set the indentation level for all Spark output back to zero
• 💬   Spark::Prompt
  • #say - Display a message to a user
  • #ask - Get information from a user
  • #yes? - Get confirmation from a user, with a default of "Yes"
  • #no? - Get confirmation from a user, with a default of "No"
  • #newline - Output a blank line to the user's prompt
• 📄   Spark::Template
  • .run_remote_file - Run Crystal code from a remote source (USE WITH CAUTION)
  • .run_local_file - Run Crystal code from a local file source (USE WITH CAUTION)
• 🗄   Spark::File
  • .replace_in_file - Replace some content in a file
  • .inject_into_file - Insert content into a file before or after a pattern
  • .prepend_to_file - Insert content at the beginning of a file
  • .append_to_file - Insert content at the end of a file
  • .copy_file - Copy a file (very few safeguards in place currently)
  • .move_file - Move a file (very few safeguards in place currently)
  • .create_file - Create a file (very few safeguards in place currently)
  • .remove_file - Remove a file
  • .chmod_file - Change the permissions of a file
• 💎   Spark::Shard
  • #add_shard - Adds a shard to the shard.yml file

Command line usage

Spark ships with a command line interface, installed in a postinstall step when you shards install. The resulting binary will be located at ./bin/spark.

With this CLI installed, you have access to the following commands:

• ./bin/spark apply [Remote Template URL] - Runs the content returned from the provided URL through crystal run
• ./bin/spark apply --local [Local File Path] - Runs the content of the provided file path through crystal run

Development

1. Add your code
2. Ensure specs pass with crystal spec
3. Ensure correct formatting with crystal tool format --check
4. Ensure correct style with ./bin/ameba

Contributing

1. Fork it (https://github.com/stephendolan/spark/fork)
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

Credits & Inspirations

• TTY because of the excellent code and organization
• Thor because I've loved using it with Ruby and Rails
• Ameba because of their excellent shard CLI

Contributors

• Stephen Dolan - creator and maintainer