Package: saltenv
saltenv is a Salt binary installation and management tool, inspired bytfenvAboutsaltenv allows users to easily install multiple salt binaries built with tiamat.
This is useful for standalone machine (desktop/laptop) configuration where the
full Salt installation isn’t warranted or necessary.saltenv is built as a POP application, which allows it to leverage other POP
plugins in the ecosystem or plug into other applications as necessary.What is POP?This project is built withpop, a Python-based
implementation ofPlugin Oriented Programming (POP). POP seeks to bring
together concepts and wisdom from the history of computing in new ways to solve
modern computing problems.For more information:Intro to Plugin Oriented Programming (POP)pop-awesomepop-createGetting StartedPrerequisitesPython 3.7+git(if installing from source, or contributing to the project)InstallationNoteIf wanting to contribute to the project, and setup your local development
environment, see theCONTRIBUTING.rstdocument in the source repository
for this project.If wanting to usesaltenv, you can do so by either
installing from PyPI or from source.Install from PyPIpipinstallsaltenvInstall from source# clone repogitclonegit@github.com/eitrtechnologies/saltenv.gitcdsaltenv# Setup venvpython3-mvenv.venv--promptsaltenvsource.venv/bin/activatepipinstall-e.Usageusage:run.py[-h][--configCONFIG][--config-template][--log-datefmtLOG_DATEFMT][--log-fileLOG_FILE][--log-fmt-consoleLOG_FMT_CONSOLE][--log-fmt-logfileLOG_FMT_LOGFILE][--log-handler-options[LOG_HANDLER_OPTIONS...]][--log-levelLOG_LEVEL][--log-pluginLOG_PLUGIN][--repo-urlREPO_URL][--saltenv-dirSALTENV_DIR][--version]{init,install,list,list-remote,pin,uninstall,use,version}...positionalarguments:{init,install,list,list-remote,pin,uninstall,use,version}options:-h,--helpshowthishelpmessageandexit--configCONFIG,-cCONFIGLoadextraoptionsfromaconfigurationfileontohub.OPT.saltenv--config-templateOutputaconfigtemplateforthiscommand--repo-urlREPO_URL,-rREPO_URLSaltsinglebinaryrepositorylocation.Versiondirectoriesareexpectedhere.--saltenv-dirSALTENV_DIR,-dSALTENV_DIRWorkingdirectoryforsaltenvdownloads--versionDisplayversioninformationLoggingOptions:--log-datefmtLOG_DATEFMTThedateformattodisplayinthelogs--log-fileLOG_FILEThelocationofthelogfile--log-fmt-consoleLOG_FMT_CONSOLEThelogformattingusedintheconsole--log-fmt-logfileLOG_FMT_LOGFILETheformattobegiventologfilemessages--log-handler-options[LOG_HANDLER_OPTIONS...]kwargsthatshouldbepassedtothelogginghandlerusedbythelog_plugin--log-levelLOG_LEVELSettheloglevel,eitherquiet,info,warning,debugorerror--log-pluginLOG_PLUGINTheloggingplugintouseExamplesBasic salt binary setup with version 3004:# Example CLI commands# List remote versions$saltenvlist-remote3004rc130043003.33003# Install version 3004$saltenvinstall3004Processingtarball...# Use version 3004$saltenvuse3004# List local versions$saltenvlist*3004setby/home/nmhughes/.saltenv/version3003.33003# Initialize the saltenv environment, which will point to the salt binaries$saltenvinitAddthesaltenvbindirectorytoyourPATH:echo'export PATH="$HOME/.saltenv/bin:$PATH"'>>~/.bashrcOR:echo'export PATH="$HOME/.saltenv/bin:$PATH"'>>~/.zshrc$echo'export PATH="$HOME/.saltenv/bin:$PATH"'>>~/.zshrc$source~/.zshrc# Kick the tires!$saltcalltest.versionlocal:3004Common IssuesIf this error is encountered, you might be running on Arch and need to install thelibxcrypt-compatpackage.[230732] Error loading Python lib '/tmp/_MEIAEr7dd/libpython3.7m.so.1.0': dlopen: libcrypt.so.1: cannot open shared object file: No such file or directoryRoadmapReference theopen issuesfor a list of proposed features (and known issues).AcknowledgementsImg Shieldsfor making repository badges easy.