Skip to main content

Automation friendly bulk action CLI helper for Uptime Kuma.

Project description

kumaone

Hatch project PyPI - Version PyPI - Python Version Documentation Status


Table of Contents

Note

kumaone's primary objective is to enable users to perform bulk action in uptime kuma server. A very special thanks to the author and contributors of the project uptime-kuma-api. kumaone is built by studying and understanding the code of uptime-kuma-api and in places I used some parts of the code as it is from uptime-kuma-api. Appreciate the outstanding work done by the author and contributors of both uptime kuma and uptime-kuma-api project.

kumaone is a CLI application. Designed for bulk operations mainly from reading configuration files. kumaone is very early in development. Contribution and constructive feedbacks are always welcome.

Virtualenv

  • Install pipenv from here

  • Activate virtual environment

    pipenv shell
    

    if there are no virtual environment available (e.g. first use), a virtual environment will be created and activated automatically.

  • Install dependencies

    To install dependencies with pipenv use the following command

    pipenv install
    

    To install dev dependencies use --dev flag

    pipenv install --dev
    

Installation

pip install kumaone

Installation (Dev)

pip install -e .

To Do List

Info

  • Show information about kumaone

Configuration

  • Show uptime kuma configuration (default/custom paths).
  • Create uptime kuma configuration (default/custom path).
  • Delete uptime kuma configuration.
  • Edit uptime kuma configuration.

Monitors

  • Supported Monitor types (tested)
    • HTTP
    • JSON_QUERY
    • PING
  • List all monitors.
  • List monitor by groups and processes also.
  • Show details of a monitor by ID.
  • Bulk add monitors from file(s).
  • Bulk delete monitors from file(s).
  • Add single monitor from inline dictionary data.
  • Delete single Monitor by name.
  • Delete single monitor by id.

Status Page

  • List all staus page(s).
  • See details of a single status page.
  • Add a new status page.
  • Add status pages from file(s).
  • Delete single status page by slug.
  • Delete status page from file(s).

Notification

  • Supported notification providers (tested)
    • Discord
    • Email(SMTP)
    • Opsgenie
    • PagerDuty
    • Rocket.Chat
    • Slack
    • Teams
    • Webhook
  • List all notification(s).
  • See details of a single notification by name/id.
  • Add new notification (interactive).
  • Add notifications from single file.
  • Delete notification by name.
  • Delete notification by id.
  • Delete notifications from single file.

Maintenance

TBA

Incident

TBA

Change Password

  • Change password from CLI.
  • Update password in kumaone config.

Cleanup

  • Clear heartbeats.
  • Clear statistics.
  • Clear events.

Backlog

  • Don't stop the program if one monitor process runs into error.
  • Add debug logs for methods.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kumaone-0.0.1a7.tar.gz (23.5 kB view details)

Uploaded Source

Built Distribution

kumaone-0.0.1a7-py3-none-any.whl (32.3 kB view details)

Uploaded Python 3

File details

Details for the file kumaone-0.0.1a7.tar.gz.

File metadata

  • Download URL: kumaone-0.0.1a7.tar.gz
  • Upload date:
  • Size: 23.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-httpx/0.27.0

File hashes

Hashes for kumaone-0.0.1a7.tar.gz
Algorithm Hash digest
SHA256 e28fd7f5f0738cf56b057e6d37409b715dee5aa28eab27c059a978a998fbe8ef
MD5 9de86dac94d3b095c31981cd97021829
BLAKE2b-256 45472b24b4dd6ff4e4c4042677232d94ff2409c82132facd92f1ae988a13d89a

See more details on using hashes here.

File details

Details for the file kumaone-0.0.1a7-py3-none-any.whl.

File metadata

  • Download URL: kumaone-0.0.1a7-py3-none-any.whl
  • Upload date:
  • Size: 32.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-httpx/0.27.0

File hashes

Hashes for kumaone-0.0.1a7-py3-none-any.whl
Algorithm Hash digest
SHA256 6c205c3b683ac79235d7179bd406daf6c547867c97872951e88c4d59f5bf9016
MD5 b0d05c9816bc786429b46d5073a55a8c
BLAKE2b-256 311efcb926d41d09c9bcf2b4cfe2c4ab02ffc7d7b05e89fccca3a1ecabdec942

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page