diff --git a/PkgInfo/README.md b/PkgInfo/README.md index a5b6598..da9a890 100644 --- a/PkgInfo/README.md +++ b/PkgInfo/README.md @@ -1,11 +1,12 @@ -Fetches package information from the repositories of various \*nix distributions, including Arch Linux, CentOS, Debian, Fedora, FreeBSD, Linux Mint, and Ubuntu. - -This plugin uses the following APIs: -- For Debian and Ubuntu, Debian's [madison.php](//qa.debian.org/madison.php) (used by the `vlist` command) -- For Arch Linux and its AUR, [AurJson](//wiki.archlinux.org/index.php/AurJson) and the [Arch Linux Web Interface](//wiki.archlinux.org/index.php/Official_Repositories_Web_Interface) -- For Fedora, the Product Definition Center API: https://pdc.fedoraproject.org/ - -Everything else is parsed as HTML using the Beautiful Soup 4 library. +Fetches package information from the repositories of various \*nix distributions. Currently it supports: +- Arch Linux +- CentOS (via a separate `centos` command) +- Debian +- Fedora +- FreeBSD +- Gentoo +- Linux Mint +- Ubuntu ### Package information @@ -13,7 +14,14 @@ Everything else is parsed as HTML using the Beautiful Soup 4 library. The `pkg` command fetches package information from distribution sources, with additional support for showing source package info (via `--source`) and dependencies (`--depends`) for some OSes. -This command supports Arch Linux (distro names `arch`/`archlinux` and `aur`/`archaur`), Debian (using release codenames such as `sid`, `unstable`, `stretch`, `stable`), FreeBSD (distro name `freebsd`), Linux Mint (release codenames such as `sonya` or `betsy`), and Ubuntu (release codenames such as `bionic` or `xenial`). +This command supports: +- Arch Linux (distro names `arch`/`archlinux` and `aur`/`archaur`) +- Debian (using release codenames such as `sid`, `unstable`, `stretch`, `stable`) +- FreeBSD (distro name `freebsd`) +- Fedora (distro name `fedora`) +- Gentoo (distro name `gentoo`) +- Linux Mint (release codenames such as `sonya` or `betsy`) +- Ubuntu (release codenames such as `bionic` or `xenial`). This command replaces the `archlinux`, `archaur`, `freebsd`, and `linuxmint` commands from earlier versions of PkgInfo. @@ -37,25 +45,29 @@ This command replaces the `archlinux`, `archaur`, `freebsd`, and `linuxmint` com #### Viewing (build-)dependencies +--depends is only supported for Arch Linux, Arch AUR, Debian, FreeBSD, and Ubuntu. + ``` `pkg sid bash --source --depends Package bash dependencies: adep: autoconf, adep: autotools-dev, adep: bison, adep: libncurses5-dev, adep: texinfo, adep: texi2html, adep: debhelper (>= 5), adep: locales, adep: gettext, adep: sharutils, adep: time, adep: xz-utils, adep: dpkg-dev (>= 1.16.1), idep: texlive-latex-base, idep: ghostscript, idep: (1 more message) - `pkg sid bash --depends - Package bash dependencies: dep: dash (>= 0.5.5.1-2.2), dep: libc0.1 (>= 2.17-91) [kfreebsd-amd64, kfreebsd-i386], dep: libc0.3 (>= 2.15) [hurd-i386], dep: libc6 (>= 2.15) [not alpha, arm64, hurd-i386, kfreebsd-amd64, kfreebsd-i386, mips, mipsel, ppc64el, sh4, x32], dep: libc6 (>= 2.16) [x32], dep: libc6 (>= 2.17) [arm64, ppc64el], dep: libc6 (>= 2.19) [mips, (1 more message) + `pkg freebsd screen --depends + screen requires: gettext-runtime-0.19.8.1_1, gmake-4.2.1_2, indexinfo-0.3.1 ``` ### Package search **Synopsis:** `pkgsearch ` -The `pkgsearch` command provides package searches on various distros. As of writing, supports all distros that `pkg` does except for Fedora. +The `pkgsearch` command provides package searches on various distros. This supports all distros that `pkg` does except for Fedora. ``` `pkgsearch arch firefox Found 207 results: arch-firefox-search, bluegriffon, firefox, firefox-adblock-plus, firefox-developer-edition, firefox-developer-edition-i18n-ach, firefox-developer-edition-i18n-af, firefox-developer-edition-i18n-an, firefox-developer-edition-i18n-ar, firefox-developer-edition-i18n-as, firefox-developer-edition-i18n-ast, firefox-developer-edition-i18n-az, firefox-developer- (14 more messages) + `pkgsearch debian geany-plugin Found 86 results: geany-plugin-addons, geany-plugin-addons-dbgsym, geany-plugin-autoclose, geany-plugin-autoclose-dbgsym, geany-plugin-automark, geany-plugin-automark-dbgsym, geany-plugin-codenav, geany-plugin-codenav-dbgsym, geany-plugin-commander, geany-plugin-commander-dbgsym, geany-plugin-ctags, geany-plugin-ctags-dbgsym, geany-plugin-debugger, geany-plugin-defineformat, (6 more messages) + `pkgsearch ubuntu unity-scope Found 54 results: libunity-scopes-cli, libunity-scopes-dev, libunity-scopes-doc, libunity-scopes-json-def-desktop, libunity-scopes-json-def-phone, libunity-scopes-qt-dev, libunity-scopes-qt-doc, libunity-scopes-qt0.2, libunity-scopes1, libunity-scopes1.0, unity-scope-audacious, unity-scope-calculator, unity-scope-chromiumbookmarks, unity-scope-clementine, unity-scope-click, (3 more messages) ``` @@ -67,6 +79,7 @@ The `pkgsearch` command provides package searches on various distros. As of writ ``` `vlist debian variety Found 4 results: jessie-backports (0.6.3-5~bpo8+1 [source, all]), stretch (0.6.3-5 [source, all]), buster (0.6.7-1 [source, all]), and sid (0.6.7-1 [source, all]); View more at: + `vlist ubuntu libreoffice --reverse Found 55 results: cosmic/universe (1:6.0.3-0ubuntu1 [amd64, i386]), cosmic (1:6.0.3-0ubuntu1 [source]), bionic/universe (1:6.0.3-0ubuntu1 [amd64, i386]), bionic (1:6.0.3-0ubuntu1 [source]), artful-updates/universe (1:5.4.6-0ubuntu0.17.10.1 [amd64, i386]), artful-updates (1:5.4.6-0ubuntu0.17.10.1 [source]), artful-security/universe (1:5.4.5-0ubuntu0.17.10.5 [amd64, i386]), artful-security (7 more messages) ``` @@ -75,7 +88,7 @@ The `pkgsearch` command provides package searches on various distros. As of writ **Synopsis**: `centos [ ] [--arch ] [--startswith|--exact]` -This lookup command is provided as a separate command due to limited package searching abilities through the CentOS website. +This lookup command is provided as a separate command due to very limited searching abilities through the CentOS website. ``` `centos 7 os zsh @@ -83,3 +96,12 @@ This lookup command is provided as a separate command due to limited package sea `centos 7 os python Available RPMs: MySQL-python-1.2.3-11.el7.x86_64.rpm, OpenIPMI-python-2.0.19-11.el7.x86_64.rpm, abrt-addon-python-2.1.11-19.el7.centos.0.3.x86_64.rpm, abrt-python-2.1.11-19.el7.centos.0.3.x86_64.rpm, abrt-python-doc-2.1.11-19.el7.centos.0.3.noarch.rpm, antlr-python-2.7.7-30.el7.noarch.rpm, at-spi-python-1.32.0-12.el7.x86_64.rpm, audit-libs-python-2.4.1-5.el7.x86_64.rpm, (25 more messages) ``` + +## Implementation Details + +This plugin uses the following APIs: +- For Debian and Ubuntu, Debian's [madison.php](//qa.debian.org/madison.php) (used by the `vlist` command) +- For Arch Linux and its AUR, [AurJson](//wiki.archlinux.org/index.php/AurJson) and the [Arch Linux Web Interface](//wiki.archlinux.org/index.php/Official_Repositories_Web_Interface) +- For Fedora, the Product Definition Center API: https://pdc.fedoraproject.org/ + +Everything else is parsed as HTML using the Beautiful Soup 4 library.