dupervisor 1.0.2

data/.travis.yml

@@ -0,0 +1,15 @@
+language: ruby
+env:
+  - CODECLIMATE_REPO_TOKEN=49ca8c0e2d56ab70e7eabc237692e21cc8fe43ef13ed5d411fa20bf1e8997a44
+rvm:
+  - 2.2.3
+  - 2.3.0
+script: "bundle exec rspec --format documentation"
+notifications:
+  slack:
+    rooms:
+  email:
+    recipients:
+      - kigster@gmail.com
+    on_success: change
+    on_failure: always

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in dupervisor.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Konstantin Gredeskoul
+
+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,162 @@
+[![Gem Version](https://badge.fury.io/rb/dupervisor.svg)](https://badge.fury.io/rb/dupervisor)
+[![Build Status](https://travis-ci.org/kigster/dupervisor.svg?branch=master)](https://travis-ci.org/kigster/dupervisor)
+[![Code Climate](https://codeclimate.com/github/kigster/dupervisor/badges/gpa.svg)](https://codeclimate.com/github/kigster/dupervisor)
+[![Test Coverage](https://codeclimate.com/github/kigster/dupervisor/badges/coverage.svg)](https://codeclimate.com/github/kigster/dupervisor/coverage)
+[![Issue Count](https://codeclimate.com/github/kigster/dupervisor/badges/issue_count.svg)](https://codeclimate.com/github/kigster/dupervisor)
+
+# DuperVisor™ Pro 
+
+The super-duper awesome library is your best friend if you want an easy way to convert configuration between any one of the supported formats, which at this time are: JSON, YAML, and Windows INI format. 
+
+This tool was originally created to allow storing configs of another great tool called [__supervisord__](http://supervisord.org), which is still highly applicable today, but unfortunately uses a rather [archaic configuration file format](http://supervisord.org/configuration.html) of the decades old Windows INI format.
+
+Whatever your preferences are, the truth is that some of the modern DevOps tools (such as Ansible and SaltStack) are using YAML format extensively to configure the environments. Ability to "embed" YAML configuration for a tool like supervisord means that you don't have to go to multiple places to see what is being run everywhere.
+
+If you enjoy using this converted, please star the repo and we very much welcome all pull requests and contributions.
+
+## YAML/JSON vs INI
+
+Consider the following example taken from the [_supervisord_ configuration documentation](http://supervisord.org/configuration.html]):
+
+```ini
+[supervisord]
+nodaemon = false
+minfds = 1024
+minprocs = 200
+umask = 022
+user = chrism
+identifier = supervisor
+directory = /tmp
+nocleanup = true
+childlogdir = /tmp
+strip_ansi = false
+environment = PATH="/usr/bin:/usr/local/bin:/bin:/sbin",ENVIRONMENT="development"
+
+[program:cat]
+command=/bin/cat
+process_name=%(program_name)s
+numprocs=1
+directory=/tmp
+umask=022
+priority=999
+autostart=true
+autorestart=unexpected
+
+```
+
+We think that it is much easier to read this:
+
+```yaml
+supervisord:
+  nodaemon: false
+  minfds: 1024
+  minprocs: 200
+  umask: 022
+  user: chrism
+  identifier: supervisor
+  directory: /tmp
+  nocleanup: true
+  childlogdir: /tmp
+  strip_ansi: false
+  environment: PATH="/usr/bin:/usr/local/bin:/bin:/sbin",ENVIRONMENT="development"
+
+program:
+  cat:
+    command: /bin/cat
+    process_name: %(program_name)s
+    numprocs: 1
+    directory: /tmp
+    umask: 022
+    priority: 999
+    autostart: true
+    autorestart: unexpected
+```
+
+Not only that, but with this structure you can leverage existing tools for merging information from the default environment to your production, and so on.
+
+## Installation
+
+Install the gem:
+
+```
+gem install dupervisor
+``` 
+
+or, if you are using Bundler, you can add it to your gem file like so:
+
+```ruby
+gem 'dupervisor'
+```
+
+## Usage
+
+To perform translations in code, you would use `DuperVisor::Parser` class to parse an existing format, and `DuperVisor::Renderer` class to convert the intermediary hash into the destination format:
+
+```ruby
+# This helper extracts format from a file extension
+Detector.new('myfile.json').detect  # => :json
+
+# This is how you can parse content by specifying the format
+content = Parser.new(File.read('myfile.json')).parse(:json) 
+
+# But the gem can also guess the source format from either 
+# the filename (if available) or the source content
+content = Parser.new(File.read('myfile.json')).parse()
+content.format # => :json
+content.parse_result # => { ... } Hash  
+
+# Finally, here we are using Renderer to convert a hash stored
+# in content.parse_result into a YAML formatted string.
+Renderer.new(content.parse_result).render(:yaml) # => YAML string
+```
+
+You can use the provided executable `dupervisor` to convert from a JSON or YAML file into an INI
+
+### `dv [source-file] [options]`
+
+Summary: convert between several hierarchical configuration file formats, such as ini, yaml, json
+Automatically guesses the source format based either on the file extension, or by attempting to parse it for STDIN.
+
+#### Specific Options
+
+```
+        --ini                        Generate an INI file
+        --yaml                       Generate a YAML file
+        --json                       Generate a JSON file
+    -o, --output [FILE]              File to write, if not supplied write to STDOUT
+    -v, --verbose                    Print extra debugging info
+    -h, --help                       Show this message
+        --version                    Show version
+```
+
+#### Examples
+
+__Guess input format, convert YAML format to an INI file:__
+
+```
+$ cat config.yml | dv --ini > config.ini
+```
+
+__Guess input format, convert INI format to a JSON file:__
+
+```
+$ dv config.ini --json -o config.json
+```
+
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/kigster/dupervisor.
+
+## Author
+
+<p>&copy; 2016 Konstantin Gredeskoul, all rights reserved.</p>
+
+#### Acknowledgements
+
+ * [Shippo, Inc.](https://goshippo.com/) for sponsoring this work financially, and their commitment to open source.
+ * [Wissam Jarjoul](https://github.com/bosswissam) for many great ideas and a good eye for bugs.
+
+## License
+
+This project is distributed under the [MIT License](https://raw.githubusercontent.com/kigster/dupervisor/master/LICENSE).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "dupervisor"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.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/dupervisor.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'dupervisor/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'dupervisor'
+  spec.version       = DuperVisor::VERSION
+  spec.authors       = ['Konstantin Gredeskoul']
+  spec.email         = ['kigster@gmail.com']
+
+  spec.summary       = %q{Convert between YAML/JSON format and Windows INI format. }
+  spec.description   = %q{This gem's purpose in life is to freely convert various configurations between supported formats, which are currently YAML, JSON and Windows INI file format. The gem is named after a popular package supervisord, which uses INI file format for it's configuration. This gem will allow you to move supervisord configuration into a YAML file, and integrate with other DevOps tools, while generating INI file on the fly. When installed, library exposes 'dv' executable, which is a an easy-to-use converter between these three formats.} 
+  spec.homepage      = 'https://github.com/kigster/dupervisor'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'require_dir'
+  spec.add_dependency 'awesome_print'
+  spec.add_dependency 'colored2'
+  spec.add_dependency 'inifile'
+
+  spec.add_development_dependency 'codeclimate-test-reporter'
+  spec.add_development_dependency 'bundler', '~> 1.12'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+end

data/exe/dv

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby -W0
+lib_path = File.dirname(__FILE__) + '/../lib'
+if Dir.exist?(lib_path)
+  $LOAD_PATH << lib_path
+end
+require 'colored2'
+require 'dupervisor'
+require 'awesome_print'
+
+begin
+  DuperVisor::Main.new(DuperVisor::CLI.new(ARGV).parse).run
+rescue DuperVisor::CLIError => e
+  STDERR.puts 'Usage error: ' + e.message.bold.red
+  puts
+  DuperVisor::CLI.new(['--help']).parse
+end

data/lib/dupervisor.rb

@@ -0,0 +1,8 @@
+require 'dupervisor/version'
+require 'require_dir'
+module DuperVisor
+  extend RequireDir
+  init_from_source __FILE__
+end
+
+DuperVisor.dir_r 'dupervisor'

data/lib/dupervisor/cli.rb

@@ -0,0 +1,84 @@
+require 'optparse'
+require 'optparse/time'
+require 'ostruct'
+require 'pp'
+require_relative 'config'
+
+module DuperVisor
+  class CLI
+    attr_accessor :args, :config, :parser
+
+    def initialize(args)
+      self.args    = args
+      self.config = Config.new
+    end
+
+    def parse
+      self.parser = OptionParser.new do |opts|
+        usage_banner(opts)
+
+        opts.on('--ini', 'Generate an INI file') do
+          config.to = :ini
+        end
+        opts.on('--yaml', 'Generate a YAML file') do
+          config.to = :yaml
+        end
+        opts.on('--json', 'Generate a JSON file') do
+          config.to = :json
+        end
+
+        opts.on('-o', '--output [FILE]',
+                'File to write, if not supplied write to STDOUT') do |file|
+          config.output = file
+        end
+
+        opts.on('-v', '--verbose',
+                'Print extra debugging info') do
+          config.verbose = true
+        end
+        example_banner(opts)
+
+        # No argument, shows at tail.  This will print an options summary.
+        # Try it and see!
+        opts.on_tail('-h', '--help', 'Show this message') do
+          puts opts
+          exit
+        end
+
+        # Another typical switch to print the version.
+        opts.on_tail('--version', 'Show version') do
+          puts DuperVisor::VERSION
+          exit
+        end
+      end
+      parser.parse!(args)
+      config
+    end
+
+    def example_banner(opts)
+      opts.separator ''
+      opts.separator 'Examples:'.bold.blue
+      opts.separator ''
+      opts.separator '    # guess input format, convert YAML format to an INI file'
+      opts.separator '    cat config.yml | dv --ini > config.ini'.green
+      opts.separator ''
+      opts.separator '    # guess input format, convert INI format to a JSON file '
+      opts.separator '    dv config.ini --json -o config.json'.green
+
+      opts.separator ''
+      opts.separator 'Common options:'.bold.blue
+    end
+
+    def usage_banner(opts)
+      opts.banner = 'Usage: '.bold.blue + 'dv [source-file] [options] '.bold.green
+      opts.separator ''
+      opts.separator '       Convert between several hierarchical configuration'
+      opts.separator '       file formats, such as ' + 'ini, yaml, json'.bold.green
+      opts.separator ''
+      opts.separator '       Automatically guesses the source format based either on'
+      opts.separator '       the file extension, or by attempting to parse it for STDIN'
+      opts.separator ''
+      opts.separator 'Specific options:'.bold.blue
+    end
+  end
+end

data/lib/dupervisor/config.rb

@@ -0,0 +1,30 @@
+require_relative 'content'
+require_relative 'renderer'
+require_relative 'detector'
+
+module DuperVisor
+  class CLIError < ArgumentError
+  end
+
+  class Config
+    attr_accessor :to, :output, :verbose
+
+    def initialize(to: nil, output: nil, verbose: false)
+      self.to      = to
+      self.verbose = verbose
+      self.output  = output
+    end
+
+    def validate!
+      raise CLIError.new('Either the output format or filename is required!') unless to
+
+      self.output = if output.is_a?(String) && output != ''
+                      File.open(output, 'w')
+                    elsif output.respond_to?(:puts)
+                      output
+                    else
+                      STDOUT
+                    end
+    end
+  end
+end

data/lib/dupervisor/content.rb

@@ -0,0 +1,27 @@
+require 'yaml'
+require 'json'
+require 'inifile'
+
+module DuperVisor
+  #
+  # This class is responsible for taking the input and converting it into a
+  # Hash. It can also be initialized with the Hash, in which no conversion is performed.
+  #
+  # The +result+
+  class Content
+    attr_accessor :body, :format, :parse_result
+
+    def initialize(body: nil, format: nil)
+      self.body   = body
+      self.format = format
+      self.parse_result = {}
+    end
+
+    def self.to_format_from(hash, format)
+      format_class = ::DuperVisor::Formats::Base.formats[format]
+      raise ArgumentError.new("No format #{format} found") unless format_class
+      Content.new(body: format_class.to.call(hash), format: format_class.format)
+    end
+  end
+end
+

data/lib/dupervisor/detector.rb

@@ -0,0 +1,23 @@
+module DuperVisor
+  class Detector
+    attr_accessor :filename
+    def initialize(filename)
+      self.filename = filename
+    end
+
+    def detect
+      format_from_extension(filename) if filename.is_a?(String)
+    end
+
+    private
+
+    def format_from_extension(filename)
+      extension = filename.gsub(/.*\.([\w]+)/, '\1')
+      format = if extension =~ /(json|ya?ml|ini)/i
+        f = extension.downcase.to_sym
+        f == :yml ? :yaml : f
+      end
+      format
+    end
+  end
+end