power_stencil 0.4.15 → 0.4.20

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 39ef892e57acf1b138606b8ce494324a76759eac
-  data.tar.gz: 811c9bbb835afa1f137c76d74a5261a01486fd6e
+  metadata.gz: e2582b92f3e64dba5535548383200c900db71ea5
+  data.tar.gz: 52cd784e7160cf2d580c86a06999e6bab6c8b0d1
 SHA512:
-  metadata.gz: 8d7d187f50b36b965576bc4dd538bacd401a8b62df1968c9f7cbc13ccfc3e6027c842dcc6e82be8753cd62e093c7d1c28d4e0f87c8247324cfa99d0e45a3aa70
-  data.tar.gz: 091f7d4bf28c89f292e33a78a1176b72678c8464c1dc0e517b6be47b42908fefd9a4fdabeec3af905871acecb72172b8a0a6395d67973ea3588c426c57acab42
+  metadata.gz: 8df322c9851a1126691cea6a7c9b2fb66dad309845b63073625ad392319c0d9221eb98f73401a5cbfe4b04bfd654d87c9dc83e281477317b82071938f33bb802
+  data.tar.gz: 3a141b9153a9d25ef54eaa8a581b64585961a9954508f8cd75631c399e7f73914af2d4e0f1b673ae16c4a7728f033b924210a28d4d3065ea64d25744439c5246

data/README.md

@@ -112,13 +112,14 @@ PowerStencil is the Swiss-army knife templating workflow for developers and ops.
 --------------------------------------------------------------------------------
  * init: Initializes a PowerStencil repository ...
  * info: Generic information about the repository ...
- * new-plugin: Generates the skeleton for a plugin ...
+ * plugin: Manipulates plugins ...
  * get: Query entities from repository ...
  * shell: Opens a shell to interact with entities ...
  * check: Check repository entities consistency ...
  * create: Creates entities in the repository ...
  * edit: Edit entities from repository ...
  * delete: Delete entities from repository ...
+ * describe: Detailed information about entity types ...
  * build: Builds entities ...
 ```
 

data/doc/builds.md

@@ -244,6 +244,8 @@ PowerStencil::SystemEntityDefinitions::ProcessDescriptor:
 ```
 It creates a `process_descriptor` entity (which is referenced from the `simple_exec` entity as the `post_process` field). So you can edit this process descriptor and define there whatever executable you want to be called.
 
+:information_source: If you are using Windows you may want to rename `main.sh` to `main.bat` and edit the `process_descriptor/simple_exec_example.process` to change the process to `main.bat`. 
+
 This should already cover 95% of everything needed.
 
 If you want to do something more custom after the build process completed, this is where you will have to do a [plugin][plugins].

data/doc/plugins.md

@@ -52,7 +52,7 @@ The normal process would be to begin with a plugin within the project and once y
 The is a command provided for that, that will create a whole plugin skeleton.
 
 ```shell
-$ power_stencil new-plugin myplugin
+$ power_stencil plugin --create myplugin
 Generated new plugin 'myplugin'
 
 $ ll .ps_project/plugins/myplugin
@@ -96,7 +96,35 @@ If you do a `power_stencil info` you see a new part appeared in the report
 ```
 Each of the lines correspond to what is called a _plugin capability_.
 
-Obviously by default the plugin does nothing, but it defined some placeholders. For example in the ouput here above it says `command_line: true`. What could it mean ?
+You can get the same information by issuing:
+
+    $ power_stencil plugin --list
+    
+```
+1 plugin found to be used in this project.
+ - myplugin (in '/tmp/tst project/.ps_project/plugins/myplugin/lib/myplugin.rb')
+```
+
+Or with the capabilities information:
+
+    $ power_stencil plugin --list -v
+
+```
+1 plugin found to be used in this project.
+ - myplugin (in '/tmp/tst project/.ps_project/plugins/myplugin/lib/myplugin.rb')
+   command_line: true
+   local_config: true
+   processors: true
+   build: false
+   dsl: false
+   entity_definitions: true
+   code: true
+   version: true
+   templates: true
+```
+   
+
+Obviously by default the plugin does nothing useful, yet it defined some placeholders. For example in the output here above it says `command_line: true`. What could it mean ?
 
 Let's try to see to help:
 
@@ -122,7 +150,7 @@ PowerStencil is the Swiss-army knife templating workflow for developers and ops.
 --------------------------------------------------------------------------------
  * init: Initializes a PowerStencil repository ...
  * info: Generic information about the repository ...
- * new-plugin: Generates the skeleton for a plugin ...
+ * plugin: Manipulates plugins ...
  * get: Query entities from repository ...
  * shell: Opens a shell to interact with entities ...
  * check: Check repository entities consistency ...

data/doc/templates.md

@@ -146,7 +146,32 @@ Here are the main methods:
 - `build_target` will return the entity that you are currently building.
 - `project_config` is a shortcut to the project entity. You could actually retrieve it using the `entity(:project_config, 'Project Config')` method.
 
-And of course you have access like in `power_stencil shell` to any class brought by `PowerStencil`, you could create entities there, destroy some, **but you should not do it**, as it would be very weird to do that during the process of detemplating !
+And of course you have access like in `power_stencil shell` to any class brought by `PowerStencil`, you could create entities there, destroy some, **but you should not do it**, as doing this during the process of detemplating could lead to strange behaviours !
+
+Nevertheless you can of course use entities data and methods within your templates. Any data can be directly accessed using [entity field] mechanism. But entities may bring as well methods you may want to use within your templates. How can we know what can be done with an entity **without reading the code** ? The answer is `power_stencil describe`... 
+
+:information_source: If you do `power_stencil describe` on any entity type, you will get a comprehensive report of what you can do with this or this entity type (by default all entity types are displayed).
+
+Here is a (not so interesting) example:
+
+```
+$ power_stencil describe simple_exec
+--------------------------------------------------------------------------------
+=> simple_exec (class: PowerStencil::SystemEntityDefinitions::SimpleExec)
+  - PARENT ENTITY TYPE: base_entity
+  - FIELDS:
+    - description
+    - post_process:
+      - has_one: process_descriptor
+      - not_null: true
+  - METHODS:
+    - delete
+    - valid?
+    - save
+```
+
+This should be self explanatory, there is another part that could be displayed in case you defined complex relation using the [reverse methods] mechanism...
+
 
 # Where do I create templates ?
 
@@ -324,7 +349,8 @@ Flawless victory !!
 [plugins]: plugins.md "Plugins in PowerStencil"
 [example use cases]: example_use_cases.md "Example uses cases using PowerStencil"
 [buildable]: entities.md#buildable-and-buildable_by "How to make an entity buildable ?"
-
+[entity field]: entities.md#field "How to access basic entity data"
+[reverse methods]: entities.md#has_one "Check reverse methods"
 <!-- Code links -->
 
 

data/etc/base_commands_definition.yml

@@ -93,14 +93,24 @@
         info [options]
 
       Displays information about the repository.
-  new-plugin:
+  plugin:
     :banner: |
-      Generates the skeleton for a plugin.
+      Manipulates plugins.
 
       Usage:
-        new-plugin [options]
+        plugin [options]
 
-      Generates a fully working although useless plugin skeleton.
+      Manipulates plugins.
+    :options:
+      create:
+        :type: bool
+        :summary: Generates a fully working although useless plugin skeleton.
+        :long_aliases:
+          - new
+          - scaffold
+      list:
+        :type: bool
+        :summary: List currently used plugins in this project.
   get:
     :banner: |
       Query entities from repository.
@@ -179,6 +189,13 @@
     :options:
       regexp:
         <<: *REGEXPOPT
+      invalid-only:
+        :type: boolean
+        :summary: Show invalid entities only.
+        :long_aliases:
+          - invalid
+        :short_aliases:
+          - i
   create:
     :banner: |
       Creates entities in the repository.
@@ -191,7 +208,7 @@
     :options:
       property:
         :type: array
-        :summary: Specifiies a first-level property for the entity
+        :summary: Specifies a first-level property for the entity
         :short_aliases:
           - p
       edit:
@@ -220,7 +237,7 @@
 
       Usage:
 
-        edit [object_type[[/ ]object_name]] [options]
+        edit [entity_type[[/ ]entity_name]] [options]
 
       Edits repository entities. Parameters are used the same way as in 'get'.
     :options:
@@ -236,7 +253,7 @@
 
       Usage:
 
-        delete [object_type[[/ ]object_name]] [options]
+        delete [entity_type[[/ ]entity_name]] [options]
 
       Deletes repository entities. Parameters are used the same way as in 'get'.
     :options:
@@ -244,6 +261,16 @@
       delete-files:
         :type: bool
         :summary: Will also remove files related to the entity.
+  describe:
+    :banner: |
+      Detailed information about entity types.
+
+      Usage:
+
+        describe [entity_type]* [options]
+
+      Displays information about core properties of given entity types.
+      By default will describe all entity types.
   build:
     :banner: |
       Builds entities.
@@ -268,4 +295,17 @@
       parallelized:
         :type: bool
         :summary: Parallelizes builds if possible
-
+      tag-build:
+        :type: string
+        :summary: Tags the build with a specific name
+        :long_aliases:
+          - tag
+        :short_aliases:
+          - t
+      target-path:
+        :type: string
+        :summary: Build into specified directory
+        :long_aliases:
+          - path
+        :short_aliases:
+          - p

data/etc/power_stencil.yaml

@@ -33,6 +33,10 @@
 :project_plugins_directory_name: plugins
 # Root directory where builds are generated
 :project_build_root_directory_name: build
+# Last build link name
+:project_build_last_stable_path: last_build
+# Previous build link name
+:project_build_previous_stable_path: previous_build
 
 
 # DSL CUSTOMIZATIONS
@@ -42,11 +46,11 @@
 :shell_dsl:
   :prompt_level_1: 'PowerStencil DSL> '
   :prompt_level_2: 'PowerStencil DSL --> '
-  :session_greetings: |
+  :session_greetings: |+
     -------------------------------------------------------------------------------
      Welcome to the PowerStencil shell session
      In this shell you have access to anything the templating engine has access to.
-     You can view, edit, save entities.
+     On top of this, you can view, edit, save and delete entities.
 
      - Retrieve and manipulate entities using the `entities` hash.
      - Persist your changes using the `save` method on each entity.
@@ -59,8 +63,6 @@
      Type `exit` to end your session.
     -------------------------------------------------------------------------------
 
-
-
 # TEMPLATING ENGINE
 
 # Map to define which kind of template engine for which type of file. Be careful if you
@@ -71,7 +73,8 @@
 
 # Files matching particular patterns can be changed on the fly
 :file_renaming_patterns:
-  # Specific .gitignore file for Windows
+  # Specific .gitignore hack for `power_stencil init` as .gitignore should be processed
+  # *after* .ps_project
   ^(.+)\.zzzgitignore\.erb$: '\1.gitignore'
   # Erb files
   ^(.+)\.erb$: '\1'

data/etc/templates/project/.ps_project/plugins/README.md

@@ -5,7 +5,7 @@ PowerStencil plugins
 In this directory, you can define project specific local plugins.
 You should create them using the `PowerStencil` command-line.
 
-    $ power_stencil new-plugin myplugin 
+    $ power_stencil plugin --create myplugin 
 
 __It is strongly advised to keep this directory under source control__
 

data/lib/power_stencil.rb

@@ -7,6 +7,7 @@ $DO_NOT_AUTOSTART_CLIMATIC=true
 require 'climatic'
 
 require 'power_stencil/error'
+require 'power_stencil/utils/os'
 require 'power_stencil/utils/semantic_version'
 require 'power_stencil/utils/file_helper'
 require 'power_stencil/utils/directory_processor'
@@ -29,8 +30,9 @@ require 'power_stencil/command_processors/create'
 require 'power_stencil/command_processors/edit'
 require 'power_stencil/command_processors/delete'
 require 'power_stencil/command_processors/shell'
-require 'power_stencil/command_processors/new_plugin'
+require 'power_stencil/command_processors/plugin'
 require 'power_stencil/command_processors/build'
+require 'power_stencil/command_processors/describe'
 
 
 module PowerStencil

data/lib/power_stencil/command_processors/build.rb

@@ -25,6 +25,11 @@ module PowerStencil
           raise PowerStencil::Error, 'Please specify something to build'
         end
 
+        if config[:'build-tag']
+          raise PowerStencil::Error, "Invalid tag name '#{config[:'build-tag']}'" if config[:'build-tag'].include? '/'
+          raise PowerStencil::Error, "Cannot tag a build under Windows" if PowerStencil::Utils::Os.windows?
+        end
+
         targets = targets_from_criteria analyse_extra_params, project.engine.root_universe
         raise PowerStencil::Error, 'No valid entity specified' if targets.empty?
         project.engine.build targets, fail_on_error: config[:'fail-on-error'], parallelized: config[:parallelized]

data/lib/power_stencil/command_processors/check.rb

@@ -9,23 +9,25 @@ module PowerStencil
       include PowerStencil::CommandProcessors::EntityHelper
 
       def execute
-        puts 'RAW ENTITIES'
         targets = targets_from_criteria analyse_extra_params, project.engine.root_universe
-        targets.sort {|a,b| a.as_path <=> b.as_path }
-            .map do |entity|
+        sorted_targets = targets.sort {|a,b| a.as_path <=> b.as_path }
+        if config[:'invalid-only']
+          sorted_targets.reject! &:valid?
+          if sorted_targets.empty?
+            puts 'No invalid entity found in this repository.'
+            return
+          else
+            puts 'Showing invalid entities only:'
+          end
+        end
+        sorted_targets.map do |entity|
           entity_info = [" '#{entity.as_path}':"]
           entity_info << "  - Storage path   : '#{entity.source_uri}'"
           entity_info << "  - Templates path : '#{entity.templates_path}'" if entity.respond_to? :templates_path
           entity_info << "  - Status         : #{entity.valid? ? 'Valid' : 'INVALID !'} "
           entity_info << "  - Buildable      : #{entity.buildable?}"
           entity_info
-        end .each { |l| puts l }
-
-
-        #
-        # targets.map do |entity|
-        #   " - '#{entity.as_path}': '#{entity.source_uri}'"
-        # end .sort.each { |l| puts l }
+        end .each { |entity_info| puts entity_info }
       end
 
 

data/lib/power_stencil/command_processors/describe.rb

@@ -0,0 +1,19 @@
+module PowerStencil
+  module CommandProcessors
+
+    class Describe
+
+      include Climatic::Script::UnimplementedProcessor
+      include Climatic::Proxy
+      include PowerStencil::Project::Proxy
+      include PowerStencil::CommandProcessors::EntityHelper
+
+      def execute
+        targets = extra_params_to_entity_types
+        describe_entity_types targets
+      end
+    end
+
+  end
+
+end

data/lib/power_stencil/command_processors/entity_helper.rb

@@ -9,6 +9,49 @@ module PowerStencil
         end
       end
 
+      def describe_entity_types(entity_types)
+        report = {}
+        project.engine.available_entity_types.each { |entity_type| report = build_entity_type_report entity_type, report }
+        scoped_classes = report.keys
+
+        report.select{|klass, _| entity_types.include? klass.entity_type}
+            .sort_by {|klass, _| klass.entity_type.to_s}
+            .each do |klass, info|
+          puts '-' * 80
+          puts "=> #{klass.entity_type} (class: #{klass.name})"
+          puts "  - PARENT ENTITY TYPE: #{klass.superclass.entity_type}" if scoped_classes.include? klass.superclass
+          unless info[:fields].empty?
+            puts '  - FIELDS:'
+            info[:fields].each do |field_name, constraints|
+              if constraints.empty?
+                puts "    - #{field_name}"
+              else
+                puts "    - #{field_name}:"
+                constraints.each do |name, value|
+                  puts "      - #{name}: #{value}"
+                end
+              end
+            end
+          end
+          unless info[:methods].empty?
+            puts '  - METHODS:'
+            info[:methods].each do |method_name, _|
+              puts "    - #{method_name}"
+            end
+          end
+          unless info[:special_methods].empty?
+            puts '  - SPECIAL METHODS:'
+            info[:special_methods].each do |method_name, method_info|
+              puts "    - #{method_name} (reverse method defined from relation '#{method_info[:source_field]}' in entity type '#{method_info[:source_entity]}')"
+            end
+          end
+
+        end
+
+      end
+
+
+
       def display_entity(entity)
         puts_and_logs "# Entity '#{entity.name}' (#{entity.type})"
         if config[:'names-only']
@@ -66,6 +109,20 @@ module PowerStencil
         end
       end
 
+      def extra_params_to_entity_types(params = config.command_line_layer.extra_parameters)
+        known_entity_types = project.engine.available_entity_types
+        return known_entity_types if params.empty?
+
+        params.map do |possible_entity_type|
+          possible_entity_type = possible_entity_type.to_sym
+          raise PowerStencil::Error, "Invalid entity type '#{possible_entity_type}' !" unless known_entity_types.include? possible_entity_type
+          possible_entity_type
+        end
+      end
+
+
+
+
       def extra_params_to_entity_search_criteria(params)
         criteria = []
         next_entity_reference = EntitySearchReference.new
@@ -101,6 +158,34 @@ module PowerStencil
       private
 
 
+      def build_entity_type_report(entity_type, report = {})
+        klass = project.engine.available_entities_hash[entity_type]
+        report[klass] ||= {fields: {}, methods: {}, special_methods: {}}
+        entity_type_info = report[klass]
+
+        # Fields
+        klass.fields_constraints.each  do |field_name, constraints|
+          next if constraints[:reverse_method]
+          entity_type_info[:fields][field_name] = {}
+          constraints.each do |constraint_name, constraints_value|
+            entity_type_info[:fields][field_name][constraint_name] = constraints_value
+          end
+        end
+        # Methods
+        klass.public_instance_methods(false).select do |method_name|
+          klass.method_defined? method_name
+        end .each do |method_name|
+          entity_type_info[:methods][method_name] = klass
+        end
+        # Special methods
+        klass.fields_constraints.each  do |method_name, constraints|
+          next unless constraints[:reverse_method]
+          entity_type_info[:special_methods][method_name] = constraints[:reverse_method]
+        end
+
+        report
+      end
+
       def analyse_extra_params(extra_params = config.command_line_layer.extra_parameters, default: [''])
         params_to_check = if extra_params.empty? then
                             config[:regexp] = true

data/lib/power_stencil/command_processors/plugin.rb

@@ -0,0 +1,56 @@
+module PowerStencil
+  module CommandProcessors
+
+    class Plugin
+
+      include Climatic::Script::UnimplementedProcessor
+      include Climatic::Proxy
+      include PowerStencil::Project::Proxy
+
+      def execute
+        
+        if config[:list]
+          if project.plugins.empty?
+            puts 'No plugin used in this project.'
+          else
+            puts "#{project.plugins.size} plugin#{project.plugins.size == 1 ? '' : 's'} found to be used in this project."
+          end
+          project.plugins.each do |plugin_name, plugin_def|
+            puts " - #{plugin_name} (in '#{plugin_def.entry_point_path}')"
+            if config[:verbose]
+              plugin_def.capabilities.each do |name, value|
+                puts "   #{name}: #{value}"
+              end
+            end
+          end
+          return
+        end
+        
+
+        if config[:create]
+          if config.command_line_layer.extra_parameters.empty?
+            raise PowerStencil::Error, 'Please specify at least one plugin name !'
+          end
+          config.command_line_layer.extra_parameters.each do |plugin_name|
+            begin
+              target_path = File.join project.project_plugin_path(plugin_name)
+              project.create_plugin_tree plugin_name, target_path
+              puts "Generated new plugin '#{plugin_name}'"
+            rescue => e
+              msg = "Could not create plugin '#{plugin_name}' because '#{e.message}'"
+              puts msg
+              logger.error "Could not create plugin '#{plugin_name}' because '#{e.message}'"
+              logger.debug PowerStencil::Error.report_error(e)
+            end
+          end
+          return
+        end
+
+        raise PowerStencil::Error, 'You should specify an option'
+
+      end
+
+    end
+
+  end
+end

data/lib/power_stencil/engine/build_handling.rb

@@ -26,7 +26,16 @@ module PowerStencil
               entity_build_report << msg
               raise PowerStencil::Error, msg
             end
-            build_entity_target_path = File.join build_target_path, entity_to_build.as_path.tr('/', '_')
+            build_entity_target_path = if config[:'target-path']
+                                         specified_target_path = File.expand_path config[:'target-path']
+                                         if File.exists? specified_target_path
+                                           raise PowerStencil::Error, "Specified target path '#{specified_target_path}' already exists ! Aborting..."
+                                         end
+                                         specified_target_path
+                                       else
+                                         File.join build_target_path, entity_to_build.as_path.tr('/', '_')
+                                       end
+
             puts_and_logs "De-templating files for '#{entity_to_build.as_path}' into '#{build_entity_target_path}'"
             build_entity entity_to_build, build_entity_target_path
             entity_build_report << 'Ok'
@@ -46,10 +55,51 @@ module PowerStencil
 
       private
 
+      def manage_build_links(last_build_path)
+        if PowerStencil::Utils::Os.windows?
+          logger.info 'Cannot create link to last build folder under Windows !'
+          return
+        end
+        last_build_link_path = project.last_build_stable_link_path
+        previous_build_link_path = project.previous_build_stable_link_path
+        current_last_build_link_target_path = (File.symlink? last_build_link_path) ? File.readlink(last_build_link_path) : nil
+
+        safely_remove_link previous_build_link_path
+        unless current_last_build_link_target_path.nil?
+          File.symlink current_last_build_link_target_path, previous_build_link_path unless File.exists? previous_build_link_path
+        end
+
+        safely_remove_link last_build_link_path
+        File.symlink last_build_path, last_build_link_path unless File.exists? last_build_link_path
+
+        if config[:'tag-build']
+          build_tag_path = File.join project.build_root_path, config[:'tag-build']
+          safely_remove_link build_tag_path
+          File.symlink last_build_path, build_tag_path unless File.exists? build_tag_path
+        end
+      end
+
+
+      def safely_remove_link(link)
+        if File.exists? link
+          if File.symlink? link
+            File.unlink link
+          else
+            logger.warn "Warning '#{link}' is not a symlink !!"
+            return false
+          end
+        else
+          logger.debug "No file/link to delete ('#{link}')"
+        end
+        true
+      end
+
+
       def build_entity(entity_to_build, target_path)
         logger.info "Building #{entity_to_build.as_path} in '#{target_path}'"
         render_source entity_to_build.templates_path, target_path, main_entry_point: entity_to_build.as_path
         logger.info "Detemplatized filed generated in '#{target_path}'"
+        manage_build_links target_path
         target_plugin_name =  entity_to_build.buildable_by
         if target_plugin_name.empty?
           post_build_hook entity_to_build, target_path
@@ -67,7 +117,7 @@ module PowerStencil
           script_to_execute = File.expand_path File.join(files_path, entity_to_build.post_process.process)
           exec_options = {message: "Running '#{script_to_execute}'"}
           exec_options[:show_output] = true if config[:verbose]
-          process_report = safely_exec_command script_to_execute, exec_options
+          process_report = safely_exec_command "'#{script_to_execute}'", exec_options
           unless process_report.exit_status.exitstatus == 0
             raise PowerStencil::Error, "Process `#{process_report.command}` failed and returned exit code '#{process_report.exit_status.exitstatus}'"
           end

data/lib/power_stencil/initializer.rb

@@ -47,8 +47,9 @@ module PowerStencil
           edit: PowerStencil::CommandProcessors::Edit,
           delete: PowerStencil::CommandProcessors::Delete,
           shell: PowerStencil::CommandProcessors::Shell,
-          :'new-plugin' => PowerStencil::CommandProcessors::NewPlugin,
-          build: PowerStencil::CommandProcessors::Build
+          plugin: PowerStencil::CommandProcessors::Plugin,
+          build: PowerStencil::CommandProcessors::Build,
+          describe: PowerStencil::CommandProcessors::Describe
       }.each do |command_name, processor|
         command_line_manager.register_processor command_line_manager.command_by_alias(command_name),
                                                 processor.new

data/lib/power_stencil/project/paths.rb

@@ -19,6 +19,14 @@ module PowerStencil
         File.join build_root_path, timestamped_uniq_dir(seed, Time.now)
       end
 
+      def last_build_stable_link_path
+        File.join build_root_path, PowerStencil.config[:project_build_last_stable_path]
+      end
+
+      def previous_build_stable_link_path
+        File.join build_root_path, PowerStencil.config[:project_build_previous_stable_path]
+      end
+
       def build_root_path
         File.join project_root, PowerStencil.config[:project_build_root_directory_name]
       end

data/lib/power_stencil/project/versioning.rb

@@ -5,7 +5,11 @@ module PowerStencil
 
       def check_project_version
         return if project_version_valid?
-        raise PowerStencil::Error, msg
+        msg = <<~EOM
+            This PowerStencil project requires a version of PowerStencil >= #{config[:min_power_stencil_version]} (You are using version #{PowerStencil::VERSION}) !
+            You should consider upgrading by doing 'gem install power_stencil'...
+        EOM
+        raise PowerStencil::Error, msg.chomp
       end
 
       private

data/lib/power_stencil/utils/os.rb

@@ -0,0 +1,15 @@
+module PowerStencil
+  module Utils
+
+    module Os
+
+      WINDOWS_RUBY_FLAVOURS = %w(mswin32 cygwin mingw bccwin)
+
+      def self.windows?
+        WINDOWS_RUBY_FLAVOURS.include? RbConfig::CONFIG['host_os']
+      end
+
+    end
+
+  end
+end

data/lib/power_stencil/version.rb

@@ -1,3 +1,3 @@
 module PowerStencil
-  VERSION = '0.4.15'.freeze
+  VERSION = '0.4.20'.freeze
 end

data/power_stencil.gemspec

@@ -27,7 +27,7 @@ Gem::Specification.new do |spec|
 
   spec.add_dependency 'climatic', '~> 0.2.29'
   spec.add_dependency 'dir_glob_ignore', '~> 0.3'
-  spec.add_dependency 'universe_compiler', '~> 0.4.3'
+  spec.add_dependency 'universe_compiler', '~> 0.5.1'
   spec.add_dependency 'pry'
 
   source_code_uri = 'https://gitlab.com/tools4devops/power_stencil'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: power_stencil
 version: !ruby/object:Gem::Version
-  version: 0.4.15
+  version: 0.4.20
 platform: ruby
 authors:
 - Laurent Briais
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-10-03 00:00:00.000000000 Z
+date: 2019-10-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -86,14 +86,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.3
+        version: 0.5.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.3
+        version: 0.5.1
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -191,12 +191,13 @@ files:
 - lib/power_stencil/command_processors/check.rb
 - lib/power_stencil/command_processors/create.rb
 - lib/power_stencil/command_processors/delete.rb
+- lib/power_stencil/command_processors/describe.rb
 - lib/power_stencil/command_processors/edit.rb
 - lib/power_stencil/command_processors/entity_helper.rb
 - lib/power_stencil/command_processors/get.rb
 - lib/power_stencil/command_processors/info.rb
 - lib/power_stencil/command_processors/init.rb
-- lib/power_stencil/command_processors/new_plugin.rb
+- lib/power_stencil/command_processors/plugin.rb
 - lib/power_stencil/command_processors/root.rb
 - lib/power_stencil/command_processors/shell.rb
 - lib/power_stencil/command_processors/trace_helper.rb
@@ -247,6 +248,7 @@ files:
 - lib/power_stencil/utils/file_helper.rb
 - lib/power_stencil/utils/gem_utils.rb
 - lib/power_stencil/utils/graphviz.rb
+- lib/power_stencil/utils/os.rb
 - lib/power_stencil/utils/secure_require.rb
 - lib/power_stencil/utils/semantic_version.rb
 - lib/power_stencil/version.rb
@@ -259,7 +261,7 @@ 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.4.15 !\nFrom the
+post_install_message: "\nThank you for installing PowerStencil 0.4.20 !\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   :

data/lib/power_stencil/command_processors/new_plugin.rb

@@ -1,31 +0,0 @@
-module PowerStencil
-  module CommandProcessors
-
-    class NewPlugin
-
-      include Climatic::Script::UnimplementedProcessor
-      include Climatic::Proxy
-      include PowerStencil::Project::Proxy
-
-      def execute
-        if config.command_line_layer.extra_parameters.empty?
-          raise PowerStencil::Error, 'Please specify a plugin name!'
-        end
-        config.command_line_layer.extra_parameters.each do |plugin_name|
-          begin
-            target_path = File.join project.project_plugin_path(plugin_name)
-            project.create_plugin_tree plugin_name, target_path
-            puts "Generated new plugin '#{plugin_name}'"
-          rescue => e
-            msg = "Could not create plugin '#{plugin_name}' because '#{e.message}'"
-            puts msg
-            logger.error "Could not create plugin '#{plugin_name}' because '#{e.message}'"
-            logger.debug PowerStencil::Error.report_error(e)
-          end
-        end
-      end
-
-    end
-
-  end
-end