SWIG

SWIG
Тип	Инструмент для разработки
Разработчики	Сообщество
ОС	POSIX, MS Windows
Версия	1.3.40 (18 авгста 2009)
Лицензия	Лицензия в стиле BSD
Сайт	www.swig.org

SWIG (англ. Simplified Wrapper and Interface Generator) — свободный инструмент для связывания программ и библиотек написанных на C/C++ со скриптовыми языками, такими как Tcl, Perl, Python, Ruby, PHP или другими языками наподобие Java, C#, Scheme или OCaml. Основная цель — достигнуть связи с минимальными усилиями: в файлы заголовка программы добавляется небольшое количество указаний, по которым SWIG генерирует исходный код для склеивания C/C++ и нужного языка. В зависимости от языка, результат склеивания может быть представлен в трех формах:

• исполняемый файл исходной программы со встроенным интерпретатором скриптового языка
• разделяемая библиотека, к которой существующий интерпретатор может подключаться в виде расширения
• разделяемая библиотека, которая может подключаться к другим программам, написанным на нужном языке (например, с помощью JNI для Java)

Существует две основные причины для встраивания скриптового языка в C/C++ программу:

• С помощью скриптового языка вместо C/C++ программа может дорабатываться намного быстрее. Скриптовый движок можно даже сделать доступным пользователям, чтобы они могли автоматизировать свою работу через скрипты. Такой приём повсеметно используется в играх для написания сюжета и уровней.
• Даже если конечный продукт не будет включать скриптовый движок, тем не менее практика написания тестовых скриптов может оказаться полезной.

Есть несколько причин для создания динамических библиотек, которые могут загружаться существующими интерпретаторами:

• Предоставить доступ к C/C++ библиотеке при отсутствии аналогов в скриптовом языке
• Изначальное создание программы полностью на скриптовом языке и переписывание критических участков кода после анализа производительности на C/C++

Сам SWIG написан на С и C++ и публично доступен с февраля 1996 года. Он распространяется на условиях, схожих с лицензией BSD, то есть его можно использовать, распространять дальше и модифицировать практически без ограничений, для коммерческих и некоммерческих целей.

Простой пример использования SWIG (Python)

Предположим, что есть программа на C, реализующая некоторую функцию (печать текста):

<source lang="C">

/* File : try.c */

1. include <stdio.h>

void echo(void) { printf("\"what's the hell!\"\n");

    /* printf("\"Hello World\"\n");     */

} </source>

Для того чтобы можно было воспользоваться этой функцией из Python, нужно написать интерфейсный файл (расширение .i) примерно следующего содержания:

<source lang="C">

/* File : try.i */ %module mytry

extern void echo(void);

</source>

создание модуля расширения может быть выполнено примерно так (на *NIX): <source lang="bash"> >swig -python try.i >gcc -c -fpic try_wrap.c try.c -DHAVE_CONFIG_H -I"/usr/local/include/python2.5" -I"/usr/local/lib/python2.5/config" >gcc -shared try.o try_wrap.o -o _try.so

</source>

или так (на win* c cygwin): <source lang="dos">

>swig -python try.i >gcc -c try_wrap.c try.c -DHAVE_CONFIG_H >gcc -shared try_wrap.o try.o -o _try.pyd -lpython25

</source>

Результат работы

Набираем в интерпретаторе Python следующуий текст

<source lang="python"> >>> import mytry >>> mytry.echo() "what's the hell!" >>>

</source>

Если заглянуть внутрь mytry.py то можно увидеть

<source lang="python">

1. This file was automatically generated by SWIG (http://www.swig.org).
2. Version 1.3.36
4. Don't modify this file, modify the SWIG interface instead.
5. This file is compatible with both classic and new-style classes.

import _mytry import new new_instancemethod = new.instancemethod try:

   _swig_property = property

except NameError:

   pass # Python < 2.2 doesn't have 'property'.

def _swig_setattr_nondynamic(self,class_type,name,value,static=1):

   if (name == "thisown"): return self.this.own(value)
   if (name == "this"):
       if type(value).__name__ == 'PySwigObject':
           self.__dict__[name] = value
           return
   method = class_type.__swig_setmethods__.get(name,None)
   if method: return method(self,value)
   if (not static) or hasattr(self,name):
       self.__dict__[name] = value
   else:
       raise AttributeError("You cannot add attributes to %s" % self)

def _swig_setattr(self,class_type,name,value):

   return _swig_setattr_nondynamic(self,class_type,name,value,0)

def _swig_getattr(self,class_type,name):

   if (name == "thisown"): return self.this.own()
   method = class_type.__swig_getmethods__.get(name,None)
   if method: return method(self)
   raise AttributeError,name

def _swig_repr(self):

   try: strthis = "proxy of " + self.this.__repr__()
   except: strthis = ""
   return "<%s.%s; %s >" % (self.__class__.__module__, self.__class__.__name__, strthis,)

import types try:

   _object = types.ObjectType
   _newclass = 1

except AttributeError:

   class _object : pass
   _newclass = 0

del types

echo = _mytry.echo

</source>

Ссылки

• Официальный сайт SWIG
• Использование SWIG
• Опыты со SWIG’ом: C++ код и Ruby