summaryrefslogtreecommitdiff
path: root/src/frontend/cli/sisyphus-cli.py
blob: 76a8cb205ea88c15aa692a9a8db5eea865d1f8d3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
#!/usr/bin/python3

import sisyphus
import typer
from typing import List
from enum import Enum
import sys

app = typer.Typer()
mirrorSetup = typer.Typer()
app.add_typer(mirrorSetup, name="mirror", help='List/Set the active binhost (binary repository) mirror.')

@app.callback()
def app_callback(ctx: typer.Context):
    """Sisyphus is a simple python wrapper around portage, gentoolkit, and portage-utils
    which provides an apt-get/yum-alike interface to these commands,
    to assist newcomer people transitioning from Debian/RedHat-based systems to Gentoo.

    Use 'sisyphus COMMAND --help' for detailed usage.
    """
    ctx.info_name = 'sisyphus'

class Filter(str, Enum):
    all = 'all'
    alien = 'alien'
    installed = 'installed'
    available = 'available'
    upgradable = 'upgradable'

@app.command("search")
def search(package: List[str] = typer.Argument(...),
           desc: str = typer.Option('', '--description', '-d', help = 'Match description.'),
           filter: Filter = typer.Option(Filter.all, '--filter', '-f', show_default=True),
           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 -f (--filter) option to select only packages of interest. Possible values:

        all (default) - search the entire database

        alien - search for installed packages but not available
        (this filter can match packages installed from e-builds or packages no longer maintained as binaries)

        installed - search in all installed packages

        available - search for available packages but not installed

        upgradable - 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 matching '--filter' packages escape it, or surround it with quotes, or use an empty string:

        sisyphus search * -f installed          # this is not valid!

        sisyphus search \* -f alien             # OK

        sisyphus search '*' -f available        # OK

        sisyphus search '' -f upgradable       # 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', '-f' 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.search.start(filter.value, cat, pn, desc, quiet)
    else:
        if not package:
            raise typer.Exit('No search term provided, try: sisyphus search --help')
        else:
            sisyphus.search.estart(package)

@app.command("install")
def install(pkgname: List[str],
            ebuild: bool = typer.Option(False, "--ebuild", "-e", help = 'Search in ebuilds (slower)'),
            oneshot: bool = typer.Option(False, "--oneshot", "-1", help= 'Do not add package to world set')):
    """Install binary and/or ebuild(source) packages.
    By default, only binary packages will be installed.
    Use the --ebuild option to install ebuild(source) packages.

    * Examples:

        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

    will compile pidgin from source

    The --ebuild option will preffer to reuse binary packages(if available) to satisfy the dependencies for the ebuild(source) package, speeding up the installation.
    You can use the --ebuild option even if you don't want to install any ebuild(source) packages; It will fall back to binary packages only.

    The --oneshot option will install the packages as described above, however it will not add them to the 'world' set, which means they will not be marked as
    explicitly installed. As a result, they will be treated as orphans and they will be uninstalled with 'sisyphus autoremove' if no other package needs them as
    a depencency, unless they are explicitly added to the 'world' set using 'emerge --noreplace pkgname'. The --oneshot option does not require any confirmation,
    and packages will be installed straight away.
    """
    if ebuild:
        sisyphus.install.start(pkgname, ebuild=True, gfx_ui=False, oneshot=oneshot)
    else:
        sisyphus.install.start(pkgname, ebuild=False, gfx_ui=False, oneshot=oneshot)

@app.command("uninstall")
def uninstall(pkgname: List[str], force: bool = typer.Option(False, "--force", "-f")):
    """Uninstall packages *SAFELY* by checking for reverse dependencies.
    If reverse dependencies exist, the package(s) will NOT be uninstalled to prevent the possible breakage of the system.
    If you really want to uninstall the package, make sure you uninstall all reverse dependencies as well.
    This will not allways be possible, as the reverse dependency chain may be way to long and require you to uninstall critical system packages.

    * Examples:

        sisyphus uninstall firefox

    will succeed, nothing depends on it

        sisyphus uninstall pulseaudio

    will fail, many packages depend on it

    With --force option, packages are uninstalled *UNSAFELY* by ignoring reverse dependencies.
    This may break your system if you uninstall critical packages.
    It will try the best it can to preserve the libraries required by other packages to prevent such a breakage.
    Upgrading the system may pull the packages back in, to fix the reverse dependency chain.

    * Examples :

        sisyphus uninstall pulseaudio --force

    will succeed, but you may no longer have audio

        sisyphus uninstall openrc --force

    will succeed, but the system will be broken
    """
    if not force:
        sisyphus.uninstall.start(pkgname, depclean=True, gfx_ui=False, unmerge=False)
    else:
        sisyphus.uninstall.start(pkgname, depclean=False, gfx_ui=False, unmerge=True)

@app.command("autoremove")
def autoremove():
    """Uninstall packages that are no longer needed.
    When you uninstall a package without it's reverse dependencies, those dependencies will become orphans if nothing else requires them.
    In addition, a package may no longer depend on another one, so that other package becomes orphan as well if nothing else requires it.
    Use this option to check the whole dependency chain for such packages, and uninstall them.
    """
    sisyphus.autoremove.start(gfx_ui=False)

@app.command("autoclean")
def autoclean():
    """Clean the binary package cache and the source tarball cache"""
    if sisyphus.checkenv.root():
        sisyphus.purgeenv.cache()
    else:
        sys.exit("\nYou need root permissions to do this, exiting!\n")

@app.command("update")
def update():
    """Update the Portage tree, the Redcore Overlay(s), Portage configs and Sisyphus's package database."""
    if sisyphus.checkenv.root():
        sisyphus.update.start(gfx_ui=False)
    else:
        sys.exit("\nYou need root permissions to do this, exiting!\n")

@app.command("upgrade")
def upgrade(ebuild: bool = typer.Option(False, "--ebuild", "-e")):
    """Upgrade the system using binary and/or ebuild (source) packages.
    By default, only binary packages will be upgraded.
    However, if you installed any ebuild(source) packages with the '--ebuild' option, it would make sense to upgrade them too.
    Use the --ebuild option to upgrade **EVERYTHING**, binary and/or ebuild(source) packages.

    * Examples:

        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

    will upgrade the system using both binary and/or ebuild(source) packages

    The --ebuild option will preffer to reuse binary packages(if available) to satisfy the dependencies for the ebuild(source) packages, speeding up the upgrade.
    You can use the --ebuild option even if you don't have any ebuild(source) packages installed; It will fall back to binary packages only.
    """
    if not ebuild:
        sisyphus.upgrade.start()
    else:
        sisyphus.upgrade.estart()

@app.command("spmsync")
def spmsync():
    """Sync Sisyphus's package database with Portage's package database.
    When you install something with Portage directly (emerge), Sisyphus is not aware of that package, and it doesn't track it in it's database.
    Use this command to synchronize Sisyphus's package database with Portage's package database.
    """
    sisyphus.syncspm.start()

@app.command("rescue")
def rescue():
    """Resurrect Sisyphus's package database if lost or corrupted.
    If for some reason Sisyphus's package database is lost or corrupted, it can be resurrected using Portage's package database.
    If Portage's package database is corrupted (in this case you're screwed anyway :D), only a partial resurrection will be possible.
    If Portage's package database is intact, full resurrection will be possible.
    """
    sisyphus.recoverdb.start()

class Branch(str, Enum):
    master = 'master'
    next = 'next'

class Remote(str, Enum):
    github = 'github'
    gitlab = 'gitlab'
    pagure = 'pagure'

@app.command("branch")
def branch(branch: Branch = typer.Argument(...), remote: Remote = typer.Option(Remote.gitlab, "--remote", "-r")):
    """Pull the selected branch of the Portage tree, Redcore overlay and Portage configs.
    The remote can be selected by using the --remote option.

    'BRANCH' can be one of the following : master, next

    'REMOTE' can be one of the following : github, gitlab, pagure (default is gitlab)

    * Examples:

        branch next --remote=github     # pull the branch 'next' from github.com

        branch master --remote=gitlab   # pull the branch 'master' from gitlab.com

        branch next --remote=pagure     # pull the branch 'next' from pagure.io

    !!! WARNING !!!

    Once you changed the branch, you must pair it with the correct binhost (binary repository).

    Branch 'master' must be paired with the stable binhost (binary repository) (odd numbers in 'sisyphus mirror list').

    * Examples:

        sisyphus mirror set 1

        sisyphus mirror set 5

    Branch 'next' must be paired with the testing binhost (binary repository) (even numbers in 'sisyphus mirror list').

    * Examples:

        sisyphus mirror set 2

        sisyphus mirror set 8
    """
    sisyphus.setbranch.start(branch.value, remote.value)

@app.command("sysinfo")
def sysinfo():
    """Display information about installed core packages and portage configuration."""
    sisyphus.sysinfo.show()

@mirrorSetup.command("list")
def mirrorlist():
    """List available binary package repository mirrors (the active one is marked with *)."""
    sisyphus.mirrors.printList()

@mirrorSetup.command("set")
def mirrorset(index: int):
    """Change the binary package repository to the selected mirror."""
    sisyphus.mirrors.setActive(index)

if __name__ == "__main__":
    if len(sys.argv) > 1 and not '--help' in sys.argv:
        sisyphus.setjobs.start()
    app()