============
Caprover API
============
.. image:: https://img.shields.io/pypi/v/caprover_api.svg
:target: https://pypi.python.org/pypi/caprover_api
.. image:: https://img.shields.io/travis/ak4zh/caprover_api.svg
:target: https://travis-ci.com/ak4zh/caprover_api
.. image:: https://readthedocs.org/projects/caprover-api/badge/?version=latest
:target: https://caprover-api.readthedocs.io/en/latest/?version=latest
:alt: Documentation Status
unofficial caprover api to deploy apps to caprover
* Free software: MIT license
* Full Documentation: https://caprover-api.readthedocs.io.
Features
--------
* create app
* add custom domain
* enable ssl
* update app with port mappings, env variables, repo info etc
* deploy one click apps
* get list of all apps
* get app by name
* delete app
* delete app and it's volumes
* stop app
* scale app
Usage
-----
To use Caprover API in a project::
from caprover_api import caprover_api
cap = caprover_api.CaproverAPI(
dashboard_url="cap-dashboard-url",
password="cap-dashboard-password"
)
One Click Apps
^^^^^^^^^^^^^^^
get app name from `List of one-click-apps <https://github.com/caprover/one-click-apps/tree/master/public/v4/apps>`_
automated deploy::
app_variables = {
"$$cap_redis_password": "REDIS-PASSWORD-HERE"
}
cap.deploy_one_click_app(
one_click_app_name='redis',
namespace='new-app',
app_variables=app_variables,
automated=True
)
manual deploy (you will be asked to enter required variables during runtime)::
cap.deploy_one_click_app(
one_click_app_name='redis',
namespace='new-app',
)
Custom Apps
^^^^^^^^^^^^
create a new app::
cap.create_app(
app_name="new-app",
has_persistent_data=False
)
create and deploy redis app from docker hub::
cap.create_and_update_app(
app_name="new-app-redis",
has_persistent_data=False,
image_name='redis:5',
persistent_directories=['new-app-redis-data:/data', ]
)
=======
History
=======
0.1.0 (2021-06-11)
------------------
* First release on PyPI.
Raw data
{
"_id": null,
"home_page": "https://github.com/neo3k/caprover-api-toolkit",
"name": "caprover-api-toolkit",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "caprover_api_toolkit",
"author": "Boris Vera",
"author_email": "boris@wearevera.com",
"download_url": "https://files.pythonhosted.org/packages/87/a2/567952e64ae42a1fe92cd94803a4b2c5fc752cd70214149df56543f90871/caprover_api_toolkit-0.2.6.tar.gz",
"platform": null,
"description": "============\nCaprover API\n============\n\n\n.. image:: https://img.shields.io/pypi/v/caprover_api.svg\n :target: https://pypi.python.org/pypi/caprover_api\n\n.. image:: https://img.shields.io/travis/ak4zh/caprover_api.svg\n :target: https://travis-ci.com/ak4zh/caprover_api\n\n.. image:: https://readthedocs.org/projects/caprover-api/badge/?version=latest\n :target: https://caprover-api.readthedocs.io/en/latest/?version=latest\n :alt: Documentation Status\n\n\n\n\nunofficial caprover api to deploy apps to caprover\n\n\n* Free software: MIT license\n* Full Documentation: https://caprover-api.readthedocs.io.\n\n\nFeatures\n--------\n\n* create app\n* add custom domain\n* enable ssl\n* update app with port mappings, env variables, repo info etc\n* deploy one click apps\n* get list of all apps\n* get app by name\n* delete app\n* delete app and it's volumes\n* stop app\n* scale app\n\n\nUsage\n-----\n\nTo use Caprover API in a project::\n\n from caprover_api import caprover_api\n\n cap = caprover_api.CaproverAPI(\n dashboard_url=\"cap-dashboard-url\",\n password=\"cap-dashboard-password\"\n )\n\n\nOne Click Apps\n^^^^^^^^^^^^^^^\n\nget app name from `List of one-click-apps <https://github.com/caprover/one-click-apps/tree/master/public/v4/apps>`_\n\nautomated deploy::\n\n app_variables = {\n \"$$cap_redis_password\": \"REDIS-PASSWORD-HERE\"\n }\n cap.deploy_one_click_app(\n one_click_app_name='redis',\n namespace='new-app',\n app_variables=app_variables,\n automated=True\n )\n\n\nmanual deploy (you will be asked to enter required variables during runtime)::\n\n cap.deploy_one_click_app(\n one_click_app_name='redis',\n namespace='new-app',\n )\n\n\nCustom Apps\n^^^^^^^^^^^^\n\ncreate a new app::\n\n cap.create_app(\n app_name=\"new-app\",\n has_persistent_data=False\n )\n\n\ncreate and deploy redis app from docker hub::\n\n cap.create_and_update_app(\n app_name=\"new-app-redis\",\n has_persistent_data=False,\n image_name='redis:5',\n persistent_directories=['new-app-redis-data:/data', ]\n )\n\n\n\n=======\nHistory\n=======\n\n0.1.0 (2021-06-11)\n------------------\n\n* First release on PyPI.\n",
"bugtrack_url": null,
"license": "MIT license",
"summary": "unofficial caprover api to deploy apps to caprover",
"version": "0.2.6",
"project_urls": {
"Homepage": "https://github.com/neo3k/caprover-api-toolkit"
},
"split_keywords": [
"caprover_api_toolkit"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ec6aecd23e3bd2e68978b02e8fb87e49dc47f56b0edeafd9b31c664ca944865e",
"md5": "f8dd253da73f3e5ed1149cbaac8764e9",
"sha256": "3326de75a3731deccd9790ce1a0734124b7d1b23831d9a703ef9d0410137d2f9"
},
"downloads": -1,
"filename": "caprover_api_toolkit-0.2.6-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "f8dd253da73f3e5ed1149cbaac8764e9",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.6",
"size": 10320,
"upload_time": "2023-11-12T17:29:35",
"upload_time_iso_8601": "2023-11-12T17:29:35.342350Z",
"url": "https://files.pythonhosted.org/packages/ec/6a/ecd23e3bd2e68978b02e8fb87e49dc47f56b0edeafd9b31c664ca944865e/caprover_api_toolkit-0.2.6-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "87a2567952e64ae42a1fe92cd94803a4b2c5fc752cd70214149df56543f90871",
"md5": "db05190445bf26ed1b16e3875b354ab6",
"sha256": "fa3b3e8c024f0b8d187c4557cef7fbe3d18970d8ed0ecddc1fb7c7e4332e7edc"
},
"downloads": -1,
"filename": "caprover_api_toolkit-0.2.6.tar.gz",
"has_sig": false,
"md5_digest": "db05190445bf26ed1b16e3875b354ab6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 20691,
"upload_time": "2023-11-12T17:29:36",
"upload_time_iso_8601": "2023-11-12T17:29:36.824117Z",
"url": "https://files.pythonhosted.org/packages/87/a2/567952e64ae42a1fe92cd94803a4b2c5fc752cd70214149df56543f90871/caprover_api_toolkit-0.2.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-12 17:29:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "neo3k",
"github_project": "caprover-api-toolkit",
"travis_ci": true,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "caprover-api-toolkit"
}
JSON
