SWIG

Материал из Википедии — свободной энциклопедии
Перейти к: навигация, поиск
SWIG
Тип

Инструмент для разработки

Разработчики

Сообщество

Написана на

C, C++

Операционная система

POSIX, MS Windows

Последняя версия

2.0.10 (27 мая 2013)

Лицензия

Лицензия в стиле BSD

Сайт

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++ программа может дорабатываться намного быстрее. Скриптовый движок можно даже сделать доступным пользователям, чтобы они могли автоматизировать свою работу через скрипты. Такой приём повсеместно используется в играх для написания сюжета и уровней.
  • Даже если конечный продукт не будет включать скриптовый движок, тем не менее практика написания тестовых скриптов может оказаться полезной.

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

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

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

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

/* File : try.c */
#include <stdio.h>
 
void echo(void) {
	printf("\"what the hell!\"\n");
     /* printf("\"Hello World\"\n");     */
}

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

/* File : try.i */
%module mytry
 
extern void echo(void);


создание модуля расширения на Unix:

>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 _mytry.so

или так (в Windows c Cygwin):

>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


Результат работы[править | править вики-текст]

В интерпретаторе Python получается следующее:

>>> import mytry
>>> mytry.echo()
"what the hell!"
>>>


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

# This file was automatically generated by SWIG (http://www.swig.org).
# Version 1.3.36
#
# Don't modify this file, modify the SWIG interface instead.
# 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


Ссылки[править | править вики-текст]

Литература[править | править вики-текст]

  • Hans Petter Langtangen Python Scripting for Computational Science. — Springer, 2008. — 750 с. — ISBN 9783540739159.