summaryrefslogtreecommitdiff
path: root/pkg-config.jam
diff options
context:
space:
mode:
authorDan Goodliffe <dan@randomdan.homeip.net>2019-11-12 16:53:31 +0000
committerDan Goodliffe <dan@randomdan.homeip.net>2019-11-12 16:53:31 +0000
commit6a30f5391ed5eb50972ce39bde02fd223d233b57 (patch)
tree9f569d8e898092db0ea515ab29fc326fd5e011d4 /pkg-config.jam
parentDon't assume packages and categories are present (diff)
downloadgentoobrowse-2.1.4.tar.bz2
gentoobrowse-2.1.4.tar.xz
gentoobrowse-2.1.4.zip
Modernize buildgentoobrowse-2.1.4
Diffstat (limited to 'pkg-config.jam')
-rw-r--r--pkg-config.jam485
1 files changed, 0 insertions, 485 deletions
diff --git a/pkg-config.jam b/pkg-config.jam
deleted file mode 100644
index 2efa9cf..0000000
--- a/pkg-config.jam
+++ /dev/null
@@ -1,485 +0,0 @@
-#|
-Copyright 2019 Dmitry Arkhipov
-Distributed under the Boost Software License, Version 1.0. (See
-accompanying file LICENSE_1_0.txt or copy at
-http://www.boost.org/LICENSE_1_0.txt)
-|#
-
-
-import "class" : new ;
-import common ;
-import errors ;
-import feature ;
-import os ;
-import param ;
-import project ;
-import regex ;
-import sequence ;
-import string ;
-import targets ;
-
-
-#| tag::doc[]
-
-= pkg-config
-The *pkg-config* program is used to retrieve information about installed
-libraries in the system. It retrieves information about packages from special
-metadata files. These files are named after the package, and have a `.pc`
-extension. The package name specified to *pkg-config* is defined to be the name
-of the metadata file, minus the `.pc` extension.
-
-|# # end::doc[]
-
-
-#| tag::doc[]
-
-== Feature: `pkg-config`
-
-Selects one of the initialized `pkg-config` configurations. This feature is
-`propagated` to dependencies. Its use is dicussed in
-section <<pkg-config-init>>.
-
-|# # end::doc[]
-
-feature.feature pkg-config : : propagated ;
-
-
-#| tag::doc[]
-
-== Feature: `pkg-config-define`
-
-This `free` feature adds a variable assignment to pkg-config invocation. For
-example,
-
-[source, jam]
-----
-pkg-config.import mypackage : requirements <pkg-config-define>key=value ;
-----
-
-is equivalent to invoking on the comand line
-
-[source, shell]
-----
-pkg-config --define-variable=key=value mypackage ;
-----
-
-|# # end::doc[]
-
-feature.feature pkg-config-define : : free ;
-
-
-#| tag::doc[]
-
-== Rule: `import`
-
-Main target rule that imports a *pkg-config* package. When its consumer targets
-are built, *pkg-config* command will be invoked with arguments that depend on
-current property set. The features that have an effect are:
-
-* `<pkg-config-define>`: adds a `--define-variable` argument;
-* `<link>`: adds `--static` argument when `<link>static`;
-* `<link>`: adds `--static` argument when `<link>static`;
-* `<name>`: specifies package name (target name is used instead if the property
- is not present);
-* `<version>`: specifies package version range, can be used multiple times and
- should be a dot-separated sequence of numbers optionally prefixed with `=`,
- `<`, `>`, `<=` or `>=`.
-
-Example:
-
-[source, jam]
-----
-pkg-config.import my-package
- : requirements <name>my_package <version><4 <version>>=3.1 ;
-----
-
-|# # end::doc[]
-
-
-rule import
- ( target-name
- : sources *
- : requirements *
- : default-build *
- : usage-requirements *
- )
-{
- param.handle-named-params
- sources requirements default-build usage-requirements ;
- targets.create-metatarget pkg-config-target
- : [ project.current ]
- : $(target-name)
- : $(sources)
- : $(requirements)
- : $(default-build)
- : $(usage-requirements)
- ;
-}
-
-
-#| tag::doc[]
-
-== Initialization [[ pkg-config-init ]]
-
-To use the `pkg-config` tool you need to declare it in a configuration file
-with the `using` rule:
-
-[source, jam]
-----
-using pkg-config : [config] : [command] ... : [ options ] ... ;
-----
-
-
-* `config`: the name of initialized configuration. The name can be omitted, in
- which case the configuration will become the default one.
-* `command`: the command, with any extra arguments, to execute. If no command
- is given, first `PKG_CONFIG` environment variable is checked, and if its
- empty the string `pkg-config` is used.
-* `options`: options that modify `pkg-config` behavior. Allowed options are:
- * `<path>`: sets `PKG_CONFIG_PATH` environment variable;
- multiple occurences are allowed.
- * `<libdir>`: sets `PKG_CONFIG_LIBDIR` environment variable;
- multiple occurences are allowed.
- * `<allow-system-cflags>`: sets `PKG_CONFIG_ALLOW_SYSTEM_CFLAGS`
- environment variable; multiple occurences are allowed.
- * `<allow-system-libs>`: sets `PKG_CONFIG_ALLOW_SYSTEM_LIBS`
- environment variable; multiple occurences are allowed.
- * `<sysroot>`: sets `PKG_CONFIG_SYSROOT_DIR` environment variable;
- multiple occurences are allowed.
- * `<variable>`: adds a variable definition argument to command invocation;
- multiple occurences are allowed.
-
-|# # end::doc[]
-
-rule init ( config ? : command * : options * )
-{
- config ?= [ default-config ] ;
-
- local tool = [ os.environ PKG_CONFIG ] ;
- tool ?= pkg-config ;
- command =
- [ common.get-invocation-command pkg-config : $(tool) : $(command) ] ;
-
- configure $(config) : $(command) : $(options) ;
- $(.configs).use $(config) ;
-}
-
-
-rule run ( config ? : args * )
-{
- config ?= [ default-config ] ;
-
- local command = [ $(.configs).get $(config) : command ] ;
- command = "$(command) $(args:J= )" ;
-
- local output = [ SHELL "$(command)" : exit-status ] ;
- if 0 != $(output[2])
- {
- errors.error "pkg-config: command '$(command)' resulted in error:"
- [ common.newline-char ] $(output[1]) ;
- }
-
- local ws = [ string.whitespace ] ;
- output = [ regex.split $(output[1]) "[$(ws)]" ] ;
- return [ sequence.filter non-empty : $(output) ] ;
-}
-
-
-#| tag::doc[]
-
-== Class `pkg-config-target`
-
-[source, jam]
-----
-class pkg-config-target : alias-target-class {
- rule construct ( name : sources * : property-set )
- rule version ( property-set )
- rule variable ( name : property-set )
-}
-----
-
-The class of objects returned by `import` rule. The objects themselves could be
-useful in situations that require more complicated logic for consuming a
-package. See <<pkg-config-tips>> for examples.
-
-. `rule construct ( name : sources * : property-set )`
- Overrides `alias-target.construct`.
-
-. `rule version ( property-set )`
- Returns the package's version, in the context of `property-set`.
-
-. `rule variable ( name : property-set )`
- Returns the value of variable `name` in the package, in the context of
- `property-set`.
-
-
-|# # end::doc[]
-
-class pkg-config-target : alias-target-class
-{
- import pkg-config ;
- import regex ;
-
- rule construct ( name : sources * : property-set )
- {
- local config = [ $(property-set).get <pkg-config> ] ;
- local args = [ common-arguments $(name) : $(property-set) ] ;
- return
- [ property-set.create
- [ compile-flags $(config) $(property-set) : $(args) ]
- [ link-flags $(config) $(property-set) : $(args) ]
- ] ;
- }
-
- rule version ( property-set )
- {
- local config = [ $(property-set).get <pkg-config> ] ;
- local args = [ common-arguments [ name ] : $(property-set) ] ;
- local version = [ pkg-config.run $(config) : --modversion $(args) ] ;
- return [ regex.split $(version) "\\." ] ;
- }
-
- rule variable ( name : property-set )
- {
- local config = [ $(property-set).get <pkg-config> ] ;
- local args = [ common-arguments [ name ] : $(property-set) ] ;
- return [ pkg-config.run $(config) : --variable=$(name) $(args) ] ;
- }
-
- local rule common-arguments ( name : property-set )
- {
- local defines = [ $(property-set).get <pkg-config-define> ] ;
- local args = --define-variable=$(defines) ;
- if [ $(property-set).get <link> ] = static
- {
- args += --static ;
- }
- return $(args) [ get-package-request $(property-set) $(name) ] ;
- }
-
- local rule get-package-request ( property-set name )
- {
- local pkg-name = [ $(property-set).get <name> ] ;
- pkg-name ?= $(name) ;
- if $(pkg-name[2])
- {
- errors.error "multiple package names were specified for target "
- "'$(name)': $(pkg-name)" ;
- }
-
- local versions ;
- for local version in [ $(property-set).get <version> ]
- {
- local match = [ MATCH "^(<=)(.*)" : $(version) ] ;
- match ?= [ MATCH "^(>=)(.*)" : $(version) ] ;
- match ?= [ MATCH "^([><=])(.*)" : $(version) ] ;
- if $(match)
- {
- version = " $(match:J= )" ;
- }
- else
- {
- version = " = $(version)" ;
- }
- versions += $(version) ;
- }
- versions ?= "" ;
-
- return "'$(pkg-name)"$(versions)"'" ;
- }
-
- local rule link-flags ( config property-set : args * )
- {
- local flags = [ pkg-config.run $(config) : --libs $(args) ] ;
- return <linkflags>$(flags) ;
- }
-
- local rule compile-flags ( config property-set : args * )
- {
- local flags = [ pkg-config.run $(config) : --cflags $(args) ] ;
- return <cflags>$(flags) ;
- }
-}
-
-
-local rule default-config ( )
-{
- return default ;
-}
-
-
-local rule configure ( config : command + : options * )
-{
- $(.configs).register $(config) ;
-
- local path ;
- local libdir ;
- local allow-system-cflags ;
- local allow-system-libs ;
- local sysroot ;
- local defines ;
- for local opt in $(options)
- {
- switch $(opt:G)
- {
- case <path> : path += $(opt:G=) ;
- case <libdir> : libdir += $(opt:G=) ;
- case <allow-system-cflags> : allow-system-cflags += $(opt:G=) ;
- case <allow-system-libs> : allow-system-libs += $(opt:G=) ;
- case <sysroot> : sysroot += $(opt:G=) ;
- case <variable> : defines += $(opt:G=) ;
- case * :
- errors.error "pkg-config: invalid property '$(opt)' was "
- "specified for configuration '$(config)'." ;
- }
- }
-
- for local opt in allow-system-cflags allow-system-libs
- {
- if ! $($(opt)) in "on" off
- {
- errors.error "pkg-config: invalid value '$($(opt))' was specified "
- "for option <$(opt)> of configuration '$(config)'."
- [ common.newline-char ] "Available values are 'on' and 'off'" ;
- }
- }
-
- if $(sysroot[2])
- {
- errors.error "pkg-config: several values were specified for option "
- "<sysroot> of configuration '$(config)'."
- [ common.newline-char ] "Only one value is allowed." ;
- }
-
- local sep = [ os.path-separator ] ;
- path = [ envar-set-command PKG_CONFIG_PATH : $(path:J=$(sep)) ] ;
- libdir = [ envar-set-command PKG_CONFIG_LIBDIR : $(libdir:J=$(sep)) ] ;
- sysroot = [ envar-set-command PKG_CONFIG_SYSROOT_DIR : $(sysroot) ] ;
- allow-cflags =
- [ envar-set-command PKG_CONFIG_ALLOW_SYSTEM_CFLAGS
- : $(allow-cflags)
- : 1
- ] ;
- allow-libs =
- [ envar-set-command PKG_CONFIG_ALLOW_SYSTEM_LIBS
- : $(allow-libs)
- : 1
- ] ;
-
- command += --print-errors --errors-to-stdout --define-variable=$(defines) ;
- $(.configs).set $(config)
- : command
- : "$(path)$(libdir)$(sysroot)$(allow-cflags)$(allow-libs)$(command:J= )"
- ;
-
- feature.extend pkg-config : $(config) ;
-}
-
-
-local rule envar-set-command ( envar : value * : implied-value * )
-{
- if $(value)
- {
- if $(implied-value)
- {
- value = $(implied-value) ;
- }
- return [ common.path-variable-setting-command $(envar) : $(value) ] ;
- }
- else
- {
- return "" ;
- }
-}
-
-
-local rule non-empty ( string )
-{
- if $(string) != "" { return true ; }
-}
-
-
-.configs = [ new configurations ] ;
-
-
-#| tag::doc[]
-
-== Tips [[pkg-config-tips]]
-
-
-=== Using several configurations
-
-Suppose, you have 2 collections of `.pc` files: one for platform A, and another
-for platform B. You can initialize 2 configurations of `pkg-config` tool each
-corresponding to specific collection:
-
-[source, jam]
-----
-using pkg-config : A : : <libdir>path/to/collection/A ;
-using pkg-config : B : : <libdir>path/to/collection/B ;
-----
-
-Then, you can specify that builds for platform A should use configuration A,
-while builds for B should use configuration B:
-
-[source, jam]
-----
-project
- : requirements
- <target-os>A-os,<architecture>A-arch:<pkg-config>A
- <target-os>B-os,<architecture>B-arch:<pkg-config>B
- ;
-----
-
-Thanks to the fact, that `project-config`, `user-config` and `site-config`
-modules are parents of jamroot module, you can put it in any of those files.o
-
-
-=== Choosing the package name based on the property set
-
-Since a file for a package should be named after the package suffixed with
-`.pc`, some projects came up with naming schemes in order to allow simultaneous
-installation of several major versions or build variants. In order to pick the
-specific name corresponding to the build request you can use `<conditional>`
-property in requirements:
-
-[source, jam]
-----
-pkg-config.import mypackage : requirements <conditional>@infer-name ;
-
-rule infer-name ( properties * )
-{
- local name = mypackage ;
- local variant = [ property.select <variant> : $(properties) ] ;
- if $(variant) = debug
- {
- name += -d ;
- }
- return <name>$(name) ;
-}
-----
-
-The `common.format-name` rule can be very useful in this situation.
-
-
-=== Modify usage requirements based on package version or variable
-
-Sometimes you need to apply some logic based on package's version or a
-variable that it defines. For that you can use `<conditional>` property in
-usage requirements:
-
-----
-mypackage =
- [ pkg-config.import mypackage : usage-requirements <conditional>@define_ns
- ] ;
-
-rule extra-props ( properties * )
-{
- local ps = [ property-set.create $(properties) ] ;
- local prefix = [ $(mypackage).variable name_prefix : $(ps) ] ;
- prefix += [ $(mypackage).version $(ps) ] ;
- return <define>$(prefix:J=_) ;
-}
-----
-
-|# # end::doc[]