UseSWIG.cmake 12.2 KB
Newer Older
1 2 3 4
#.rst:
# UseSWIG
# -------
#
5
# Defines the following macros for use with SWIG:
6 7 8 9 10 11 12 13
#
# ::
#
#    SWIG_ADD_MODULE(name language [ files ])
#      - Define swig module with given name and specified language
#    SWIG_LINK_LIBRARIES(name [ libraries ])
#      - Link libraries to swig module
#
14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45
# Source files properties on module files can be set before the invocation
# of the SWIG_ADD_MODULE macro to specify special behavior of SWIG.
#
# The source file property CPLUSPLUS calls SWIG in c++ mode, e.g.::
#
#    set_property(SOURCE mymod.i PROPERTY CPLUSPLUS ON)
#    swig_add_module(mymod python mymod.i)
#
# The source file property SWIG_FLAGS adds custom flags to the SWIG executable.
#
# The source-file property SWIG_MODULE_NAME have to be provided to specify the actual
# import name of the module in the target language if it cannot be scanned automatically
# from source or different from the module file basename.::
#
#    set_property(SOURCE mymod.i PROPERTY SWIG_MODULE_NAME mymod_realname)
#
# To get the name of the swig module target library, use: ${SWIG_MODULE_${name}_REAL_NAME}.
#
# Also some variables can be set to specify special behavior of SWIG.
#
# CMAKE_SWIG_FLAGS can be used to add special flags to all swig calls.
#
# Another special variable is CMAKE_SWIG_OUTDIR, it allows one to specify
# where to write all the swig generated module (swig -outdir option)
#
# The name-specific variable SWIG_MODULE_<name>_EXTRA_DEPS may be used to specify extra
# dependencies for the generated modules.
#
# If the source file generated by swig need some special flag you can use::
#
#    set_source_files_properties( ${swig_generated_file_fullname}
#                                 PROPERTIES COMPILE_FLAGS "-bla")
46

47 48
#=============================================================================
# Copyright 2004-2009 Kitware, Inc.
49
# Copyright 2009 Mathieu Malaterre <mathieu.malaterre@gmail.com>
50 51 52 53 54 55 56 57
#
# Distributed under the OSI-approved BSD License (the "License");
# see accompanying file Copyright.txt for details.
#
# This software is distributed WITHOUT ANY WARRANTY; without even the
# implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
# See the License for more information.
#=============================================================================
58
# (To distribute this file outside of CMake, substitute the full
59 60
#  License text for the above reference.)

61 62
set(SWIG_CXX_EXTENSION "cxx")
set(SWIG_EXTRA_LIBRARIES "")
63

64
set(SWIG_PYTHON_EXTRA_FILE_EXTENSION "py")
65 66 67 68

#
# For given swig module initialize variables associated with it
#
69 70 71 72 73 74 75
macro(SWIG_MODULE_INITIALIZE name language)
  string(TOUPPER "${language}" swig_uppercase_language)
  string(TOLOWER "${language}" swig_lowercase_language)
  set(SWIG_MODULE_${name}_LANGUAGE "${swig_uppercase_language}")
  set(SWIG_MODULE_${name}_SWIG_LANGUAGE_FLAG "${swig_lowercase_language}")

  set(SWIG_MODULE_${name}_REAL_NAME "${name}")
76
  if (";${CMAKE_SWIG_FLAGS};" MATCHES ";-noproxy;")
77 78
    set (SWIG_MODULE_${name}_NOPROXY TRUE)
  endif ()
79
  if("x${SWIG_MODULE_${name}_LANGUAGE}" STREQUAL "xUNKNOWN")
80
    message(FATAL_ERROR "SWIG Error: Language \"${language}\" not found")
81
  elseif("x${SWIG_MODULE_${name}_LANGUAGE}" STREQUAL "xPYTHON" AND NOT SWIG_MODULE_${name}_NOPROXY)
82 83 84
    # swig will produce a module.py containing an 'import _modulename' statement,
    # which implies having a corresponding _modulename.so (*NIX), _modulename.pyd (Win32),
    # unless the -noproxy flag is used
85
    set(SWIG_MODULE_${name}_REAL_NAME "_${name}")
86
  elseif("x${SWIG_MODULE_${name}_LANGUAGE}" STREQUAL "xPERL")
87
    set(SWIG_MODULE_${name}_EXTRA_FLAGS "-shadow")
88
  elseif("x${SWIG_MODULE_${name}_LANGUAGE}" STREQUAL "xCSHARP")
89 90 91
    # This makes sure that the name used in the generated DllImport
    # matches the library name created by CMake
    set(SWIG_MODULE_${name}_EXTRA_FLAGS "-dllimport;${name}")
92
  endif()
93
endmacro()
94 95 96

#
# For a given language, input file, and output file, determine extra files that
97
# will be generated. This is internal swig macro.
98 99
#

100 101 102
macro(SWIG_GET_EXTRA_OUTPUT_FILES language outfiles generatedpath infile)
  set(${outfiles} "")
  get_source_file_property(SWIG_GET_EXTRA_OUTPUT_FILES_module_basename
Bill Hoffman's avatar
Bill Hoffman committed
103
    ${infile} SWIG_MODULE_NAME)
104
  if(SWIG_GET_EXTRA_OUTPUT_FILES_module_basename STREQUAL "NOTFOUND")
105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128

    # try to get module name from "%module foo" syntax
    if ( EXISTS ${infile} )
      file ( STRINGS ${infile} _MODULE_NAME REGEX "[ ]*%module[ ]*[a-zA-Z0-9_]+.*" )
    endif ()
    if ( _MODULE_NAME )
      string ( REGEX REPLACE "[ ]*%module[ ]*([a-zA-Z0-9_]+).*" "\\1" _MODULE_NAME "${_MODULE_NAME}" )
      set(SWIG_GET_EXTRA_OUTPUT_FILES_module_basename "${_MODULE_NAME}")

    else ()
      # try to get module name from "%module (options=...) foo" syntax
      if ( EXISTS ${infile} )
        file ( STRINGS ${infile} _MODULE_NAME REGEX "[ ]*%module[ ]*\\(.*\\)[ ]*[a-zA-Z0-9_]+.*" )
      endif ()
      if ( _MODULE_NAME )
        string ( REGEX REPLACE "[ ]*%module[ ]*\\(.*\\)[ ]*([a-zA-Z0-9_]+).*" "\\1" _MODULE_NAME "${_MODULE_NAME}" )
        set(SWIG_GET_EXTRA_OUTPUT_FILES_module_basename "${_MODULE_NAME}")

      else ()
        # fallback to file basename
        get_filename_component(SWIG_GET_EXTRA_OUTPUT_FILES_module_basename ${infile} NAME_WE)
      endif ()
    endif ()

129
  endif()
130 131
  foreach(it ${SWIG_${language}_EXTRA_FILE_EXTENSION})
    set(${outfiles} ${${outfiles}}
Bill Hoffman's avatar
Bill Hoffman committed
132
      "${generatedpath}/${SWIG_GET_EXTRA_OUTPUT_FILES_module_basename}.${it}")
133 134
  endforeach()
endmacro()
135 136 137 138

#
# Take swig (*.i) file and add proper custom commands for it
#
139 140 141 142 143 144 145 146
macro(SWIG_ADD_SOURCE_TO_MODULE name outfiles infile)
  set(swig_full_infile ${infile})
  get_filename_component(swig_source_file_name_we "${infile}" NAME_WE)
  get_source_file_property(swig_source_file_generated ${infile} GENERATED)
  get_source_file_property(swig_source_file_cplusplus ${infile} CPLUSPLUS)
  get_source_file_property(swig_source_file_flags ${infile} SWIG_FLAGS)
  if("${swig_source_file_flags}" STREQUAL "NOTFOUND")
    set(swig_source_file_flags "")
147
  endif()
148
  get_filename_component(swig_source_file_fullname "${infile}" ABSOLUTE)
149

Ken Martin's avatar
Ken Martin committed
150
  # If CMAKE_SWIG_OUTDIR was specified then pass it to -outdir
151 152
  if(CMAKE_SWIG_OUTDIR)
    set(swig_outdir ${CMAKE_SWIG_OUTDIR})
153
  else()
154
    set(swig_outdir ${CMAKE_CURRENT_BINARY_DIR})
155
  endif()
156 157 158 159 160 161
  if (NOT SWIG_MODULE_${name}_NOPROXY)
    SWIG_GET_EXTRA_OUTPUT_FILES(${SWIG_MODULE_${name}_LANGUAGE}
      swig_extra_generated_files
      "${swig_outdir}"
      "${swig_source_file_fullname}")
  endif()
162
  set(swig_generated_file_fullname
163
    "${swig_outdir}/${swig_source_file_name_we}")
Bill Hoffman's avatar
Bill Hoffman committed
164 165
  # add the language into the name of the file (i.e. TCL_wrap)
  # this allows for the same .i file to be wrapped into different languages
166
  set(swig_generated_file_fullname
Bill Hoffman's avatar
Bill Hoffman committed
167
    "${swig_generated_file_fullname}${SWIG_MODULE_${name}_LANGUAGE}_wrap")
168

169 170
  if(swig_source_file_cplusplus)
    set(swig_generated_file_fullname
171
      "${swig_generated_file_fullname}.${SWIG_CXX_EXTENSION}")
172
  else()
173
    set(swig_generated_file_fullname
174
      "${swig_generated_file_fullname}.c")
175
  endif()
176

177 178 179
  #message("Full path to source file: ${swig_source_file_fullname}")
  #message("Full path to the output file: ${swig_generated_file_fullname}")
  get_directory_property(cmake_include_directories INCLUDE_DIRECTORIES)
180
  list(REMOVE_DUPLICATES cmake_include_directories)
181 182 183
  set(swig_include_dirs)
  foreach(it ${cmake_include_directories})
    set(swig_include_dirs ${swig_include_dirs} "-I${it}")
184
  endforeach()
185

186
  set(swig_special_flags)
Bill Hoffman's avatar
Bill Hoffman committed
187
  # default is c, so add c++ flag if it is c++
188 189
  if(swig_source_file_cplusplus)
    set(swig_special_flags ${swig_special_flags} "-c++")
190
  endif()
191 192 193
  set(swig_extra_flags)
  if(SWIG_MODULE_${name}_EXTRA_FLAGS)
    set(swig_extra_flags ${swig_extra_flags} ${SWIG_MODULE_${name}_EXTRA_FLAGS})
194
  endif()
195
  add_custom_command(
Ken Martin's avatar
Ken Martin committed
196
    OUTPUT "${swig_generated_file_fullname}" ${swig_extra_generated_files}
197 198
    # Let's create the ${swig_outdir} at execution time, in case dir contains $(OutDir)
    COMMAND ${CMAKE_COMMAND} -E make_directory ${swig_outdir}
Ken Martin's avatar
Ken Martin committed
199 200 201 202 203 204 205 206 207 208
    COMMAND "${SWIG_EXECUTABLE}"
    ARGS "-${SWIG_MODULE_${name}_SWIG_LANGUAGE_FLAG}"
    ${swig_source_file_flags}
    ${CMAKE_SWIG_FLAGS}
    -outdir ${swig_outdir}
    ${swig_special_flags}
    ${swig_extra_flags}
    ${swig_include_dirs}
    -o "${swig_generated_file_fullname}"
    "${swig_source_file_fullname}"
209 210
    MAIN_DEPENDENCY "${swig_source_file_fullname}"
    DEPENDS ${SWIG_MODULE_${name}_EXTRA_DEPS}
211
    COMMENT "Swig source")
212
  set_source_files_properties("${swig_generated_file_fullname}" ${swig_extra_generated_files}
213
    PROPERTIES GENERATED 1)
214
  set(${outfiles} "${swig_generated_file_fullname}" ${swig_extra_generated_files})
215
endmacro()
216 217 218 219

#
# Create Swig module
#
220
macro(SWIG_ADD_MODULE name language)
221
  SWIG_MODULE_INITIALIZE(${name} ${language})
222 223 224
  set(swig_dot_i_sources)
  set(swig_other_sources)
  foreach(it ${ARGN})
225
    if(${it} MATCHES "\\.i$")
226
      set(swig_dot_i_sources ${swig_dot_i_sources} "${it}")
227
    else()
228
      set(swig_other_sources ${swig_other_sources} "${it}")
229 230
    endif()
  endforeach()
231 232 233

  set(swig_generated_sources)
  foreach(it ${swig_dot_i_sources})
234
    SWIG_ADD_SOURCE_TO_MODULE(${name} swig_generated_source ${it})
235
    set(swig_generated_sources ${swig_generated_sources} "${swig_generated_source}")
236
  endforeach()
237 238
  get_directory_property(swig_extra_clean_files ADDITIONAL_MAKE_CLEAN_FILES)
  set_directory_properties(PROPERTIES
Bill Hoffman's avatar
Bill Hoffman committed
239
    ADDITIONAL_MAKE_CLEAN_FILES "${swig_extra_clean_files};${swig_generated_sources}")
240
  add_library(${SWIG_MODULE_${name}_REAL_NAME}
241 242 243
    MODULE
    ${swig_generated_sources}
    ${swig_other_sources})
244
  set_target_properties(${SWIG_MODULE_${name}_REAL_NAME} PROPERTIES NO_SONAME ON)
245
  string(TOLOWER "${language}" swig_lowercase_language)
246 247 248
  if ("${swig_lowercase_language}" STREQUAL "octave")
    set_target_properties(${SWIG_MODULE_${name}_REAL_NAME} PROPERTIES PREFIX "")
    set_target_properties(${SWIG_MODULE_${name}_REAL_NAME} PROPERTIES SUFFIX ".oct")
249 250
  elseif ("${swig_lowercase_language}" STREQUAL "go")
    set_target_properties(${SWIG_MODULE_${name}_REAL_NAME} PROPERTIES PREFIX "")
251
  elseif ("${swig_lowercase_language}" STREQUAL "java")
252
    if (APPLE)
253 254 255 256 257 258
        # In java you want:
        #      System.loadLibrary("LIBRARY");
        # then JNI will look for a library whose name is platform dependent, namely
        #   MacOS  : libLIBRARY.jnilib
        #   Windows: LIBRARY.dll
        #   Linux  : libLIBRARY.so
259
        set_target_properties (${SWIG_MODULE_${name}_REAL_NAME} PROPERTIES SUFFIX ".jnilib")
260
      endif ()
261 262
  elseif ("${swig_lowercase_language}" STREQUAL "lua")
    set_target_properties(${SWIG_MODULE_${name}_REAL_NAME} PROPERTIES PREFIX "")
263
  elseif ("${swig_lowercase_language}" STREQUAL "python")
264
    # this is only needed for the python case where a _modulename.so is generated
265
    set_target_properties(${SWIG_MODULE_${name}_REAL_NAME} PROPERTIES PREFIX "")
266 267 268 269 270 271 272 273
    # Python extension modules on Windows must have the extension ".pyd"
    # instead of ".dll" as of Python 2.5.  Older python versions do support
    # this suffix.
    # http://docs.python.org/whatsnew/ports.html#SECTION0001510000000000000000
    # <quote>
    # Windows: .dll is no longer supported as a filename extension for extension modules.
    # .pyd is now the only filename extension that will be searched for.
    # </quote>
274 275
    if(WIN32 AND NOT CYGWIN)
      set_target_properties(${SWIG_MODULE_${name}_REAL_NAME} PROPERTIES SUFFIX ".pyd")
276
    endif()
277 278
  elseif ("${swig_lowercase_language}" STREQUAL "r")
    set_target_properties(${SWIG_MODULE_${name}_REAL_NAME} PROPERTIES PREFIX "")
279 280 281 282 283 284 285 286 287 288 289
  elseif ("${swig_lowercase_language}" STREQUAL "ruby")
    # In ruby you want:
    #      require 'LIBRARY'
    # then ruby will look for a library whose name is platform dependent, namely
    #   MacOS  : LIBRARY.bundle
    #   Windows: LIBRARY.dll
    #   Linux  : LIBRARY.so
    set_target_properties (${SWIG_MODULE_${name}_REAL_NAME} PROPERTIES PREFIX "")
    if (APPLE)
      set_target_properties (${SWIG_MODULE_${name}_REAL_NAME} PROPERTIES SUFFIX ".bundle")
    endif ()
290 291
  endif ()
endmacro()
292 293 294 295

#
# Like TARGET_LINK_LIBRARIES but for swig modules
#
296 297 298
macro(SWIG_LINK_LIBRARIES name)
  if(SWIG_MODULE_${name}_REAL_NAME)
    target_link_libraries(${SWIG_MODULE_${name}_REAL_NAME} ${ARGN})
299
  else()
300
    message(SEND_ERROR "Cannot find Swig library \"${name}\".")
301 302
  endif()
endmacro()
303