# robocorp-vault
`robocorp-vault` is a library that provides read and write access to the [Vault](https://robocorp.com/docs/development-guide/variables-and-secrets/vault) in Robocorp Control Room, which can be used to store and retrieve secret values such as passwords.
## Getting started
A secret consists of a name, an optional description, and a map of keys and values. For instance, one secret can be login credentials for a website, which includes both a username and a password:
```python
from robocorp.tasks import task
from robocorp import vault
@task
def inspect_secret():
secret = vault.get_secret("login_credentials")
print("Secret name:", secret.name)
print("Secret description:", secret.description)
print("Secret keys:", secret.keys())
print("Secret value:", secret["username"])
```
## Guides
- [Local development](https://github.com/robocorp/robocorp/blob/master/vault/docs/guides/00-local-development.md)
- [Hiding values](https://github.com/robocorp/robocorp/blob/master/vault/docs/guides/01-hiding-values.md)
- [Modifying secrets](https://github.com/robocorp/robocorp/blob/master/vault/docs/guides/02-modifying-secrets.md)
Further user guides and tutorials can be found in [Robocorp Docs](https://robocorp.com/docs).
## API Reference
Explore our [API](https://github.com/robocorp/robocorp/blob/master/vault/docs/api/README.md) for extensive documentation.
## Changelog
A list of releases and corresponding changes can be found in the [changelog](https://github.com/robocorp/robocorp/blob/master/vault/docs/CHANGELOG.md).
Raw data
{
"_id": null,
"home_page": "https://github.com/robocorp/robocorp/",
"name": "robocorp-vault",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0.0,>=3.9.2",
"maintainer_email": null,
"keywords": null,
"author": "Fabio Z.",
"author_email": "fabio@robocorp.com",
"download_url": "https://files.pythonhosted.org/packages/c7/3d/c8481db7788ab595fcdcf5a080f1aa8f7a5cd29b7609e7757fe5461ebd8f/robocorp_vault-1.3.9.tar.gz",
"platform": null,
"description": "# robocorp-vault\n\n`robocorp-vault` is a library that provides read and write access to the [Vault](https://robocorp.com/docs/development-guide/variables-and-secrets/vault) in Robocorp Control Room, which can be used to store and retrieve secret values such as passwords.\n\n## Getting started\n\nA secret consists of a name, an optional description, and a map of keys and values. For instance, one secret can be login credentials for a website, which includes both a username and a password:\n\n```python\nfrom robocorp.tasks import task\nfrom robocorp import vault\n\n@task\ndef inspect_secret():\n secret = vault.get_secret(\"login_credentials\")\n print(\"Secret name:\", secret.name)\n print(\"Secret description:\", secret.description)\n print(\"Secret keys:\", secret.keys())\n print(\"Secret value:\", secret[\"username\"])\n```\n\n## Guides\n\n- [Local development](https://github.com/robocorp/robocorp/blob/master/vault/docs/guides/00-local-development.md)\n- [Hiding values](https://github.com/robocorp/robocorp/blob/master/vault/docs/guides/01-hiding-values.md)\n- [Modifying secrets](https://github.com/robocorp/robocorp/blob/master/vault/docs/guides/02-modifying-secrets.md)\n\nFurther user guides and tutorials can be found in [Robocorp Docs](https://robocorp.com/docs).\n\n## API Reference\n\nExplore our [API](https://github.com/robocorp/robocorp/blob/master/vault/docs/api/README.md) for extensive documentation.\n\n## Changelog\n\nA list of releases and corresponding changes can be found in the [changelog](https://github.com/robocorp/robocorp/blob/master/vault/docs/CHANGELOG.md).\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Robocorp Control Room Vault API integration library",
"version": "1.3.9",
"project_urls": {
"Homepage": "https://github.com/robocorp/robocorp/",
"Repository": "https://github.com/robocorp/robocorp/"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ecf4857b1e62a2be6812ba487d018a97dce366c769321ab4e4b126f6ef238190",
"md5": "ea0bcdb0c46c95538186464f488d4a85",
"sha256": "7cdeb5eec3b2cc696ff282a0e175583bcde4caba83adbf00f67936194dc50626"
},
"downloads": -1,
"filename": "robocorp_vault-1.3.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ea0bcdb0c46c95538186464f488d4a85",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0.0,>=3.9.2",
"size": 12687,
"upload_time": "2025-08-07T12:23:44",
"upload_time_iso_8601": "2025-08-07T12:23:44.544457Z",
"url": "https://files.pythonhosted.org/packages/ec/f4/857b1e62a2be6812ba487d018a97dce366c769321ab4e4b126f6ef238190/robocorp_vault-1.3.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c73dc8481db7788ab595fcdcf5a080f1aa8f7a5cd29b7609e7757fe5461ebd8f",
"md5": "9fc35a08bf4b1df01cbd14d3ba69148d",
"sha256": "4514d2994022f95f235dad12b6945ad363ec1b8d264527b26933ab7ac040e861"
},
"downloads": -1,
"filename": "robocorp_vault-1.3.9.tar.gz",
"has_sig": false,
"md5_digest": "9fc35a08bf4b1df01cbd14d3ba69148d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0.0,>=3.9.2",
"size": 10504,
"upload_time": "2025-08-07T12:23:45",
"upload_time_iso_8601": "2025-08-07T12:23:45.306488Z",
"url": "https://files.pythonhosted.org/packages/c7/3d/c8481db7788ab595fcdcf5a080f1aa8f7a5cd29b7609e7757fe5461ebd8f/robocorp_vault-1.3.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-07 12:23:45",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "robocorp",
"github_project": "robocorp",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "robocorp-vault"
}
JSON
