# BitWarden backend for Pants
[](https://pypi.org/project/pants-backend-bitwarden)
> **Warning**
> This plugin is in development. No stability is guaranteed! Contributions welcome.
This backends implements targets for reading BitWarden secrets.
* [bw](https://bitwarden.com/help/cli/) - the BitWarden CLI client
## Planned and missing features
* Setting and creating secrets via Pants
## Targets
### `bw_item`
Matches one entry in your vault.
``` python
bw_item(
name="pypi",
id="386c6037-cbdd-4aa3-ba80-9ed6661f751b",
session_secret=":bw_session_key",
)
```
| Argument | Meaning | Default value |
|------------------|-----------------------------------------------------------------|-------------------------------------------------------|
| `name` | The target name | Same as any other target, which is the directory name |
| `id` | Item id used by this target as seen in the address bar | **Required** |
| `item_name` | The name in the vault. If ambiguous this will fail. Prefer IDs. | ` ` |
| `session_secret` | The secret to use for the BW_SESSION variable. | `env["BW_SESSION"]` |
| `decsription` | A description of the target | ` ` |
| `tags` | List of tags | `[]` |
### `bw_password`
The password of an item in your vault.
``` python
bw_password(
name="pypi_password",
item=[":pypi"],
)
```
| Argument | Meaning | Default value |
|---------------|-----------------------------------|-------------------------------------------------------|
| `name` | The target name | Same as any other target, which is the directory name |
| `item` | The item containing the password. | **Required** |
| `decsription` | A description of the target | ` ` |
| `tags` | List of tags | `[]` |
### `bw_field`
A field from an item in your vault. These are the "Custom Fields" at the bottom of an item, not to be confused with attachments.
``` python
bw_field(
name="pypi_token",
field_name="api_token"
item=[":pypi"],
)
```
| Argument | Meaning | Default value |
|---------------|-----------------------------------|-------------------------------------------------------|
| `name` | The target name | Same as any other target, which is the directory name |
| `item` | The item containing the password. | **Required** |
| `field_name` | The item containing the password. | **Required** |
| `decsription` | A description of the target | ` ` |
| `tags` | List of tags | `[]` |
Raw data
{
"_id": null,
"home_page": null,
"name": "pants-backend-bitwarden",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "pantsbuild, pants, backend, bitwarden",
"author": null,
"author_email": "Tom Solberg <me@sbg.dev>",
"download_url": "https://files.pythonhosted.org/packages/9b/14/d73135f720177f1a20c72ecc38d9a1d17d69d6441159886bb745dd7dc708/pants-backend-bitwarden-0.4.0.tar.gz",
"platform": null,
"description": "# BitWarden backend for Pants\n\n[](https://pypi.org/project/pants-backend-bitwarden)\n\n> **Warning**\n> This plugin is in development. No stability is guaranteed! Contributions welcome.\n\nThis backends implements targets for reading BitWarden secrets.\n\n* [bw](https://bitwarden.com/help/cli/) - the BitWarden CLI client\n\n## Planned and missing features\n\n* Setting and creating secrets via Pants\n\n## Targets\n\n### `bw_item`\n\nMatches one entry in your vault.\n\n``` python\nbw_item(\n name=\"pypi\",\n id=\"386c6037-cbdd-4aa3-ba80-9ed6661f751b\",\n session_secret=\":bw_session_key\",\n)\n```\n\n| Argument | Meaning | Default value |\n|------------------|-----------------------------------------------------------------|-------------------------------------------------------|\n| `name` | The target name | Same as any other target, which is the directory name |\n| `id` | Item id used by this target as seen in the address bar | **Required** |\n| `item_name` | The name in the vault. If ambiguous this will fail. Prefer IDs. | ` ` |\n| `session_secret` | The secret to use for the BW_SESSION variable. | `env[\"BW_SESSION\"]` |\n| `decsription` | A description of the target | ` ` |\n| `tags` | List of tags | `[]` |\n\n\n### `bw_password`\n\nThe password of an item in your vault.\n\n``` python\nbw_password(\n name=\"pypi_password\",\n item=[\":pypi\"],\n)\n```\n\n| Argument | Meaning | Default value |\n|---------------|-----------------------------------|-------------------------------------------------------|\n| `name` | The target name | Same as any other target, which is the directory name |\n| `item` | The item containing the password. | **Required** |\n| `decsription` | A description of the target | ` ` |\n| `tags` | List of tags | `[]` |\n\n### `bw_field`\n\nA field from an item in your vault. These are the \"Custom Fields\" at the bottom of an item, not to be confused with attachments.\n\n``` python\nbw_field(\n name=\"pypi_token\",\n\tfield_name=\"api_token\"\n item=[\":pypi\"],\n)\n```\n\n| Argument | Meaning | Default value |\n|---------------|-----------------------------------|-------------------------------------------------------|\n| `name` | The target name | Same as any other target, which is the directory name |\n| `item` | The item containing the password. | **Required** |\n| `field_name` | The item containing the password. | **Required** |\n| `decsription` | A description of the target | ` ` |\n| `tags` | List of tags | `[]` |\n\n",
"bugtrack_url": null,
"license": null,
"summary": "A Bitwarden plugin for the Pants build system",
"version": "0.4.0",
"project_urls": {
"Changelog": "https://github.com/tgolsson/pants-backends/tree/main/pants-plugins/bitwarden/CHANGELOG.md",
"Code": "https://github.com/tgolsson/pants-backends/tree/main/pants-plugins/bitwarden",
"Repository": "https://github.com/tgolsson/pants-backends"
},
"split_keywords": [
"pantsbuild",
" pants",
" backend",
" bitwarden"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "23572360978eb85a647ceb8080fbc8c994b8b293441ea5c79f6e462bce6f8679",
"md5": "000ebc39b0857c8ed30aebd7127d8e0a",
"sha256": "9db4da9eeff72bd10b2c4191a489c3a866375ca0172640aa8d6842f6ed15c083"
},
"downloads": -1,
"filename": "pants_backend_bitwarden-0.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "000ebc39b0857c8ed30aebd7127d8e0a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 7513,
"upload_time": "2024-09-19T12:07:15",
"upload_time_iso_8601": "2024-09-19T12:07:15.925970Z",
"url": "https://files.pythonhosted.org/packages/23/57/2360978eb85a647ceb8080fbc8c994b8b293441ea5c79f6e462bce6f8679/pants_backend_bitwarden-0.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9b14d73135f720177f1a20c72ecc38d9a1d17d69d6441159886bb745dd7dc708",
"md5": "e7a434b671cdb2dee6bdb3bda0af75a7",
"sha256": "98a77725c0a32bf1c108deb0f956b5c50a712a9d97ebc04b1341ee45ed492a06"
},
"downloads": -1,
"filename": "pants-backend-bitwarden-0.4.0.tar.gz",
"has_sig": false,
"md5_digest": "e7a434b671cdb2dee6bdb3bda0af75a7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 5508,
"upload_time": "2024-09-19T12:07:17",
"upload_time_iso_8601": "2024-09-19T12:07:17.660481Z",
"url": "https://files.pythonhosted.org/packages/9b/14/d73135f720177f1a20c72ecc38d9a1d17d69d6441159886bb745dd7dc708/pants-backend-bitwarden-0.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-19 12:07:17",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tgolsson",
"github_project": "pants-backends",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pants-backend-bitwarden"
}
JSON
