| Name | plush-fabric JSON |
| Version |
1.0.8
JSON |
| download |
| home_page | None |
| Summary | Helper library for Fabric to simplify creating and managing GitHub deploy keys when deploying GitHub-hosted repositories |
| upload_time | 2024-12-01 17:57:20 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.12 |
| license | None |
| keywords |
fabric
github
deployment
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
Plush
==============
A helper library for [Fabric](https://www.fabfile.org) to simplify creating and managing GitHub deploy keys when deploying your GitHub-hosted
repository. Currently, Plush is only tested on Ubuntu 24.04 LTS.
Plush aims to make deployments easier by:
- Using OAuth flows to securely connect to the GitHub API on your behalf
(while supporting 2 factor auth and never handling your username/password)
- Generating SSH deploy keys on your target server/computer
- Registering these deploy keys with your GitHub repo programmatically
- Configuring your new clone to use the appropriate deploy key while not conflicting with other
SSH keys used elsewhere on your server
- ACL'ing these keys so they can be reused by people to fetch/deploy on your behalf
(and not readable by anyone else on the server)
- Example PowerShell scripts are provided that give tab completion around fab.exe
To see this project in action, follow the directions in Setup-Dev-Environment.md. You will need access to an Ubuntu 24.04 machine (ideally a VM).
## Usage
This project is intended to be used by projects that use or are considering [Fabric](https://www.fabfile.org) for their deployments. Plush versions 1.0 and greater expect Fabric 3.2.2 and greater. In a project that uses Fabric, install Plush by running:
```
pip install plush-fabric
```
To get started, see the fabfile.py in this repo for a minimal usage of Plush. For a more complete example, see my [BaseDjangoAngular template](https://github.com/kbarnes3/BaseDjangoAngular).
Raw data
{
"_id": null,
"home_page": null,
"name": "plush-fabric",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "Fabric, GitHub, deployment",
"author": null,
"author_email": "Kevin Barnes <kbarnes3@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/64/8f/cd3a3729089c8a0833325e301fe9952fc4b1b37b1b6f965d79de70ea4c75/plush_fabric-1.0.8.tar.gz",
"platform": null,
"description": "Plush\n==============\n\nA helper library for [Fabric](https://www.fabfile.org) to simplify creating and managing GitHub deploy keys when deploying your GitHub-hosted\nrepository. Currently, Plush is only tested on Ubuntu 24.04 LTS.\n\nPlush aims to make deployments easier by:\n- Using OAuth flows to securely connect to the GitHub API on your behalf\n(while supporting 2 factor auth and never handling your username/password)\n- Generating SSH deploy keys on your target server/computer\n- Registering these deploy keys with your GitHub repo programmatically\n- Configuring your new clone to use the appropriate deploy key while not conflicting with other \nSSH keys used elsewhere on your server\n- ACL'ing these keys so they can be reused by people to fetch/deploy on your behalf\n(and not readable by anyone else on the server)\n- Example PowerShell scripts are provided that give tab completion around fab.exe\n\nTo see this project in action, follow the directions in Setup-Dev-Environment.md. You will need access to an Ubuntu 24.04 machine (ideally a VM).\n\n## Usage\n\nThis project is intended to be used by projects that use or are considering [Fabric](https://www.fabfile.org) for their deployments. Plush versions 1.0 and greater expect Fabric 3.2.2 and greater. In a project that uses Fabric, install Plush by running:\n\n```\npip install plush-fabric\n```\n\nTo get started, see the fabfile.py in this repo for a minimal usage of Plush. For a more complete example, see my [BaseDjangoAngular template](https://github.com/kbarnes3/BaseDjangoAngular).\n",
"bugtrack_url": null,
"license": null,
"summary": "Helper library for Fabric to simplify creating and managing GitHub deploy keys when deploying GitHub-hosted repositories",
"version": "1.0.8",
"project_urls": {
"Homepage": "https://github.com/kbarnes3/Plush",
"Issues": "https://github.com/kbarnes3/Plush/issues"
},
"split_keywords": [
"fabric",
" github",
" deployment"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7ed3ddcb25a25cc38c426f59a7b6a248a3ce5c92e420aed81ae22dcd8620c37c",
"md5": "654fefaa1a7f587442e941220a21a35d",
"sha256": "a1be092e45a208f4935c4be335b47b631386af322e7154389ec191fc686c0dad"
},
"downloads": -1,
"filename": "plush_fabric-1.0.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "654fefaa1a7f587442e941220a21a35d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 14098,
"upload_time": "2024-12-01T17:57:18",
"upload_time_iso_8601": "2024-12-01T17:57:18.708010Z",
"url": "https://files.pythonhosted.org/packages/7e/d3/ddcb25a25cc38c426f59a7b6a248a3ce5c92e420aed81ae22dcd8620c37c/plush_fabric-1.0.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "648fcd3a3729089c8a0833325e301fe9952fc4b1b37b1b6f965d79de70ea4c75",
"md5": "7360023db94866adb0a8c1df86228d03",
"sha256": "25c56a6fea09424d96a85cbe975a8ac671e197c41a092a626c36f7da31906eac"
},
"downloads": -1,
"filename": "plush_fabric-1.0.8.tar.gz",
"has_sig": false,
"md5_digest": "7360023db94866adb0a8c1df86228d03",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 12647,
"upload_time": "2024-12-01T17:57:20",
"upload_time_iso_8601": "2024-12-01T17:57:20.664563Z",
"url": "https://files.pythonhosted.org/packages/64/8f/cd3a3729089c8a0833325e301fe9952fc4b1b37b1b6f965d79de70ea4c75/plush_fabric-1.0.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-01 17:57:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "kbarnes3",
"github_project": "Plush",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "plush-fabric"
}
