From Start To Finish

Первое, что вам нужно сделать, это создать модуль Hello World и попробовать его на Python. В этом разделе мы опишем шаги, необходимые для достижения этой цели. Мы будем использовать инструмент сборки, который поставляется в комплекте с каждым расширением:bjam.

Note

Строительство без бьяма Помимо bjam, есть и другие способы создания вашего модуля. То, что здесь написано, не должно восприниматься как «единственный и единственный путь». Конечно, есть и другие инструменты, кроме<bjam>. Обратите внимание, что предпочтительный инструмент для сборки Boost. Python - это bjam. Существует так много способов настроить сборку неправильно. Опыт показывает, что 90% проблем «Я не могу создать Boost.Python» возникают у людей, которым приходилось использовать другой инструмент.

Мы пропустим детали. Наша цель будет заключаться в том, чтобы просто создать модуль Hello World и запустить его на Python. Для полной ссылки на строительство Boost. Python, проверьте:building.html. После этого краткого учебникаbjamмы должны были построить DLL и запустить программу Python с использованием расширения.

Пример из учебника можно найти в каталоге:<libs/python/example/tutorial>. Там вы можете найти:

Файл<hello.cpp>является нашим примером C++.<Jamroot>— это минималистскийбьямсценарий, который строит DLL для нас. Наконец,<hello.py>— это наша программа Python, которая использует расширение<hello.cpp>.

Прежде всего, у вас должен быть исполняемый файл bjam в вашем каталоге ускорений или где-то на вашем пути, так что<bjam>может быть выполнен в командной строке. Предварительно построенный буст. JAM-исполнители доступны для большинства платформ. Полный список исполняемых файлов Bjam можно найти здесь.

Let's Jam!

Здесьнаш минималистский файл Jamroot. Просто скопируйте файл и настройте<use-project boost>туда, где находится ваш корневой каталог, и вы в порядке.

Комментарии, содержащиеся в вышеприведенном файле Jamrules, должны быть достаточными для того, чтобы заставить вас двигаться вперед.

Running bjam

bjamзапускается с помощью интерпретатора командной строки вашей операционной системы.

Файл, называемый user-config.jam, используется для настройки инструментов. В Windows ваш домашний каталог можно найти, набрав:

ECHO %HOMEDRIVE%%HOMEPATH%

В окно командной строки. Ваш файл должен иметь правила для компилятора и установки python. Конкретным примером этого в Windows будет:

#  MSVC configuration
using msvc : 8.0 ;
#  Python configuration
using python : 2.4 : C:dev/tools/Python ;

Первое правило говорит Bjam использовать компилятор MSVC 8.0 и связанные с ним инструменты. Второе правило содержит информацию о Python, его версии и местонахождении. Вышесказанное предполагает, что установка Python находится в<C:dev/tools\/Python>. Если у вас есть одна довольно «стандартная» установка питонов для вашей платформы, вам может не понадобиться это делать.

Теперь мы готовы... Будьте уверены<cd>до<libs/python/example/tutorial>, где находится учебник<"hello.cpp">и<"Jamroot">.

Наконец:

bjam

Он должен быть построен сейчас:

cd C:\dev\boost\libs\python\example\tutorial
bjam
...patience...
...found 1101 targets...
...updating 35 targets...

И так далее... Наконец:

   Creating library path-to-boost_python.dll
   Creating library /path-to-hello_ext.exp/
**passed** ... hello.test
...updated 35 targets...

Или что-то подобное. Если все в порядке, вы должны были создать DLL и запустить программу Python.