Mxx_ru 1.1.0

data/lib/mxx_ru/cpp/toolsets/vc_family.rb

@@ -0,0 +1,428 @@
+#--
+# 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
+    module Toolsets
+
+      # Toolset implemetation for Visual C++
+      class Vc_family < Mxx_ru::Cpp::Toolset
+      public
+        def initialize( a_name )
+          super( a_name )
+
+          setup_tag( "host_os", "mswin" )
+          setup_tag( "target_os", "mswin" )
+        end
+
+        # Returns compiler name.
+        def compiler_name
+          return "cl"
+        end
+
+        # Returns linker name.
+        def linker_name
+          return "link"
+        end
+
+        # Returns librarian name.
+        def librarian_name
+          return "lib"
+        end
+
+        # Returns resource compiler name.
+        def rc_name
+          return "rc"
+        end
+
+        # See description at Mxx_ru::Cpp::Toolset#setup_mandatory_options.
+        def setup_mandatory_options( target )
+
+          target.compiler_option( "-nologo" )
+          target.linker_option( "/NOLOGO" )
+          target.librarian_option( "/NOLOGO" )
+          target.cpp_compiler_option( "-EHsc" )
+
+          if RUNTIME_DEBUG == target.mxx_runtime_mode
+            target.compiler_option( "-Zi" )
+            target.linker_option( "/DEBUG" )
+            setup_vc_specific_debug_options( target )
+          elsif RUNTIME_RELEASE == target.mxx_runtime_mode
+            target.define( "NDEBUG" )
+            if OPTIM_SIZE == target.mxx_optimization
+              target.compiler_option( "-O1" )
+            else
+              target.compiler_option( "-O2" )
+            end
+          end
+
+          if RTTI_ENABLED == target.mxx_rtti_mode
+            target.cpp_compiler_option( "-GR" )
+          end
+
+          if RTL_SHARED == target.mxx_rtl_mode
+            if THREADING_SINGLE == target.mxx_threading_mode
+              raise Mxx_ru::Unsupported_mode_ex.new(
+                "Visual C++ not support single-threaded shared RTL" )
+            else
+              if RUNTIME_DEBUG == target.mxx_runtime_mode
+                target.compiler_option( "-MDd" )
+              else
+                target.compiler_option( "-MD" )
+              end
+            end
+          else
+            if THREADING_MULTI == target.mxx_threading_mode
+              if RUNTIME_DEBUG == target.mxx_runtime_mode
+                target.compiler_option( "-MTd" )
+              else
+                target.compiler_option( "-MT" )
+              end
+            else
+              if RUNTIME_DEBUG == target.mxx_runtime_mode
+                target.compiler_option( "-MLd" )
+              else
+                target.compiler_option( "-ML" )
+              end
+            end
+          end
+
+          if target.target_type.name == Dll_target_type::TYPE
+            target.compiler_option( "-LD" )
+          end
+
+          if SCREEN_WINDOW == target.mxx_screen_mode
+            target.linker_option( "/SUBSYSTEM:WINDOWS" )
+          else
+            target.linker_option( "/SUBSYSTEM:CONSOLE" )
+          end
+
+          # All defines and all include_path should be applied
+          # to resource compiler too.
+          target.mxx_all_defines.each { |d|
+            target.compiler_option( "-D" + d )
+            target.mswin_rc_option( "/d" + d )
+          }
+
+          target.mxx_all_include_paths.each { |p|
+            target.compiler_option( "-I" + p )
+            target.mswin_rc_option( "/i" + p )
+          }
+
+          # Resource compiler specific options.
+          target.mxx_all_mswin_rc_defines.each { |d|
+            target.mswin_rc_option( "/d" + d )
+          }
+          target.mxx_all_mswin_rc_include_paths.each { |p|
+            target.mswin_rc_option( "/i" + p )
+          }
+
+        end
+
+        # Common description see Mxx_ru::Cpp::Toolset#clean_lib_specific_files.
+        #
+        # Removes VC specific garbage files.
+        def clean_lib_specific_files(
+          a_lib_file,
+          a_lib_info,
+          a_target )
+
+          clean_vc_specific_garbage( a_lib_file )
+        end
+
+        # See description at Mxx_ru::Cpp::Toolset#clean_dll_specific_files.
+        #
+        # Removes import library if exists.
+        #
+        # Removes *.ilk, *.pdb files.
+        def clean_dll_specific_files(
+          a_dll_file,
+          a_dll_info,
+          a_target )
+
+          # Remove import library if exists.
+          if nil != a_dll_info.link_name
+            implib_name = File.join( [ a_dll_info.link_path, a_dll_info.link_name ] )
+            Mxx_ru::Util::delete_file( implib_name )
+
+            # *.exp files are also created by Visual C++.
+            explib_name =
+              Mxx_ru::Util::change_file_ext( implib_name, ".exp" )
+            Mxx_ru::Util::delete_file( explib_name )
+          end
+
+          clean_vc_specific_garbage( a_dll_file )
+        end
+
+        # See description at Mxx_ru::Cpp::Toolset#clean_exe_specific_files.
+        #
+        # Removing *.ilk, *.pdb files.
+        def clean_exe_specific_files(
+          a_exe_file,
+          a_exe_info,
+          a_target )
+
+          clean_vc_specific_garbage( a_exe_file )
+        end
+
+        # See description at Mxx_ru::Cpp::Toolset#obj_file_ext.
+        def obj_file_ext
+          return ".obj"
+        end
+
+        # See description at Mxx_ru::Cpp::Toolset#make_c_obj_command_lines.
+        def make_c_obj_command_lines(
+          obj_name,
+          source_name,
+          compiler_options,
+          target )
+
+          tmpfile = Mxx_ru::Util::Tmp_files.instance.create(
+            "-c -TC -Fo#{obj_name} " +
+            "#{compiler_options.join(' ')} #{source_name}" )
+
+          return [ "#{compiler_name} @#{tmpfile}" ]
+        end
+
+        # See description at Mxx_ru::Cpp::Toolset#make_c_obj_command_lines.
+        def make_cpp_obj_command_lines(
+          obj_name,
+          source_name,
+          compiler_options,
+          target )
+
+          tmpfile = Mxx_ru::Util::Tmp_files.instance.create(
+            "-c -TP -Fo#{obj_name} " +
+            "#{compiler_options.join(' ')} #{source_name}" )
+
+          return [ "#{compiler_name} @#{tmpfile}" ]
+        end
+
+        # See description at Mxx_ru::Cpp::Toolset#mswin_res_file_name.
+        def mswin_res_file_name( source_name )
+          return source_name + ".res"
+        end
+
+        # See description at Mxx_ru::Cpp::Toolset#make_mswin_res_command_lines.
+        def make_mswin_res_command_lines(
+          res_name,
+          rc_file,
+          rc_options,
+          target )
+
+          return [ "#{rc_name} " +
+            "#{rc_options.join(' ')} /r " +
+            "/fo#{res_name} #{rc_file}" ]
+        end
+
+        # See description at Mxx_ru::Cpp::Toolset#lib_file_name.
+        def lib_file_name( source_name )
+          return source_name + ".lib"
+        end
+
+        # See description at Mxx_ru::Cpp::Toolset#lib_link_name.
+        def lib_link_name( source_name )
+          return lib_file_name( source_name )
+        end
+
+        # See description at Mxx_ru::Cpp::Toolset#make_lib_command_lines.
+        def make_lib_command_lines(
+          lib_name,
+          obj_files,
+          librarian_options,
+          target )
+
+          tmpfile = Mxx_ru::Util::Tmp_files.instance.create(
+            "#{librarian_options.join(' ')} " +
+            "/OUT:#{lib_name} #{obj_files.join(' ')}" )
+
+          return [ "#{librarian_name} @#{tmpfile}" ]
+        end
+
+        # See description at Mxx_ru::Cpp::Toolset#dll_file_name.
+        def dll_file_name( source_name )
+          return source_name + ".dll"
+        end
+
+        # See description at Mxx_ru::Cpp::Toolset#implib_link_name.
+        def implib_link_name(
+          dll_real_name,
+          target )
+
+          # Import library should be defined explicitly for Visual C++.
+          if nil != target.mxx_implib_path
+            return lib_file_name( target.mxx_target_name )
+          end
+
+          return nil
+        end
+
+        # See description at Mxx_ru::Cpp::Toolset#implib_link_path.
+        #
+        # Returns a value, based on
+        # Mxx_ru::Cpp::Target#mxx_implib_path.
+        def implib_link_path(
+          dll_real_name,
+          dll_real_path,
+          target )
+          return target.mxx_obj_placement.get_lib(
+            target.mxx_implib_path, self, target )
+        end
+
+        # See description at Mxx_ru::Cpp::Toolset#make_dll_command_lines.
+        def make_dll_command_lines(
+          a_dll_name,
+          a_dll_info,
+          a_linker_lists,
+          a_target )
+
+          result = "/DLL " +
+            "#{a_linker_lists.linker_options.join(' ')} " +
+            "/OUT:#{a_dll_name} "
+
+          if a_linker_lists.resources.size
+            result << "#{a_target.mxx_all_mswin_rlink_options.join(' ')} "
+          end
+
+          if nil != a_dll_info.link_name
+            implib_name = File.join( [ a_dll_info.link_path,
+              a_dll_info.link_name ] )
+            result << "/IMPLIB:#{implib_name} "
+          end
+
+          a_linker_lists.lib_paths.each { |p| result << "/LIBPATH:#{p} " }
+
+          result << "#{a_linker_lists.objs.join(' ')} "
+          result << "#{a_linker_lists.libs.join(' ')} "
+          result << "#{a_linker_lists.resources.join(' ')} "
+
+          tmpfile = Mxx_ru::Util::Tmp_files.instance.create( result )
+
+          return [ "#{linker_name} @#{tmpfile}" ]
+        end
+
+        # See description at Mxx_ru::Cpp::Toolset#make_dll_requirements.
+        def make_dll_requirements(
+          a_dll_name,
+          a_dll_info,
+          a_linker_lists,
+          a_target )
+
+          result = Dll_requirements.new
+
+          # Dependencies are exists only if import library is present.
+          if nil != a_dll_info.link_name
+            result.add_libs( [ a_dll_info.link_name ] )
+            result.add_lib_paths( [ a_dll_info.link_path ] )
+          end
+
+          return result
+        end
+
+        # See description at Mxx_ru::Cpp::Toolset#exe_file_name.
+        def exe_file_name( source_name )
+          return source_name + ".exe"
+        end
+
+        # See description at Mxx_ru::Cpp::Toolset#make_exe_command_lines.
+        def make_exe_command_lines(
+          a_exe_name,
+          a_exe_info,
+          a_linker_lists,
+          a_target )
+
+          result = "#{a_linker_lists.linker_options.join(' ')} " +
+            "/OUT:#{a_exe_name} "
+
+          if a_linker_lists.resources.size
+            result << "#{a_target.mxx_all_mswin_rlink_options.join(' ')} "
+          end
+
+          a_linker_lists.lib_paths.each { |p| result << "/LIBPATH:#{p} " }
+
+          result << "#{a_linker_lists.objs.join(' ')} "
+          result << "#{a_linker_lists.libs.join(' ')} "
+          result << "#{a_linker_lists.resources.join(' ')} "
+
+          tmpfile = Mxx_ru::Util::Tmp_files.instance.create( result )
+
+          return [ "#{linker_name} @#{tmpfile}" ]
+        end
+
+        # Setting up VC specific options for managing PDB files.
+        #
+        # Adding '/Fd<full-target-name>.pdb' option for compiler.
+        # Adding '/PDB:<full-target-name>.pdb' option for linker (in case
+        # of EXE or DLL).
+        def setup_vc_specific_debug_options( target )
+          full_name =
+            case target.target_type.name
+              when Exe_target_type::TYPE:
+                make_exe_name( target.mxx_target_name, target ).full_name
+              when Dll_target_type::TYPE:
+                make_dll_name( target.mxx_target_name, target ).full_name
+              when Lib_target_type::TYPE:
+                make_lib_name( target.mxx_target_name, target ).full_name
+              else nil
+            end
+          if full_name
+            pdb_file = Mxx_ru::Util::change_file_ext( full_name, ".pdb" )
+            target.compiler_option( "/Fd#{pdb_file}" )
+            target.linker_option( "/PDB:#{pdb_file}" )
+          end
+        end
+
+        # Remove VC specific garbage.
+        #
+        # In DEBUG mode: *.ilk, *.pdb files.
+        # If something exported from executable: *.exp, *.lib (only if
+        # *.exp file exists).
+        def clean_vc_specific_garbage( full_name )
+          Mxx_ru::Util::delete_file(
+            Mxx_ru::Util::change_file_ext( full_name, ".ilk" ) )
+          Mxx_ru::Util::delete_file(
+            Mxx_ru::Util::change_file_ext( full_name, ".pdb" ) )
+
+          exp_file_name = Mxx_ru::Util::change_file_ext( full_name, ".exp" )
+          if File.exists?( exp_file_name )
+            Mxx_ru::Util::delete_file( exp_file_name )
+            # Import library for this export-file must be removed too.
+            Mxx_ru::Util::delete_file(
+              Mxx_ru::Util::change_file_ext( full_name, ".lib" ) )
+          end
+        end
+
+      end # class Vc_family
+
+    end # module Toolsets
+
+  end # module Cpp
+
+end # module Mxx_ru

data/lib/mxx_ru/cpp.rb

@@ -0,0 +1,36 @@
+#--
+# 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/abstract_target'
+require 'mxx_ru/binary_target'
+require 'mxx_ru/cpp/detect_toolset'
+require 'mxx_ru/cpp/target'
+require 'mxx_ru/cpp/composite'
+
+# Determining which toolset should be used.
+Mxx_ru::Cpp::detect_toolset

data/lib/mxx_ru/ex.rb

@@ -0,0 +1,134 @@
+#--
+# 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.
+#++
+
+module  Mxx_ru
+
+  # Base class for all exceptions.
+  class Ex < Exception
+  end
+
+  # Exception, thrown on execution of 'pure abstract method'.
+  class Abstract_method_ex < Ex
+    def initialize( method_name )
+      super( "Pure virtual method call: " + method_name )
+    end
+  end
+
+  # Exception, thrown if returned object type is not expected.
+  class Invalid_cast_ex < Ex
+    def initialize( msg )
+      super( msg )
+    end
+  end
+
+  # Exception, thrown if build commands fail.
+  class Build_ex < Ex
+    def initialize( cmd_line, desc )
+      super( "Build error: '#{cmd_line}' returns '#{desc}'" )
+    end
+  end
+
+  # Exception, thrown if unknown target type is detected.
+  class Unsupported_target_type_ex < Ex
+    def initialize( target_class, target_type )
+      super( "Unsupported target type '#{target_type}'" +
+        " in '#{target_class}'" )
+    end
+  end
+
+  # Exception, thrown if no target object is found for given alias.
+  class Target_unknown_ex < Ex
+    def initialize( target_name )
+      super( "Target unknown for: " + target_name )
+    end
+  end
+
+  # Exception, thrown if value conflict for global options such as 
+  # runtime_mode, rtl_mode, etc is detected
+  class Global_option_conflict_ex < Ex
+    # [_a_name_] Option name.
+    # [_a_current_] Current option value.
+    # [_a_current_owner_] Who was set current value.
+    # [_a_new_] New option value.
+    # [_a_new_owner_] Who tries to set current value.
+    def initialize(
+      a_name,
+      a_current,
+      a_current_owner,
+      a_new,
+      a_new_owner )
+
+      super( "Global option '#{a_name}' conflict detected! " +
+        "Current value '#{a_current}' set by '#{a_current_owner}'. " +
+        "New value '#{a_new}' required by '#{a_new_owner}'" )
+    end
+  end
+
+  # Exception, thrown if anyone tries to set invalid value to global options such as
+  # runtime_mode, rtl_mode, etc.
+  class Global_option_disallowed_value_ex < Ex
+    # [_a_name_] Option name.
+    # [_a_available_values_] Available values list. Should be Array of String.
+    # [_a_new_] New option value.
+    # [_a_new_owner_] Who tries to set new value.
+    def initialize(
+      a_name,
+      a_available_values,
+      a_new,
+      a_new_owner )
+
+      super( "Value '#{new}' required by '#{a_new_owner}' " +
+        "disallowed for global option '#{a_name}'! " +
+        "Allowed values are: #{a_available_values.join(' ')}" )
+    end
+  end
+
+  # Exception, thrown if some mode is not supported by the toolset.
+  class Unsupported_mode_ex < Ex
+    def initialize( msg )
+      super( msg )
+    end
+  end
+
+  # Exception, thrown if some dependency file is missing.
+  class Missing_depend_file_ex < Ex
+    def initialize( missing_file, depend_for )
+      super( "File '#{missing_file}' required by '#{depend_for}' " +
+        "missing" )
+    end
+  end
+
+  # Exception, thrown if some value is invalid in current context.
+  class Invalid_value_ex < Ex
+    def initialize( msg )
+      super( msg )
+    end
+  end
+
+end
+