ppkg-configp: en línea en la nube

PROGRAMA:

NOMBRE

PkgConfig - Reemplazo de Pure-Perl Core-Only para pkg-config

SINOPSIS

As a reemplazo para "pkg-config"
$ ppkg-config --libs --cflags --static gio-2.0

#outputs (líneas divididas artificialmente para facilitar la lectura):
# -I / usr / include / glib-2.0 -I / usr / lib / glib-2.0 / include
# -pthread -lgio-2.0 -lz -lresolv -lgobject-2.0
# -lgmodule-2.0 -ldl -lgthread-2.0 -pthread -lrt -lglib-2.0

"pkg-config.pl" se puede utilizar como un alias para "ppkg-config" en plataformas que lo admitan.
También se puede instalar como "pkg-config", aunque no se recomienda si su sistema tiene
un "pkg-config" nativo.

Comparar con:
$ pkg-config --libs --cflags --static gio-2.0

#salidas (""):
# -pthread -I / usr / include / glib-2.0 -I / usr / lib / glib-2.0 / include
# -pthread -lgio-2.0 -lz -lresolv -lgobject-2.0 -lgmodule-2.0
# -ldl -lgthread-2.0 -lrt -lglib-2.0

Desde una alternativa, Perl módulo
utilizar PkgConfig;

my $ o = PkgConfig-> find ('gio');
if ($ o-> errmsg) {
#manejar error
} Else {
my $ prefix = $ o-> get_var ('prefijo');
my @cflags = $ o-> get_cflags;
my @ldflags = $ o-> get_ldflags;
}

DESCRIPCIÓN

"PkgConfig" proporciona un reemplazo de núcleo puro de Perl para la utilidad "pkg-config".

Esta no es una descripción de los usos de "pkg-config", sino más bien una descripción del
diferencias entre la versión C y la de Perl.

Si bien "pkg-config" es un binario compilado vinculado con glib, la versión pure-perl no tiene
tal requisito, y se ejecutará donde sea que lo haga Perl (> = 5.6).

Las principales opciones admitidas son las "--libs", "--cflags", "--static", "--exists" y
"--modversion".

GUIÓN OPCIONES
USO

[--opciones]

ARGUMENTOS

De forma predeterminada, se debe proporcionar un nombre de biblioteca a menos que uno de --version o --real-version sea
especificado.

Normalmente, la salida debería ser adecuada para pasar a su compilador favorito.

--libras

(También) imprime banderas del enlazador. Las dependencias se recorren en orden. Las dependencias de nivel superior
aparecen antes en la línea de comando que las dependencias de nivel inferior.

--libs-solo-L

Imprime -L / -R parte de "--libs". Define la ruta de búsqueda de la biblioteca pero sin bibliotecas para
enlazar con.

--libs-solo-l

Imprime la parte -l de "--libs".

--libs-solo-otros

Imprime la parte de "--libs" no cubierta por "--libs-only-L" y "--libs-only-l", como
"--pthread".

--Listar todo

Enumere todos los paquetes conocidos.

--cflags

(También) imprime los indicadores del compilador y del preprocesador C.

--cflags-solo-yo

Imprime la parte -I de "--cflags"

--cflags-solo-otros

Imprime las partes de "--cflags" no cubiertas por "--cflags-only-I".

--modversión

Imprime la versión de un paquete determinado.

--estático

Utilice bibliotecas y dependencias adicionales si se vincula con una versión estática de la solicitud
bibliotecas

--existe

Devuelve éxito (0) si el paquete existe en la ruta de búsqueda.

--with-path = RUTA

Anteponga "PATH" a la lista de rutas de búsqueda que contienen archivos ".pc".

Esta opción se puede especificar varias veces con diferentes rutas, y todas serán
añadido.

- solo env

Usando esta opción, único Se reconocen las rutas especificadas en "PKG_CONFIG_PATH" y cualquier
los valores predeterminados codificados se ignoran.

- caminos-de-adivinanzas

Invoque "gcc" y "ld" para determinar el vinculador predeterminado e incluir rutas. Las rutas predeterminadas serán
excluido de los indicadores explícitos -L e -I.

--define-variable = VARIABLE = VALOR

Defina una variable, anulando cualquier definición de variable en el archivo .pc y permitiendo
su valor para interpolar con usos posteriores.

--variable = VARIABLE

Esto devuelve el valor de una variable definida en el archivo .pc de un paquete.

--imprimir-variables

Imprima todas las variables definidas que se encuentran en los archivos .pc.

--versión

La versión de destino de "pkg-config" emulada por este script

--versión real

La versión real de este script.

--depurar

Imprimir información de depuración

- errores de silencio

Apague los errores. Este es el valor predeterminado para argumentos que no son libs / cflag / modversion

- errores de impresión

Imprime los errores en STDERR y tiene prioridad sobre "--silence-errors"

- errores cortos

Ignorado, pero reconocido por compatibilidad.

--errores a salida estándar

Imprime los errores en STDOUT y tiene prioridad sobre "--print-errors"

MEDIO AMBIENTE

las variables "PKG_CONFIG_PATH" y "PKG_CONFIG_LIBDIR" se respetan y se utilizan como dos puntos
lista delimitada (delimitada por punto y coma en Windows) de directorios que contienen archivos ".pc".

Otras variables de entorno reconocidas por "pkg-config" y PkgConfig incluyen:

PKG_CONFIG_ALLOW_SYSTEM_CFLAGS
PKG_CONFIG_ALLOW_SYSTEM_LIBS

Si Win32API :: Registry está instalado, en Windows (pero no Cygwin) PkgConfig también
consulte estas claves de registro. Los nombres se ignoran, pero los valores son rutas que contienen
Archivos ".pc".

HKEY_CURRENT_USER \ Software \ pkgconfig \ PKG_CONFIG_PATH
HKEY_LOCAL_MACHINE \ Software \ pkgconfig \ PKG_CONFIG_PATH

El soporte de registro debe considerarse algo experimental, sujeto a cambios en el
futuro, aunque no sin una buena razón. El fundamento de esta advertencia es que este
La función está documentada en varios lugares, pero todavía tengo que encontrar una versión funcional que
implementa esta característica.

MÓDULO OPCIONES
PkgConfig-> buscar

my $ result = PkgConfig-> find ($ libary,% opciones);

Busque una biblioteca y devuelva un objeto de resultado. $ library puede ser un solo nombre de un
biblioteca, o una referencia a una matriz de nombres de bibliotecas

Las opciones tienen la forma de claves y valores hash, y se reconocen las siguientes:

"ruta_de_búsqueda"
"search_path_override"
Anteponer rutas de búsqueda además de las rutas especificadas en $ ENV {PKG_CONFIG_PATH} La
valor es una referencia de matriz.

la variante "_override" ignora los valores predeterminados (como "PKG_CONFIG_PATH").

"ruta de archivo"
Especifica la ruta completa del archivo .pc que desea cargar. No es asi
debe estar en la ruta de búsqueda (aunque cualquier dependencia deberá estar). Útil si
conoce la ruta completa del archivo .pc exacto que desea.

"exclude_cflags"
"exclude_ldflags"
"exclude_cflags_override"
"exclude_ldflags_override"
Algunos archivos ".pc" especifican rutas de búsqueda predeterminadas del compilador y del enlazador, por ejemplo
"-I / usr / include -L / usr / lib". Especificarlos en la línea de comando puede ser problemático ya que
cambia drásticamente el orden de búsqueda.

Las opciones anteriores agregarán o reemplazarán las opciones que están excluidas y
filtrado.

Las opciones de compilador y enlazador excluidas predeterminadas se pueden obtener a través de
@PkgConfig :: DEFAULT_EXCLUDE_LFLAGS y @PkgConfig :: DEFAULT_EXCLUDE_CFLAGS,
respectivamente.

"estático"
También especifique bibliotecas estáticas.

"no_recurse"
No recurra a las dependencias. Esto es útil para realizar comprobaciones de versión.

"VARS"
Defina un hashref de variables para anular cualquier definición de variable dentro del .pc
archivos. Esto es equivalente a la opción de línea de comandos "--define-variable".

Se devuelve un objeto "PkgConfig" y se puede consultar sobre los resultados:

$ o-> errmsg

Un mensaje de error, si lo hubiera. Esta es una cadena e indica un error.

$ o-> pkg_exists

Valor booleano, verdadero si el paquete existe.

$ o-> pkg_version

La versión del paquete

$ o-> get_cflags

$ o-> get_ldflags

Devuelve los indicadores del compilador y del vinculador, respectivamente.

En el contexto de lista, estos métodos devuelven una lista con cada argumento dividido en espacios sin escape.

En el contexto de lista, devuelve una lista de indicadores del compilador y del vinculador, respectivamente.

En contexto escalar, devuelve una cadena de indicadores del compilador y del vinculador con espacios y comillas.
escapó correctamente.

$ o-> get_var ($ nombre)

Obtenga la variable con el nombre de pila.

PkgConfig-> Adivinar

Este es un método de clase y reemplazará el enlazador predeterminado codificado e incluirá rutas
con los descubiertos invocando ld(1) y cpp(1).

Actualmente, esto solo funciona con "ld" suministrados por GCC y "ld" de GNU.

INSTALAR
El "Makefile.PL" que viene con "PkgConfig" puede tomar una o más opciones "--script" para
cambio del nombre del script o scripts que están instalados.

--script ppkg-config
Este es el predeterminado y funciona en todas las plataformas.

--script paquete-config.pl
Esto se instala por defecto en todas las plataformas excepto Windows, donde el .pl puede
confundir el shell y hacer que el script se abra en un editor de texto.

--script paquete-config
Este es el nombre predeterminado del "pkg-config" real, por lo que debe especificar
habilítelo si lo desea.

--script ninguno
No instale ningún script.

Por ejemplo, instale todos los nombres de secuencias de comandos:

% perl Makefile.PL --script ppkg-config --script pkg-config.pl --script pkg-config

Por ejemplo, no instale ningún script:

% perl Makefile.PL --script ninguno

También puede establecer la variable de entorno PERL_PKG_CONFIG_SCRIPTS en la secuencia de comandos deseada
valor (separando cada nombre de secuencia de comandos con una coma ",") para garantizar que las actualizaciones de PkgConfig
hacer lo mismo.

AVISOS
En Strawberry Perl, "ppkg-config" actúa como si Strawberry fuera el sistema. Esto significa que

· Los archivos .pc que se incluyen con Strawberry se buscan de forma predeterminada.

· Los directorios include y lib de Strawberry se utilizan para calcular las listas de exclusión.

A partir de Strawberry 5.20.0.1, PkgConfig se incluye con Strawberry y "pkg-config" es
instalado por defecto (además de "ppkg-config", aunque el alias "ppkg-config" NO es
incluido con la propia fresa).

Para obtener detalles sobre cómo parchear los archivos .pc incluidos con las fresas más antiguas, consulte la
"README.win32" que viene con esta distribución.

LOCO
El orden de las banderas no coincide exactamente con el de "pkg-config". De mi propia
observación, parece que este módulo hace un mejor trabajo, pero podría estar equivocado.

A diferencia de "pkg-config", la función de scripts "--exists" devolverá un valor distinto de cero si un paquete or
falta alguna de sus dependencias. Esto difiere del comportamiento de "pkg-config" que
solo comprobará la definición del paquete en sí (sin dependencias).

Use ppkg-configp en línea usando los servicios de onworks.net