Welcome to Wrap Dev Tools’s documentation!¶
Programs¶
wrapdev-newwrap¶
newwrap.
Initialize a new wrap from an upstream tarball.
Newwrap will download the tarball (with curl) saving it under the
packagecache directory. It will use the filename supplied by the
server, or, if the server doesn’t supply a filename it will use the
end of the url (This is the -O -J
option for curl). After downloading
it will take the sha256 hash of the tarball, and output a wrap file.
Note that this command will fail if the wrap’s tarball or extraction directory already exists
- Todo:
- handle tarballs without a root directory
usage: wrapdev-newwrap [-h] [--wrapdev-tree WRAPDEV_TREE] url wrap_name
-
url
¶
URL of the upstream tarball
-
wrap_name
¶
the name of the wrap, this will be the basename of the generated wrap file
-
-h
,
--help
¶
show this help message and exit
-
--wrapdev-tree
<wrapdev_tree>
¶ Project tree. Should be the root of a meson project
wrapdev-extractpatch¶
extractpatch.
Extract changes to an upstream into a patch directory. For now this works with file (tarball) based wraps only. Additionally this tool will copy the wrap file to upstream.wrap in the destination directory
usage: wrapdev-extractpatch [-h] --output OUTPUT
[--layout {flat,directoryname}]
wrapfile
-
wrapfile
¶
wrap file to extract a patch from
-
-h
,
--help
¶
show this help message and exit
-
--output
<output>
¶ directory in which to output patch
-
--layout
{flat,directoryname}
¶ How to output the patch, flat simply outputs files in the output directory, whereas directoryname will create a directory named as the directory the wrap extracts to
wrapdev-listsrc¶
listsrc.
List sources in a subdirectory matching a pattern, and format them for pasting into a meson build file
usage: wrapdev-listsrc [-h] pattern
-
pattern
¶
the glob pattern to search for
-
-h
,
--help
¶
show this help message and exit
wrapdev-tocmake¶
tocmake.
Take a meson wrap file and emit a cmake snippet using FetchContent. This is designed to make it easier to maintain cmake build systems for projects primaraly using meson, and to ease transition.
Note: This will not do anything with the patch files, it’s assumed that either the upstream uses cmake or you will edit the resulting cmake code to do your own patch handling.
usage: wrapdev-tocmake [-h] wrapfile
-
wrapfile
¶
wrap to generate cmake infomation from
-
-h
,
--help
¶
show this help message and exit