Example File

Class helper for example files. Usually it's the alternative to environment variables (and .env files).

You can have git-controlled example files and git-ignored real files. For example, configuration, especially with sensitive data.

Add this line to your application's Gemfile:

gem 'example_file'

And then execute:

bundle install

Or install it yourself as:

gem install example_file

require 'example_file'

ExampleFile.new('some_file.example.conf').actualize_regular_file

For some_file.example.conf example file there is some_file.conf regular file.

Editor below is $EDITOR environment variable. You should set it to your preferred editor, console or GUI (console is more comfortable usually for such scenarios). Otherwise the whole program will be aborted with a message about this.

It'll act in these ways:

• If there is no regular file:
  • create it with content from example and open the editor.
• If there is example file with file modified time after regular file:
  • If there is no difference between their contents:
    • touch regular file for updating its modified time.
  • If there is a difference between their contents:
    • ask for a further action:
      • open the editor;
      • just update regular without changes;
      • replace regular file with a content from new example file;
      • or replace and then open the editor.
• If there is regular file with file modified time after example file:
  • do nothing.

You should add example files to git control:

git add some_file.example.conf

And ignore regular ones in .gitignore:

some_file.conf

Recursively it'd be like:

config/**/*
!config/**/*.example*

After checking out the repo, run bundle install to install dependencies.

Then, run toys rspec to run the tests.

To install this gem onto your local machine, run toys gem install.

To release a new version, run toys gem release %version%. See how it works here.

Bug reports and pull requests are welcome on GitHub.

The gem is available as open source under the terms of the MIT License.