Fabio Valentini
63acdf63c4
Using .rust2rpm.conf is confusing to new users, because they never see these files in existing packages and are only seeing magic happen. This commit changes the default location of the configuration file to ./rust2rpm.conf, and will rename existing .rust2rpm.conf or _rust2rpm.conf files to the new name if they already exist. I have also added a little more documentation about the config file itself to the README. |
||
---|---|---|
data | ||
rust2rpm | ||
tools | ||
.gitignore | ||
LICENSE | ||
MANIFEST.in | ||
NEWS | ||
README.md | ||
requirements.txt | ||
setup.py | ||
test.py | ||
tox.ini |
rust2rpm
rust2rpm is a tool for automatically generating RPM spec files for Rust crates.
rust2rpm.conf
If it is present, a rust2rpm.conf
configuration file is read
by rust2rpm to override some aspects of the automatic spec file generation.
This file can be committed to dist-git to ensure that these settings will be applied for future updates of a crate package, as well.
The file follows a slightly modified ini
syntax. It supports sections for
default settings ([DEFAULT]
) and target-specific settings (i.e. [fedora]
).
These configuration options are available right now:
unwanted-features
: features or optional dependencies for which no+feature
subpackage should be generated (for example, dependencies on Rust compiler internals for crates that are also bundled with Rust itself)buildrequires
: additional build dependencies that must be installed for the package to build correctly (i.e.,pkgconfig(foo)
for thefoo-sys
crate)lib.requires
: additional build dependencies that must be installed for the crate to build correctly as a dependency of another crate (usually, this contains the same values as thebuildrequires
option)lib+foo.requires
: additional build dependencies that must be installed for the crate to build correctly as a dependency of another crate if it has enabled the optionalfoo
featurebin.requires
: additional runtime dependencies of the binary application that is built from this crate
[DEFAULT]
unwanted-features =
compiler_builtins
rustc-dep-of-std
buildrequires =
pkgconfig(foo) >= 1.2.3
lib.requires =
pkgconfig(foo) >= 1.2.3
[fedora]
bin.requires =
findutils
buildrequires =
lib.requires =
lib+default.requires =
pkgconfig(bar) >= 2.0.0
Note that features and optional dependencies that are marked as
unwanted-features
must not be dependencies of other Cargo features that are
not marked "unwanted" as well. Failing to consider transitive dependencies will
lead to broken dependencies of generated rust-foo+bar-devel
packages and / or
errors when generating spec files with rust2rpm.