# livecheck
[](https://github.com/Tatsh/livecheck/actions/workflows/qa.yml)
[](https://github.com/Tatsh/livecheck/actions/workflows/tests.yml)
[](https://coveralls.io/github/Tatsh/livecheck?branch=master)
[](https://livecheck.readthedocs.io/en/latest/?badge=latest)
Tool for overlays to update ebuilds. Inspired by the MacPorts `port` subcommand of the same name.
## Installation
On Gentoo, add my overlay and install:
```shell
eselect overlay enable tatsh-overlay
emerge --sync
emerge livecheck
```
## Command line usage
```plain
Usage: livecheck [OPTIONS] [PACKAGE_NAMES]...
Options:
-a, --auto-update Rename and modify ebuilds.
-d, --debug Enable debug logging.
-e, --exclude TEXT Exclude package(s) from updates.
-W, --working-dir DIRECTORY Working directory. Should be a port tree root.
--help Show this message and exit.
```
## Heuristic update detection
This package can do automated lookups based on commonly used hosts. Currently:
- GitHub archives
- GitHub commit hashes
- GitHub releases
- JetBrains products
- PyPI
This works as long as the version system is usable with Portage's version
comparison function. For anything else, see [Package configuration](#package-configuration).
## Package configuration
For packages that will not work with currently heuristic checking, a configuration file named
`livecheck.json` can be placed in the directory alongside the ebuild.
### Configuration keys
- `type` - `none`, `regex`, or `checksum`
- `branch` - The GitHub branch name to use for commits
- `no_auto_update` - boolean - Do not allow auto-updating of this package
- `regex` - The regular expression to use
- `semver` - When set to `false`, do not allow detection of semantic versioning
- `transformation_function` - string - Function to use to transform the version string. Currently
only `dotize` is supported. Others are for internal use.
- `url` - URL of the document to run regular expressions against
- `use_vercmp` - boolean - if `vercmp` from Portage should be used. Default: `true`.
## Development use
### Set up PYTHONPATH
As root, set the environment variable `PYTHONPATH` to include where the `livecheck` module is
located. Use `python -m livecheck` instead of `livecheck` to execute commands.
### With a virtualenv
Run `poetry install --all-extras --with=dev,docs,tests` to set up a virtualenv.
Fully copy `/etc/portage` to the root of your virtualenv. Then you must fix `make.profile`. Also
consider making changes in `repos.conf` if necessary.
Example:
```shell
poetry shell
cd "${VIRTUAL_ENV}/etc"
cp -R /etc/portage .
cd portage
ln -sf "$(readlink -f /etc/portage/make.profile)" make.profile
```
Raw data
{
"_id": null,
"home_page": "https://github.com/Tatsh/livecheck",
"name": "portage-livecheck",
"maintainer": null,
"docs_url": null,
"requires_python": "<4,>=3.11",
"maintainer_email": null,
"keywords": "command line, ebuild, gentoo, portage",
"author": "Andrew Udvare",
"author_email": "audvare@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/63/fc/534f7a80db385f00ef42d83764ce0642b66153f540fd966ca8d5f036f4b3/portage_livecheck-0.0.13.tar.gz",
"platform": null,
"description": "# livecheck\n\n[](https://github.com/Tatsh/livecheck/actions/workflows/qa.yml)\n[](https://github.com/Tatsh/livecheck/actions/workflows/tests.yml)\n[](https://coveralls.io/github/Tatsh/livecheck?branch=master)\n[](https://livecheck.readthedocs.io/en/latest/?badge=latest)\n\n\n\n\n\nTool for overlays to update ebuilds. Inspired by the MacPorts `port` subcommand of the same name.\n\n## Installation\n\nOn Gentoo, add my overlay and install:\n\n```shell\neselect overlay enable tatsh-overlay\nemerge --sync\nemerge livecheck\n```\n\n## Command line usage\n\n```plain\nUsage: livecheck [OPTIONS] [PACKAGE_NAMES]...\n\nOptions:\n -a, --auto-update Rename and modify ebuilds.\n -d, --debug Enable debug logging.\n -e, --exclude TEXT Exclude package(s) from updates.\n -W, --working-dir DIRECTORY Working directory. Should be a port tree root.\n --help Show this message and exit.\n```\n\n## Heuristic update detection\n\nThis package can do automated lookups based on commonly used hosts. Currently:\n\n- GitHub archives\n- GitHub commit hashes\n- GitHub releases\n- JetBrains products\n- PyPI\n\nThis works as long as the version system is usable with Portage's version\ncomparison function. For anything else, see [Package configuration](#package-configuration).\n\n## Package configuration\n\nFor packages that will not work with currently heuristic checking, a configuration file named\n`livecheck.json` can be placed in the directory alongside the ebuild.\n\n### Configuration keys\n\n- `type` - `none`, `regex`, or `checksum`\n- `branch` - The GitHub branch name to use for commits\n- `no_auto_update` - boolean - Do not allow auto-updating of this package\n- `regex` - The regular expression to use\n- `semver` - When set to `false`, do not allow detection of semantic versioning\n- `transformation_function` - string - Function to use to transform the version string. Currently\n only `dotize` is supported. Others are for internal use.\n- `url` - URL of the document to run regular expressions against\n- `use_vercmp` - boolean - if `vercmp` from Portage should be used. Default: `true`.\n\n## Development use\n\n### Set up PYTHONPATH\n\nAs root, set the environment variable `PYTHONPATH` to include where the `livecheck` module is\nlocated. Use `python -m livecheck` instead of `livecheck` to execute commands.\n\n### With a virtualenv\n\nRun `poetry install --all-extras --with=dev,docs,tests` to set up a virtualenv.\n\nFully copy `/etc/portage` to the root of your virtualenv. Then you must fix `make.profile`. Also\nconsider making changes in `repos.conf` if necessary.\n\nExample:\n\n```shell\npoetry shell\ncd \"${VIRTUAL_ENV}/etc\"\ncp -R /etc/portage .\ncd portage\nln -sf \"$(readlink -f /etc/portage/make.profile)\" make.profile\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Tool to update ebuilds.",
"version": "0.0.13",
"project_urls": {
"Documentation": "https://livecheck.readthedocs.io/",
"Homepage": "https://github.com/Tatsh/livecheck",
"Repository": "https://github.com/Tatsh/livecheck"
},
"split_keywords": [
"command line",
" ebuild",
" gentoo",
" portage"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "04900c53f428f230ceebc0d701c354878128b47fbb3cf578c890b74810866cb9",
"md5": "c2e197befac34e11198db1a542d4df8b",
"sha256": "1eeb9fc5a288816c585da172f91bce2d932a5e3ab54fed515d828c77caa81530"
},
"downloads": -1,
"filename": "portage_livecheck-0.0.13-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c2e197befac34e11198db1a542d4df8b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4,>=3.11",
"size": 22175,
"upload_time": "2024-07-07T15:36:41",
"upload_time_iso_8601": "2024-07-07T15:36:41.488988Z",
"url": "https://files.pythonhosted.org/packages/04/90/0c53f428f230ceebc0d701c354878128b47fbb3cf578c890b74810866cb9/portage_livecheck-0.0.13-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "63fc534f7a80db385f00ef42d83764ce0642b66153f540fd966ca8d5f036f4b3",
"md5": "fcf8bfae97f6fdc385a152bc0ec6ea9d",
"sha256": "871c8af0f699345f5f8f1f1edc8e7d6884090656651ae9fa316c6cb7a90f759c"
},
"downloads": -1,
"filename": "portage_livecheck-0.0.13.tar.gz",
"has_sig": false,
"md5_digest": "fcf8bfae97f6fdc385a152bc0ec6ea9d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4,>=3.11",
"size": 21332,
"upload_time": "2024-07-07T15:36:43",
"upload_time_iso_8601": "2024-07-07T15:36:43.060802Z",
"url": "https://files.pythonhosted.org/packages/63/fc/534f7a80db385f00ef42d83764ce0642b66153f540fd966ca8d5f036f4b3/portage_livecheck-0.0.13.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-07 15:36:43",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Tatsh",
"github_project": "livecheck",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "portage-livecheck"
}
JSON
