summaryrefslogtreecommitdiff
path: root/src/frontend/cli
diff options
context:
space:
mode:
authorbionel <ionel.busuioc@gmail.com>2020-08-04 14:42:59 +0300
committerbionel <ionel.busuioc@gmail.com>2020-08-04 14:43:50 +0300
commit4c50f315b37b1ebc7905ef0858e6161f6a03724f (patch)
tree9defb11890f5f3027be6b82144661726ef98935c /src/frontend/cli
parent4fc5a53da38955b35b9b48e6ee24acf7b5cf3fdf (diff)
add dbsearch for cli frontend
Diffstat (limited to 'src/frontend/cli')
-rw-r--r--src/frontend/cli/README.md93
-rwxr-xr-xsrc/frontend/cli/sisyphus-cli.py118
2 files changed, 183 insertions, 28 deletions
diff --git a/src/frontend/cli/README.md b/src/frontend/cli/README.md
index 02ac61d..54fc628 100644
--- a/src/frontend/cli/README.md
+++ b/src/frontend/cli/README.md
@@ -60,9 +60,9 @@ The remote can be selected by using the --remote option.
* Examples:
-'branch master --remote=gitlab' will pull the branch 'master' from gitlab.com
+ branch master --remote=gitlab # pull the branch 'master' from gitlab.com
-'branch next --remote=pagure' will pull the branch 'next' from pagure.io
+ branch next --remote=pagure # pull the branch 'next' from pagure.io
!!! WARNING !!!
@@ -70,11 +70,19 @@ Once you changed the branch, you must pair it with the correct binary repository
Branch 'master' must be paired with the stable binary repository (odd numbers in 'sisyphus mirror list').
-* Examples : 'sisyphus mirror set 1' or 'sisyphus mirror set 5'
+* Examples:
+
+ sisyphus mirror set 1
+
+ sisyphus mirror set 5
Branch 'next' must be paired with the testing binary repository (even numbers in 'sisyphus mirror list').
-* Examples : 'sisyphus mirror set 2' or 'sisyphus mirror set 8'
+* Examples:
+
+ sisyphus mirror set 2
+
+ sisyphus mirror set 8
**Usage**:
@@ -95,11 +103,11 @@ Use the --ebuild option to install ebuild(source) packages.
* Examples:
-'sisyphus install pidgin'
+ sisyphus install pidgin
will install pidgin binary package (if available); if there is none, but the ebuild(source) package for pidgin is found, it will stop and suggest the --ebuild option.
-'sisyphus install pidgin --ebuild'
+ sisyphus install pidgin --ebuild
will compile pidgin from source
@@ -185,14 +193,73 @@ $ sisyphus rescue [OPTIONS]
Search for binary and/or ebuild (source) packages.
+By default will search for binary packages, using internal database.
+The search term can be provided also in the category/name format, e.g:
+
+ sisyphus search openbox
+
+ OR
+
+ sisyphus search x11-wm/openbox
+
+Using * and ? wildcards is supported. An empty string will match everything (similar to *).
+
+* Examples:
+
+to search for all packages belonging to a category, use '*' or leave the name empty:
+
+ sisyphus search x11-wm/
+
+ sisyphus search x11-wm/*
+
+In addition, search can be performed by package description, using the -d (--description) option:
+
+ sisyphus search x11/open -d 'window manager'
+
+(use single or double quotes when the description contains spaces)
+
+Use the -s (--state) filters to select only packages of interest. Possible values:
+
+ all (default) - search the entire database
+
+ installed - search in all installed packages
+
+ local - search for installed packages but not available
+ (this filter can match packages installed from e-builds or packages no longer maintained as binaries)
+
+ remote - search for available packages but not installed
+
+ upgrade - search for installed packages where installed version is different from available version
+
+!!! NOTE !!! bash will expand a single * character as current folder listing.
+To search for all '--state' packages escape it, or surround it with quotes, or use an empty string:
+
+ sisyphus search * -s installed # this is not valid!
+
+ sisyphus search \* -s local # OK
+
+ sisyphus search '*' -s remote # OK
+
+ sisyphus search '' -s upgrade # OK
+
+
+To search for all (including source) packages, use the --ebuild option.
+This is slower since will perform an emerge --search actually.
+With this option, more than one package can be provided as search term.
+'-d', '-s' and '-q' (quiet) options are ignored in this mode.
+
**Usage**:
```console
-$ sisyphus search [OPTIONS] PKGNAME...
+$ sisyphus search [OPTIONS] PACKAGE...
```
**Options**:
+* `-d, --description TEXT`: Match description.
+* `-s, --state [all|installed|local|remote|upgrade]`: [default: all]
+* `-q`: Short (one line) output.
+* `-e, --ebuild`: Search in ebuilds (slower).
* `--help`: Show this message and exit.
## `sisyphus spmsync`
@@ -234,11 +301,11 @@ This will not allways be possible, as the reverse dependency chain may be way to
* Examples:
-'sisyphus uninstall firefox'
+ sisyphus uninstall firefox
will succeed, nothing depends on it
-'sisyphus uninstall pulseaudio'
+ sisyphus uninstall pulseaudio
will fail, many packages depend on it
@@ -249,11 +316,11 @@ Upgrading the system may pull the packages back in, to fix the reverse dependenc
* Examples :
-'sisyphus uninstall pulseaudio --force'
+ sisyphus uninstall pulseaudio --force
will succeed, but you may no longer have audio
-'sisyphus uninstall openrc --force'
+ sisyphus uninstall openrc --force
will succeed, but the system will be broken
@@ -291,11 +358,11 @@ Use the --ebuild option to upgrade **EVERYTHING**, binary and/or ebuild(source)
* Examples:
-'sisyphus upgrade'
+ sisyphus upgrade
will upgrade the system using binary packages; if any ebuild(source) package upgrade is detected, it will stop and suggest the --ebuild option
-'sisyphus upgrade --ebuild'
+ sisyphus upgrade --ebuild
will upgrade the system using both binary and/or ebuild(source) packages
diff --git a/src/frontend/cli/sisyphus-cli.py b/src/frontend/cli/sisyphus-cli.py
index 0be7b45..e5eb999 100755
--- a/src/frontend/cli/sisyphus-cli.py
+++ b/src/frontend/cli/sisyphus-cli.py
@@ -20,10 +20,90 @@ def app_callback(ctx: typer.Context):
"""
ctx.info_name = 'sisyphus'
+class State(str, Enum):
+ all = 'all'
+ installed = 'installed'
+ local = 'local'
+ remote = 'remote'
+ upgrade = 'upgrade'
+
+def state_completion():
+ return ["all", "installed", "local", "remote", "upgrade"]
+
@app.command("search")
-def search(pkgname: List[str]):
- """Search for binary and/or ebuild (source) packages."""
- sisyphus.search.start(pkgname)
+def search(package: List[str] = typer.Argument(...),
+ desc: str = typer.Option('', '--description', '-d', help = 'Match description.'),
+ state: State = typer.Option(State.all, '--state', '-s', show_default=True, autocompletion=state_completion),
+ quiet: bool = typer.Option(False, '-q', help='Short (one line) output.'),
+ ebuild: bool = typer.Option(False, "--ebuild", "-e", help = 'Search in ebuilds (slower).')):
+ """Search for binary and/or ebuild (source) packages.
+
+ By default will search for binary packages, using internal database.
+ The search term can be provided also in the category/name format, e.g:
+
+ sisyphus search openbox
+
+ OR
+
+ sisyphus search x11-wm/openbox
+
+ Using * and ? wildcards is supported. An empty string will match everything (similar to *).
+
+ * Examples:
+
+ to search for all packages belonging to a category, use '*' or leave the name empty:
+
+ sisyphus search x11-wm/
+
+ sisyphus search x11-wm/*
+
+ In addition, search can be performed by package description, using the -d (--description) option:
+
+ sisyphus search x11/open -d 'window manager'
+
+ (use single or double quotes when the description contains spaces)
+
+ Use the -s (--state) filters to select only packages of interest. Possible values:
+
+ all (default) - search the entire database
+
+ installed - search in all installed packages
+
+ local - search for installed packages but not available
+ (this filter can match packages installed from e-builds or packages no longer maintained as binaries)
+
+ remote - search for available packages but not installed
+
+ upgrade - search for installed packages where installed version is different from available version
+
+ !!! NOTE !!! bash will expand a single * character as current folder listing.
+ To search for all '--state' packages escape it, or surround it with quotes, or use an empty string:
+
+ sisyphus search * -s installed # this is not valid!
+
+ sisyphus search \* -s local # OK
+
+ sisyphus search '*' -s remote # OK
+
+ sisyphus search '' -s upgrade # OK
+
+
+ To search for all (including source) packages, use the --ebuild option.
+ This is slower since will perform an emerge --search actually.
+ With this option, more than one package can be provided as search term.
+ '-d', '-s' and '-q' (quiet) options are ignored in this mode.
+ """
+ if not ebuild:
+ if '/' in package[0]:
+ cat, pn = package[0].split('/')
+ else:
+ cat, pn = '', package[0]
+ sisyphus.dbsearch.showSearch(state.value, cat, pn, desc, quiet)
+ else:
+ if not package:
+ raise typer.Exit('No search term provided, try: sisyphus search --help')
+ else:
+ sisyphus.search.start(package)
@app.command("install")
def install(pkgname: List[str], ebuild: bool = typer.Option(False, "--ebuild", "-e")):
@@ -33,11 +113,11 @@ def install(pkgname: List[str], ebuild: bool = typer.Option(False, "--ebuild", "
* Examples:
- 'sisyphus install pidgin'
+ sisyphus install pidgin
will install pidgin binary package (if available); if there is none, but the ebuild(source) package for pidgin is found, it will stop and suggest the --ebuild option.
- 'sisyphus install pidgin --ebuild'
+ sisyphus install pidgin --ebuild
will compile pidgin from source
@@ -58,11 +138,11 @@ def uninstall(pkgname: List[str], force: bool = typer.Option(False, "--force", "
* Examples:
- 'sisyphus uninstall firefox'
+ sisyphus uninstall firefox
will succeed, nothing depends on it
- 'sisyphus uninstall pulseaudio'
+ sisyphus uninstall pulseaudio
will fail, many packages depend on it
@@ -73,11 +153,11 @@ def uninstall(pkgname: List[str], force: bool = typer.Option(False, "--force", "
* Examples :
- 'sisyphus uninstall pulseaudio --force'
+ sisyphus uninstall pulseaudio --force
will succeed, but you may no longer have audio
- 'sisyphus uninstall openrc --force'
+ sisyphus uninstall openrc --force
will succeed, but the system will be broken
"""
@@ -109,11 +189,11 @@ def upgrade(ebuild: bool = typer.Option(False, "--ebuild", "-e")):
* Examples:
- 'sisyphus upgrade'
+ sisyphus upgrade
will upgrade the system using binary packages; if any ebuild(source) package upgrade is detected, it will stop and suggest the --ebuild option
- 'sisyphus upgrade --ebuild'
+ sisyphus upgrade --ebuild
will upgrade the system using both binary and/or ebuild(source) packages
@@ -161,9 +241,9 @@ def branch(branch: Branch = typer.Argument(...), remote: Remote = typer.Option(R
* Examples:
- 'branch master --remote=gitlab' will pull the branch 'master' from gitlab.com
+ branch master --remote=gitlab # pull the branch 'master' from gitlab.com
- 'branch next --remote=pagure' will pull the branch 'next' from pagure.io
+ branch next --remote=pagure # pull the branch 'next' from pagure.io
!!! WARNING !!!
@@ -171,11 +251,19 @@ def branch(branch: Branch = typer.Argument(...), remote: Remote = typer.Option(R
Branch 'master' must be paired with the stable binary repository (odd numbers in 'sisyphus mirror list').
- * Examples : 'sisyphus mirror set 1' or 'sisyphus mirror set 5'
+ * Examples:
+
+ sisyphus mirror set 1
+
+ sisyphus mirror set 5
Branch 'next' must be paired with the testing binary repository (even numbers in 'sisyphus mirror list').
- * Examples : 'sisyphus mirror set 2' or 'sisyphus mirror set 8'
+ * Examples:
+
+ sisyphus mirror set 2
+
+ sisyphus mirror set 8
"""
sisyphus.branchsetup.start(branch.value, remote.value)