kameleon-builder 2.6.7 → 2.7.0

data/.bumpversion.cfg

@@ -1,7 +1,7 @@
 [bumpversion]
 commit = True
 tag = True
-current_version = 2.6.7
+current_version = 2.7.0
 parse = (?P<major>\d+)\.(?P<minor>\d+)\.(?P<patch>\d+)(\.(?P<release>[a-z]+))?
 serialize = 
 	{major}.{minor}.{patch}.{release}

data/CHANGES

@@ -1,6 +1,24 @@
 Kameleon CHANGELOG
 ==================
 
+Version 2.7.0
+-------------
+
+Released on December 09th 2015
+
+- Fixed variables overload when using inheritance
+- Added support for including global options from a separate file (#57)
+- Allowed kameleon to fail silently if some error occured during include
+- Marked all bash variables for export
+- Sorted variables in ``kameleon info`` dump
+- Removed duplicate error messages
+- Shutdown polipo cleanly (#54)
+- Added offline mode to prevent Polipo from contacting remote servers
+- Fixed polipo default options to avoid "206 partial responses" (#54)
+- Made only one checkpoint per macrostep to improve performance
+- Made polipo log file unique for each user to avoid "Permission denied" error
+- Added new keyword in ZSH completion
+
 Version 2.6.7
 -------------
 

data/RELEASING

@@ -0,0 +1,16 @@
+You can use the script ``./scripts/bumpversion.py`` which will handle
+everything (incrementation, git tag creation, changelog update).
+
+1) After each release, a new version has to be created (in this example, the 2.7.0 dev)
+
+$ python2 ./scripts/bumpversion.py newversion minor  # 2.6.7 -> 2.7.0.dev
+
+[work/commit]
+
+2) Releasing a new version
+
+$ python2 ./scripts/bumpversion.py release  # 2.7.0.dev -> 2.7.0 + git tag + changelog
+$ gem build kameleon-builder.gemspec
+$ gem push kameleon-builder-2.7.0.gem
+
+You need a rubygem account and I have to give you permissions so that you can push 

data/completion/_kameleon

@@ -147,6 +147,7 @@ _kameleon () {
           _arguments -C \
             '(--from-cache)1:Kameleon recipe path:_files' \
             '(1)--from-cache=:Persistent cache tar file to build the image:_files' \
+            '--cache-archive-compression=:Select the persistent cache compression:(gzip xz bz2)' \
             '(-b --build-path)'{-b,--build-path=}':Build directory path:_directories' \
             '--clean[Runs the command `kameleon clean` first]' \
             '--from-checkpoint=:Specify checkpoint to build the image' \
@@ -154,6 +155,8 @@ _kameleon () {
             {--checkpoints,--list-checkpoints}'[Lists all availables checkpoints]' \
             '--enable-cache[Generates a persistent cache for the appliance]' \
             '--cache-path=:Cache directory path:_directories' \
+            '--proxy=:Specifies the hostname and port number of the parent HTTP proxy define as host\:port' \
+            '--proxy-credentials=:Specifies the username and password if the parent proxy requires authorisation define as username\:password' \
             '*'{-g,--global}':Custom global variable define as key\:value' && ret=0
           ;;
         (help)

data/contrib/kameleon_exec_cmd.sh

@@ -2,6 +2,7 @@
 
 set -o errexit
 set -o pipefail
+set -o allexport
 
 __ROOT_DIRECTORY__=$(dirname $(readlink -f ${BASH_SOURCE[0]}))
 

data/lib/kameleon/cli.rb

@@ -60,7 +60,7 @@ module Kameleon
         rescue
           raise TemplateNotFound, "Template '#{template_name}' not found. " \
                                   "To see all templates, run the command "\
-                                  "`kameleon template ls`"
+                                  "`kameleon template list`"
         else
           tpl.all_files.each do |path|
             relative_path = path.relative_path_from(Kameleon.env.repositories_path)
@@ -149,7 +149,7 @@ module Kameleon
       rescue
         raise TemplateNotFound, "Template '#{template_name}' not found. " \
                                 "To see all templates, run the command "\
-                                "`kameleon templates`"
+                                "`kameleon template list`"
       else
         tpl.all_files.each do |path|
           relative_path = path.relative_path_from(Kameleon.env.repositories_path)
@@ -234,6 +234,9 @@ module Kameleon
                   :desc => "Specifies the username and password if the parent "\
                            "proxy requires authorisation it should have the "\
                            "form 'username:password'"
+    method_option :proxy_offline, :type => :boolean ,
+                  :default => false, :aliases => "--offline",
+                  :desc => "Prevents Polipo from contacting remote servers"
     method_option :global, :type => :hash,
                   :default => {}, :aliases => "-g",
                   :desc => "Set custom global variables."

data/lib/kameleon/engine.rb

@@ -46,6 +46,7 @@ module Kameleon
         @cache.polipo_path = @options[:polipo_path]
         @cache.name = @recipe.name
         @cache.mode = @options[:enable_cache] ? :build : :from
+        @cache.offline = @options[:proxy_offline]
         @cache.cache_path = @options[:from_cache]
         @cache.recipe_path = @recipe.path
         @cache.archive_format = @options[:cache_archive_compression]
@@ -184,6 +185,7 @@ module Kameleon
     def do_steps(section_name)
       section = @recipe.sections.fetch(section_name)
       section.sequence do |macrostep|
+        checkpointed = false
         macrostep_time = Time.now.to_i
         if @cache then
           Kameleon.ui.debug("Starting proxy cache server for macrostep '#{macrostep.name}'...")
@@ -209,9 +211,12 @@ module Kameleon
                 safe_exec_cmd(cmd)
               end
               unless microstep.on_checkpoint == "redo"
-                if checkpoint_enabled?
-                  Kameleon.ui.msg("--> Creating checkpoint : #{ microstep.identifier }")
-                  create_checkpoint(microstep.identifier)
+                unless checkpointed
+                  if checkpoint_enabled?
+                    Kameleon.ui.msg("--> Creating checkpoint : #{ microstep.identifier }")
+                    create_checkpoint(microstep.identifier)
+                    checkpointed = true
+                  end
                 end
               end
             end

data/lib/kameleon/persistent_cache.rb

@@ -21,6 +21,7 @@ module Kameleon
     attr_accessor :recipe_path
     attr_accessor :archive_format
     attr_accessor :polipo_cmd_options
+    attr_accessor :offline
 
     def initialize()
       ## we must configure Polipo to be execute for the in and out context
@@ -29,18 +30,15 @@ module Kameleon
       @polipo_process = nil
       @polipo_port = find_unused_port
 
-                             # :idleTime => "1",
       @polipo_cmd_options = {:diskCacheRoot => "",
                              :maxDiskCacheEntrySize => "-1",
-                             :disableIndexing => "false",
-                             :disableServersList => "false",
+                             :idleTime => "1",
                              :allowedClients => "0.0.0.0/0",
                              :proxyPort => @polipo_port,
-                             :relaxTransparency =>"true",
                              :daemonise => false,
                              :proxyAddress => "0.0.0.0",
-                             :logFile => File.join(Kameleon.env.build_path, 'polipo.log'),
-                             :logLevel => "4",
+                             :logFile => File.join(Kameleon.env.build_path, "polipo-#{ENV['USER']}.log"),
+                             :logLevel => "0xFF",
                             }
 
       @activated = false
@@ -56,6 +54,7 @@ module Kameleon
       @recipe_file = nil
       @steps_files = []
       @cached_recipe_dir = nil
+      @offline = false
     end
 
     def find_unused_port
@@ -104,13 +103,16 @@ module Kameleon
     def proxy_is_running?()
       begin
         res = Net::HTTP.get_response(URI("http://127.0.0.1:#{@polipo_port}/polipo/status"))
-        if not res.body.include? "is on line"
-          Kameleon.ui.debug("The proxy is running but not responding. Server response: #{res.inspect}")
-        else
-          Kameleon.ui.debug("The proxy is responding")
-          return true
+        if not @offline
+          if not res.body.include? "is on line"
+            Kameleon.ui.debug("The proxy is running but not responding. Server response: #{res.inspect}")
+            return false
+          else
+            Kameleon.ui.debug("The proxy is responding")
+            return true
+          end
         end
-        return false
+        return true
       rescue Exception => e
         Kameleon.ui.debug("The proxy is not responding. Server response: #{e.message}")
         return false
@@ -141,8 +143,17 @@ module Kameleon
 
 
     def stop_web_proxy
-      @polipo_process.stop
+      # http://www.pps.univ-paris-diderot.fr/~jch/software/polipo/manual/Stopping.html
       Kameleon.ui.info("Stopping web proxy polipo")
+      unless (@polipo_process.nil? || @polipo_process.exited?)
+        Process.kill("USR1", @polipo_process.pid)  # will write out all the in-memory data to disk
+        Process.kill("SIGINT", @polipo_process.pid)  # will shut down cleanly
+        begin
+          @polipo_process.poll_for_exit(10)
+        rescue ChildProcess::TimeoutError
+          @polipo_process.stop # tries increasingly harsher methods to kill the process.
+        end
+      end
     end
 
     def pack()
@@ -198,12 +209,7 @@ module Kameleon
     end
 
     def stop()
-      begin
-        @polipo_process.poll_for_exit(5)
-      rescue ChildProcess::TimeoutError
-        @polipo_process.stop # tries increasingly harsher methods to kill the process.
-      end
-      Kameleon.ui.info("Stopping web proxy polipo")
+      stop_web_proxy
       Kameleon.ui.info("Finishing persistent cache with last files")
       cache_metadata_dir = File.join(@cache_dir,"metadata")
       if @mode == :build then
@@ -260,6 +266,7 @@ module Kameleon
       FileUtils.mkdir_p File.join(@cache_dir,"recipe")
       FileUtils.mkdir_p File.join(@cache_dir,"DATA")
       FileUtils.mkdir_p File.join(@cache_dir,"metadata")
+      @polipo_cmd_options[:proxyOffline] = @offline
     end
 
     def get_recipe()

data/lib/kameleon/recipe.rb

@@ -50,6 +50,13 @@ module Kameleon
       load! :strict => false
     end
 
+    def update_steps_dirs()
+      # Where we can find steps
+      @steps_dirs = @base_recipes_files.map do |recipe_path|
+        get_steps_dirs(recipe_path)
+      end.flatten!
+    end
+
     def get_steps_dirs(recipe_path)
       relative_path = recipe_path.to_s.gsub(Kameleon.env.root_dir.to_s + '/', '')
       if relative_path.eql? recipe_path.to_s
@@ -80,6 +87,9 @@ module Kameleon
       unless yaml_recipe.kind_of? Hash
         fail RecipeError, "Invalid yaml error : #{@path}"
       end
+
+      update_steps_dirs()
+
       # Load entended recipe variables
       yaml_recipe = load_base_recipe(yaml_recipe, @path)
       yaml_recipe.delete("extend")
@@ -92,7 +102,8 @@ module Kameleon
 
       # Load Global variables
       @global.merge!(yaml_recipe.fetch("global", {}))
-      @global.merge!(@cli_global)
+      # merge cli variable with recursive variable overload
+      @global = Utils.overload_merge(@global, @cli_global)
       # Resolve dynamically-defined variables !!
       resolved_global = Utils.resolve_vars(@global.to_yaml, @path, @global, self, kwargs)
       resolved_global = @global.merge YAML.load(resolved_global)
@@ -176,6 +187,7 @@ module Kameleon
     end
 
     def load_base_recipe(yaml_recipe, path)
+
       base_recipe_name = yaml_recipe.fetch("extend", "")
       return yaml_recipe if base_recipe_name.empty?
 
@@ -186,6 +198,9 @@ module Kameleon
       ## check that the recipe has not already been loaded
       return yaml_recipe if @base_recipes_files.include? base_recipe_path
 
+      @base_recipes_files.push(Pathname.new(File.expand_path(base_recipe_path)))
+      update_steps_dirs()
+
       base_recipe_path << ".yaml" unless base_recipe_path.end_with? ".yaml"
       fail RecipeError, "Could not find this following recipe : #{@recipe_path}" \
          unless File.file? path
@@ -213,17 +228,107 @@ module Kameleon
           end
           base_yaml_recipe[key] = recipe_section
         elsif ["global"].include? key
-          base_section = base_yaml_recipe.fetch(key, {})
-          base_section = {} if base_section.nil?
-          recipe_section = yaml_recipe[key]
-          recipe_section = {} if recipe_section.nil?
-          base_yaml_recipe[key] = base_section.merge(recipe_section)
+          base_section = load_global(base_yaml_recipe, base_recipe_path)
+          recipe_section = load_global(yaml_recipe, path)
+          # manage recursive variable overload
+          base_yaml_recipe[key] = Utils.overload_merge(base_section, recipe_section)
         end
       end
-      @base_recipes_files.push(Pathname.new(File.expand_path(base_recipe_path)))
       return load_base_recipe(base_yaml_recipe, base_recipe_path)
     end
 
+    def load_global(yaml_recipe, recipe_path)
+      global = {}
+      if yaml_recipe.keys.include? "global"
+        global_loaded = yaml_recipe.fetch("global", {})
+        global_loaded = {} if global_loaded.nil?
+        if global_loaded.kind_of? Hash
+          global_loaded.each do |key, value|
+            if key.eql? "include"
+              global_to_include = load_include_global(value, recipe_path)
+              global.merge!(global_to_include)
+            else
+              global[key] = value
+            end
+          end
+        end
+      end
+      return global
+    end
+
+    def load_include_global(yaml_include, recipe_path)
+      def load_global_file(global_file, recipe_path)
+        def try_to_load(absolute_path)
+          if File.file?(absolute_path)
+            global_to_include = YAML.load_file(absolute_path)
+            if global_to_include.kind_of? Hash
+              @step_files.push(absolute_path)
+              return global_to_include
+            else
+              fail RecipeError, "Global should be a Hash. (check #{absolute_path})"
+            end
+          end
+        end
+        ## check that the recipe has not already been loaded
+        global_file << ".yaml" unless global_file.end_with? ".yaml"
+
+        dir_search = @steps_dirs.map do |steps_dir|
+          File.join(steps_dir, "global")
+        end.flatten
+        dir_search.unshift(File.join(File.dirname(recipe_path)))
+        # try relative/absolute path
+        if Pathname.new(global_file).absolute?
+          global_to_include = try_to_load(global_file)
+          unless global_to_include.nil?
+            return global_to_include
+          else
+            fail RecipeError, "File '#{global_file}' not found"
+          end
+        else
+          dir_search.each do |dir_path|
+            absolute_path = Pathname.new(File.join(dir_path, global_file))
+            global_to_include = try_to_load(absolute_path)
+            unless global_to_include.nil?
+              return global_to_include
+            end
+          end
+        end
+        rel_dir_search = dir_search.map do |steps_dir|
+          relative_path = Pathname.new(steps_dir).relative_path_from(Pathname(Dir.pwd)).to_s
+        end.flatten
+        fail RecipeError, "File '#{global_file}' not found here #{rel_dir_search}"
+      end
+
+      global_hash = {}
+      if yaml_include.kind_of? String
+        list_files = [yaml_include]
+      elsif yaml_include.kind_of? Array
+        list_files = []
+        yaml_include.each do |value|
+          if value.kind_of? String
+            list_files.push(value)
+          end
+        end
+      else
+        return global_hash
+      end
+      list_files.each do |includes_file|
+        filename = includes_file
+        if includes_file.start_with?("-")
+          filename = includes_file[1..-1]
+        end
+        begin
+          new_global = load_global_file(filename, recipe_path)
+          global_hash.merge!(new_global)
+        rescue
+          unless includes_file.start_with?("-")
+            raise
+          end
+        end
+      end
+      return global_hash
+    end
+
     def load_aliases(yaml_recipe)
       def load_aliases_file(aliases_file)
         dir_search = @steps_dirs.map do |steps_dir|
@@ -681,7 +786,8 @@ module Kameleon
         prefix ; Kameleon.ui.info("#{d}")
       end
       Kameleon.ui.info("Variables:")
-      @global.each do |key, value|
+      @global.sort.map do |key, value|
+        value = "\n" if value.to_s.empty?
         prefix ; Kameleon.ui.info("#{key}: #{value}")
       end
     end

data/lib/kameleon/utils.rb

@@ -4,7 +4,7 @@ module Kameleon
 
     def self.resolve_vars(raw, yaml_path, initial_variables, recipe, kwargs = {})
       raw = resolve_data_dir_vars(raw, yaml_path, initial_variables, recipe, kwargs)
-      return resolve_simple_vars(raw, yaml_path, initial_variables, recipe, kwargs)
+      return resolve_simple_vars(raw, yaml_path, initial_variables, kwargs)
     end
 
     def self.resolve_data_dir_vars(raw, yaml_path, initial_variables, recipe, kwargs)
@@ -12,7 +12,7 @@ module Kameleon
       matches = raw.to_enum(:scan, reg).map { Regexp.last_match }
       matches.each do |m|
         unless m.nil?
-          path = resolve_simple_vars(m[1], yaml_path, initial_variables, recipe, kwargs)
+          path = resolve_simple_vars(m[1], yaml_path, initial_variables, kwargs)
           resolved_path = recipe.resolve_data_path(path.chomp('"'), yaml_path)
           raw.gsub!(m[0].chomp('"'), "#{resolved_path}")
         end
@@ -20,8 +20,41 @@ module Kameleon
       return raw
     end
 
-    def self.resolve_simple_vars(raw, yaml_path, initial_variables, recipe, kwargs)
-      initial_variables.merge! recipe.cli_global
+    def self.resolve_simple_vars_once(raw, initial_variables)
+      raw.to_s.gsub(/\$\$\{[a-zA-Z0-9\-_]+\}|\$\$[a-zA-Z0-9\-_]+/) do |var|
+        # remove the dollars
+        if var.include? "{"
+          strip_var = var[3,(var.length - 4)]
+        else
+          strip_var = var[2,(var.length - 2)]
+        end
+        # check in local vars
+        if initial_variables.has_key? strip_var
+          value = initial_variables[strip_var]
+        end
+        return $` + value.to_s + $'
+      end
+    end
+
+
+    # Variables are replaced correctly for recursive variable overload of
+    # the parent by the child:
+    # For example:
+    #   Parent={var: 10}
+    #   Child={var: $$var 11}
+    #   => {var: 10 11}
+    def self.overload_merge(parent_dict, child_dict)
+      parent_dict.merge(child_dict){ |key, old_value, new_value|
+        if new_value.to_s.include?("$$" + key.to_s) or new_value.to_s.include?("$${" + key.to_s + "}")
+          Utils.resolve_simple_vars_once(new_value, {key => old_value})
+        else
+          new_value
+        end
+      }
+    end
+
+
+    def self.resolve_simple_vars(raw, yaml_path, initial_variables, kwargs)
       raw.to_s.gsub(/\$\$\{[a-zA-Z0-9\-_]+\}|\$\$[a-zA-Z0-9\-_]+/) do |var|
         # remove the dollars
         if var.include? "{"
@@ -37,7 +70,7 @@ module Kameleon
             fail RecipeError, "#{yaml_path}: variable #{var} not found in local or global"
           end
         end
-        return $` + resolve_simple_vars(value.to_s + $', yaml_path, initial_variables, recipe, kwargs)
+        return $` + resolve_simple_vars(value.to_s + $', yaml_path, initial_variables, kwargs)
       end
     end
 

data/tests/recipes/test_recipe.yaml

@@ -16,6 +16,9 @@ global:
   user_name: kameleon
   user_password: $$user_name
 
+  # test overload
+  toto: $$toto tata
+
   # Distribution
   distrib: linux
 

data/tests/test2/test2.yaml

@@ -1,2 +1,3 @@
+extend: ./test3.yaml
 global:
-  toto: tata
+  toto: $$toto test $$user_name

data/tests/test2/test3.yaml

@@ -0,0 +1,2 @@
+global:
+  toto: titi

data/version.txt

@@ -1 +1 @@
-2.6.7
+2.7.0

metadata

@@ -1,7 +1,8 @@
 --- !ruby/object:Gem::Specification
 name: kameleon-builder
 version: !ruby/object:Gem::Version
-  version: 2.6.7
+  version: 2.7.0
+  prerelease: 
 platform: ruby
 authors:
 - Salem Harrache
@@ -12,60 +13,66 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-10-01 00:00:00.000000000 Z
+date: 2015-12-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: childprocess
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 0.5.3
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: 0.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 0.5.3
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: 0.3.0
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '0.19'
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: 0.15.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '0.19'
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: 0.15.0
 - !ruby/object:Gem::Dependency
   name: table_print
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 1.5.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 1.5.2
 description: The mindful appliance builder
@@ -80,15 +87,16 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- ".bumpversion.cfg"
-- ".editorconfig"
-- ".env"
-- ".gitignore"
+- .bumpversion.cfg
+- .editorconfig
+- .env
+- .gitignore
 - AUTHORS
 - CHANGES
 - COPYING
 - Gemfile
 - README.rst
+- RELEASING
 - Vagrantfile
 - bin/kameleon
 - completion/_kameleon
@@ -156,6 +164,7 @@ files:
 - tests/recipes/steps/setup/linux/software_install.yaml
 - tests/recipes/test_recipe.yaml
 - tests/test2/test2.yaml
+- tests/test2/test3.yaml
 - tests/test_context.rb
 - tests/test_recipe.rb
 - tests/test_version.rb
@@ -163,27 +172,28 @@ files:
 homepage: http://kameleon.imag.fr/
 licenses:
 - GPL-2
-metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
-  - - ">="
+  - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
-  - - ">="
+  - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements:
 - polipo 1.0.3, or greater
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 1.8.23.2
 signing_key: 
-specification_version: 4
+specification_version: 3
 summary: Kameleon is a tool to build virtual machines from scratch
 test_files:
 - tests/helper.rb
@@ -195,6 +205,7 @@ test_files:
 - tests/recipes/steps/setup/linux/software_install.yaml
 - tests/recipes/test_recipe.yaml
 - tests/test2/test2.yaml
+- tests/test2/test3.yaml
 - tests/test_context.rb
 - tests/test_recipe.rb
 - tests/test_version.rb

checksums.yaml

@@ -1,7 +0,0 @@
----
-SHA1:
-  metadata.gz: 41ec4253d5c8e1212274257dd0ef731fd911680c
-  data.tar.gz: 9f6a9adf0e0764e352d2968ade87478d8c9c82a5
-SHA512:
-  metadata.gz: ecd9d831258ff4d46e034e740221c4dc3cf5a10b8e66e711bec447b9fbc417f3519b019e930d503ee2d9791ec5b2d14c412b357bf41cee617e3a7f52009c733b
-  data.tar.gz: 31575ddef96d63072c0d2d4a8ab391a989eaf871a2fce7e7d5bc89babe03febfb1059330fe5b6221bd94fd71c3952ff15ccec5a5e05bfa122d24edff3a2bce4c