power_stencil 0.8.9 → 0.8.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 696922401cd53b56b5b0c902376e0c95093069c8
-  data.tar.gz: 2ce84bd347b0d55337e72521d47ebdecaa0704f6
+  metadata.gz: 953c643a9a919791eeb8dc12c8e725c2a8ab80c6
+  data.tar.gz: 8231bae8f9f3d2fe16987b758ffcc8e22be3f295
 SHA512:
-  metadata.gz: 8f30eea32756e4c6ff86dd116d36574a8277f027d7641f720d601e55135d435af197d842589c74945280a9367950c3d338525bfdca6e8abd6cffefe915dc80c3
-  data.tar.gz: 26ad01bce4343dc399553281413fbfaa56331f35b0163ad430273d166aa7aff9811258a54b07ce670f46cad0ce1877c2706a11a778d8c985ab07bebb301512fd
+  metadata.gz: dfede811fa8dc0efc67e158abf08e93aac47fb327c6642fff344d6caa0bb7b908443ad31bc229c9b165ab3868c1f311adb63c7d24d168e5fbef98b09495634a4
+  data.tar.gz: 1b962bde64576cc9cb8a20f272a048289e42caf212d4fa63814c778fb672e1b0e137ff3dcedb3ecfab6a30488942f1db37e26eceb8b2e687a39156ec13419268

data/etc/meta_templates/plugin_seed/README.md

@@ -0,0 +1,118 @@
+<% gem_name = "psplugin_#{ plugin_name}" -%>
+<%= plugin_title_name %>
+<%= '=' * plugin_title_name.size %>
+
+[![Gem Version](https://badge.fury.io/rb/<%= gem_name %>.svg)](https://rubygems.org/gems/<%= gem_name %>) [![Pipeline status](https://gitlab.com/tools4devops/psplugins/<%= gem_name %>/badges/master/pipeline.svg)](https://gitlab.com/tools4devops/psplugins/<%= gem_name %>/commits/master)
+
+[PowerStencil] is the Swiss-army knife templating workflow for developers and ops.
+
+`<%= plugin_title_name %>` is a [PowerStencil] plugin.
+
+See [official website][PowerStencil site].
+
+
+<!-- TOC -->
+
+- [What is a PowerStencil plugin ?](#what-is-a-powerstencil-plugin-)
+- [Using this plugin in your `PowerStencil` projects](#using-this-plugin-in-your-powerstencil-projects)
+- [Goal of this plugin](#goal-of-this-plugin)
+- [Plugin capabilities](#plugin-capabilities)
+    - [Config](#config)
+    - [Subcommands and options](#subcommands-and-options)
+    - [Post-build actions](#post-build-actions)
+    - [DSL in templates and in `power_stencil shell`](#dsl-in-templates-and-in-power_stencil-shell)
+    - [Entity types](#entity-types)
+    - [Templates-templates](#templates-templates)
+- [Contributing](#contributing)
+    - [License](#license)
+    - [Code of Conduct](#code-of-conduct)
+
+<!-- /TOC -->
+
+# What is a PowerStencil plugin ?
+
+A `PowerStencil` plugin can be used in the context of a `PowerStencil` project and bring extra features to a standard project.
+
+If you don't know what `PowerStencil` is made for, you may read [the documentation][PowerStencil] first.
+
+Features provided by a plugin can be:
+
+* Extra config.
+* Extra subcommands or options added to the `power_stencil` command-line.
+* Extra post-build actions.
+* Extra DSL methods available in templates and in `power_stencil shell`.
+* Extra entity types.
+* Extra templates-templates.
+
+# Using this plugin in your `PowerStencil` projects
+
+To use this plugin within your `PowerStencil` project, you need to:
+
+* be within a `PowerStencil` project :wink:.
+* declare this plugin in the project configuration (from the root of your project in the `.ps_project/versioned-config.yaml` file).
+
+In this yaml configuration file, you just have to add a new entry in the `:project_plugins` array or simply create it if it is not yet existing:
+
+```yaml
+:project_plugins:
+  - <%= gem_name %>
+```
+If this plugin is not already present on your machine, you may have to download it:
+
+    $ power_stencil plugin --install
+
+And then you may see information about the plugin by running:
+
+* `power_stencil info` in the plugins section.
+* `power_stencil plugin --list -v`
+
+# Goal of this plugin
+
+# Plugin capabilities
+
+This plugin provides the following features:
+
+## Config
+
+## Subcommands and options
+
+## Post-build actions
+
+## DSL in templates and in `power_stencil shell`
+
+## Entity types
+
+## Templates-templates
+
+
+# Contributing
+
+Bug reports and pull requests are welcome on Gitlab at https://gitlab.com/tools4devops/psplugins/<%= plugin_name %>/issues. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License].
+
+## Code of Conduct
+
+Everyone interacting in the PowerStencil project’s codebase, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct].
+
+<!-- End of Document -->
+
+<!-- Pages -->
+[code of conduct]: CODE_OF_CONDUCT.md
+
+<!-- Code links -->
+
+<!-- Illustrations -->
+[simple-flow-image]: doc/images/power-stencil-simple-flow.svg
+
+<!-- External links -->
+[MIT License]: http://opensource.org/licenses/MIT "The MIT license"
+[ERB]: https://ruby-doc.org/stdlib-2.6.3/libdoc/erb/rdoc/ERB.html "Quick ERB description"
+[Haml]: http://haml.info/ "The templating engine for XML-like documents"
+[Ruby]: https://www.ruby-lang.org "The powerful Ruby language"
+[Rails]: https://rubyonrails.org/ "The Ruby on Rails framework"
+[PowerStencil site]: https://powerstencil.brizone.org "Official PowerStencil website"
+[PowerStencil]: https://gitlab.com/tools4devops/power_stencil/blob/master/README.md "PowerStencil documentation"
+[PowerStencil plugins]: https://gitlab.com/tools4devops/power_stencil/blob/master/doc/plugins.md "PowerStencil plugins documentation"

data/etc/meta_templates/plugin_seed/psplugin_{entity}.gemspec

@@ -12,13 +12,27 @@ Gem::Specification.new do |spec|
   spec.summary       = %q{<%= plugin_name %> is a plugin for the PowerStencil framework.}
   spec.description   = %q{TODO: Write a longer description or delete this line.}
   spec.homepage      = "TODO: Put your gem's website or public repo URL here."
-  spec.license       = "MIT"
+  spec.license       = 'MIT'
 
-  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
-  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  # Change this and following metadata if you don't want your plugin to be an "official" PowerStencil plugin.
+  # ie deployed to https://gitlab.com/tools4devops/psplugins
+  source_code_uri = 'https://gitlab.com/tools4devops/psplugins/<%= plugin_name %>'
+
+  # Gem metadata
   if spec.respond_to?(:metadata)
+    # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+    # to allow pushing to a single host or delete this line to allow pushing to any host.
     spec.metadata['allowed_push_host'] = "TODO: Set to 'http://mygemserver.com'"
-    # This metadata is mandatory for PowerStencil !!
+
+    # Nice link to your home page on rubygems.org
+    spec.metadata['homepage_uri'] = spec.homepage
+
+    # You have to probably change this if you don't deploy to gitlab
+    spec.metadata['bug_tracker_uri'] = "#{source_code_uri}/issues"
+    spec.metadata['documentation_uri'] = "#{source_code_uri}/blob/master/README.md"
+    spec.metadata['source_code_uri'] = source_code_uri
+
+    # This metadata is mandatory for a PowerStencil plugin !!
     spec.metadata['plugin_name'] = '<%= plugin_name %>'
   else
     raise 'RubyGems 2.0 or newer is required to protect against public gem pushes and PowerStencil plugin mechanism !'
@@ -31,8 +45,9 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_development_dependency 'bundler', '~> 2.0.2'
+  spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'rake', '~> 10.0'
   spec.add_development_dependency 'rspec', '~> 3.0'
   spec.add_development_dependency 'power_stencil', "~> <%= PowerStencil::VERSION %>"
+
 end

data/etc/meta_templates/plugin_seed/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+require "bundler/setup"
+require 'power_stencil'
+require "<%= plugin_name %>"
+
+RSpec.configure do |config|
+  # Enable flags like --only-failures and --next-failure
+  config.example_status_persistence_file_path = ".rspec_status"
+
+  # Disable RSpec exposing methods globally on `Module` and `main`
+  config.disable_monkey_patching!
+
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+end

data/etc/meta_templates/plugin_seed/spec/{entity}_spec.rb

@@ -0,0 +1,10 @@
+RSpec.describe <%= plugin_module_name %> do
+  it 'has a version number' do
+    expect(<%= plugin_module_name %>::VERSION).not_to be nil
+  end
+
+  it 'does something useful' do
+    pending 'Tests implementation'
+    RSpec.fail
+  end
+end

data/etc/power_stencil.yaml

@@ -110,6 +110,7 @@
 :completion_target:
   :zsh:
     :completion_dir: ~/.zsh/completion
+    :project_completion_filename: .zsh_project_completion
 
 
 

data/etc/templates/plugin_definition/README.md

@@ -1,43 +1,118 @@
-# <%= plugin_module_name %>
+<% gem_name = "psplugin_#{ plugin_name}" -%>
+<%= plugin_title_name %>
+<%= '=' * plugin_title_name.size %>
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/<%= plugin_module_name %>`. To experiment with that code, run `bin/console` for an interactive prompt.
+[![Gem Version](https://badge.fury.io/rb/<%= gem_name %>.svg)](https://rubygems.org/gems/<%= gem_name %>) [![Pipeline status](https://gitlab.com/tools4devops/psplugins/<%= gem_name %>/badges/master/pipeline.svg)](https://gitlab.com/tools4devops/psplugins/<%= gem_name %>/commits/master)
 
-TODO: Delete this and the text above, and describe your gem
+[PowerStencil] is the Swiss-army knife templating workflow for developers and ops.
 
-## Installation
+`<%= plugin_title_name %>` is a [PowerStencil] plugin.
 
-Add this line to your application's Gemfile:
+See [official website][PowerStencil site].
 
-```ruby
-gem '<%= plugin_module_name %>'
+
+<!-- TOC -->
+
+- [What is a PowerStencil plugin ?](#what-is-a-powerstencil-plugin-)
+- [Using this plugin in your `PowerStencil` projects](#using-this-plugin-in-your-powerstencil-projects)
+- [Goal of this plugin](#goal-of-this-plugin)
+- [Plugin capabilities](#plugin-capabilities)
+    - [Config](#config)
+    - [Subcommands and options](#subcommands-and-options)
+    - [Post-build actions](#post-build-actions)
+    - [DSL in templates and in `power_stencil shell`](#dsl-in-templates-and-in-power_stencil-shell)
+    - [Entity types](#entity-types)
+    - [Templates-templates](#templates-templates)
+- [Contributing](#contributing)
+    - [License](#license)
+    - [Code of Conduct](#code-of-conduct)
+
+<!-- /TOC -->
+
+# What is a PowerStencil plugin ?
+
+A `PowerStencil` plugin can be used in the context of a `PowerStencil` project and bring extra features to a standard project.
+
+If you don't know what `PowerStencil` is made for, you may read [the documentation][PowerStencil] first.
+
+Features provided by a plugin can be:
+
+* Extra config.
+* Extra subcommands or options added to the `power_stencil` command-line.
+* Extra post-build actions.
+* Extra DSL methods available in templates and in `power_stencil shell`.
+* Extra entity types.
+* Extra templates-templates.
+
+# Using this plugin in your `PowerStencil` projects
+
+To use this plugin within your `PowerStencil` project, you need to:
+
+* be within a `PowerStencil` project :wink:.
+* declare this plugin in the project configuration (from the root of your project in the `.ps_project/versioned-config.yaml` file).
+
+In this yaml configuration file, you just have to add a new entry in the `:project_plugins` array or simply create it if it is not yet existing:
+
+```yaml
+:project_plugins:
+  - <%= gem_name %>
 ```
+If this plugin is not already present on your machine, you may have to download it:
+
+    $ power_stencil plugin --install
+
+And then you may see information about the plugin by running:
+
+* `power_stencil info` in the plugins section.
+* `power_stencil plugin --list -v`
+
+# Goal of this plugin
 
-And then execute:
+# Plugin capabilities
 
-    $ bundle
+This plugin provides the following features:
 
-Or install it yourself as:
+## Config
 
-    $ gem install <%= plugin_module_name %>
+## Subcommands and options
 
-## Usage
+## Post-build actions
 
-TODO: Write usage instructions here
+## DSL in templates and in `power_stencil shell`
 
-## Development
+## Entity types
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+## Templates-templates
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
-## Contributing
+# Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/<%= plugin_module_name %>. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+Bug reports and pull requests are welcome on Gitlab at https://gitlab.com/tools4devops/psplugins/<%= plugin_name %>/issues. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+The gem is available as open source under the terms of the [MIT License].
 
 ## Code of Conduct
 
-Everyone interacting in the <%= plugin_module_name %> project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/<%= plugin_module_name %>/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the PowerStencil project’s codebase, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct].
+
+<!-- End of Document -->
+
+<!-- Pages -->
+[code of conduct]: CODE_OF_CONDUCT.md
+
+<!-- Code links -->
+
+<!-- Illustrations -->
+[simple-flow-image]: doc/images/power-stencil-simple-flow.svg
+
+<!-- External links -->
+[MIT License]: http://opensource.org/licenses/MIT "The MIT license"
+[ERB]: https://ruby-doc.org/stdlib-2.6.3/libdoc/erb/rdoc/ERB.html "Quick ERB description"
+[Haml]: http://haml.info/ "The templating engine for XML-like documents"
+[Ruby]: https://www.ruby-lang.org "The powerful Ruby language"
+[Rails]: https://rubyonrails.org/ "The Ruby on Rails framework"
+[PowerStencil site]: https://powerstencil.brizone.org "Official PowerStencil website"
+[PowerStencil]: https://gitlab.com/tools4devops/power_stencil/blob/master/README.md "PowerStencil documentation"
+[PowerStencil plugins]: https://gitlab.com/tools4devops/power_stencil/blob/master/doc/plugins.md "PowerStencil plugins documentation"

data/etc/templates/plugin_definition/psplugin_{entity}.gemspec

@@ -12,13 +12,27 @@ Gem::Specification.new do |spec|
   spec.summary       = %q{<%= plugin_name %> is a plugin for the PowerStencil framework.}
   spec.description   = %q{TODO: Write a longer description or delete this line.}
   spec.homepage      = "TODO: Put your gem's website or public repo URL here."
-  spec.license       = "MIT"
+  spec.license       = 'MIT'
 
-  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
-  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  # Change this and following metadata if you don't want your plugin to be an "official" PowerStencil plugin.
+  # ie deployed to https://gitlab.com/tools4devops/psplugins
+  source_code_uri = 'https://gitlab.com/tools4devops/psplugins/<%= plugin_name %>'
+
+  # Gem metadata
   if spec.respond_to?(:metadata)
+    # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+    # to allow pushing to a single host or delete this line to allow pushing to any host.
     spec.metadata['allowed_push_host'] = "TODO: Set to 'http://mygemserver.com'"
-    # This metadata is mandatory for PowerStencil !!
+
+    # Nice link to your home page on rubygems.org
+    spec.metadata['homepage_uri'] = spec.homepage
+
+    # You have to probably change this if you don't deploy to gitlab
+    spec.metadata['bug_tracker_uri'] = "#{source_code_uri}/issues"
+    spec.metadata['documentation_uri'] = "#{source_code_uri}/blob/master/README.md"
+    spec.metadata['source_code_uri'] = source_code_uri
+
+    # This metadata is mandatory for a PowerStencil plugin !!
     spec.metadata['plugin_name'] = '<%= plugin_name %>'
   else
     raise 'RubyGems 2.0 or newer is required to protect against public gem pushes and PowerStencil plugin mechanism !'
@@ -31,8 +45,9 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_development_dependency 'bundler', '~> 2.0.2'
+  spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'rake', '~> 10.0'
   spec.add_development_dependency 'rspec', '~> 3.0'
   spec.add_development_dependency 'power_stencil', "~> <%= PowerStencil::VERSION %>"
+
 end

data/etc/templates/plugin_definition/spec/spec_helper.rb

@@ -1,5 +1,6 @@
 require "bundler/setup"
-require "<%= plugin_module_name %>"
+require 'power_stencil'
+require "<%= plugin_name %>"
 
 RSpec.configure do |config|
   # Enable flags like --only-failures and --next-failure

data/etc/templates/plugin_definition/spec/{entity}_spec.rb

@@ -1,9 +1,10 @@
 RSpec.describe <%= plugin_module_name %> do
-  it "has a version number" do
+  it 'has a version number' do
     expect(<%= plugin_module_name %>::VERSION).not_to be nil
   end
 
-  it "does something useful" do
-    expect(false).to eq(true)
+  it 'does something useful' do
+    pending 'Tests implementation'
+    RSpec.fail
   end
 end

data/etc/templates/zsh_command_line_completion/_power_stencil.sh.erb

@@ -2,10 +2,10 @@
 
 # zsh shell completion script for <%= script_name %>
 # To regenerate this file: '<%= script_name %> adm --zsh-completion'
-# Generated on the <%= Time.now %> by <%= script_name %> v<%= PowerStencil::VERSION %>
+# Generated<%= timestamp %> by <%= script_name %> v<%= PowerStencil::VERSION %>
 
-<% commands = PowerStencil.command_line_manager.commands -%>
-_<%= script_name %>() {
+<% commands = context_commands -%>
+_<%= script_name %>_first_level() {
     local cmd
     local <%= script_name %>_sub_commands
     <%= script_name %>_sub_commands=(<%= commands.reject { |c| c.name.empty? }.sort { |a,b| a.name <=> b.name }.map(&:name).join ' ' %>)
@@ -21,7 +21,7 @@ _<%= script_name %>() {
   	    (( $+functions[_<%= script_name %>_cmd_$cmd] )) && _<%= script_name %>_cmd_$cmd
   	  else
   	    _values : \
-<%= continued_multilines(root_command(commands).options.sort { |a,b| a.name <=> b.name }.map {|o| option_representation o}, number_spaces: 10) %>
+<%= continued_multilines(context_options(root_command commands).sort { |a,b| a.name <=> b.name }.map {|o| option_representation o}, number_spaces: 10) %>
   	  fi
     else
 	    _values : \
@@ -33,7 +33,7 @@ _<%= script_name %>() {
 <% end -%>
 	      <%= command_representation command %> \
 <% end -%>
-<%= continued_multilines(root_command.options.sort { |a,b| a.name <=> b.name }.map {|o| option_representation o}, number_spaces: 8) %>
+<%= continued_multilines(context_options(root_command).sort { |a,b| a.name <=> b.name }.map {|o| option_representation o}, number_spaces: 8) %>
     fi
 }
 
@@ -46,7 +46,7 @@ _<%= script_name %>_cmd_<%= command.name %>() {
   _arguments -s : \
 <%
 command_param = default_command_param_type command
-options_lines = command.options.sort { |a,b| a.name <=> b.name }.map {|o| option_representation o}
+options_lines = context_options(command).sort { |a,b| a.name <=> b.name }.map {|o| option_representation o}
 options_lines << command_param unless command_param.empty?
 -%>
 <%= continued_multilines(options_lines) %>
@@ -124,5 +124,15 @@ _power_stencil_do_nothing() {
   return 1
 }
 
-# Let's rock
-_<%= script_name %> "$@"
+
+_<%= script_name %>() {
+  if $( _within_power_stencil_project ); then
+    local project_root=$( _power_stencil_project_root )
+    if [ -f "${project_root}/.ps_project/<%= PowerStencil.config[:completion_target][:zsh][:project_completion_filename] %>" ]; then
+      . "${project_root}/.ps_project/<%= PowerStencil.config[:completion_target][:zsh][:project_completion_filename] %>"
+    fi
+  else
+    . "<%= File.expand_path(File.join PowerStencil.config[:completion_target][:zsh][:completion_dir],  "_#{script_name}") %>"
+  fi
+   _<%= script_name %>_first_level "$@"
+}

data/lib/power_stencil.rb

@@ -5,6 +5,10 @@ require 'dir_glob_ignore'
 
 $DO_NOT_AUTOSTART_CLIMATIC=true
 require 'climatic'
+require 'power_stencil/ultra_command_line/command_line_manager'
+require 'power_stencil/ultra_command_line/providers_manager'
+require 'power_stencil/ultra_command_line/option_definition'
+require 'power_stencil/ultra_command_line/sub_command'
 
 require 'power_stencil/error'
 require 'power_stencil/utils/os'

data/lib/power_stencil/command_processors/adm.rb

@@ -12,7 +12,35 @@ module PowerStencil
       def execute
 
         if config[:'zsh-completion']
-          generate_zsh_completion 'power_stencil'
+          target_dir = File.expand_path config[:completion_target][:zsh][:completion_dir]
+          script_name = 'power_stencil'
+          user_completion_script = File.join target_dir, "_#{script_name}"
+          begin
+            current_dir = Dir.pwd
+            Dir.mktmpdir 'completion_generation' do |tmpdir|
+              Dir.chdir tmpdir
+              generate_zsh_completion script_name, user_completion_script, false
+            end
+          ensure
+            Dir.chdir current_dir
+          end
+
+          begin
+            project
+            shortname_project_completion_script = File.join config[:default_config_directory_name], config[:completion_target][:zsh][:project_completion_filename]
+            project.track_action_with_git("Adding project specific zsh completion file: '#{ shortname_project_completion_script }'.") do
+              project_completion_script = File.join project.project_config_root, config[:completion_target][:zsh][:project_completion_filename]
+              generate_zsh_completion script_name, project_completion_script, true
+              puts_and_logs "A specific completion has been generated for this project in '#{project_completion_script}'.", check_verbose: false
+            end
+          rescue
+            # Do not check errors. This is just to load project config...
+            logger.debug "Outside of a PowerStencil project... Not generating zsh project completion."
+          end
+          puts_and_logs "zsh global auto_completion has been installed in '#{user_completion_script}'.", check_verbose: false
+          puts
+          puts "You should ensure you have something like 'fpath=(#{target_dir} $fpath)' in your ~/.zshrc file..."
+          puts 'You may have to relog for changes to be applied.'
           return
         end
 

data/lib/power_stencil/dsl/completion.rb

@@ -5,15 +5,52 @@ module PowerStencil
 
       class << self
         attr_accessor :script_name
+        attr_accessor :generating_project_completion
       end
 
       attr_reader :encountered_types
 
+      def timestamp
+        if generating_user_completion?
+          " on the #{Time.now}"
+        else
+          ''
+        end
+      end
+
       def initialize(universe)
         super
         @encountered_types = {}
       end
 
+      def generating_project_completion?
+        self.class.generating_project_completion
+      end
+
+      def generating_user_completion?
+        !self.class.generating_project_completion
+      end
+
+      def context_commands
+        if generating_user_completion?
+          PowerStencil.command_line_manager.commands.select do |command|
+            command.providers.include? PowerStencil
+          end
+        else
+          PowerStencil.command_line_manager.commands
+        end
+      end
+
+      def context_options(command)
+        if generating_user_completion?
+          command.options.select do |option|
+            option.providers.include? PowerStencil
+          end
+        else
+          command.options
+        end
+      end
+
       def script_name
         self.class.script_name
       end

data/lib/power_stencil/dsl/plugin_generation.rb

@@ -7,6 +7,10 @@ module PowerStencil
          main_entry_point.underscore
       end
 
+      def plugin_title_name
+        plugin_name.tr('_', ' ').split.map(&:capitalize).join(' ')
+      end
+
       def plugin_module_name
         plugin_name.camelize
       end

data/lib/power_stencil/engine/build_handling.rb

@@ -95,8 +95,11 @@ module PowerStencil
 
 
       def build_entity(entity_to_build, target_path)
+        initial_directory = Dir.pwd
         target_plugin_name =  entity_to_build.buildable_by.to_s
         default_build entity_to_build, target_path
+        # Post processing executed from generated directory (#11)
+        Dir.chdir target_path
 
         if target_plugin_name.empty?
           post_build_hook entity_to_build, target_path
@@ -106,6 +109,8 @@ module PowerStencil
           raise PowerStencil::Error, "Plugin '#{target_plugin_name}' has no build capability !" unless target_plugin.capabilities[:build]
           target_plugin.post_build_hook entity_to_build, target_path
         end
+      ensure
+        Dir.chdir initial_directory
       end
 
       def default_build(entity_to_build, target_path)

data/lib/power_stencil/engine/directory_processor.rb

@@ -30,10 +30,27 @@ module PowerStencil
           end
         end
       ensure
-        @rendering_context = nil
+        @files_not_to_rename = nil
         @files_not_to_render = nil
       end
 
+
+      def render_single_template_file(source_template, destination_file, main_entry_point: nil)
+        compiled_universe = root_universe.compile scenario: config[:scenario]
+        puts_and_logs 'Entities analysis completed.'
+
+        logger.info 'Generating target file...'
+
+        process_file source_template, destination_file,
+                     compiled_universe,
+                     overwrite_files: true,
+                     main_entry_point: main_entry_point
+      ensure
+        @files_not_to_rename = nil
+        @files_not_to_render = nil
+      end
+
+
       private
 
       def detemplatized_file_name(filename, replacement_text)

data/lib/power_stencil/engine/entities_handling.rb

@@ -34,11 +34,11 @@ module PowerStencil
         @available_entities_hash.keys
       end
 
-      def entity(type, name, universe)
+      def entity(type, name, universe = self.root_universe)
         universe.get_entity type, name
       end
 
-      def entities(universe, criterion: nil, value: nil, &filter_block)
+      def entities(universe = self.root_universe, criterion: nil, value: nil, &filter_block)
         universe.get_entities criterion: criterion, value: value, &filter_block
       end
 

data/lib/power_stencil/initializer.rb

@@ -17,6 +17,7 @@ module PowerStencil
       logger.debug 'Starting PowerStencil initialization...'
       setup_system_processors
       setup_universe_compiler_logger
+      try_to_load_project fail_on_error: false
       logger.debug 'PowerStencil initialization complete'
     end
 
@@ -29,7 +30,12 @@ module PowerStencil
     include PowerStencil::Utils::FileHelper
 
     def try_to_load_project(fail_on_error: true)
-      PowerStencil::Project::Base.instantiate_from_config config
+      begin
+        PowerStencil::Project::Base.instantiate_from_config config
+      rescue => e
+        raise e if fail_on_error
+      end
+
     end
 
     def setup_system_processors
@@ -49,14 +55,19 @@ module PowerStencil
           describe: PowerStencil::CommandProcessors::Describe,
           adm: PowerStencil::CommandProcessors::Adm
       }.each do |command_name, processor|
-        command_line_manager.register_processor command_line_manager.command_by_alias(command_name),
+        command = command_line_manager.command_by_alias(command_name)
+        command_line_manager.register_processor command,
                                                 processor.new
+        command.add_provider self
       end
     end
 
     def setup_climatic(cmd_line_args)
       mngr = Climatic::ConfigLayers::CommandLineLayer.build_command_line_manager base_commands_definition_file
       Climatic.bootstrap cmd_line_args: cmd_line_args, command_manager: mngr
+      mngr.commands.each do |command|
+        command.add_provider PowerStencil
+      end
       begin
         # Fix command line layer priority to allow a bigger number of plugins
         config.command_line_layer.priority = 999

data/lib/power_stencil/plugins/command_line.rb

@@ -10,7 +10,9 @@ module PowerStencil
         clm = PowerStencil.command_line_manager
         plugin_definition[:processors].each do |processors_name, processor|
           processor_class = Object.const_get processor
-          clm.register_processor clm.command_by_alias(processors_name), processor_class.new
+          command = clm.command_by_alias(processors_name)
+          clm.register_processor command, processor_class.new
+          command.add_provider self
         end
       end
 

data/lib/power_stencil/project/completion.rb

@@ -6,17 +6,15 @@ module PowerStencil
       def query_for_completion(query_type)
         case query_type
         when :entities
-          engine.entities(engine.root_universe).map(&:as_path).sort
+          engine.entities.map(&:as_path).sort
         when :'entity-types'
           engine.available_entity_types.sort
         when :scenario
-          engine.entities(engine.root_universe, criterion: :by_type, value: :entity_override) do |entity|
+          engine.entities(criterion: :by_type, value: :entity_override) do |entity|
             !entity.scenario.nil? and !entity.scenario.empty?
           end.map(&:scenario).sort.uniq
         when :buildable
-          engine.entities(engine.root_universe) do |entity|
-            entity.buildable?
-          end.map(&:as_path).sort
+          engine.entities(&:buildable?).map(&:as_path).sort
         else
           raise PowerStencil::Error, "'#{query_type}' is not a valid query type for completion !"
         end

data/lib/power_stencil/ultra_command_line/command_line_manager.rb

@@ -0,0 +1,35 @@
+class UltraCommandLine::Manager::Base
+
+  class << self
+
+    def add_provider_for(command_or_option, provider)
+      providers = providers_for command_or_option
+      providers << provider unless providers.include? provider
+    end
+
+    def providers_for(command_or_option)
+      default_command_data = {options: {}, providers: []}
+      case command_or_option
+      when UltraCommandLine::Commands::SubCommand
+        sc = command_or_option
+        internal_provider_mapping[sc.name] ||= default_command_data
+        internal_provider_mapping[sc.name][:providers]
+      when UltraCommandLine::Commands::OptionDefinition
+        sco = command_or_option
+        internal_provider_mapping[sco.sub_command.name] ||= default_command_data
+        internal_provider_mapping[sco.sub_command.name][:options][sco.name] ||= []
+        internal_provider_mapping[sco.sub_command.name][:options][sco.name]
+      else
+        raise PowerStencil::Error, "Invalid command or option"
+      end
+    end
+
+ #   private
+
+    def internal_provider_mapping
+      @internal_provider_mapping ||= {}
+    end
+
+  end
+
+end

data/lib/power_stencil/ultra_command_line/option_definition.rb

@@ -0,0 +1,5 @@
+class UltraCommandLine::Commands::OptionDefinition
+
+  include PowerStencil::UltraCommandLine::ProvidersManager
+
+end

data/lib/power_stencil/ultra_command_line/providers_manager.rb

@@ -0,0 +1,21 @@
+module PowerStencil
+  module UltraCommandLine
+
+    module ProvidersManager
+
+      def providers_manager
+        PowerStencil.command_line_manager.class
+      end
+
+      def providers
+        providers_manager.providers_for self
+      end
+
+      def add_provider(provider)
+        providers_manager.add_provider_for self, provider
+      end
+
+    end
+
+  end
+end

data/lib/power_stencil/ultra_command_line/sub_command.rb

@@ -0,0 +1,12 @@
+class UltraCommandLine::Commands::SubCommand
+
+  include PowerStencil::UltraCommandLine::ProvidersManager
+
+  def add_provider(provider)
+    super
+    options.each do |option|
+      option.add_provider provider
+    end
+  end
+
+end

data/lib/power_stencil/utils/completion.rb

@@ -3,24 +3,34 @@ module PowerStencil
 
     module Completion
 
-      include PowerStencil::Utils::DirectoryProcessor
+      class FakeIgnoreList
+        attr_accessor :return_value
+        def ignore_file?(file)
+          return_value
+        end
+      end
 
-      def generate_zsh_completion(script_name)
+      include PowerStencil::Utils::DirectoryProcessor
 
-        # Dirty hack
-        config.executable_gem_layer[:file_renaming_patterns] = {'(.+)_power_stencil.sh.erb' => '\1_power_stencil' }
+      def generate_zsh_completion(script_name, target_file, generating_project_completion)
 
-        target_dir = File.expand_path config[:completion_target][:zsh][:completion_dir]
         source_dir = File.join PowerStencil::Project::Paths.system_templates_templates_path, 'zsh_command_line_completion'
+        source_template = File.join source_dir, '_power_stencil.sh.erb'
 
         engine = PowerStencil::Engine::InitEngine.new
         engine.dsl = PowerStencil::Dsl::Completion
         engine.dsl.script_name = script_name
-        engine.render_source source_dir, target_dir, overwrite_files: true
+        engine.dsl.generating_project_completion = generating_project_completion
+
+        engine.instance_eval do
+          @files_not_to_rename = FakeIgnoreList.new
+          files_not_to_rename.return_value = true
+          @files_not_to_render = FakeIgnoreList.new
+          files_not_to_render.return_value = false
+        end
+
+        engine.render_single_template_file source_template, target_file
 
-        puts_and_logs "zsh auto_completion has been installed in '#{File.join target_dir, "_#{script_name}"}'.", check_verbose: false
-        puts "You should ensure you have something like 'fpath=(#{target_dir} $fpath)' in your ~/.zshrc file..."
-        puts 'You may have to relog for changes to be applied.'
       end
 
     end

data/lib/power_stencil/version.rb

@@ -1,3 +1,3 @@
 module PowerStencil
-  VERSION = '0.8.9'.freeze
+  VERSION = '0.8.14'.freeze
 end

data/power_stencil.gemspec

@@ -25,7 +25,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'rake', '~> 10.0'
   spec.add_development_dependency 'rspec', '~> 3.0'
 
-  spec.add_dependency 'climatic', '~> 0.2.32'
+  spec.add_dependency 'climatic', '~> 0.2.34'
   spec.add_dependency 'dir_glob_ignore', '~> 0.3'
   spec.add_dependency 'universe_compiler', '~> 0.5.5'
   spec.add_dependency 'pry'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: power_stencil
 version: !ruby/object:Gem::Version
-  version: 0.8.9
+  version: 0.8.14
 platform: ruby
 authors:
 - Laurent Briais
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-11-06 00:00:00.000000000 Z
+date: 2019-11-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -58,14 +58,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.32
+        version: 0.2.34
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.32
+        version: 0.2.34
 - !ruby/object:Gem::Dependency
   name: dir_glob_ignore
   requirement: !ruby/object:Gem::Requirement
@@ -154,6 +154,7 @@ files:
 - doc/plugins.md
 - doc/templates.md
 - etc/base_commands_definition.yml
+- etc/meta_templates/plugin_seed/README.md
 - etc/meta_templates/plugin_seed/etc/command_line.yaml
 - etc/meta_templates/plugin_seed/etc/plugin_capabilities.yaml
 - etc/meta_templates/plugin_seed/etc/plugin_config.yaml
@@ -168,6 +169,8 @@ files:
 - etc/meta_templates/plugin_seed/lib/{entity}/version.rb.erb
 - etc/meta_templates/plugin_seed/lib/{entity}/{entity}_processor.rb.erb
 - etc/meta_templates/plugin_seed/psplugin_{entity}.gemspec
+- etc/meta_templates/plugin_seed/spec/spec_helper.rb
+- etc/meta_templates/plugin_seed/spec/{entity}_spec.rb
 - etc/power_stencil.yaml
 - etc/templates/plugin_definition/.gitignore
 - etc/templates/plugin_definition/.rspec
@@ -279,6 +282,10 @@ files:
 - lib/power_stencil/system_entity_definitions/project_entity.rb
 - lib/power_stencil/system_entity_definitions/simple_exec.rb
 - lib/power_stencil/system_entity_definitions/source_provider.rb
+- lib/power_stencil/ultra_command_line/command_line_manager.rb
+- lib/power_stencil/ultra_command_line/option_definition.rb
+- lib/power_stencil/ultra_command_line/providers_manager.rb
+- lib/power_stencil/ultra_command_line/sub_command.rb
 - lib/power_stencil/utils/completion.rb
 - lib/power_stencil/utils/directory_processor.rb
 - lib/power_stencil/utils/file_edit.rb
@@ -299,12 +306,13 @@ metadata:
   documentation_uri: https://gitlab.com/tools4devops/power_stencil/blob/master/README.md
   source_code_uri: https://gitlab.com/tools4devops/power_stencil
   homepage_uri: https://powerstencil.brizone.org/
-post_install_message: "\nThank you for installing PowerStencil 0.8.9 !\nFrom the command
-  line you can run `power_stencil --help`\nIf your shell is not completing the command:\n
-  \ If you use rbenv: `rbenv rehash`\n  If you use zsh  : `rehash`\n\nOfficial Website
-  \         : https://powerstencil.brizone.org/\nFull documentation here   : https://gitlab.com/tools4devops/power_stencil/blob/master/README.md\nFeel
-  free to report issues: https://gitlab.com/tools4devops/power_stencil/issues\n\nType
-  'power_stencil adm --zsh-completion' to install auto-completion for zsh.\n\n  "
+post_install_message: "\nThank you for installing PowerStencil 0.8.14 !\nFrom the
+  command line you can run `power_stencil --help`\nIf your shell is not completing
+  the command:\n  If you use rbenv: `rbenv rehash`\n  If you use zsh  : `rehash`\n\nOfficial
+  Website          : https://powerstencil.brizone.org/\nFull documentation here   :
+  https://gitlab.com/tools4devops/power_stencil/blob/master/README.md\nFeel free to
+  report issues: https://gitlab.com/tools4devops/power_stencil/issues\n\nType 'power_stencil
+  adm --zsh-completion' to install auto-completion for zsh.\n\n  "
 rdoc_options: []
 require_paths:
 - lib