Configuring Boost.Build . Boost , Boost.Python , Chapter 1. Building and Testing

Configuring Boost.Build

Python Configuration Parameters
Examples

Как описано в. Справочное руководство по сборке, файл под названием<user-config.jam>в домашнем каталоге используется для указания инструментов и библиотек, доступных для системы сборки. Возможно, вам потребуется создать или отредактировать<user-config.jam>, чтобы сообщить Boost. Постройте, как вызвать Python,<#include>его заголовки и свяжитесь с его библиотеками.

Note

Если вы используете Unix-вариантную ОС и запускаете скрипт Boost<configure>, он может генерировать<user-config.jam>для вас.^<#include>Если ваша последовательность<configure>/<make>была успешной и улучшилась. Были созданы двоичные файлы Python, ваш<user-config.jam>файл, вероятно, уже прав.

Если у вас есть установка python для вашей платформы и #8220; Standard & #8221, вам не нужно делать ничего особенного, чтобы описать ее. Если вы не настроили питон в<user-config.jam>(и не указали<--without-python>на Boost). Постройте командную строку. Постройка автоматически выполняет эквивалент

import toolset : using ;
using python ;

Он автоматически ищет Python в наиболее вероятных местах. Однако это происходит только при использовании бустера. Файл проекта Python (например, когда другой проект ссылается на метод быстрого запуска). Если вместо этого вы ссылаетесь на отдельно собранный Boost. Вы должны настроить файл<user-config.jam>с минимальным заклинанием выше.

Python Configuration Parameters

Если у вас установлено несколько версий Python или Python установлен необычным способом, вы можете предоставить любые или все из следующих дополнительных параметров<usingpython>.

version: Версия Python для использования. Должно быть на майоре. Малый формат, например<2.3>. Не включайте незначительную версию (т.е., а не<2.5.1>). Если у вас установлено несколько версий Python, версия обычно будет единственным требуемым аргументом конфигурации.
cmd-or-prefix: Предпочтительно, команда, которая вызывает интерпретатор Python. Альтернативно, установочный префикс для библиотек Python и файлов заголовков. Используйте только альтернативную формулировку, если нет подходящего исполняемого файла Python.
includes: <#include>Пути для заголовков Python. Как правило, правильный путь будет автоматически выведен из<version>и / или<cmd-or-prefix>.
libraries: Путь к библиотечным двоичным файлам Python. На MacOS/Darwin также можно пройти путь фреймворка Python. Обычно правильный путь будет автоматически выведен из<version>и/или<cmd-or-prefix>.
condition: Если указано, то должен быть набор Boost. Постройте свойства, которые соответствуют конфигурации сборки при увеличении. Build выбирает конфигурацию Python для использования. Примеры см. ниже для деталей.
extension-suffix: Струна для добавления к имени модулей расширения перед истинным расширением имени файла. Вы почти наверняка не должны использовать это. Обычно этот суффикс используется только при нацеливании на сборку отладки Windows Python и будет установлен автоматически для вас на основе значения функции. Однако по крайней мере один дистрибутив Linux (Ubuntu Feisty Fawn) имеет специально настроенныйпакет, который утверждает, что использует такой суффикс.

Examples

Обратите внимание, что в приведенных ниже примерах значительны случай и, особенно белое пространство.

Если у вас установлен как Python 2.5, так и Python 2.4,<user-config.jam>может содержать
<
```
usingpython:2.5;#MakebothversionsofPythonavailable
usingpython:2.4;#Tobuildwithpython2.4,addpython=2.4
                     # toyourcommandline.
```
>
. Первая конфигурированная версия (2.5) становится по умолчанию. Чтобы построить против python 2.4, добавьте<python=2.4>в<bjam>командную строку.
Если у вас установлен питон в необычном месте, вы можете указать путь к переводчику по параметру<cmd-or-prefix>:
<
```
usingpython::/usr/local/python-2.6-beta/bin/python;
```
>
Если у вас есть отдельная сборка Python для использования с определенным набором инструментов, вы можете предоставить этот набор инструментов по параметру<condition>:
<
```
usingpython;#useformosttoolsets
# UsewithIntelC++toolset
usingpython
    :#version
    :c:\\Devel\\Python-2.5-IntelBuild\\PCBuild\\python#cmd-or-prefix
    :#includes
    :#libraries
    :<toolset>intel#condition
    ;
```
>
Если вы загрузили источники Python и создали как обычную, так и«отладку Python»сборки из источника в Windows, вы можете увидеть:
<
```
usingpython:2.5:C:\\src\\Python-2.5\\PCBuild\\python;
usingpython:2.5:C:\\src\\Python-2.5\\PCBuild\\python_d
 :#includes
 :#libs
 :<python-debugging>on;
```
>
Вы можете настроить конфигурацию пользователя. bjam, построенный под Windows, может создавать / тестировать расширения Windows и Cygwin_python. Просто пройдите<<target-os>cygwin>в<condition>параметре для установки питона-цигвина:
<
```
# windowsinstallation
usingpython;
# cygwininstallation
usingpython::c:\\cygwin\\bin\\python2.5:::<target-os>cygwin;
```
>
, когда вы помещаете target-os =cygwin в свой запрос на сборку, он должен строить с помощью версии питона-цигвина:_
<
```
bjamtarget-os=cygwintoolset=gcc
```
>
Предполагается, что это работает и в обратном направлении (нацеливание оконного питона наCygwinbjam), но похоже, что поддержка в Boost. Наборы инструментов для строительства таким образом сломаны во время написания этой статьи.
Заметьте, что из-запуть увеличивается. В настоящее время Build выбирает целевые альтернативы, вы можете быть очень откровенны в своих запросах на сборку. Например:
<
```
usingpython:2.5;#aregularwindowsbuild
usingpython:2.4::::<target-os>cygwin;
```
>
здание с
<
```
bjamtarget-os=cygwin
```
>
приведет к ошибке. Вместо этого вам нужно будет написать
<
```
bjamtarget-os=cygwin/python=2.4
```
>.

^<#include><configure>перезаписывает существующий<user-config.jam>в домашнем каталоге (если таковой имеется) после создания резервной копии старой версии.

Статья Configuring Boost.Build раздела Boost.Python Chapter 1. Building and Testing может быть полезна для разработчиков на c++ и boost.

Configuring Boost.Build

Boost , Boost.Python , Chapter 1. Building and Testing

Boost C++ Libraries

Configuring Boost.Build

Python Configuration Parameters

Examples