CDIST-TYPE__PACKAGE_PIP(7)

📦
version 7.0.0 · 8 versions
, in fedora 43, fedora 44

🌸 NAME 🌸

okay bestie, welcome to cdist-type__package_pip 💖 — it's a cdist manual page (section 7, periodt), and it's literally just: Manage packages with pip. that's the whole vibe. let's get into it 🫶

✨ DESCRIPTION ✨

so here's the tea ☕ — Pip is what we use in Python environments to install packages. that's its whole job. it's also included in the python virtualenv environment, so if you're living that virtualenv life, pip is already in the building 💅

🎀 REQUIRED PARAMETERS 🎀

None. not a single one. zero. free. unbothered. ✨

💖 OPTIONAL PARAMETERS 💖

  • name — if you supply this, it uses the name you gave instead of the object id as the package name. cute little override, iykyk.
  • extra — extra optional dependencies that should be installed along with the selected package. you can specify it multiple times, and you can also pass multiple extras in one --extra as a comma-separated list. 🌈

heads up bestie: extra optional dependencies will be installed even when the base package is already installed. also notice that the type will not remove installed extras that aren't explicitly named for the type, because pip does not offer a management for orphaned packages and they may be used by other packages. so like, no cleanup, no take-backs 🫠

  • pip — instead of using pip from PATH, use the specific pip path. main character pip, your choice 💅
  • state — either "present" or "absent", defaults to "present".
  • runas — run pip as the specified user. by default it runs as root. 👑

🔥 EXAMPLES 🔥

# Install a package
__package_pip pyro --state present

# Use pip in a virtualenv located at /root/shinken_virtualenv
__package_pip pyro --state present --pip /root/shinken_virtualenv/bin/pip

# Use pip in a virtualenv located at /foo/shinken_virtualenv as user foo
__package_pip pyro --state present --pip /foo/shinken_virtualenv/bin/pip --runas foo

# Install package with optional dependencies
__package_pip mautrix-telegram --extra speedups --extra webp_convert --extra hq_thumbnails
# the extras can also be specified comma-separated
__package_pip mautrix-telegram --extra speedups,webp_convert,hq_thumbnails --extra postgres

# or take all extras
__package_pip mautrix-telegram --extra all

🌟 SEE ALSO 🌟

👑 AUTHORS 👑

  • Nico Schottelius <nico-cdist--@--schottelius.org>
  • Matthias Stecher <matthiasstecher--@--gmx.de>

🦋 COPYING 🦋

Copyright (C) 2012 Nico Schottelius, 2021 Matthias Stecher. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

ungleich GmbH 2021

and that's the whole page, bestie 🥹💖 this was version 7.0.0 from Jul 31, 2022, brought to you by the cdist girlies. go install something slay. periodt ✨💅🎀

📦 where this page comes from