power_stencil 0.4.16 → 0.4.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b10ddad9f41bfb08e3d0917d4226038c4f80804c
-  data.tar.gz: 614c5bf32a33a9e55ce3b62f9a9d6a1e24db3b39
+  metadata.gz: 090721c55ffc99653d0be5a9b923c45c175cd538
+  data.tar.gz: 80ba7636a39ceed4f6403cef1170206ca33ee8d4
 SHA512:
-  metadata.gz: 23e52fc919f98bb92b173e4b5e945028b78a6a14597646ffc6fef7f39fbafe9be0d0bae32b8ee247537144ccb7ccd3206eb8d795711003879b76557f1b925dc7
-  data.tar.gz: f2af26ceb8859707ff7b721b2346c93fafca817c9253ac65b9b9840205f21833798bd39606f377715ed0c0ce6849656e7943b293e306ab2edca026621c774f6e
+  metadata.gz: 601aa0ba6a72326dc3dab22ecc0304ac26c33046dd0f208c1bd2e045d0767c4624a69027389dc76b2dc154f38eb55750e7229fffcbaee853aa891b77368d2e08
+  data.tar.gz: 87f465b799e7802715383c226e8acd57c4eb0cc50ff336b7666eb22802b876662554b43d0e482a2f0fc84b15f4323e047484dc19543413dd47463024c2bb99d8

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/etc/base_commands_definition.yml

@@ -268,4 +268,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

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/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

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/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.16'.freeze
+  VERSION = '0.4.17'.freeze
 end

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'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: power_stencil
 version: !ruby/object:Gem::Version
-  version: 0.4.16
+  version: 0.4.17
 platform: ruby
 authors:
 - Laurent Briais
@@ -247,6 +247,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 +260,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.16 !\nFrom the
+post_install_message: "\nThank you for installing PowerStencil 0.4.17 !\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   :