# rpmlint
<h1 align="center">
<img src="rpmlint.svg" width="200">
</h1>
[](https://github.com/rpm-software-management/rpmlint/actions/workflows/main.yml)
[](https://github.com/rpm-software-management/rpmlint/actions/workflows/main.yml)
[](https://build.opensuse.org/package/show/devel:openSUSE:Factory:rpmlint/rpmlint)
[](https://repology.org/project/rpmlint/versions)
[](https://coveralls.io/github/rpm-software-management/rpmlint)
`rpmlint` is a tool for checking common errors in RPM packages.
`rpmlint` can be used to test individual packages before uploading or to check
an entire distribution.
`rpmlint` can check binary RPMs, source RPMs, and plain specfiles, but all
checks do not apply to all argument types.
For best check coverage, run `rpmlint` on source RPMs instead of
plain specfiles.
The idea for `rpmlint` is from the lintian tool of the Debian project.
All the checks reside in `rpmlint/checks` folder. Feel free to provide new
checks and suggestions at:
https://github.com/rpm-software-management/rpmlint
## Install
For installation on your machine you will need the following packages:
Mandatory:
- Python 3.8 or newer
- python3-setuptools, python3-tomli (for `python3 < 3.11`), python3-tomli-w,
python3-pyxdg, python3-pybeam
- rpm and its python bindings
- binutils, cpio, gzip, bzip, xz and zstd
Optional, for running the test suite:
- devscripts
- dash
- a 32-bit glibc if on a 64-bit architecture
- desktop-file-utils
- libmagic and its python bindings
- enchant and its python bindings, along with en_US and cs_CZ dictionaries
- appstream-util, part of appstream-glib
`rpmlint` is part of most distributions and as an user you can simply
dnf install rpmlint
## Testing
You will need to have all the required modules as listed on the Install section above.
You will also need `pytest`,`pytest-cov` and `pytest-xdist`,
which you can install individually or by running:
pip install -e ".[test]"
If all the dependencies are present you can just execute tests using:
python3 -m pytest
Or even pick one of the tests using `pytest`:
python3 -m pytest test/test_config.py
## Bugfixing and contributing
Any help is, of course, welcome but honestly most probable cause for your visit
here is that `rpmlint` is marking something as invalid while it shouldn't or
it is marking something as correct while it should not either :)
Now there is an easy way how to fix that. Our testsuite simply needs an
extension to take the above problem into the account.
Primarily we just need the offending rpm file (best the smallest you can
find or we would soon take few GB to take a checkout) and some basic
expectation of what should happen.
### Building the installable rpm and installing
This section focuses on how to build the tool as you develop it.
To build the tool, we'll use a tool called `packit`. First, install `packit` on your system:
dnf install packit
Then, build the project using:
packit build locally
If you encounter any errors, install the missing dependencies and run the same command again. Once the build is successful, you'll find a RPM file under the `noarch` directory. To install the package on your system, run:
dnf install <the_rpm_you_just_built>
Alternatively, the built binary can be found in the `rpmlint` directory under the `.packit` directory, which you can run directly.
### Example workflow for testing a functionality
1) I have rpmfile that should report unreadable zip file
2) I store this file in git under `test/binary/texlive-codepage-doc-2018.151.svn21126-38.1.noarch.rpm`
3) Now I need to figure out what `check` should test this, in this case `test_zip.py`
4) For the testing I will have to devise a small function that validates my expectations:
```
@pytest.mark.parametrize('package', ['binary/texlive-codepage-doc'])
def test_zip2(tmpdir, package, zipcheck):
output, test = zipcheck
test.check(get_tested_package(package, tmpdir))
out = output.print_results(output.results)
assert 'W: unable-to-read-zip' in out
```
As you can see it is not so hard and with each added test we get better
coverage on what is really expected from rpmlint and avoid naughty regressions
in the long run.
Preferable approach for binary packages is to create artificial testcase (to keep binaries small and trivial).
We are currently using OBS to produce binaries:
https://build.opensuse.org/project/show/devel:openSUSE:Factory:rpmlint:tests
For a sample package see:
https://build.opensuse.org/package/show/devel:openSUSE:Factory:rpmlint:tests/non-position-independent-exec
## Configuration
If you want to change configuration options or the list of checks you can
use the following locations:
`/etc/xdg/rpmlint/*toml`
`$XDG_CONFIG_HOME/rpmlint/*toml`
The configuration itself is a `toml` file where for some basic inspiration
you can check up [`rpmlint/configdefaults.toml`](rpmlint/configdefaults.toml) which specifies format/defaults.
One can also include additional configuration files (or directories) by using the `--config` option.
Note that all TOML configuration values are merged and not overridden.
So e.g. values in a list are concatenated. If you need an override,
use `*.override.*toml` configuration file, where all defined values are selected as default.
Additional option to control `rpmlint` behaviour is the addition of `rpmlintrc` file
which uses old syntax for compatibility with old `rpmlint` releases, yet
it can be normal `toml` file if you wish:
setBadness('check', 0)
addFilter('test-i-ignore')
The location of `rpmlintrc` can be set using `--rpmlintrc` option.
Or it can load any `*.rpmlintrc` or `*-rpmlintrc` that are located in the same
folder as check RPM file (or a specfile). Note the auto-loading happens only
when one RPM file (or a specfile) is used.
The best practice is to store the name in `$PACKAGE_NAME.rpmlintrc`.
`setBadness` overrides a default badness for a given check and `addFilter` ignores all errors
that match the given regular expression (one cannot filter out errors that are listed in `BlockedFilters`
in a configuration file).
Raw data
{
"_id": null,
"home_page": null,
"name": "rpmlint",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": "RPMLint maintainers <rpm-ecosystem@lists.rpm.org>",
"keywords": "RPM, .spec, validator",
"author": null,
"author_email": "Fr\u00e9d\u00e9ric Lepied <flepied@mandriva.com>",
"download_url": "https://files.pythonhosted.org/packages/71/77/1c5574d8501a73881f99fcce6e0981fd75fc01486cd92ace52b024961b03/rpmlint-2.6.1.tar.gz",
"platform": "Linux",
"description": "# rpmlint\n\n<h1 align=\"center\">\n <img src=\"rpmlint.svg\" width=\"200\">\n</h1>\n\n[](https://github.com/rpm-software-management/rpmlint/actions/workflows/main.yml)\n[](https://github.com/rpm-software-management/rpmlint/actions/workflows/main.yml)\n[](https://build.opensuse.org/package/show/devel:openSUSE:Factory:rpmlint/rpmlint)\n[](https://repology.org/project/rpmlint/versions)\n[](https://coveralls.io/github/rpm-software-management/rpmlint)\n\n`rpmlint` is a tool for checking common errors in RPM packages.\n`rpmlint` can be used to test individual packages before uploading or to check\nan entire distribution.\n\n`rpmlint` can check binary RPMs, source RPMs, and plain specfiles, but all\nchecks do not apply to all argument types.\nFor best check coverage, run `rpmlint` on source RPMs instead of\nplain specfiles.\n\nThe idea for `rpmlint` is from the lintian tool of the Debian project.\nAll the checks reside in `rpmlint/checks` folder. Feel free to provide new\nchecks and suggestions at:\n\nhttps://github.com/rpm-software-management/rpmlint\n\n## Install\n\nFor installation on your machine you will need the following packages:\n\nMandatory:\n- Python 3.8 or newer\n- python3-setuptools, python3-tomli (for `python3 < 3.11`), python3-tomli-w,\n python3-pyxdg, python3-pybeam\n- rpm and its python bindings\n- binutils, cpio, gzip, bzip, xz and zstd\n\nOptional, for running the test suite:\n- devscripts\n- dash\n- a 32-bit glibc if on a 64-bit architecture\n- desktop-file-utils\n- libmagic and its python bindings\n- enchant and its python bindings, along with en_US and cs_CZ dictionaries\n- appstream-util, part of appstream-glib\n\n`rpmlint` is part of most distributions and as an user you can simply\n\n dnf install rpmlint\n\n## Testing\n\nYou will need to have all the required modules as listed on the Install section above.\nYou will also need `pytest`,`pytest-cov` and `pytest-xdist`, \nwhich you can install individually or by running:\n\n pip install -e \".[test]\"\n\nIf all the dependencies are present you can just execute tests using:\n\n python3 -m pytest\n\nOr even pick one of the tests using `pytest`:\n\n python3 -m pytest test/test_config.py\n\n## Bugfixing and contributing\n\nAny help is, of course, welcome but honestly most probable cause for your visit\nhere is that `rpmlint` is marking something as invalid while it shouldn't or\nit is marking something as correct while it should not either :)\n\nNow there is an easy way how to fix that. Our testsuite simply needs an\nextension to take the above problem into the account.\n\nPrimarily we just need the offending rpm file (best the smallest you can\nfind or we would soon take few GB to take a checkout) and some basic\nexpectation of what should happen.\n\n### Building the installable rpm and installing\nThis section focuses on how to build the tool as you develop it.\n\nTo build the tool, we'll use a tool called `packit`. First, install `packit` on your system:\n\n dnf install packit\n\nThen, build the project using:\n\n packit build locally\n\nIf you encounter any errors, install the missing dependencies and run the same command again. Once the build is successful, you'll find a RPM file under the `noarch` directory. To install the package on your system, run:\n\n dnf install <the_rpm_you_just_built>\n\nAlternatively, the built binary can be found in the `rpmlint` directory under the `.packit` directory, which you can run directly.\n\n### Example workflow for testing a functionality\n\n1) I have rpmfile that should report unreadable zip file\n2) I store this file in git under `test/binary/texlive-codepage-doc-2018.151.svn21126-38.1.noarch.rpm`\n3) Now I need to figure out what `check` should test this, in this case `test_zip.py`\n4) For the testing I will have to devise a small function that validates my expectations:\n\n```\n@pytest.mark.parametrize('package', ['binary/texlive-codepage-doc'])\ndef test_zip2(tmpdir, package, zipcheck):\n output, test = zipcheck\n test.check(get_tested_package(package, tmpdir))\n out = output.print_results(output.results)\n assert 'W: unable-to-read-zip' in out\n```\n\nAs you can see it is not so hard and with each added test we get better\ncoverage on what is really expected from rpmlint and avoid naughty regressions\nin the long run.\n\nPreferable approach for binary packages is to create artificial testcase (to keep binaries small and trivial).\nWe are currently using OBS to produce binaries:\nhttps://build.opensuse.org/project/show/devel:openSUSE:Factory:rpmlint:tests\n\nFor a sample package see:\nhttps://build.opensuse.org/package/show/devel:openSUSE:Factory:rpmlint:tests/non-position-independent-exec\n\n## Configuration\n\nIf you want to change configuration options or the list of checks you can\nuse the following locations:\n\n`/etc/xdg/rpmlint/*toml`\n\n`$XDG_CONFIG_HOME/rpmlint/*toml`\n\nThe configuration itself is a `toml` file where for some basic inspiration\nyou can check up [`rpmlint/configdefaults.toml`](rpmlint/configdefaults.toml) which specifies format/defaults.\n\nOne can also include additional configuration files (or directories) by using the `--config` option.\nNote that all TOML configuration values are merged and not overridden.\nSo e.g. values in a list are concatenated. If you need an override,\nuse `*.override.*toml` configuration file, where all defined values are selected as default.\n\nAdditional option to control `rpmlint` behaviour is the addition of `rpmlintrc` file\nwhich uses old syntax for compatibility with old `rpmlint` releases, yet\nit can be normal `toml` file if you wish:\n\n setBadness('check', 0)\n addFilter('test-i-ignore')\n\nThe location of `rpmlintrc` can be set using `--rpmlintrc` option.\nOr it can load any `*.rpmlintrc` or `*-rpmlintrc` that are located in the same\nfolder as check RPM file (or a specfile). Note the auto-loading happens only\nwhen one RPM file (or a specfile) is used.\nThe best practice is to store the name in `$PACKAGE_NAME.rpmlintrc`.\n\n`setBadness` overrides a default badness for a given check and `addFilter` ignores all errors\nthat match the given regular expression (one cannot filter out errors that are listed in `BlockedFilters`\nin a configuration file).\n",
"bugtrack_url": null,
"license": "License :: OSI Approved :: GNU General Public License v2 or later (GPLv2+)",
"summary": "Check for common errors in RPM packages",
"version": "2.6.1",
"project_urls": {
"download-url": "https://github.com/rpm-software-management/rpmlint",
"homepage": "https://github.com/rpm-software-management/rpmlint"
},
"split_keywords": [
"rpm",
" .spec",
" validator"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "71771c5574d8501a73881f99fcce6e0981fd75fc01486cd92ace52b024961b03",
"md5": "8f4c96da8277b4940c7cbfbe9ca9a53d",
"sha256": "e8744b0f330361c124334e92bd3b0a2f8cdc3b3e76868dde4c0876fac070ad85"
},
"downloads": -1,
"filename": "rpmlint-2.6.1.tar.gz",
"has_sig": false,
"md5_digest": "8f4c96da8277b4940c7cbfbe9ca9a53d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 6774969,
"upload_time": "2024-08-02T06:26:26",
"upload_time_iso_8601": "2024-08-02T06:26:26.000111Z",
"url": "https://files.pythonhosted.org/packages/71/77/1c5574d8501a73881f99fcce6e0981fd75fc01486cd92ace52b024961b03/rpmlint-2.6.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-02 06:26:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "rpm-software-management",
"github_project": "rpmlint",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "rpmlint"
}
JSON
