Saravanan666/pypi-org huggingface dataset:
Package: saltext.azurerm
Salt Extension Modules for Azure Resource ManagerThis is a collection of Salt extension modules for use with  Microsoft Azure Resource ManagerSecurityIf you think you've found a security vulnerability, seeSalt's security guide.User DocumentationThis README is more for contributing to the project. If you just want to get
started, check out theUser Documentation.ContributingThe saltext-azurerm project team welcomes contributions from the community.TheSalt Contributing guidehas a lot of relevant
information, but if you'd like to jump right in here's how to get started:# Clone the repo
git clone --origin salt git@github.com:salt-extensions/saltext-azurerm.git

# Change to the repo dir
cd saltext-azurerm

# Create a new venv
python3 -m venv env --prompt azurerm
source env/bin/activate

# On mac, you may need to upgrade pip
python -m pip install --upgrade pip

# On WSL or some flavors of linux you may need to install the `enchant`
# library in order to build the docs
sudo apt-get install -y enchant

# Install extension + test/dev/doc dependencies into your environment
python -m pip install -e .[tests,dev,docs]

# Run tests!
python -m nox -e tests-3

# skip requirements install for next time
export SKIP_REQUIREMENTS_INSTALL=1

# Build the docs, serve, and view in your web browser:
python -m nox -e docs && (cd docs/_build/html; python -m webbrowser localhost:8000; python -m http.server; cd -)Writing code isn't the only way to contribute! We value contributions in any of
these areas:Documentation - especially examples of how to use this module to solve
specific problems.Triagingissuesand participating indiscussionsReviewingPull Requests(we really likeConventional Comments!)You could also contribute in other ways:Writing blog postsPosting on social media about how you used Salt+Prometheus to solve your
problems, including videosGiving talks at conferencesPublishing videosAsking/answering questions in IRC, Slack, or email groupsAny of these things are super valuable to our community, and we sincerely
appreciate every contribution!For more information, build the docs and head over tohttp://localhost:8000/—
that's where you'll find the rest of the documentation.
Package: saltext.consul
Salt Extension for ConsulSalt Extension for interacting with ConsulSecurityIf you think you've found a security vulnerability, seeSalt's security guide.User DocumentationThis README is for people aiming to contribute to the project.
If you just want to get started with the extension, check out the
module docstrings (for now, documentation is coming!).ContributingThe saltext-consul project team welcomes contributions from the community.TheSalt Contributing guidehas a lot of relevant
information, but if you'd like to jump right in here's how to get started:# Clone the repogitclone--originsaltgit@github.com:salt-extensions/saltext-consul.git# Change to the repo dircdsaltext-consul# Create a new venvpython3-mvenvenv--promptsaltext-consulsourceenv/bin/activate# On mac, you may need to upgrade pippython-mpipinstall--upgradepip# On WSL or some flavors of linux you may need to install the `enchant`# library in order to build the docssudoapt-getinstall-yenchant# Install extension + test/dev/doc dependencies into your environmentpython-mpipinstall-e'.[tests,dev,docs]'# Run tests!python-mnox-etests-3# skip requirements install for next timeexportSKIP_REQUIREMENTS_INSTALL=1# Build the docs, serve, and view in your web browser:python-mnox-edocs&&(cddocs/_build/html;python-mwebbrowserlocalhost:8000;python-mhttp.server;cd-)Writing code isn't the only way to contribute! We value contributions in any of
these areas:Documentation - especially examples of how to use this module to solve
specific problems.Triagingissuesand participating indiscussionsReviewingPull Requests(we really likeConventional Comments!)You could also contribute in other ways:Writing blog postsPosting on social media about how you used Salt+Consul to solve your
problems, including videosGiving talks at conferencesPublishing videosAsking/answering questions in IRC, Slack, or email groupsAny of these things are super valuable to our community, and we sincerely
appreciate every contribution!For more information, build the docs and head over tohttp://localhost:8000/—
that's where you'll find the rest of the documentation.
Package: saltext.elasticsearch
elasticsearch'Elasticsearch extension'QuickstartTo get started with your new project:# Create a new venv
python3 -m venv env --prompt elasticsearch
source env/bin/activate

# On mac, you may need to upgrade pip
python -m pip install --upgrade pip

# On WSL or some flavors of linux you may need to install the `enchant`
# library in order to build the docs
sudo apt-get install -y enchant

# Install extension + test/dev/doc dependencies into your environment
python -m pip install -e .[tests,dev,docs]

# Run tests!
python -m nox -e tests-3

# skip requirements install for next time
export SKIP_REQUIREMENTS_INSTALL=1

# Build the docs, serve, and view in your web browser:
python -m nox -e docs && (cd docs/_build/html; python -m webbrowser localhost:8000; python -m http.server; cd -)

# Run the example function
salt-call --local elasticsearch.ping
Package: salt-extension
salt-extensionTool to simplify the creation of a new salt extension.The whysalt-extensionis a Python-based CLI tool for generating a project scaffolding
to easily extendsaltwith exec modules, state modules, and more.Extensions make life easier in several ways:Deployments where proprietary Python modules are developed internally, like at enterprises that want to extendsaltfunctionality without modifyingsaltitself, can follow a standard.Extensions can develop and release at a faster speed thansaltitself. No need to wait for a specific major release.Developing extensions as separate repos allows for smaller, more isolated test suites that are tailored specifically to the scope of the extension.This approach to development, of thesaltecosystem, could also assist in the powers ofTiamat(resources:SEP26//tiamat-pipsource code).Converting existing module sets into extensions could begin treatingsaltas a more "pluggable"/"extensible" ecosystem, and could make it easier to understand what modules haven’t been contributed to in a long time. It is difficult to maintain so many modules withinsaltthat manage and orchestrate an ocean of APIs, operating systems, clouds, etc.QuickstartThe best way to use this project is withpipx:$ pipx install salt-extension
$ mkdir my_extension
$ cd my_extension
$ create-salt-extension my_extension -l states -l module
Author: John Example Doe
Author email: jd@example.com
Summary: An example Salt Extension Module
Url: https://example.com/my-saltext
License (apache, other): apacheThen follow the other output instructions.If all goes well, you should be able to run:$ salt-call --local my_extension.example_function text="it worked!"
local:
    it worked!Happy hacking!
Package: saltext.freezer
Salt Extension for FreezerSalt Extension for interacting with FreezerSecurityIf you think you've found a security vulnerability, seeSalt's security guide.User DocumentationThis README is for people aiming to contribute to the project.
If you just want to get started with the extension, check out the
module docstrings (for now, documentation is coming!).ContributingThe saltext-freezer project team welcomes contributions from the community.TheSalt Contributing guidehas a lot of relevant
information, but if you'd like to jump right in here's how to get started:# Clone the repogitclone--originsaltgit@github.com:salt-extensions/saltext-freezer.git# Change to the repo dircdsaltext-freezer# Create a new venvpython3-mvenvenv--promptsaltext-freezersourceenv/bin/activate# On mac, you may need to upgrade pippython-mpipinstall--upgradepip# On WSL or some flavors of linux you may need to install the `enchant`# library in order to build the docssudoapt-getinstall-yenchant# Install extension + test/dev/doc dependencies into your environmentpython-mpipinstall-e'.[tests,dev,docs]'# Run tests!python-mnox-etests-3# skip requirements install for next timeexportSKIP_REQUIREMENTS_INSTALL=1# Build the docs, serve, and view in your web browser:python-mnox-edocs&&(cddocs/_build/html;python-mwebbrowserlocalhost:8000;python-mhttp.server;cd-)Writing code isn't the only way to contribute! We value contributions in any of
these areas:Documentation - especially examples of how to use this module to solve
specific problems.Triagingissuesand participating indiscussionsReviewingPull Requests(we really likeConventional Comments!)You could also contribute in other ways:Writing blog postsPosting on social media about how you used Salt+Freezer to solve your
problems, including videosGiving talks at conferencesPublishing videosAsking/answering questions in IRC, Slack, or email groupsAny of these things are super valuable to our community, and we sincerely
appreciate every contribution!For more information, build the docs and head over tohttp://localhost:8000/—
that's where you'll find the rest of the documentation.
Package: saltext.heist
Salt Extension for HeistThis is a collection of Salt-maintained extension modules for use withHeistandHeist-Salt.SecurityIf you think you've found a security vulnerability, seeSalt's security guide.ContributingThe salt-ext-heist project team welcomes contributions from the community. If you wish to
contribute code and you have not signed our contributor license agreement (CLA), our bot
will update the issue when you open a Pull Request. For any questions about the CLA process,
please refer to ourFAQ.TheSalt Contributing guidehas a lot of relevant information, but if
you'd like to jump right in here's how to get started:# Clone the repo
git clone --origin salt https://github.com/saltstack/salt-ext-heist.git

# Change to the repo dir
cd salt-ext-heist

# Create a new venv
python3 -m venv env --prompt heist-ext
source env/bin/activate

# On mac, you may need to upgrade pip
python -m pip install --upgrade pip

# Install extension + test/doc dependencies into your environment
python -m pip install -e . -r requirements/tests.in -r requirements/base.txt -r requirements/docs.in

# Run tests!
python -m nox -e tests-3

# skip requirements install for next time
export SKIP_REQUIREMENTS_INSTALL=1

# Build the docs, serve, and view in your web browser:
python -m nox -e docs && (cd docs/_build/html; python -m webbrowser localhost:8000; python -m http.server; cd -)For code contributions, as part of VMware we requirea signed CLA.
If you've already signed the VMware CLA, you're probably good to go.Of course, writing code isn't the only way to contribute! We value
contributions in any of these areas:Documentation - especially examples of how to use this module to solve
specific problems.Triagingissuesand participating indiscussionsReviewingPull Requests(we really likeConventional
Comments!)You could also contribute in other ways:Writing blog postsPosting on social media about how you used Salt+Heist to solve your
problems, including videosGiving talks at conferencesPublishing videosAsking/answering questions in IRC, Slack, or email groupsAny of these things are super valuable to our community, and we sincerely
appreciate every contribution!For more information, build the docs and head over tohttp://localhost:8000/—
that's where you'll find the rest of the documentation.How to use the Heist Salt Extension# Distribute the Salt artifact to the target
salt-run heist.deploy salt.minionThis starts up the Heist-Salt process, copies the artifact and initiates
the SSH tunnel between the Master and Minion. Once you run this command
you can interact with the Heist Minions. If you runsalt-keyyou will
see the new key for the host you targeted and you can run Salt commands
for the new minion.You can read theHeistorHeist Saltdocs to learn more about the projects.
Package: saltext.kubernetes
Salt Extension for KubernetesSalt Extension for interacting with KubernetesSecurityIf you think you've found a security vulnerability, seeSalt's security guide.User DocumentationThis README is for people aiming to contribute to the project.
If you just want to get started with the extension, check out the
module docstrings (for now, documentation is coming!).ContributingThe saltext-kubernetes project team welcomes contributions from the community.TheSalt Contributing guidehas a lot of relevant
information, but if you'd like to jump right in here's how to get started:# Clone the repogitclone--originsaltgit@github.com:salt-extensions/saltext-kubernetes.git# Change to the repo dircdsaltext-kubernetes# Create a new venvpython3-mvenvenv--promptsaltext-kubernetessourceenv/bin/activate# On mac, you may need to upgrade pippython-mpipinstall--upgradepip# On WSL or some flavors of linux you may need to install the `enchant`# library in order to build the docssudoapt-getinstall-yenchant# Install extension + test/dev/doc dependencies into your environmentpython-mpipinstall-e'.[tests,dev,docs]'# Run tests!python-mnox-etests-3# skip requirements install for next timeexportSKIP_REQUIREMENTS_INSTALL=1# Build the docs, serve, and view in your web browser:python-mnox-edocs&&(cddocs/_build/html;python-mwebbrowserlocalhost:8000;python-mhttp.server;cd-)Writing code isn't the only way to contribute! We value contributions in any of
these areas:Documentation - especially examples of how to use this module to solve
specific problems.Triagingissuesand participating indiscussionsReviewingPull Requests(we really likeConventional Comments!)You could also contribute in other ways:Writing blog postsPosting on social media about how you used Salt+Kubernetes to solve your
problems, including videosGiving talks at conferencesPublishing videosAsking/answering questions in IRC, Slack, or email groupsAny of these things are super valuable to our community, and we sincerely
appreciate every contribution!For more information, build the docs and head over tohttp://localhost:8000/—
that's where you'll find the rest of the documentation.
Package: saltext.mqtt-return
mqtt_returnA useful Salt Event returner for publishing messages to MQTT or AWS IoTQuickstartTo get started with your new project:# Create a new venv
python3 -m venv env --prompt mqtt_return
source env/bin/activate

# On mac, you may need to upgrade pip
python -m pip install --upgrade pip

# On WSL or some flavors of linux you may need to install the `enchant`
# library in order to build the docs
sudo apt-get install -y enchant

# Install extension + test/dev/doc dependencies into your environment
python -m pip install -e .[tests,dev,docs]

# Run tests!
python -m nox -e tests-3

# skip requirements install for next time
export SKIP_REQUIREMENTS_INSTALL=1

# Build the docs, serve, and view in your web browser:
python -m nox -e docs && (cd docs/_build/html; python -m webbrowser localhost:8000; python -m http.server; cd -)

# Run the example function
salt-call --local mqtt_return.example_function text="Happy Hacking!"ConfigurationFor publishing to a standard MQTT brokerevent_return:[mqtt_return]returner.mqtt_return.output:mqttreturner.mqtt_return.endpoint:mqttreturner.mqtt_return.port:1883returner.mqtt_return.topic_prefix:"example/prefix"For publishing to AWS IoT Core MQTT broker using boto3 and the iot-data clientevent_return:[mqtt_return]returner.mqtt_return.output:awsiotreturner.mqtt_return.endpoint:https://example.iot.amazonaws.comreturner.mqtt_return.topic_prefix:"example/prefix"returner.mqtt_return.aws_access_key_id:"aaaaa"returner.mqtt_return.aws_secret_access_key:"aaaaa"Topic Re-writingAllows you to re-write the topics with Regex and Python SubstrFor example to remove thesalt/prefix from the topics:returner.mqtt_return.topic_rewrite_regex:"salt/"returner.mqtt_return.topic_rewrite_replace:""
Package: saltext.prometheus
Salt Extension Modules for PrometheusThis is a collection of Salt extension modules for use with Prometheus.SecurityIf you think you've found a security vulnerability, seeSalt's security guide.User DocumentationThis README is more for contributing to the project. If you just want to get
started, check out theUser Documentation.ContributingThe saltext-prometheus project team welcomes contributions from the community.TheSalt Contributing guidehas a lot of relevant
information, but if you'd like to jump right in here's how to get started:# Clone the repo
git clone --origin salt git@github.com:salt-extensions/saltext-prometheus.git

# Change to the repo dir
cd saltext-prometheus

# Create a new venv
python3 -m venv env --prompt salt-ext-prom
source env/bin/activate

# On mac, you may need to upgrade pip
python -m pip install --upgrade pip

# On WSL or some flavors of linux you may need to install the `enchant`
# library in order to build the docs
sudo apt-get install -y enchant

# Install extension + test/dev/doc dependencies into your environment
python -m pip install -e .\[tests,dev,docs\]

# Run tests!
python -m nox -e tests-3

# skip requirements install for next time
export SKIP_REQUIREMENTS_INSTALL=1

# Build the docs, serve, and view in your web browser:
python -m nox -e docs && (cd docs/_build/html; python -m webbrowser localhost:8000; python -m http.server; cd -)Writing code isn't the only way to contribute! We value contributions in any of
these areas:Documentation - especially examples of how to use this module to solve
specific problems.Triagingissuesand participating indiscussionsReviewingPull Requests(we really likeConventional Comments!)You could also contribute in other ways:Writing blog postsPosting on social media about how you used Salt+Prometheus to solve your
problems, including videosGiving talks at conferencesPublishing videosAsking/answering questions in IRC, Slack, or email groupsAny of these things are super valuable to our community, and we sincerely
appreciate every contribution!For more information, build the docs and head over tohttp://localhost:8000/—
that's where you'll find the rest of the documentation.
Package: saltext.proxmox
Salt Extension Modules for ProxmoxThis is a collection of Salt extension modules for use with Proxmox PVE.SecurityIf you think you've found a security vulnerability, seeSalt's security guide.User DocumentationThis README is more for contributing to the project. If you just want to get
started, check out theUser Documentation.ContributingThe saltext-proxmox project team welcomes contributions from the community.TheSalt Contributing guidehas a lot of relevant
information, but if you'd like to jump right in here's how to get started:# Clone the repo
git clone --origin salt git@github.com:salt-extensions/saltext-proxmox.git

# Change to the repo dir
cd saltext-proxmox

# Create a new venv
python3 -m venv env --prompt proxmox
source env/bin/activate

# On mac, you may need to upgrade pip
python -m pip install --upgrade pip

# On WSL or some flavors of linux you may need to install the `enchant`
# library in order to build the docs
sudo apt-get install -y enchant

# Install extension + test/dev/doc dependencies into your environment
python -m pip install -e .[tests,dev,docs]

# Run tests!
python -m nox -e tests-3

# skip requirements install for next time
export SKIP_REQUIREMENTS_INSTALL=1

# Build the docs, serve, and view in your web browser:
python -m nox -e docs && (cd docs/_build/html; python -m webbrowser localhost:8000; python -m http.server; cd -)Writing code isn't the only way to contribute! We value contributions in any of
these areas:Documentation - especially examples of how to use this module to solve
specific problems.Triagingissuesand participating indiscussionsReviewingPull Requests(we really likeConventional Comments!)You could also contribute in other ways:Writing blog postsPosting on social media about how you used Salt+Prometheus to solve your
problems, including videosGiving talks at conferencesPublishing videosAsking/answering questions in IRC, Slack, or email groupsAny of these things are super valuable to our community, and we sincerely
appreciate every contribution!For more information, build the docs and head over tohttp://localhost:8000/—
that's where you'll find the rest of the documentation.
Package: saltext.salt-describe
Salt DescribeSalt Describe is a Salt Extension used to automate the generation of infrastructure
as code files using Salt to query target machines.QuickstartTo get started with your new project:# Create a new venv
python3 -m venv env --prompt salt-describe
source env/bin/activate

# On mac, you may need to upgrade pip
python -m pip install --upgrade pip

# On WSL or some flavors of linux you may need to install the `enchant`
# library in order to build the docs
sudo apt-get install -y enchant

# Install extension + test/dev/doc dependencies into your environment
python -m pip install -e .[tests,dev,docs]

# Run tests!
python -m nox -e tests-3

# skip requirements install for next time
export SKIP_REQUIREMENTS_INSTALL=1

# Build the docs, serve, and view in your web browser:
python -m nox -e docs && (cd docs/_build/html; python -m webbrowser localhost:8000; python -m http.server; cd -)

# Run the pkg describe function
salt-run describe.pkg <minion-tgt>

# Run the file describe function
salt-run describe.file <minion-tgt> <file name>

# Generate the top file for the minion target based off of previously generated SLS files.
salt-run describe.top <minion-tgt>
Package: saltext.sap
SaltStack general SAP extensionThis SaltStack extension handles generic SAP operations.THIS PROJECT IS NOT ASSOCIATED WITH SAP IN ANY WAYInstallationRun the following to install the SaltStack general SAP extension:salt-callpip.installsaltext.sapKeep in mind that this package must be installed on every minion that should utilize the states and execution modules.Alternatively, you can add this repository directly over gitfsgitfs_remotes:-https://github.com/SAPUCC/saltext-sap.git:-root:src/saltext/sapIn order to enable this, logical links undersrc/saltext/sap/from_<dir_type>(where the code lives) to<dir_type>have been placed, e.g._modules->modules. This will double the source data during build, but:_modulesis required for integrating the repo over gitfsmodulesis required for the salt loader to find the modules / statesUsageA state using the generic SAP extension looks like this:{%-setsystem_data=salt["sap.get_system_data"](sid="S4H",username="sapadm",password="Abcd1234!")%}{%-setmessage_server=system_data["message_servers"][0]%}{%-setlogon_group=system_data["logon_groups"][0]%}SLD config is present on S4H:sap_nwabap.sld_config_present:- name: SLD_DS_TARGET- sid: S4H- client: "000"- message_server_host:{{message_server["host"]}}- message_server_port:{{message_server["msport"]}}- logon_group:{{logon_group}}- username: SALT- password: __slot__:salt:vault.read_secret(path="nwabap/S4H/000", key="SALT")DocsSeehttps://saltext-sap.readthedocs.io/for the documentation.ContributingWe would love to see your contribution to this project. Please refer toCONTRIBUTING.mdfor further details.LicenseThis project is licensed under GPLv3. SeeLICENSE.mdfor the license text andCOPYRIGHT.mdfor the general copyright notice.