falkorlib 0.3.14 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0e93d828315d07d5c2c2b2016c9e7436a8e10293
-  data.tar.gz: afdca4fff506283b7e9f00bef8699e13ce01fb01
+  metadata.gz: 844b9104ffcc2838a8b9176658a6ee5b3db82e77
+  data.tar.gz: 918eab8d5e9945fcbc71beeb80d18c3eb2c3a6ae
 SHA512:
-  metadata.gz: 10835e724bc95479750d8aa0ae112c2a814d41bef28f26f213d9e00cbe79234b564b9589771d9cc165ed40658b140dea1048bb544f5844cdddf5a63c2dc6ef44
-  data.tar.gz: 145c8067c68d49fbb2f933c3417c8c82aa5eb89060e74ea731f383e7e5dbadae12da456353c9088aea39b788812a926bf245b35bd6f2b2d6bb5730ed8ff8569f
+  metadata.gz: 204b9fd452435462ee29119978f0747a65138ee6474b546c7a56b76bcc6c8b00c2c60560b8bc7d6ff817ac56829d314551220c54f18a6fde49852189a217ef45
+  data.tar.gz: 264f60f7e3cc56122815f4e0017cb2b55bf741978710f7c70b61d7f3ec25e541e0e2307e3f7594d085bca9ae639d8c3dc2698890fb04c5814f7ea53ec0651824

data/Gemfile.lock

@@ -1,29 +1,31 @@
 PATH
   remote: .
   specs:
-    falkorlib (0.3.14)
+    falkorlib (0.4.0)
       awesome_print (~> 1.2)
       configatron (~> 3.2)
       diffy (>= 3.0)
       git_remote_branch (~> 0)
       json (~> 1.8)
       license-generator (~> 0)
+      logger (>= 1.2.8)
       minigit (~> 0)
       rake (~> 10.1, >= 10.1.0)
       term-ansicolor (~> 1.3)
+      thor (>= 0.19)
 
 GEM
   remote: http://rubygems.org/
   specs:
     addressable (2.3.6)
-    awesome_print (1.2.0)
+    awesome_print (1.6.1)
     backports (3.6.0)
     codeclimate-test-reporter (0.3.0)
       simplecov (>= 0.7.1, < 1.0.0)
     coderay (1.1.0)
     configatron (3.2.0)
     diff-lcs (1.1.3)
-    diffy (3.0.6)
+    diffy (3.0.7)
     docile (1.1.5)
     ethon (0.7.0)
       ffi (>= 1.3.0)
@@ -47,6 +49,7 @@ GEM
       addressable (~> 2.3)
     license-generator (0.4.1)
       thor
+    logger (1.2.8)
     method_source (0.8.2)
     minigit (0.0.4)
     multi_json (1.10.1)
@@ -60,7 +63,7 @@ GEM
     pusher-client (0.6.0)
       json
       websocket (~> 1.0)
-    rake (10.3.2)
+    rake (10.4.2)
     rspec (2.7.0)
       rspec-core (~> 2.7.0)
       rspec-expectations (~> 2.7.0)
@@ -80,7 +83,7 @@ GEM
     term-ansicolor (1.3.0)
       tins (~> 1.0)
     thor (0.19.1)
-    tins (1.3.2)
+    tins (1.3.3)
     travis (1.6.14)
       addressable (~> 2.3)
       backports

data/Rakefile

@@ -1,6 +1,6 @@
 ##############################################################################
 # Rakefile - Configuration file for rake (http://rake.rubyforge.org/)
-# Time-stamp: <Ven 2014-06-20 00:10 svarrette>
+# Time-stamp: <Lun 2015-01-12 21:10 svarrette>
 #
 # Copyright (c) 2012 Sebastien Varrette <Sebastien.Varrette@uni.lu>
 # .             http://varrette.gforge.uni.lu
@@ -16,7 +16,7 @@
 # * http://www.stuartellis.eu/articles/rake/
 ##############################################################################
 
-task :default => [ :build, :rspec ]
+task :default => [ :rspec ]
 #.....................
 require 'rake/clean'
 

data/bin/falkor

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby -U
+# -*- encoding: utf-8 -*-
+################################################################################
+# Time-stamp: <Lun 2015-01-19 14:48 svarrette>
+#
+# Copyright (c) 2015 Sebastien Varrette <Sebastien.Varrette@uni.lu>
+#
+################################################################################
+# Resources:
+#
+# * [cleanthor](https://github.com/lastobelus/cleanthor)
+# * http://chrisparai.so/creating-a-thor-gem/
+# * http://willschenk.com/making-a-command-line-utility-with-gems-and-thor/
+
+# Exit cleanly from an early interrupt
+Signal.trap("INT") { exit 1 }
+
+
+
+require "thor/error"
+require 'falkorlib'
+
+begin
+  FalkorLib::CLI::App.start(ARGV, :debug => true)
+rescue Thor::InvocationError => e
+  error e.message.gsub(/^ERROR:/, '')
+end
+
+

data/completion/falkor.bash

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+################################################################################
+# Time-stamp: <Lun 2015-01-19 16:25 svarrette>
+#
+# BASH completion for [FalkorLib](https://github.com/Falkor/falkorlib)
+#
+# Copyright (c) 2015 Sebastien Varrette <Sebastien.Varrette@uni.lu>
+################################################################################
+_falkor() {
+    COMPREPLY=()
+    local word="${COMP_WORDS[COMP_CWORD]}"
+
+    if [ "$COMP_CWORD" -eq 1 ]; then
+        local commands="$(compgen -W "$(falkor commands)" -- "$word")"
+        COMPREPLY=( $commands $projects )
+    fi
+}
+
+complete -o default -F _falkor falkor

data/completion/falkor.zsh

@@ -0,0 +1,25 @@
+#!/usr/bin/env zsh
+################################################################################
+# Time-stamp: <Lun 2015-01-19 16:24 svarrette>
+#
+# ZSH completion for [FalkorLib](https://github.com/Falkor/falkorlib)
+#
+# Copyright (c) 2015 Sebastien Varrette <Sebastien.Varrette@uni.lu>
+################################################################################
+
+if [[ ! -o interactive ]]; then
+    return
+fi
+
+compctl -f -K _falkor falkor
+
+_falkor() {
+    local words completions
+    read -cA words
+
+    if [ "${#words}" -eq 2 ]; then
+        completions="$(falkor commands)"
+    fi
+
+    reply=("${(ps:\n:)completions}")
+}

data/falkorlib.gemspec

@@ -101,7 +101,7 @@ Gem::Specification.new do |s|
 
     # Executables included in the gem.
     #
-    #s.executables = (Dir["bin/*"]).collect{|f| File.basename(f)}
+    s.executables = (Dir["bin/*"]).collect{|f| File.basename(f)}
 
     ################################################################### REQUIREMENTS & INSTALL
     # Remember the gem version requirements operators and schemes:
@@ -133,7 +133,11 @@ Gem::Specification.new do |s|
 	s.add_runtime_dependency("json", "~> 1.8")
 	s.add_runtime_dependency("license-generator", '~> 0')
 	s.add_runtime_dependency("diffy", '>= 3.0')
+	s.add_runtime_dependency("logger", '>= 1.2.8')
+    s.add_runtime_dependency("thor",      '>= 0.19')
+    #s.add_runtime_dependency("mercenary", '>= 0.3.5')
 
+    #
     #
     # One call to add_dependency('gem_name', 'gem version requirement') for each
     # runtime dependency. These gems will be installed with your gem.

data/lib/falkorlib.rb

@@ -1,6 +1,6 @@
 # -*- encoding: utf-8 -*-
 ################################################################################
-# Time-stamp: <Sam 2014-08-23 23:18 svarrette>
+# Time-stamp: <Mar 2015-01-13 21:24 svarrette>
 ################################################################################
 #                   _____     _ _              _     _ _
 #                   |  ___|_ _| | | _____  _ __| |   (_) |__
@@ -47,5 +47,6 @@ module FalkorLib
 
 end # module FalkorLib
 
+
 require "falkorlib/version"
 require "falkorlib/loader"

data/lib/falkorlib/bootstrap.rb

@@ -0,0 +1,15 @@
+# -*- encoding: utf-8 -*-
+################################################################################
+# Time-stamp: <Mer 2015-01-21 22:35 svarrette>
+################################################################################
+# Management of Bootstrapping operations
+
+require "falkorlib"
+
+module FalkorLib #:nodoc:
+
+end # module FalkorLib
+
+require "falkorlib/bootstrap/base"
+#require "falkorlib/bootstrap/repo"
+ 

data/lib/falkorlib/bootstrap/base.rb

@@ -0,0 +1,241 @@
+# -*- encoding: utf-8 -*-
+################################################################################
+# Time-stamp: <Ven 2015-01-23 00:12 svarrette>
+################################################################################
+# Interface for the main Bootstrapping operations
+#
+
+require "falkorlib"
+require "falkorlib/common"
+
+include FalkorLib::Common
+
+module FalkorLib  #:nodoc:
+    module Config
+
+        # Default configuration for Bootstrapping processes
+        module Bootstrap
+            DEFAULTS =
+              {
+               :trashdir => '.Trash',
+               :types    => [ 'article', 'slides', 'gem', 'octopress', 'puppet_module', 'rvm' ],
+               :rvm => {
+                        :version     => '1.9.3',
+                        :versionfile => '.ruby-version',
+                        :gemsetfile  => '.ruby-gemset'
+                       },
+               :puppet   => {},
+              }
+
+
+        end
+    end
+end
+
+
+
+module FalkorLib
+    module Bootstrap
+        module_function
+
+        ###
+        # Initialize a trash directory in path
+        ##
+        def trash(path = Dir.pwd, dirname = FalkorLib.config[:templates][:trashdir], options = {})
+            #args = method(__method__).parameters.map { |arg| arg[1].to_s }.map { |arg| { arg.to_sym => eval(arg) } }.reduce Hash.new, :merge
+            #ap args
+            exit_status = 0
+            trashdir = File.join(path, dirname)
+            if Dir.exists?(trashdir)
+                warning "The trash directory '#{dirname}' already exists"
+                return 1
+            end
+            Dir.chdir(path) do
+                info "creating the trash directory '#{dirname}'"
+                exit_status = run %{
+          mkdir -p #{dirname}
+          echo '*' > #{dirname}/.gitignore
+                }
+                if FalkorLib::Git.init?(path)
+                    exit_status = FalkorLib::Git.add(File.join(path, dirname, '.gitignore' ),
+                                                     'Add Trash directory',
+                                                     { :force => true } )
+                end
+            end
+            exit_status.to_i
+        end # trash
+
+        ###### rvm ######
+        # Initialize RVM in the current directory
+        # Supported options:
+        #  * :force       [boolean] force overwritting
+        #  * :ruby        [string]  Ruby version to configure for RVM
+        #  * :versionfile [string]  Ruby Version file
+        #  * :gemset      [string]  RVM Gemset to configure
+        #  * :gemsetfile  [string]  RVM Gemset file
+        #  * :commit      [boolean] Commit the changes NOT YET USED
+        ##
+        def rvm(dir = Dir.pwd, options = {})
+            info "Initialize Ruby Version Manager (RVM)"
+            ap options if options[:debug]
+            path = normalized_path(dir)
+            use_git = FalkorLib::Git.init?(path)
+            rootdir = use_git ? FalkorLib::Git.rootdir(path) : path
+            files = {}
+            exit_status = 1
+            [:versionfile, :gemsetfile].each do |type|
+                f = options[type.to_sym].nil? ? FalkorLib.config[:rvm][type.to_sym] : options[type.to_sym]
+                if File.exists?( File.join( rootdir, f ))
+                    content = `cat #{File.join( rootdir, f)}`.chomp
+                    warning "The RVM file '#{f}' already exists (and contains '#{content}')"
+                    next unless options[:force]
+                    warning "... and it WILL BE overwritten"
+                end
+                files[type.to_sym] = f
+            end
+            # ==== Ruby version ===
+            unless files[:versionfile].nil?
+                file = File.join(rootdir, files[:versionfile])
+                v =
+                  options[:ruby] ?
+                  options[:ruby] :
+                  select_from(FalkorLib.config[:rvm][:rubies],
+                              "Select RVM ruby to configure for this directory",
+                              1)
+                info " ==>  configuring RVM version file '#{files[:versionfile]}' for ruby version '#{v}'"
+                File.open(file, 'w') do |f|
+                    f.puts v
+                end
+                exit_status = (File.exists?(file) and `cat #{file}`.chomp == v) ? 0 : 1
+                FalkorLib::Git.add(File.join(rootdir, files[:versionfile])) if use_git
+            end
+            # === Gemset ===
+            if files[:gemsetfile]
+                file = File.join(rootdir, files[:gemsetfile])
+                default_gemset = File.basename(rootdir)
+                default_gemset = `cat #{file}`.chomp if File.exists?( file )
+                g = options[:gemset] ? options[:gemset] : ask("Enter RVM gemset name for this directory", default_gemset)
+                info " ==>  configuring RVM gemset file '#{files[:gemsetfile]}' with content '#{g}'"
+                File.open( File.join(rootdir, files[:gemsetfile]), 'w') do |f|
+                    f.puts g
+                end
+                exit_status = (File.exists?(file) and `cat #{file}`.chomp == g) ? 0 : 1
+                FalkorLib::Git.add(File.join(rootdir, files[:gemsetfile])) if use_git
+            end
+            exit_status
+        end # rvm
+
+        ###### repo ######
+        # Initialize a Git repository for a project with my favorite layout
+        # Supported options:
+        # :interactive [boolean] Confirm Gitflow branch names
+        # :master      [string]  Branch name for production releases
+        # :develop     [string]  Branch name for development commits
+        # :make        [boolean] Use a Makefile to pilot the repository actions
+        # :rake        [boolean] Use a Rakefile (and FalkorLib) to pilot the repository action
+        # :remote_sync [boolean] Operate a git remote synchronization
+        ##
+        def repo(name, options = {})
+            ap options if options[:debug]
+            path    = normalized_path(name)
+            project = File.basename(path)
+            use_git = FalkorLib::Git.init?(path)
+            info "Bootstrap a [Git] repository for the project '#{project}'"
+            if use_git
+                warning "Git is already initialized for the repository '#{name}'"
+                really_continue? unless options[:force]
+            end
+            info " ==> initialize Git flow in #{path}"
+            FalkorLib::GitFlow.init(path, options)
+            gitflow_branches = {}
+            [ :master, :develop ].each do |t|
+                gitflow_branches[t.to_sym] = FalkorLib::GitFlow.branches(t, path)
+            end
+            # === prepare Git submodules ===
+            info " ==> prepare the relevant Git submodules"
+            submodules = {
+                          'gitstats' => { :url => 'https://github.com/hoxu/gitstats.git' }
+                         }
+            if options[:make]
+                submodules['Makefiles'] = {
+                                           :url    => 'https://github.com/Falkor/Makefiles.git',
+                                           :branch => 'devel'
+                                          }
+            end
+            FalkorLib::Git.submodule_init(path, submodules)
+            # === Prepare root [M|R]akefile ===
+            if options[:make]
+                info " ==> prepare Root Makefile"
+                makefile = File.join(path, "Makefile")
+                unless File.exist?( makefile )
+                    src_makefile = File.join(path, FalkorLib.config.git[:submodulesdir],
+                                             'Makefiles', 'repo', 'Makefile')
+                    FileUtils.cp src_makefile, makefile
+                    info "adapting Makefile to the gitflow branches"
+                    Dir.chdir( path ) do
+                        run %{
+   sed -i '' \
+        -e \"s/^GITFLOW_BR_MASTER=production/GITFLOW_BR_MASTER=#{gitflow_branches[:master]}/\" \
+        -e \"s/^GITFLOW_BR_DEVELOP=devel/GITFLOW_BR_DEVELOP=#{gitflow_branches[:develop]}/\" \
+        Makefile
+                        }
+                    end
+                    FalkorLib::Git.add(makefile, 'Initialize root Makefile for the repo')
+                else
+                    puts "  ... not overwriting the root Makefile which already exists"
+                end
+            end
+            if options[:rake]
+                warning "TODO: setup Rakefile"
+            end
+
+            # === VERSION file ===
+            FalkorLib::Bootstrap.versionfile(path, :tag => 'v0.0.0')
+
+            #===== remote synchro ========
+            if options[:remote_sync]
+                remotes  = FalkorLib::Git.remotes(path)
+                if remotes.include?( 'origin' )
+                    info "perform remote synchronization"
+                    [ :master, :develop ].each do |t|
+                        FalkorLib::Git.publish(gitflow_branch[t.to_sym], path, 'origin')
+                    end
+                else
+                    warning "no Git remote  'origin' found, thus no remote synchronization performed"
+                end
+            end
+
+        end # repo
+
+        ###### versionfile ######
+        # Bootstrap a VERSION file at the root of a project
+        # Supported options:
+        # * :file [string] filename
+        ##
+        def versionfile(dir = Dir.pwd, options = {})
+            file    = options[:file]    ? options[:file]    : 'VERSION'
+            version = options[:version] ? options[:version] : '0.0.0'
+            info " ==> bootstrapping a VERSION file"
+            path = normalized_path(dir)
+            path = FalkorLib::Git.rootdir(path) if FalkorLib::Git.init?(path)
+            unless Dir.exists?( path )
+                warning "The directory #{path} does not exists and will be created"
+                really_continue?
+                FileUtils.mkdir_p path
+            end
+            versionfile = File.join(path, file)
+            unless File.exists?( versionfile )
+                run %{  echo "#{version}" > #{versionfile} }
+                if FalkorLib::Git.init?(path)
+                    FalkorLib::Git.add(versionfile, "Initialize #{file} file")
+                    Dir.chdir( path ) do
+                        run %{ git tag #{options[:tag]} } if options[:tag]
+                    end
+                end
+            else
+                puts "  ... not overwriting the #{file} file which already exists"
+            end
+        end # versionfile
+
+    end # module Bootstrap
+end # module FalkorLib