vaping


Namevaping JSON
Version 1.5.4 PyPI version JSON
download
home_pagehttps://github.com/20c/vaping
Summaryvaping is a healthy alternative to smokeping!
upload_time2024-04-29 02:21:43
maintainerNone
docs_urlNone
author20C
requires_python<4.0,>=3.8
licenseApache-2.0
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            
# Vaping

[![PyPI](https://img.shields.io/pypi/v/vaping.svg?maxAge=60)](https://pypi.python.org/pypi/vaping)
[![PyPI](https://img.shields.io/pypi/pyversions/vaping.svg?maxAge=600)](https://pypi.python.org/pypi/vaping)
[![Tests](https://github.com/20c/vaping/workflows/tests/badge.svg)](https://github.com/20c/vaping)
[![CodeQL](https://github.com/20c/vaping/actions/workflows/codeql.yml/badge.svg)](https://github.com/20c/vaping/actions/workflows/codeql.yml)
[![Codecov](https://img.shields.io/codecov/c/github/20c/vaping/master.svg)](https://codecov.io/github/20c/vaping)


vaping is a healthy alternative to smokeping!*

* (This statement has not been evaluated by the Food and Drug Administration)

![Vaping](https://raw.githubusercontent.com/20c/vaping/master/docs/img/vaping.png)

## Introduction

Vaping provides the following features:

- Real-time latency graphing viewable in the browser
- Line and smokestack graphs
- Containerized and easy to setup and configure
- Support for time-series databases
- Plugin-based design to allow integration with other services
- Supports distributed setups through message queue

Vaping is a Python daemon which polls for input and sends its output through plugins.

It has a standalone mode to directly serve realtime graphs in a browser, or can use ZeroMQ to distribute messages.

## Installation

```sh
pip install vaping
```

You will need a compiler and Python development libraries for some components, which you can obtain with the `gcc` and `python-devel` packages for your operating system.

Alternatively, you can use the [Docker image](Dockerfile), which includes all requirements.

## Quick Start

To use Vaping, you need first a configuration file that defines which hosts to target and where to send the output. You can have a look at [the examples in this repository](examples/) and adapt them to your needs.

Then, start the `vaping` program from the command line, specifying the path to the configuration file.

A quick start example is [available here](https://vaping.readthedocs.io/en/stable/quickstart/). It shows you how to ping multiple hosts and display the resulting graphs using a local web server.

## Usage


Vaping has a command-line interface with the following usage:

```
Usage: vaping [OPTIONS] COMMAND [ARGS]...

  Vaping

Options:
  --version    Show the version and exit.
  --quiet      no output at all
  --verbose    enable more verbose output
  --home TEXT  specify the home directory, by default will check in order:
               $VAPING_HOME, ./.vaping, ~/.config/vaping
  --debug      enable extra debug output
  --help       Show this message and exit.

Commands:
  start    start a vaping process
  stop     stop a vaping process
  restart  restart a vaping process
```

### start

Starts a vaping process, by default will fork into the background unless
`--debug` or `--no-fork` is passed.

It adds options:

```
  -d, --no-fork  do not fork into background
```


### stop

Stops a vaping process identified by `$VAPING_HOME/vaping.pid`


## Documentation

Documentation is created with mkdocs and available here:

**stable**: <http://vaping.readthedocs.io/en/stable/>

**latest**: <http://vaping.readthedocs.io/en/latest/>


## Changes

The current change log is available at <https://github.com/20c/vaping/blob/master/CHANGELOG.md>


## License

Copyright 2016-2021 20C, LLC

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this software except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.



            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/20c/vaping",
    "name": "vaping",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<4.0,>=3.8",
    "maintainer_email": null,
    "keywords": null,
    "author": "20C",
    "author_email": "code@20c.com",
    "download_url": "https://files.pythonhosted.org/packages/6f/50/d807c04c16b998748fd702c7f649079087a9f2000f97f4ca148ded4ebed2/vaping-1.5.4.tar.gz",
    "platform": null,
    "description": "\n# Vaping\n\n[![PyPI](https://img.shields.io/pypi/v/vaping.svg?maxAge=60)](https://pypi.python.org/pypi/vaping)\n[![PyPI](https://img.shields.io/pypi/pyversions/vaping.svg?maxAge=600)](https://pypi.python.org/pypi/vaping)\n[![Tests](https://github.com/20c/vaping/workflows/tests/badge.svg)](https://github.com/20c/vaping)\n[![CodeQL](https://github.com/20c/vaping/actions/workflows/codeql.yml/badge.svg)](https://github.com/20c/vaping/actions/workflows/codeql.yml)\n[![Codecov](https://img.shields.io/codecov/c/github/20c/vaping/master.svg)](https://codecov.io/github/20c/vaping)\n\n\nvaping is a healthy alternative to smokeping!*\n\n* (This statement has not been evaluated by the Food and Drug Administration)\n\n![Vaping](https://raw.githubusercontent.com/20c/vaping/master/docs/img/vaping.png)\n\n## Introduction\n\nVaping provides the following features:\n\n- Real-time latency graphing viewable in the browser\n- Line and smokestack graphs\n- Containerized and easy to setup and configure\n- Support for time-series databases\n- Plugin-based design to allow integration with other services\n- Supports distributed setups through message queue\n\nVaping is a Python daemon which polls for input and sends its output through plugins.\n\nIt has a standalone mode to directly serve realtime graphs in a browser, or can use ZeroMQ to distribute messages.\n\n## Installation\n\n```sh\npip install vaping\n```\n\nYou will need a compiler and Python development libraries for some components, which you can obtain with the `gcc` and `python-devel` packages for your operating system.\n\nAlternatively, you can use the [Docker image](Dockerfile), which includes all requirements.\n\n## Quick Start\n\nTo use Vaping, you need first a configuration file that defines which hosts to target and where to send the output. You can have a look at [the examples in this repository](examples/) and adapt them to your needs.\n\nThen, start the `vaping` program from the command line, specifying the path to the configuration file.\n\nA quick start example is [available here](https://vaping.readthedocs.io/en/stable/quickstart/). It shows you how to ping multiple hosts and display the resulting graphs using a local web server.\n\n## Usage\n\n\nVaping has a command-line interface with the following usage:\n\n```\nUsage: vaping [OPTIONS] COMMAND [ARGS]...\n\n  Vaping\n\nOptions:\n  --version    Show the version and exit.\n  --quiet      no output at all\n  --verbose    enable more verbose output\n  --home TEXT  specify the home directory, by default will check in order:\n               $VAPING_HOME, ./.vaping, ~/.config/vaping\n  --debug      enable extra debug output\n  --help       Show this message and exit.\n\nCommands:\n  start    start a vaping process\n  stop     stop a vaping process\n  restart  restart a vaping process\n```\n\n### start\n\nStarts a vaping process, by default will fork into the background unless\n`--debug` or `--no-fork` is passed.\n\nIt adds options:\n\n```\n  -d, --no-fork  do not fork into background\n```\n\n\n### stop\n\nStops a vaping process identified by `$VAPING_HOME/vaping.pid`\n\n\n## Documentation\n\nDocumentation is created with mkdocs and available here:\n\n**stable**: <http://vaping.readthedocs.io/en/stable/>\n\n**latest**: <http://vaping.readthedocs.io/en/latest/>\n\n\n## Changes\n\nThe current change log is available at <https://github.com/20c/vaping/blob/master/CHANGELOG.md>\n\n\n## License\n\nCopyright 2016-2021 20C, LLC\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this software except in compliance with the License.\nYou may obtain a copy of the License at\n\n   http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n\n\n",
    "bugtrack_url": null,
    "license": "Apache-2.0",
    "summary": "vaping is a healthy alternative to smokeping!",
    "version": "1.5.4",
    "project_urls": {
        "Homepage": "https://github.com/20c/vaping",
        "Repository": "https://github.com/20c/vaping"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "450aefdb90405272be46b9503176ca4437894b369cd2dcf5ba01b8e439255086",
                "md5": "80ba19be9175dcbaa4f5062ac2007ea1",
                "sha256": "0d721fe59ce480d5cb5a70332a3dd72f3c6731b08a7e4bf0eda982b94815cd11"
            },
            "downloads": -1,
            "filename": "vaping-1.5.4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "80ba19be9175dcbaa4f5062ac2007ea1",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4.0,>=3.8",
            "size": 32949,
            "upload_time": "2024-04-29T02:21:42",
            "upload_time_iso_8601": "2024-04-29T02:21:42.366005Z",
            "url": "https://files.pythonhosted.org/packages/45/0a/efdb90405272be46b9503176ca4437894b369cd2dcf5ba01b8e439255086/vaping-1.5.4-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "6f50d807c04c16b998748fd702c7f649079087a9f2000f97f4ca148ded4ebed2",
                "md5": "59256919723a6d11b59ba4b4c37eca6f",
                "sha256": "5b733ce5c7490a758ef678734258b312e7257ef83700086452da982efb419d49"
            },
            "downloads": -1,
            "filename": "vaping-1.5.4.tar.gz",
            "has_sig": false,
            "md5_digest": "59256919723a6d11b59ba4b4c37eca6f",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4.0,>=3.8",
            "size": 28058,
            "upload_time": "2024-04-29T02:21:43",
            "upload_time_iso_8601": "2024-04-29T02:21:43.950073Z",
            "url": "https://files.pythonhosted.org/packages/6f/50/d807c04c16b998748fd702c7f649079087a9f2000f97f4ca148ded4ebed2/vaping-1.5.4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-04-29 02:21:43",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "20c",
    "github_project": "vaping",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "tox": true,
    "lcname": "vaping"
}
        
20C
Elapsed time: 0.22445s