power_stencil 0.4.11 → 0.4.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 94f31697927b7c398f3479e6119e5ec7b9ada878
-  data.tar.gz: 1aa4ee24ce33bb0d056a471cde643d85c804b369
+  metadata.gz: b10ddad9f41bfb08e3d0917d4226038c4f80804c
+  data.tar.gz: 614c5bf32a33a9e55ce3b62f9a9d6a1e24db3b39
 SHA512:
-  metadata.gz: 903b071f3761253f8dcb766bd1d340a494115f6a5483d5346872488074c023ebf9b1fd573510f64fbfa53abddcdcdd944ac8ea778d528188748d6be7f6af6cfe
-  data.tar.gz: 6df31360e4f082f1a45e80120d49057da5222e3f8466a02c71bafe31e39b6047a9223e5eb793c0c50b5b88d4802105cdbeaac86e750d000539b067f6768aa980
+  metadata.gz: 23e52fc919f98bb92b173e4b5e945028b78a6a14597646ffc6fef7f39fbafe9be0d0bae32b8ee247537144ccb7ccd3206eb8d795711003879b76557f1b925dc7
+  data.tar.gz: f2af26ceb8859707ff7b721b2346c93fafca817c9253ac65b9b9840205f21833798bd39606f377715ed0c0ce6849656e7943b293e306ab2edca026621c774f6e

data/README.md

@@ -75,10 +75,12 @@ Then you can install the `PowerStencil` gem by issuing the usual:
 
     $ gem install power_stencil
 
-If you want to create graphviz graphs, you probably may want to install it for your system. If you are using an _apt-based_ system like Ubuntu or Debian it may probably be as simple as:
+If you want to create [Graphviz] graphs, you probably may want to install it for your system. If you are using an _apt-based_ system like Ubuntu or Debian it may probably be as simple as:
 
     $ sudo apt install graphviz
 
+If you use Windows, install [Graphviz] using the stable version for Windows and add the `bin` directory to the `%PATH%`.
+
 # Usage
 
 ## Help
@@ -246,4 +248,5 @@ Everyone interacting in the PowerStencil project’s codebases, issue trackers,
 [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 site]: https://powerstencil.brizone.org "Official PowerStencil website"
+[Graphviz]: https://www.graphviz.org/ "Graph Visualization Software"

data/doc/entities.md

@@ -984,4 +984,4 @@ Now you know an entity type is just a regular Ruby class. As such you could add
 [Ruby On Rails]: https://rubyonrails.org/ "One of the best Web framework"
 [universe_compiler]: https://gitlab.com/tools4devops/universe_compiler "The underlying engine to manage entities and compilation !"
 [`universe_compiler` advanced relations documentation]: https://gitlab.com/tools4devops/universe_compiler#advanced-relations "Advanced relational features"
-[Graphviz]: (https://www.graphviz.org/) "Graph Visualization Software"
+[Graphviz]: https://www.graphviz.org/ "Graph Visualization Software"

data/doc/faq.md

@@ -65,7 +65,9 @@ So the two main remaining contenders are JSON and YAML. Although there is no rea
 
 As such, even if I never tested, I would expect it to probably work out of the box on MacOS, BSD or other Unices supporting Ruby 2.2+.
 
-Regarding Windows, I stopped using spywareOS years ago so I can't really tell you. Last time I tried using Ruby on Windows (maybe 10 years ago), I did face a lot of dependency issues. Maybe things are better now, but I have no idea. As far as I understood you can now have an Ubuntu running on top of Windows 10 as a kind of blessed VM. I would probably more go this way...
+~~Regarding Windows, I stopped using spywareOS years ago so I can't really tell you. Last time I tried using Ruby on Windows (maybe 10 years ago), I did face a lot of dependency issues. Maybe things are better now, but I have no idea. As far as I understood you can now have an Ubuntu running on top of Windows 10 as a kind of blessed VM. I would probably more go this way...~~
+
+I had the opportunity to have access to a Windows VM and tested `PowerStencil`. I had to fix a couple of issues related to the way Windows manages concurrent access to files (:rofl:) , but **since version `0.4.14`, `PowerStencil` should now fully work under Windows**, including generating files using GraphViz if it is installed and correctly set in the `%PATH%`. I used the standard Ruby for Windows with no hack.
 
 
 # What is the status of `PowerStencil` ?

data/etc/power_stencil.yaml

@@ -71,6 +71,8 @@
 
 # Files matching particular patterns can be changed on the fly
 :file_renaming_patterns:
+  # Specific .gitignore file for Windows
+  ^(.+)\.zzzgitignore\.erb$: '\1.gitignore'
   # Erb files
   ^(.+)\.erb$: '\1'
 

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

@@ -0,0 +1,12 @@
+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 
+
+__It is strongly advised to keep this directory under source control__
+
+This should be the PowerStencil default behaviour. 

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

@@ -1,12 +1,10 @@
-PowerStencil project templates
-==============================
+PowerStencil project templates templates
+========================================
 
 
-In this directory, you can define project specific templates for entities
-defined locally in this project. 
+In this directory, you can define project specific templates for entity types defined locally in this project. 
 
-Templates can be a whole tree structure in a directory named from the entity
-type of entities you defined in `entity_definitions` folder that are `buildable`.
+Templates can be a whole tree structure in a directory named from the entity type of entities you defined in `entity_definitions` folder that are `buildable`.
 
 __It is strongly advised to keep this directory under source control__
 

data/etc/templates/simple_exec/main.sh

@@ -2,3 +2,6 @@
 # Generated on the <%= Time.now %>
 
 echo "Nothing to do... Easy task..."
+
+# Return 0 if the build succeeds
+exit 0

data/lib/power_stencil/engine/build_handling.rb

@@ -67,7 +67,11 @@ 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]
-          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
+          process_report
         end
       end
 

data/lib/power_stencil/engine/directory_processor.rb

@@ -59,7 +59,7 @@ module PowerStencil
         unless files_not_to_rename.ignore_file? src_file
           config[:file_renaming_patterns].each do |regexp_str, replacement|
             regexp = Regexp.new regexp_str
-            next if (dest_file =~ regexp).nil?
+            next if (src_file =~ regexp).nil?
             dest_file = dest_file.gsub regexp, replacement
             break
           end

data/lib/power_stencil/utils/directory_processor.rb

@@ -12,7 +12,7 @@ module PowerStencil
         # Dir.glob_with_ignore_file ignore_file, base_dir, *glob_args, &block
         file_pattern = "#{source}/**/*"
         res = {}
-        Dir.glob_with_ignore_file ignore_files_pattern, source, file_pattern, File::FNM_DOTMATCH do |original_file|
+        Dir.glob_with_ignore_file(ignore_files_pattern, source, file_pattern, File::FNM_DOTMATCH).sort.each do |original_file|
           logger.debug "Processing '#{original_file}'"
           res[original_file] = destination_file(original_file, source, destination)
           if block_given?

data/lib/power_stencil/utils/file_edit.rb

@@ -25,14 +25,21 @@ module PowerStencil
       def securely_edit_entity(entity, &modifications_validation_block)
         initial_uri = entity.source_uri
         modified_entity = nil
-        Tempfile.create(["#{entity.type.to_s}_#{entity.name.to_s}", '.yaml']) do |tmpfile|
+        tmpfile = Tempfile.create(["#{entity.type.to_s}_#{entity.name.to_s}", '.yaml'])
+        tmpfile_path = tmpfile.path
+        begin
           tmpfile.puts entity.to_yaml
           tmpfile.flush
-          securely_edit_file(tmpfile, &modifications_validation_block)
-          modified_entity = UniverseCompiler::Entity::Persistence.load tmpfile
-          modified_entity.source_uri = initial_uri
+        ensure
+          tmpfile.close
         end
+        securely_edit_file(tmpfile_path, &modifications_validation_block)
+        modified_entity = UniverseCompiler::Entity::Persistence.load tmpfile_path
+        modified_entity.source_uri = initial_uri
         return modified_entity
+      ensure
+        tmpfile.close
+        File.unlink tmpfile
       end
 
       def securely_edit_file(file, &modifications_validation_block)
@@ -41,7 +48,9 @@ module PowerStencil
         end
         ext = File.extname file
         base = File.basename file, ext
-        tmp_file_path = Tempfile.new([base, ext]).path
+        tmp_file = Tempfile.create([base, ext])
+        tmp_file_path = tmp_file.path
+        tmp_file.close
         retry_count = 1
         begin
           FileUtils.copy file, tmp_file_path if retry_count == 1

data/lib/power_stencil/version.rb

@@ -1,3 +1,3 @@
 module PowerStencil
-  VERSION = '0.4.11'.freeze
+  VERSION = '0.4.16'.freeze
 end

data/power_stencil.gemspec

@@ -11,7 +11,7 @@ Gem::Specification.new do |spec|
 
   spec.summary       = %q{PowerStencil is the Swiss-army knife templating workflow for developers and ops.}
   spec.description   = %q{PowerStencil is the Swiss-army knife templating workflow for developers and ops.}
-  spec.homepage      = ''
+  spec.homepage      = 'https://powerstencil.brizone.org/'
   spec.license       = 'MIT'
 
   spec.files         = `git ls-files -z`.split("\x0").reject do |f|
@@ -33,9 +33,10 @@ Gem::Specification.new do |spec|
   source_code_uri = 'https://gitlab.com/tools4devops/power_stencil'
 
   spec.metadata = {
-      "bug_tracker_uri"       => "#{source_code_uri}/issues",
-      "documentation_uri"     => "#{source_code_uri}/blob/master/README.md",
-      "source_code_uri"       =>  source_code_uri
+      'bug_tracker_uri'       => "#{source_code_uri}/issues",
+      'documentation_uri'     => "#{source_code_uri}/blob/master/README.md",
+      'source_code_uri'       => source_code_uri,
+      'homepage_uri'          => spec.homepage
   }
 
   spec.post_install_message = %Q{
@@ -45,6 +46,7 @@ If your shell is not completing the command:
   If you use rbenv: `rbenv rehash`
   If you use zsh  : `rehash`
 
+Official Website          : #{spec.homepage}
 Full documentation here   : #{spec.metadata['source_code_uri']}/blob/master/README.md
 Feel free to report issues: #{spec.metadata['source_code_uri']}/issues
   }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: power_stencil
 version: !ruby/object:Gem::Version
-  version: 0.4.11
+  version: 0.4.16
 platform: ruby
 authors:
 - Laurent Briais
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-09-28 00:00:00.000000000 Z
+date: 2019-10-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -171,18 +171,19 @@ files:
 - etc/templates/plugin_definition/spec/spec_helper.rb
 - etc/templates/plugin_definition/spec/{entity}_spec.rb
 - etc/templates/project/.copy_ignore
-- etc/templates/project/.gitignore.erb
 - etc/templates/project/.ps_project/entities/.gitkeep
 - etc/templates/project/.ps_project/entities/README.md
 - etc/templates/project/.ps_project/entity_definitions/.gitkeep
 - etc/templates/project/.ps_project/entity_definitions/README.md
 - etc/templates/project/.ps_project/personal-config.yaml
 - etc/templates/project/.ps_project/plugins/.gitkeep
+- etc/templates/project/.ps_project/plugins/README.md
 - etc/templates/project/.ps_project/templates-templates/.gitkeep
 - etc/templates/project/.ps_project/templates-templates/README.md
 - etc/templates/project/.ps_project/user_entities/.gitkeep
 - etc/templates/project/.ps_project/user_entities/README.md
 - etc/templates/project/.ps_project/versioned-config.yaml
+- etc/templates/project/.zzzgitignore.erb
 - etc/templates/simple_exec/main.sh
 - exe/power_stencil
 - lib/power_stencil.rb
@@ -250,18 +251,20 @@ files:
 - lib/power_stencil/utils/semantic_version.rb
 - lib/power_stencil/version.rb
 - power_stencil.gemspec
-homepage: ''
+homepage: https://powerstencil.brizone.org/
 licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://gitlab.com/tools4devops/power_stencil/issues
   documentation_uri: https://gitlab.com/tools4devops/power_stencil/blob/master/README.md
   source_code_uri: https://gitlab.com/tools4devops/power_stencil
-post_install_message: "\nThank you for installing PowerStencil 0.4.11 !\nFrom the
+  homepage_uri: https://powerstencil.brizone.org/
+post_install_message: "\nThank you for installing PowerStencil 0.4.16 !\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\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  "
+  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  "
 rdoc_options: []
 require_paths:
 - lib