Mxx_ru 1.1.0

data/lib/mxx_ru/cpp/analyzer.rb

@@ -0,0 +1,230 @@
+#--
+# Copyright (c) 1996-2004, Yauheni Akhotnikau
+# Copyright (c) 2004-2006, JSC Intervale
+# Copyright (c) 2006, The Mxx_ru Project
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without modification,
+# are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+# 3. The name of the author may not be used to endorse or promote products derived
+#    from this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
+# WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
+# AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#++
+
+require 'singleton'
+
+module  Mxx_ru
+  module  Cpp
+
+    module  Analyzer
+      # Class, describing one source file.
+      class Source_file
+        # Already processed file sign.
+        attr_reader :is_processed
+        # A set of files-dependecies.
+        # Hash, key is a String, no value.
+        attr_reader :depends
+
+        def initialize
+          @is_processed = false
+          @depends = Hash.new
+        end
+
+        # Set processed file sign.
+        def processed
+          @is_processed = true
+        end
+
+        # Add a dependency.
+        def <<( a_name )
+          @depends[ a_name ]= nil
+        end
+
+      end # class Source_file
+
+      class Cpp_analyzer
+        include Singleton
+
+        @@include_regex = Regexp.new(
+          '^[ \t]*#[ \t]*include[ \t]*(<|")([^>"]+)(>|")' )
+
+        def initialize
+          # Key is a string, value - Source_file.
+          @sources = Hash.new
+          # A list of folders to look header files in.
+          @include_paths = Array.new
+        end
+
+        # Add files to view.
+        # [_a_sources_] Should be Array of Strings.
+        def add_sources( a_sources )
+
+          a_sources.each { |s|
+              if !@sources.key?( s )
+                @sources[ s ] = Source_file.new
+              end
+            }
+        end
+
+        # Add paths to header files.
+        # [_a_paths_] Should be Array of Strings.
+        def add_include_paths( a_paths )
+
+          a_paths.each { |p|
+              if !@include_paths.include?( p )
+                @include_paths << p
+              end
+            }
+        end
+
+        # Perform file analisys.
+        def analyze
+          # Current list of keys should be taken to avoid 
+          # dynamic growth of file list.
+          # Repeat iterations until source file list changes stop
+          old_size = 0
+          files = @sources.keys
+          while old_size != files.size
+            files.each { |file_name|
+                current = @sources[ file_name ]
+                if !current.is_processed
+                  process_file( file_name, current )
+                end
+              }
+
+            old_size = files.size
+            files = @sources.keys
+          end
+        end
+
+        # Get full dependencies list for a file.
+        # Returns Array of Strings.
+        def get_depends_for( a_file_name )
+          result_hash = Hash.new
+          file_obj = @sources[ a_file_name ]
+          if nil != file_obj
+            to_review = file_obj.depends
+            to_review_next = Hash.new
+
+            while to_review.size != to_review_next.size
+              to_review.each_key { |f|
+                  if !result_hash.key?( f )
+                    result_hash[ f ] = nil
+                    to_review_next_obj = @sources[ f ]
+                    to_review_next_obj.depends.each_key { |k|
+                        to_review_next[ k ] = nil }
+                  end
+                }
+
+              to_review = to_review_next
+              to_review_next = Hash.new
+            end
+          end
+
+          return result_hash.keys
+        end
+
+      protected
+        # Process next file.
+        # [_a_file_name_] File name.
+        # [_a_file_obj_] Corresponding object.
+        def process_file( a_file_name, a_file_obj )
+
+          # Gather file names list from include directives.
+          std_path_included = Array.new
+          local_path_included = Array.new
+          IO.foreach( a_file_name ) { |line|
+              r = @@include_regex.match( line )
+              if nil != r
+                if "<" == r[ 1 ]
+                  std_path_included << r[ 2 ]
+                else
+                  local_path_included << r[ 2 ]
+                end
+              end
+            }
+
+          # All files, loaded through include <>
+          # should be searched in standard search paths only.
+          std_path_included.each { |f|
+              process_std_include_path_file( f, a_file_obj )
+            }
+
+          if local_path_included.size
+            # Files loaded through include ""
+            # should be searched in folder with the source file first.
+            local_path = File.dirname( a_file_name )
+            local_path_included.each { |f|
+                process_local_include_path_file( f, local_path, a_file_obj )
+              }
+          end
+
+          a_file_obj.processed
+        end
+
+        # Processing file loaded through include <>
+        # [_a_file_name_] File name.
+        # [_a_owner_obj_] File object contained include directive.
+        def process_std_include_path_file( a_file_name, a_owner_obj )
+
+          @include_paths.find { |path|
+              test_name = File.join( [ path, a_file_name ] )
+              if File.exists?( test_name )
+                add_depend_to( a_owner_obj, test_name )
+                true
+              else
+                false
+              end
+            }
+        end
+
+        # Processing file loaded through include ""
+        # [_a_file_name_] File name.
+        # [_a_local_path_] Folder with owner_obj.
+        # [_a_owner_obj_] File object contained include directive.
+        def process_local_include_path_file(
+          a_file_name,
+          a_local_path,
+          a_owner_obj )
+
+          test_name = File.join( [ a_local_path, a_file_name ] )
+          if File.exists?( test_name )
+            add_depend_to( a_owner_obj, test_name )
+          else
+            process_std_include_path_file( a_file_name, a_owner_obj )
+          end
+        end
+
+        # Add dependency to a file.
+        # [_a_owner_obj_] Dependency owner.
+        # [_a_depend_name_] Dependency file name.
+        def add_depend_to( a_owner_obj, a_depend_name )
+
+          a_owner_obj << a_depend_name
+
+          if !@sources.key?( a_depend_name )
+            # This file wasn't viewed yet.
+            @sources[ a_depend_name ] = Source_file.new
+          end
+        end
+      end # class Cpp_analyzer
+
+    end # module Analyzer
+  end # module cpp
+end # module Mxx_ru
+

data/lib/mxx_ru/cpp/composite.rb

@@ -0,0 +1,106 @@
+#--
+# Copyright (c) 1996-2004, Yauheni Akhotnikau
+# Copyright (c) 2004-2006, JSC Intervale
+# Copyright (c) 2006, The Mxx_ru Project
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without modification,
+# are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+# 3. The name of the author may not be used to endorse or promote products derived
+#    from this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
+# WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
+# AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#++
+
+require 'mxx_ru/cpp/target'
+
+module  Mxx_ru
+
+  module Cpp
+
+    # Target type is a composition of subprojects
+    class Composite_target_type < Target_type
+      TYPE = "composite"
+
+      def name
+        return TYPE
+      end
+    end
+
+    # Composition of subprojects target
+    class Composite_target < Target
+      def initialize( a_alias, &block )
+        super( a_alias )
+
+        instance_eval( &block ) if block
+      end
+
+      def target_type
+        return Composite_target_type.new
+      end
+
+      def build
+        if nil == @mxx_last_build_result
+
+          if !@mxx_all_options_defined
+            # It's required for toolset to define all required options
+            # taking all current modes into account.
+            Mxx_ru::Cpp::toolset.setup_mandatory_options( self )
+            @mxx_all_options_defined = true
+          end
+
+          @mxx_last_build_result = build_required_projects
+        end
+
+        return @mxx_last_build_result
+
+      end
+
+      def clean
+        if nil == @mxx_last_build_result
+
+          if !@mxx_all_options_defined
+            # It's required for toolset to define all required options
+            # taking all current modes into account.
+            Mxx_ru::Cpp::toolset.setup_mandatory_options( self )
+            @mxx_all_options_defined = true
+          end
+
+          clean_required_prjs
+
+          @mxx_last_build_result = Mxx_ru::Target_state.new(
+            Mxx_ru::Target_state::ABSENT )
+        end
+      end
+
+    end # class Composite_target
+
+    # Simple method to define composite target.
+    #
+    # Example:
+    #   Mxx_ru::Cpp::composite_target( Mxx_ru::BUILD_ROOT ) {
+    #     required_prj 'some_project.rb'
+    #     required_prj 'some_another_project.rb'
+    #   }
+    def Cpp.composite_target( prj_alias, &block )
+      Mxx_ru::setup_target Composite_target.new( prj_alias, &block )
+    end
+
+  end # module Cpp
+
+end # module Mxx_ru
+

data/lib/mxx_ru/cpp/detect_toolset.rb

@@ -0,0 +1,122 @@
+#--
+# Copyright (c) 1996-2004, Yauheni Akhotnikau
+# Copyright (c) 2004-2006, JSC Intervale
+# Copyright (c) 2006, The Mxx_ru Project
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without modification,
+# are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+# 3. The name of the author may not be used to endorse or promote products derived
+#    from this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
+# WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
+# AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#++
+
+require 'mxx_ru/cpp/toolset'
+
+module Mxx_ru
+  module Cpp
+
+    # Detect current toolset based on values of environment variables
+    #
+    # Following algorithm is used:
+    # Getting the value of MXX_RU_CPP_TOOLSET envonment variable.
+    # It should be in a following format:
+    #  <file> [tag=value [tag=value [...]]
+    # <file> value is used in require directive.
+    #
+    # After loading of file defined, toolset method should return
+    # a pointer to toolset object.
+    #
+    # If toolset object was created, pairs of tag=value are parsed and
+    # saved to the toolset created using a setup_tag method.
+    def Cpp.detect_toolset
+      begin
+        env_var = "MXX_RU_CPP_TOOLSET"
+
+        env = ENV[ env_var ]
+        if nil == env
+          raise Mxx_ru::Invalid_value_ex.new(
+            "Environment variable '#{env_var}' not found (not set " +
+            "or empty" )
+        end
+
+        # Exctracting file name, responsible for toolset object creation.
+        toolset_file_name_regexp = /^(\S+)(.*)$/
+        file_name_match = toolset_file_name_regexp.match( env )
+        if nil == file_name_match
+          raise Mxx_ru::Invalid_value_ex.new(
+            "Invalid format of environment variable '#{env_var}'. " +
+            "Expected format: #{env_var}=<file>[ <tag>=<value>[ " +
+            "<tag>=<value>[ ...]]]" )
+        end
+
+        file_name = file_name_match[ 1 ]
+        unparsed_tags = file_name_match[ 2 ]
+
+        # Loading the file
+        # Try to loading specified file first, if it fails try to
+        # loading file with 'mxx_ru/cpp/toolsets' added...
+        try_load_toolset_file file_name
+
+        if nil == toolset()
+          raise Mxx_ru::Invalid_value_ex.new(
+            "C/C++ Toolset is not set by file '#{file_name}'" )
+        end
+
+        # Setting up toolset tags
+        setup_toolset_tags( toolset(), unparsed_tags )
+
+      rescue Mxx_ru::Ex => ex
+        $stderr.print "<<<[#{ex.class.name}]\t#{ex}>>>\n"
+        exit( -1 )
+      end
+    end
+
+    # [_a_toolset_] Toolset, tags are set for
+    # [_a_unparsed_tags_] A string, formatted that way:
+    #                     <tag>=<value>[ <tag>=<value> [<tag>=<value> ...]]
+    def Cpp.setup_toolset_tags( a_toolset,
+      a_unparsed_tags )
+
+      a_unparsed_tags.scan( /(\S+)=(\S+)/ ) { |t, v|
+        a_toolset.setup_tag( t, v )
+      }
+
+    end
+
+    # Try load toolset file (without and with 'mxx_ru/cpp/toolsets' prefix).
+    #
+    # Raises LoadError if loading failed
+    def Cpp.try_load_toolset_file( file_name )
+      files_to_load = [ file_name,
+          File.join( 'mxx_ru/cpp/toolsets', file_name ) ]
+      load_result = files_to_load.detect { |file_to_load|
+          begin
+            require file_to_load
+          rescue LoadError
+            false
+          end
+        }
+      raise Mxx_ru::Invalid_value_ex.new(
+        "Unable to load Toolset from files: " +
+          "'#{files_to_load.join('; ')}'" ) unless load_result
+    end
+
+  end # module Cpp
+end # module Mxx_ru
+

data/lib/mxx_ru/cpp/mode.rb

@@ -0,0 +1,85 @@
+#--
+# Copyright (c) 1996-2004, Yauheni Akhotnikau
+# Copyright (c) 2004-2006, JSC Intervale
+# Copyright (c) 2006, The Mxx_ru Project
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without modification,
+# are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+# 3. The name of the author may not be used to endorse or promote products derived
+#    from this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
+# WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
+# AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#++
+
+require 'singleton'
+
+module  Mxx_ru
+module  Cpp
+
+  # Arguments passed into Ruby interpreter, intended to control Mxx_ru::Cpp.
+  MXXCPPARG_RELEASE = "--mxx-cpp-release"
+  MXXCPPARG_DEBUG = "--mxx-cpp-debug"
+  MXXCPPARG_ONLY_ONE = "--mxx-cpp-1"
+  MXXCPPARG_NO_DEPENDS_ANALYZER = "--mxx-cpp-no-depends-analyzer"
+
+  # Class, detecting a mode of Mxx_ru::Cpp is running
+  class Mode
+    include Singleton
+
+    attr_reader :is_release
+    attr_reader :is_debug
+    attr_reader :is_only_one
+    attr_reader :is_no_depends_analyzer
+
+    # Constructor checks for a special arguments in a command line
+    def initialize
+      @is_release = ARGV.include?( MXXCPPARG_RELEASE )
+      @is_debug = ARGV.include?( MXXCPPARG_DEBUG )
+      @is_only_one = ARGV.include?( MXXCPPARG_ONLY_ONE )
+      @is_no_depends_analyzer = ARGV.include?( MXXCPPARG_NO_DEPENDS_ANALYZER )
+      @manual_dry_run_counter = 0
+    end
+
+    # It should be executed before build/clean of subprojects.
+    # If is_only_one option is set and manual_dry_run_counter is equal to 0,
+    # manual dry_run mode is activated.
+    def before_subprj_processing
+      if is_only_one
+        if 0 == @manual_dry_run_counter
+          Mxx_ru::Util::Mode.instance.manual_dry_run( true )
+        end
+        @manual_dry_run_counter += 1
+      end
+    end
+
+    # It should be executed after build/clean of subprojects.
+    # If is_only_one option is set and manual_dry_run_counter is equal to 0,
+    # manual dry_run mode is activated.
+    def after_subprj_processing
+      if is_only_one
+        @manual_dry_run_counter -= 1
+        if 0 == @manual_dry_run_counter
+          Mxx_ru::Util::Mode.instance.manual_dry_run( false )
+        end
+      end
+    end
+
+  end
+
+end # module Cpp
+end # module Mxx_ru