falkorlib 0.7.18 → 0.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e9ac26908e8ce646855d75dcb16306238e5d076a
-  data.tar.gz: 5bc7b5df10fa94899039eb60ec0734fc544a6872
+  metadata.gz: 293f8e0a679cbb41fe60088ac8c5af3733314836
+  data.tar.gz: 3dfb1d70887c8a85970e17f953ab587669eb7939
 SHA512:
-  metadata.gz: 89e9b34f9c11dbfbeb6f4bcddd4a2cf85ae86038fc601f34f30c3c3822d258cd486c2fe0f907c0ffcdadd0af11691e1c4d026d159203b35915a42653ecf9691d
-  data.tar.gz: 0af69b51808b3a84741ebf1a6f00baefe038904b23920058253c2e89ac29fab3ce87d2a47ea2456f7a08b201cc103ae09036bf67ed02877f9ca4323cc13a023b
+  metadata.gz: d8757a823057832f31e7a5f09155bb2d41df3275a1584a947bb68333d36fbd99cdcb7ccbf130274ccf645fc2003869f6af454090c33f0050b14a21b1cfc7284f
+  data.tar.gz: 4119b57d72bc6ede622aebda462777c7c7d6ef4a852c95a1c609e5d390f12c532b65765c1c088ac4db4e3126de0b3867fa0c46fe3297bb5d0f39cbd87c7ddad1

data/.travis.yml

@@ -23,15 +23,18 @@ addons:
     - unzip
     - git
     - git-flow
-    - git-crypt
+    # - git-crypt
   hosts:
     - travis.dev
 before_install:
   - gem install bundler
 rvm:
- - 2.0.0
+# - 2.0.0
  - 2.1
  - 2.2
+ - 2.3
+ - 2.4
+ - 2.5
 env:
   global:
   - TRAVIS_CI_RUN=true

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    falkorlib (0.7.18)
+    falkorlib (0.8.1)
       activesupport (~> 4.0)
       artii (>= 2.1)
       awesome_print (~> 1.2)

data/README.md

@@ -2,10 +2,8 @@
 
 [![Version     ](https://badge.fury.io/rb/falkorlib.png)](http://badge.fury.io/rb/falkorlib)
 [![Build Status](https://travis-ci.org/Falkor/falkorlib.png)](https://travis-ci.org/Falkor/falkorlib)
-[![Code Climate](https://codeclimate.com/github/Falkor/falkorlib.png)](https://codeclimate.com/github/Falkor/falkorlib)
-[![Test Coverage](https://codeclimate.com/github/Falkor/falkorlib/coverage.png)](https://codeclimate.com/github/Falkor/falkorlib)
-[![Inline docs ](http://inch-ci.org/github/Falkor/falkorlib.svg)](http://inch-ci.org/github/Falkor/falkorlib)
-[![Gittip](http://img.shields.io/gittip/Falkor.svg)](http://gittip.com/Falkor)
+[![Code Climate](https://codeclimate.com/github/Falkor/falkorlib.png)](https://codeclimate.com/github/Falkor/falkorlib) [![Test Coverage](https://api.codeclimate.com/v1/badges/9f1c7762f29572b3f8f0/test_coverage)](https://codeclimate.com/github/Falkor/falkorlib/test_coverage)
+[![Inline docs ](http://inch-ci.org/github/Falkor/falkorlib.svg)](http://inch-ci.org/github/Falkor/falkorlib)[![Liberapay receiving](https://img.shields.io/liberapay/receives/Falkor.svg)](https://liberapay.com/Falkor/donate)
 
                     _____     _ _              _     _ _
                    |  ___|_ _| | | _____  _ __| |   (_) |__
@@ -14,7 +12,7 @@
                    |_|  \__,_|_|_|\_\___/|_|  |_____|_|_.__/
 
 
-        Copyright (c) 2012-2017 Sebastien Varrette <Sebastien.Varrette@uni.lu>
+        Copyright (c) 2012-2018 Sebastien Varrette <Sebastien.Varrette@uni.lu>
 
 Sebastien Varrette aka Falkor's Common library to share Ruby code, `{rake,cap}`
 tasks and project templates
@@ -46,7 +44,7 @@ Or install it yourself as:
 This library features two aspects
 
 * a binary `falkor` I use daily to bootstrap and operate with the projects I'm
-  working one
+  working one -- see below for an brief overview of the provided commands
 
 * A set of toolbox functions / components I'm using everywhere in my Ruby
   developments, more specifically a set of modules:
@@ -98,7 +96,7 @@ This library features two aspects
 
 		require "falkorlib/tasks/<object>" # OR require "falkorlib/<object>_tasks"
 
-### `FalkorLib` Ruby Modules / Classes Documentation
+## `FalkorLib` Ruby Modules / Classes Documentation
 
 [Online documentation](https://rubygems.org/gems/falkorlib) is a available.
 Yet to get the latest version, you might want to run
@@ -111,7 +109,65 @@ Statistics on the documentation generation (in particular *non*-documented compo
 
 	$> rake yard:stats
 
-### Overview of the implemented Rake tasks
+## Overview of the `falkor` CLI
+
+This library comes with a CLI `falkor`, providing the following [sub] commands.
+
+__Base commands__
+
+| Command                            | Description                                                       |
+|------------------------------------|-------------------------------------------------------------------|
+| `falkor --version, -V`             | Print the version number of Falkor[Lib]                           |
+| `falkor help [COMMAND]`            | Describe available commands or one specific command               |
+| `falkor gitcrypt <PATH> [options]` | Initialize git-crypt for the current repository                   |
+| `falkor init <PATH> [options]`     | Bootstrap a Git[flow] Repository                                  |
+| `falkor mkdocs [options]`          | Initialize mkdocs for the current project                         |
+| `falkor motd <PATH> [options]`     | Initiate a 'motd' file - message of the day                       |
+| `falkor vagrant [options]`         | Initialize vagrant for the current project                        |
+
+__`falkor link <type> [path]`__
+
+Initialize a special symlink in `<path>` (the current directory by default)
+
+| Command                         | Description                                                                                               |
+|---------------------------------|-----------------------------------------------------------------------------------------------------------|
+| `falkor link help [COMMAND]`    | Get help on the corresponding sub command                                                                 |
+| `falkor link make [options]`    | Create a symlink to one of [Falkor's Makefile](https://github.com/Falkor/Makefiles), set as Git submodule |
+| `falkor link rootdir [options]` | Create a symlink `.root` which targets the root of the repository                                         |
+
+__`falkor new <stuff> [path]`__
+
+Initialize the directory `<path>` (the current directory by default) with one of FalkorLib's template(s)
+
+| Command                                 | Description                                                    |
+|-----------------------------------------|----------------------------------------------------------------|
+| `falkor new help [COMMAND]`             | Describe subcommands or one specific subcommand                |
+| `falkor new article [options]`          | Bootstrap a LaTeX Article                                      |
+| `falkor new letter [options]`           | LaTeX-based letter                                             |
+| `falkor new license [options]`          | Generate an Open-Source License for your project               |
+| `falkor new make [options]`             | Initiate one of Falkor's Makefile                              |
+| `falkor new pyenv PATH [options]`       | Initialize pyenv/direnv                                        |
+| `falkor new readme PATH [options]`      | Initiate a README file in the PATH directory ('./' by default) |
+| `falkor new repo NAME [options]`        | Bootstrap a Git Repository                                     |
+| `falkor new rvm PATH [options]`         | Initialize RVM                                                 |
+| `falkor new slides [options]`           | Bootstrap LaTeX Beamer slides                                  |
+| `falkor new trash PATH`                 | Add a Trash directory                                          |
+| `falkor new versionfile PATH [options]` | initiate a VERSION file                                        |
+
+__`falkor make <type> [path]`__
+
+| Command                     | Description                                           |
+|-----------------------------|-------------------------------------------------------|
+| `falkor new help [COMMAND]` | Describe subcommands or one specific subcommand       |
+| `falkor make generic`       | Symlink to Generic Makefile for sub directory         |
+| `falkor make gnuplot`       | Symlink to a Makefile to compile GnuPlot scripts      |
+| `falkor make latex`         | Symlink to a Makefile to compile LaTeX documents      |
+| `falkor make repo`          | Create a root Makefile piloting repository operations |
+
+
+A ZSH completion files is also maintained for this command, you'll find it in [`completion/_falkor`](completion/_falkor)
+
+## Overview of the implemented Rake tasks
 
 You can find the list of implemented Rake tasks (detailed below) in the
 `lib/falkorlib/*_tasks.rb` files

data/completion/_falkor

@@ -1,7 +1,7 @@
 #compdef falkor
 ########################################################################################
 # -*- mode:sh; -*-
-# Time-stamp: <Thu 2018-11-08 23:50 svarrette>
+# Time-stamp: <Wed 2018-11-21 11:53 svarrette>
 #
 # ZSH completion for [FalkorLib](https://github.com/Falkor/falkorlib)
 #
@@ -105,16 +105,17 @@ __falkor_new()
 {
     local -a _falkor_new_cmds
     _falkor_new_cmds=(
-        'repo:Bootstrap a Git Repository with my favorite git-flow layout'
         'article:Bootstrap a LaTeX Article'
         'letter:LaTeX-based letter'
+        'license:Generate an Open-Source License for your project'
+        'make:Initiate one of Falkor Makefile'
+        'pyenv:Initialize pyenv/direnv'
+        'readme:Initiate a README file in the PATH directory (''./'' by default)'
+        'repo:Bootstrap a Git Repository with my favorite git-flow layout'
+        'rvm:Initialize RVM'
         'slides:Bootstrap LaTeX Beamer slides'
         'trash:Add a Trash directory for your LaTeX project'
-        'rvm:Initialize RVM'
         'versionfile:initiate a VERSION file'
-        'license:Generate an Open-Source License for your project'
-        'motd:Initiate a ''motd'' file - message of the day'
-        'readme:Initiate a README file in the PATH directory (''./'' by default)'
         'help:Describe subcommands or one specific subcommand'
     )
 
@@ -161,6 +162,16 @@ __falkor_new()
                                {--images,-i,--img}'[Makefile to optimize images]' \
                                {--src,-s}'[Path to Falkor''s Makefile for latex_src]' && ret=0
                     ;;
+                (pyenv)
+                    _arguments -C \
+                               '--python[Python version to configure]:version' \
+                               '--virtualenv[Virtualenv to configure for this directory]:env' \
+                               '*: :->path' && ret=0
+                    case "$state" in
+                        (path)
+                            _directories ;;
+                    esac
+                    ;;
                 (readme)
                     _arguments -C \
                                '--make[Use a Makefile to pilot the repository actions]' \

data/lib/falkorlib/bootstrap.rb

@@ -1,6 +1,6 @@
 # -*- encoding: utf-8 -*-
 ################################################################################
-# Time-stamp: <Fri 2018-04-27 13:46 svarrette>
+# Time-stamp: <Sun 2018-11-11 18:03 svarrette>
 ################################################################################
 # Management of Bootstrapping operations
 
@@ -11,11 +11,12 @@ module FalkorLib #:nodoc:
 end # module FalkorLib
 
 require "falkorlib/bootstrap/base"
-require "falkorlib/bootstrap/link"
-require "falkorlib/bootstrap/ruby"
 require "falkorlib/bootstrap/git"
 require "falkorlib/bootstrap/latex"
+require "falkorlib/bootstrap/link"
 require "falkorlib/bootstrap/mkdocs"
+require "falkorlib/bootstrap/ruby"
+require "falkorlib/bootstrap/python"
 require "falkorlib/bootstrap/vagrant"
 
 #require "falkorlib/bootstrap/repo"

data/lib/falkorlib/bootstrap/base.rb

@@ -1,6 +1,6 @@
 # -*- encoding: utf-8 -*-
 ################################################################################
-# Time-stamp: <Thu 2018-11-08 17:47 svarrette>
+# Time-stamp: <Thu 2018-11-29 11:39 svarrette>
 ################################################################################
 # Interface for the main Bootstrapping operations
 #
@@ -183,7 +183,7 @@ module FalkorLib
         gitflow_branches = FalkorLib::Config::GitFlow::DEFAULTS[:branches]
         if FalkorLib::GitFlow.init?(path)
           [ :master, :develop ].each do |b|
-            gitflow_branches[t.to_sym] = FalkorLib::GitFlow.branches(b.to_sym)
+            gitflow_branches[b.to_sym] = FalkorLib::GitFlow.branches(b.to_sym)
           end
         end
         unless options.nil?

data/lib/falkorlib/bootstrap/python.rb

@@ -0,0 +1,169 @@
+# -*- encoding: utf-8 -*-
+################################################################################
+# Time-stamp: <Wed 2018-11-21 11:46 svarrette>
+################################################################################
+# Interface for the main python Bootstrapping operations
+#
+
+require "falkorlib"
+require "falkorlib/common"
+require "falkorlib/bootstrap"
+
+require 'erb' # required for module generation
+require 'artii'
+require 'facter'
+
+include FalkorLib::Common
+
+
+
+module FalkorLib
+  module Bootstrap #:nodoc:
+
+    module_function
+
+    ###### pyenv ######
+    # Initialize pyenv/direnv in the current directory
+    # Supported options:
+    #  * :force          [boolean] force overwritting
+    #  * :python         [string]  Python version to configure for pyenv
+    #  * :virtualenv     [string]  Python virtualenv name to configure
+    #  * :versionfile    [string]  Python Version file
+    #  * :virtualenvfile [string]  Python virtualenv file (specifying its name)
+    #  * :direnvfile     [string]  Direnv configuration file
+    #  * :commit         [boolean] Commit the changes NOT YET USED
+    #  * :global         [boolean] Also configure the global direnv configuration
+    #  .                           in ~/.config/direnv
+    ##
+    def pyenv(dir = Dir.pwd, options = {})
+      info "Initialize Pyenv-virtualenv and direnv setup in '#{dir}'"
+      ap options if options[:debug]
+      path = normalized_path(dir)
+      unless File.directory?(path)
+        warning "The directory '#{path}' does not exist yet."
+        warning 'Do you want to create (and git init) this directory?'
+        really_continue?
+        run %(mkdir -p #{path})
+      end
+      use_git = FalkorLib::Git.init?(path)
+      rootdir = (use_git) ? FalkorLib::Git.rootdir(path) : path
+      config =  FalkorLib::Config::DEFAULTS[:pyenv].clone
+      files = {}   # list of files to create
+      exit_status = 1
+      # Specialize configuration
+      [:versionfile, :virtualenvfile, :direnvfile].each do |k|
+        #config[k] =  (options[k]) ? options[k] : ask("\t" + Kernel.format("%-20s", "#{k.to_s.capitalize.gsub!(/file/, ' filename')}"), config[k])
+        config[k] = options[k] if options[k]
+        if File.exist?( File.join( rootdir, config[k] ))
+          content = `cat #{File.join( rootdir, config[k])}`.chomp
+          warning "The python/pyenv file '#{config[k]}' already exists"
+          warning "    (with content '#{content}')" unless k == :direnvfile
+          next unless options[:force]
+          warning "... and it WILL BE overwritten"
+        end
+        files[k] = config[k]
+      end
+      # ==== Python version ===
+      unless files[:versionfile].nil?
+        file = File.join(rootdir, config[:versionfile])
+        config[:version] = FalkorLib.config[:pyenv][:version]
+        if options[:python]
+          config[:version] = options[:python]
+        else
+          config[:version] = select_from(FalkorLib.config[:pyenv][:versions],
+                                         "Select Python pyenv version to configure for this directory",
+                                         (FalkorLib.config[:pyenv][:versions].find_index(FalkorLib.config[:pyenv][:version]) + 1))
+        end
+        info " ==>  configuring pyenv version file '#{config[:versionfile]}' for python version '#{config[:version]}'"
+        File.open(file, 'w') do |f|
+          f.puts config[:version]
+        end
+        exit_status = (File.exist?(file) && (`cat #{file}`.chomp == config[:version])) ? 0 : 1
+        FalkorLib::Git.add( file ) if use_git
+      end
+      # === Virtualenv ===
+      if files[:virtualenvfile]
+        file = File.join(rootdir, files[:virtualenvfile])
+        default_virtualenv = File.basename(rootdir)
+        default_virtualenv = `cat #{file}`.chomp if File.exist?( file )
+        g = (options[:virtualenv]) ? options[:virtualenv] : ask("Enter virtualenv name for this directory", default_virtualenv)
+        info " ==>  configuring virtualenv file '#{files[:virtualenvfile]}' with content '#{g}'"
+        File.open( File.join(rootdir, files[:virtualenvfile]), 'w') do |f|
+          f.puts g
+        end
+        exit_status = (File.exist?(file) && (`cat #{file}`.chomp == g)) ? 0 : 1
+        FalkorLib::Git.add(File.join(rootdir, files[:virtualenvfile])) if use_git
+      end
+      # ==== Global direnvrc ====
+      if options and options[:global]
+        direnvrc     = config[:direnvrc]
+        direnvrc_dir = File.dirname( direnvrc )
+        unless File.directory?( direnvrc_dir )
+          warning "The directory '#{direnvrc_dir}' meant for hosting the globa direnv settings does not exist"
+          warning "About to create this directory"
+          really_continue?
+          run %(mkdir -p #{direnvrc_dir})
+        end
+        if (!File.exists?(direnvrc) or options[:force])
+          templatedir = File.join( FalkorLib.templates, 'direnv')
+          info " ==> configuring Global direnvrc #{files[:direnvrc]}"
+          init_from_template(templatedir, direnvrc_dir, config,
+                             :no_interaction => true,
+                             :no_commit      => true,
+                            )
+        end
+      end
+      # ==== Local Direnv setup and .envrc ===
+      if files[:direnvfile]
+        envrc = File.join(rootdir, files[:direnvfile])
+        setup = File.join(rootdir, 'setup.sh')
+        if (!File.exists?(setup) or options[:force])
+          templatedir = File.join( FalkorLib.templates, 'python')
+          info " ==> configuring local direnv setup and #{files[:direnvfile]}"
+          init_from_template(templatedir, rootdir, config,
+                             :no_interaction => true,
+                             :no_commit => true,
+                            )
+        end
+        if (!File.exists?(envrc) or options[:force])
+          run %(ln -s setup.sh #{envrc})
+        end
+        FalkorLib::Git.add( envrc ) if use_git
+        FalkorLib::Git.add( setup ) if use_git
+      end
+      # Last motd
+      warning <<-MOTD
+
+----------------------------------------------------------------------------
+Direnv/Pyenv configured for #{path}.
+For more detailed instructions, see
+     https://varrette.gforge.uni.lu/tutorials/pyenv.html
+
+Now you probably need to perform the following actions:
+
+    cd #{path}
+    direnv allow .
+    # Eventually install the pyenv version
+    pyenv install #{config[:version]}
+
+You can then enjoy your newly configured sand-boxed environment
+
+    pip list
+    pip install numpy scipy matplotlib
+    pip install jupyter ipykernel
+    python -m ipykernel install --user --name=$(head .python-virtualenv)
+    jupyter notebook
+
+To freeze your environment to pass it around
+
+    pip freeze -l  # List all the pip packages used in the virtual environment
+    pip freeze -l > requirements.txt  # Dump it to a requirements file
+    git add requirements.txt
+    git commit -s -m 'Python package list' requirements.txt
+
+MOTD
+      exit_status.to_i
+    end # rvm
+
+  end # module Bootstrap
+end # module FalkorLib

data/lib/falkorlib/bootstrap/ruby.rb

@@ -1,8 +1,8 @@
 # -*- encoding: utf-8 -*-
 ################################################################################
-# Time-stamp: <Sat 2016-11-12 02:32 svarrette>
+# Time-stamp: <Sun 2018-11-11 18:03 svarrette>
 ################################################################################
-# Interface for the main Bootstrapping operations
+# Interface for the bootstrapping RVM/ruby operations
 #
 
 require "falkorlib"

data/lib/falkorlib/cli/new.rb

@@ -1,6 +1,6 @@
 # -*- encoding: utf-8 -*-
 ################################################################################
-# Time-stamp: <Thu 2018-11-08 17:01 svarrette>
+# Time-stamp: <Wed 2018-11-21 11:45 svarrette>
 ################################################################################
 
 require 'thor'
@@ -43,12 +43,12 @@ By default, NAME is '.' meaning that the repository will be initialized in the c
       method_option :make, :default => true,     :type => :boolean, :desc => 'Use a Makefile to pilot the repository actions'
       method_option :rake, :type => :boolean, :desc => 'Use a Rakefile (and FalkorLib) to pilot the repository actions'
       method_option :interactive, :aliases => '-i', :default => true,
-                                  :type => :boolean, :desc => "Interactive mode, in particular to confirm Gitflow branch names"
+                    :type => :boolean, :desc => "Interactive mode, in particular to confirm Gitflow branch names"
       method_option :remote_sync, :aliases => '-r',
-                                  :type => :boolean, :desc => "Operate a git remote synchronization with remote. By default, all commits stay local"
+                    :type => :boolean, :desc => "Operate a git remote synchronization with remote. By default, all commits stay local"
       method_option :master, :default => 'production', :banner => 'BRANCH', :desc => "Master Branch name for production releases"
       method_option :develop, :aliases => [ '-b', '--branch', '--devel'],
-                              :default => 'devel', :banner => 'BRANCH', :desc => "Branch name for development commits"
+                    :default => 'devel', :banner => 'BRANCH', :desc => "Branch name for development commits"
       #method_option :latex, :aliases => '-l', :type => :boolean, :desc => "Initiate a LaTeX project"
       #method_option :gem,   :type => :boolean, :desc => "Initiate a Ruby gem project"
       method_option :ruby, :default => '2.1.10', :desc => "Ruby version to configure for RVM"
@@ -77,7 +77,7 @@ By default, NAME is '.' meaning that the repository will be initialized in the c
       desc "article [options]", "Bootstrap a LaTeX Article"
       #___________________
       def article(path = Dir.pwd)
-          FalkorLib::Bootstrap.latex(path, :article, options)
+        FalkorLib::Bootstrap.latex(path, :article, options)
       end # article
 
 
@@ -103,17 +103,17 @@ By default, NAME is '.' meaning that the repository will be initialized in the c
 
       ##### make ######
       method_option :repo, :type => :boolean, :aliases => '-r',
-                            :desc => "Create a root Makefile piloting repository operations"
+                    :desc => "Create a root Makefile piloting repository operations"
       method_option :latex, :type => :boolean, :aliases => '-l',
-                            :desc => "Makefile to compile LaTeX documents"
+                    :desc => "Makefile to compile LaTeX documents"
       method_option :gnuplot, :type => :boolean, :aliases => ['--plot', '-p'],
-                              :desc => "Makefile to compile GnuPlot scripts"
+                    :desc => "Makefile to compile GnuPlot scripts"
       method_option :generic, :type => :boolean, :aliases => '-g',
-                              :desc => "Generic Makefile for sub directory"
+                    :desc => "Generic Makefile for sub directory"
       method_option :images, :type => :boolean, :aliases => [ '-i', '--img' ],
-                             :desc => "Makefile to optimize images"
+                    :desc => "Makefile to optimize images"
       method_option :src, :type => :boolean, :aliases => [ '--src', '-s' ],
-                          :desc => "Path to Falkor's Makefile for latex_src"
+                    :desc => "Path to Falkor's Makefile for latex_src"
       #......................................
       desc "make [options]", "Initiate one of Falkor's Makefile"
       def make(dir = Dir.pwd)
@@ -127,6 +127,39 @@ By default, NAME is '.' meaning that the repository will be initialized in the c
       end # make
 
 
+      ###### pyenv ######
+      desc "pyenv PATH [options]", "Initialize pyenv/direnv"
+      long_desc <<-PYENV_LONG_DESC
+Initialize  pyenv/direnv for the current directory (or at the root directory of the Git repository)
+according to the configuration suggested on https://varrette.gforge.uni.lu/tutorials/pyenv.html
+
+It consists of the following files:
+\x5 * `.python-version`:    Project file hosting a single line for the expected python version
+\x5 * `.python-virtualenv`: Virtualenv file hosting a single line for the virtualenv to use for this project
+\x5 * `.envrc` (symlink to `setup.sh`): Direnv configuration meant to automatically activate the configured virtualenv when entering the directory (and deactivate when quitting).
+
+These files will be committed in Git to ensure a consistent environment for the project.
+
+Eventually (with the --global option enabled by default), the global direnvrc file will be setup for you (in `~/.config/direnv/direnvrc`)
+PYENV_LONG_DESC
+      method_option :force, :aliases => '-f',
+                    :type => :boolean, :desc => 'Force overwritting the  pyenv/direnv config'
+      method_option :python, :banner => 'VERSION', :aliases => [ '--pyenv', '-p' ],
+                    :desc => 'Python version to configure / install for pyenv'
+      method_option :versionfile, :banner => 'FILE',
+                    :default => FalkorLib.config[:pyenv][:versionfile], :desc => 'Python Version file'
+      method_option :virtualenv, :aliases => [ '--env', '-e' ],
+                    :desc => 'Python virtualenv name to configure for this directory'
+      method_option :virtualenvfile, :banner => 'FILE',
+                    :default => FalkorLib.config[:pyenv][:gemsetfile], :desc => ' Python virtualenv filename'
+      method_option :global, :aliases => '-g', :type => :boolean,
+                    :default => true, :desc => 'Force overwritting the  pyenv/direnv config'
+      #____________________
+      def pyenv(path = '.')
+        FalkorLib::Bootstrap.pyenv(path, options)
+      end # pyenv
+
+
       ###### slides ######
       #......................................
       desc "slides [options]", "Bootstrap LaTeX Beamer slides"
@@ -155,14 +188,14 @@ It consists of two files:
 These files will be committed in Git to ensure a consistent environment for the project.
 RVM_LONG_DESC
       method_option :force, :aliases => '-f',
-                            :type => :boolean, :desc => 'Force overwritting the RVM config'
+                    :type => :boolean, :desc => 'Force overwritting the RVM config'
       method_option :ruby, :banner => 'VERSION',
-                           :desc => 'Ruby version to configure / install for RVM'
+                    :desc => 'Ruby version to configure / install for RVM'
       method_option :versionfile, :banner => 'FILE',
-                                  :default => FalkorLib.config[:rvm][:versionfile], :desc => 'RVM ruby version file'
+                    :default => FalkorLib.config[:rvm][:versionfile], :desc => 'RVM ruby version file'
       method_option :gemset, :desc => 'RVM gemset to configure for this directory'
       method_option :gemsetfile, :banner => 'FILE',
-                                 :default => FalkorLib.config[:rvm][:gemsetfile], :desc => 'RVM gemset file'
+                    :default => FalkorLib.config[:rvm][:gemsetfile], :desc => 'RVM gemset file'
       #____________________
       def rvm(path = '.')
         FalkorLib::Bootstrap.rvm(path, options)
@@ -171,11 +204,11 @@ RVM_LONG_DESC
       ###### versionfile ######
       desc "versionfile PATH [options]", "initiate a VERSION file"
       method_option :file, :aliases => '-f',
-                           :desc => "Set the VERSION filename"
+                    :desc => "Set the VERSION filename"
       method_option :tag,  :aliases => '-t',
-                           :desc => "Git tag to use"
+                    :desc => "Git tag to use"
       method_option :version, :aliases => '-v',
-                              :desc => "Set the version to initialize in the version file"
+                    :desc => "Set the version to initialize in the version file"
       #_______________
       def versionfile(path = '.')
         FalkorLib::Bootstrap.versionfile(path, options)
@@ -184,7 +217,7 @@ RVM_LONG_DESC
 
       ###### readme ######
       method_option :make, :default => true,
-                           :type => :boolean, :desc => 'Use a Makefile to pilot the repository actions'
+                    :type => :boolean, :desc => 'Use a Makefile to pilot the repository actions'
       method_option :rake,
                     :type => :boolean, :desc => 'Use a Rakefile (and FalkorLib) to pilot the repository actions'
       method_option :latex, :aliases => '-l', :type => :boolean, :desc => "Describe a LaTeX project"

data/lib/falkorlib/config.rb

@@ -1,6 +1,6 @@
 # -*- encoding: utf-8 -*-
 ################################################################################
-# Time-stamp: <Fri 2018-04-27 13:52 svarrette>
+# Time-stamp: <Mon 2018-11-12 07:15 svarrette>
 ################################################################################
 # FalkorLib Configuration
 #
@@ -60,6 +60,14 @@ module FalkorLib #:nodoc:
         :versionfile => '.ruby-version',
         :gemsetfile  => '.ruby-gemset'
       },
+      :pyenv => {
+        :versions       => ['2.7.14', '2.7.15', '3.6.4', '3.7.1' ],
+        :version        => '2.7.14',
+        :versionfile    => '.python-version',
+        :virtualenvfile => '.python-virtualenv',
+        :direnvfile     => '.envrc',
+        :direnvrc       => File.join( ENV['HOME'], '.config', 'direnv', 'direnvrc')
+      },
       :templates => {
         :trashdir => '.Trash',
         :puppet   => {}

data/lib/falkorlib/git/base.rb

@@ -1,6 +1,6 @@
 # -*- encoding: utf-8 -*-
 ################################################################################
-# Time-stamp: <Thu 2018-10-04 08:07 svarrette>
+# Time-stamp: <Wed 2018-11-21 13:31 svarrette>
 ################################################################################
 # Interface for the main Git operations
 #
@@ -398,7 +398,7 @@ module FalkorLib #:nodoc:
           remotes = FalkorLib::Git.remotes
           unless remotes.include?( remote )
             info "Initialize Git remote '#{remote}' from URL '#{url}'"
-            exit_status = execute "git remote add -f #{remote} #{url}"
+            exit_status = execute "git remote add --no-tags -f #{remote} #{url}"
           end
           unless File.directory?( File.join(git_root_dir, dir) )
             info "initialize Git subtree '#{dir}'"

data/lib/falkorlib/tasks/rspec.rake

@@ -71,7 +71,7 @@ begin
     #t.pattern = "spec/**/common_*.rb"
     #t.pattern = "spec/**/versioning_*spec.rb"
     #t.pattern = "spec/**/puppet*spec.rb"
-    #t.pattern = "spec/**/bootstrap_*spec.rb"
+    #t.pattern = "spec/**/bootstrap_spec.rb"
     #t.pattern = "spec/**/git*spec.rb"
     #t.pattern = "spec/**/error*spec.rb"
     #t.pattern = "spec/**/config*spec.rb"

data/lib/falkorlib/version.rb

@@ -19,7 +19,7 @@ module FalkorLib #:nodoc:
     # MAJOR: Defines the major version
     # MINOR: Defines the minor version
     # PATCH: Defines the patch version
-    MAJOR, MINOR, PATCH = 0, 7, 18
+    MAJOR, MINOR, PATCH = 0, 8, 1
 
     module_function
 
@@ -74,3 +74,4 @@ module FalkorLib #:nodoc:
 
 end
 
+

data/spec/falkorlib/bootstrap_python_spec.rb

@@ -0,0 +1,119 @@
+#!/usr/bin/ruby
+#########################################
+# bootstrap_python_spec.rb
+# @author Sebastien Varrette <Sebastien.Varrette@uni.lu>
+# Time-stamp: <Wed 2018-11-21 11:23 svarrette>
+#
+# @description Check the Bootstrapping operations for python-based projects
+#
+# Copyright (c) 2013 Sebastien Varrette <Sebastien.Varrette@uni.lu>
+# .             http://varrette.gforge.uni.lu
+##############################################################################
+
+require 'spec_helper'
+require 'tmpdir'
+require 'fileutils'
+
+describe FalkorLib::Bootstrap do
+
+  include FalkorLib::Common
+
+  dirs = {
+    :without_git => Dir.mktmpdir,
+    :with_git    => Dir.mktmpdir,
+  }
+
+  #_____________
+  before :all do
+    $stdout.sync = true
+    FalkorLib.config[:no_interaction] = true
+  end
+
+  #____________
+  after :all do
+    dirs.each do |t,d|
+      #next if t == :with_git
+      FileUtils.remove_entry_secure d
+    end
+    FalkorLib.config[:no_interaction] = false
+  end
+
+  [ :without_git, :with_git ].each do |ctx|
+    # [ :without_git ].each do |ctx|
+    # [ :with_git ].each do |ctx|
+    dir = dirs[ctx]
+    ########################################################################
+    context "bootstrap/python (#{ctx}) within temporary directory '#{dir}'" do
+
+      if ctx == :with_git
+        it "initialize Git in the temporary directory #{dir}" do
+          c = FalkorLib::Git.init(dir)
+          expect(c).to eq(0)
+          t = FalkorLib::Git.init?(dir)
+          expect(t).to be true
+        end
+      end
+
+      ######### Pyenv/Direnv #########
+      it "#pyenv -- #{ctx}" do
+        c = FalkorLib::Bootstrap.pyenv(dir)
+        expect(c).to eq(0)
+        content = {}
+        [:versionfile, :virtualenvfile, :direnvfile].each do |type|
+          f = File.join(dir, FalkorLib.config[:pyenv][type.to_sym])
+          t = File.exists?(f)
+          expect(t).to be true
+          content[type.to_sym] = `cat #{f}`.chomp
+        end
+        expect(content[:versionfile]).to eq(FalkorLib.config[:pyenv][:version])
+        expect(content[:virtualenvfile]).to  eq(File.basename(dir))
+        File.read(File.realpath( File.join(dir, FalkorLib.config[:pyenv][:direnvfile]))) do |f|
+          [
+            'layout virtualenv ${pyversion} ${pvenv}',
+            'layout activate ${pvenv}'
+          ].each do |pattern|
+            f.should include "#{pattern}"
+          end
+        end
+      end
+
+      it "#python -- #{ctx} -- repeat" do
+        t = FalkorLib::Bootstrap.pyenv(dir)
+        expect(t).to eq(1)
+        c = capture(:stdout) { FalkorLib::Bootstrap.pyenv(dir, { :force => true }) }
+        [
+          "The python/pyenv file '.python-version' already exists",
+          "The python/pyenv file '.python-virtualenv' already exists",
+          "The python/pyenv file '.envrc' already exists",
+          "and it WILL BE overwritten"
+        ].each do |pattern|
+          expect(c).to include pattern
+        end
+      end
+
+      it "#pyenv -- change targets (ctx = #{ctx}; dir = #{dir})" do
+        opts = {
+          :python         => '3.7.1',
+          :versionfile    => '.myversion',
+          :virtualenv     => 'newvirtualenv',
+          :virtualenvfile => '.myvirtualenv'
+        }
+        c = FalkorLib::Bootstrap.pyenv(dir, opts)
+        expect(c).to eq(0)
+        content = {}
+        [:versionfile, :virtualenvfile].each do |type|
+          f = File.join(dir, opts[type.to_sym])
+          t = File.exists?(f)
+          expect(t).to be true
+          content[type.to_sym] = `cat #{f}`.chomp
+        end
+        expect(content[:versionfile]).to     eq(opts[:python])
+        expect(content[:virtualenvfile]).to  eq(opts[:virtualenv])
+      end
+
+
+
+    end # context "bootstrap/python"
+  end # each
+
+end

data/spec/falkorlib/bootstrap_ruby_spec.rb

@@ -2,7 +2,7 @@
 #########################################
 # bootstrap_ruby_spec.rb
 # @author Sebastien Varrette <Sebastien.Varrette@uni.lu>
-# Time-stamp: <Sat 2016-11-12 02:28 svarrette>
+# Time-stamp: <Wed 2018-11-21 08:48 svarrette>
 #
 # @description Check the Bootstrapping operations for ruby-based projects
 #
@@ -38,8 +38,8 @@ describe FalkorLib::Bootstrap do
     FalkorLib.config[:no_interaction] = false
   end
 
-  #[ :without_git, :with_git ].each do |ctx|
-    [ :without_git ].each do |ctx|
+  [ :without_git, :with_git ].each do |ctx|
+    # [ :without_git ].each do |ctx|
     # [ :with_git ].each do |ctx|
     dir = dirs[ctx]
     ########################################################################

data/spec/falkorlib/bootstrap_spec.rb

@@ -2,7 +2,7 @@
 #########################################
 # bootstrap_spec.rb
 # @author Sebastien Varrette <Sebastien.Varrette@uni.lu>
-# Time-stamp: <Thu 2018-11-08 16:26 svarrette>
+# Time-stamp: <Fri 2018-11-09 09:43 svarrette>
 #
 # @description Check the basic Bootstrapping operations
 #
@@ -163,7 +163,7 @@ describe FalkorLib::Bootstrap do
         end
       end
 
-      if ctx == :with_git
+      if (ctx == :with_git and !ENV['TRAVIS_CI_RUN'])
         it "#gitcrypt -- owner is empty" do
           c = FalkorLib::Bootstrap.gitcrypt(dir, { :owner => '', :no_interaction => true })
           [ '.git-crypt' ].each do |d|

data/templates/direnv/direnvrc

@@ -0,0 +1,32 @@
+# -*- mode: sh; -*-
+# Global configuration for direnv to make it compliant with pyenv
+# See https://direnv.net/
+#
+# Adapted from
+#  - https://github.com/direnv/direnv/wiki/Python#-pyenv and
+#  - https://github.com/direnv/direnv/wiki/Python#-virtualenvwrapper
+
+# use a certain pyenv version
+use_python() {
+    if [ -n "$(which pyenv)" ]; then
+        local pyversion=$1
+        pyenv local ${pyversion}
+    fi
+}
+
+layout_virtualenv() {
+    local pyversion=$1
+    local pvenv=$2
+    if [ -n "$(which pyenv-virtualenv)" ]; then
+        pyenv virtualenv --force --quiet ${pyversion} ${pvenv}-${pyversion}
+    fi
+}
+
+layout_activate() {
+    if [ -n "$(which pyenv)" ]; then
+        local pyenvprefix=$(pyenv prefix)
+        local pyversion=$(pyenv version-name)
+        local pvenv="$1"
+        source ${pyenvprefix}/envs/${pvenv}-${pyversion}/bin/activate
+    fi
+}

data/templates/puppet/modules/Gemfile

@@ -17,7 +17,7 @@ group :test do
   gem "puppetlabs_spec_helper"
   gem "metadata-json-lint"
   gem "rspec-puppet-facts"
-  gem 'rubocop', '0.33.0'
+  gem 'rubocop',   '~> 0.51'
   gem 'simplecov', '>= 0.11.0'
   gem 'simplecov-console'
 

data/templates/python/setup.sh.erb

@@ -0,0 +1,21 @@
+# -*- mode: sh; -*-
+# (rootdir)/.envrc : direnv configuration file
+# see https://direnv.net/
+# Grab the latest version of this file from
+#      https://github.com/Falkor/dotfiles/blob/master/direnv/envrc
+#
+if [ -f ".python-version" ]; then
+    pyversion=$(head <%= config[:versionfile] %>)
+else
+    pyversion=<%= FalkorLib.config[:pyenv][:version] %>
+fi
+use python ${pyversion}
+
+if [ -f ".python-virtualenv" ]; then
+    pvenv=$(head <%= config[:virtualenvfile] %>)
+
+    # Create the virtualenv if not yet done
+    layout virtualenv ${pyversion} ${pvenv}
+    # activate it
+    layout activate ${pvenv}      #-${pyversion}
+fi

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: falkorlib
 version: !ruby/object:Gem::Version
-  version: 0.7.18
+  version: 0.8.1
 platform: ruby
 authors:
 - Sebastien Varrette
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-11-08 00:00:00.000000000 Z
+date: 2018-11-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -417,6 +417,7 @@ files:
 - lib/falkorlib/bootstrap/latex.rb
 - lib/falkorlib/bootstrap/link.rb
 - lib/falkorlib/bootstrap/mkdocs.rb
+- lib/falkorlib/bootstrap/python.rb
 - lib/falkorlib/bootstrap/ruby.rb
 - lib/falkorlib/bootstrap/vagrant.rb
 - lib/falkorlib/cli.rb
@@ -452,6 +453,7 @@ files:
 - spec/falkorlib/bootstrap_helpers_spec.rb
 - spec/falkorlib/bootstrap_latex_spec.rb
 - spec/falkorlib/bootstrap_link_spec.rb
+- spec/falkorlib/bootstrap_python_spec.rb
 - spec/falkorlib/bootstrap_ruby_spec.rb
 - spec/falkorlib/bootstrap_spec.rb
 - spec/falkorlib/common_spec.rb
@@ -477,6 +479,7 @@ files:
 - templates/Rakefile/footer_rakefile.erb
 - templates/Rakefile/header_rakefile.erb
 - templates/Rakefile/rakefile_gitflow.erb
+- templates/direnv/direnvrc
 - templates/gems/Gemfile
 - templates/gems/LICENCE.md
 - templates/gems/README.md
@@ -554,6 +557,7 @@ files:
 - templates/puppet/modules/tests/vagrant/bootstrap.sh
 - templates/puppet/modules/tests/vagrant/config.yaml
 - templates/puppet/modules/tests/vagrant/puppet_modules_setup.rb
+- templates/python/setup.sh.erb
 - templates/vagrant/Vagrantfile.erb
 - templates/vagrant/vagrant/bootstrap.sh
 - templates/vagrant/vagrant/config.yaml
@@ -592,6 +596,7 @@ test_files:
 - spec/falkorlib/config_spec.rb
 - spec/falkorlib/bootstrap_ruby_spec.rb
 - spec/falkorlib/bootstrap_link_spec.rb
+- spec/falkorlib/bootstrap_python_spec.rb
 - spec/falkorlib/git_spec.rb
 - spec/falkorlib/gitflow_spec.rb
 - spec/falkorlib/bootstrap_latex_spec.rb