Metadata-Version: 2.1
Name: vaping
Version: 1.4.2
Summary: vaping is a healthy alternative to smokeping!
Home-page: https://github.com/20c/vaping
License: Apache-2.0
Author: 20C
Author-email: code@20c.com
Requires-Python: >=3.6.2,<4.0.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: No Input/Output (Daemon)
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Telecommunications Industry
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: System :: Networking :: Monitoring
Provides-Extra: all
Provides-Extra: graphite
Provides-Extra: rrdtool
Provides-Extra: standalone
Provides-Extra: whisper
Provides-Extra: zeromq
Requires-Dist: confu (>=1.7.1,<2.0.0)
Requires-Dist: graphsrv (>=2,<3); extra == "standalone" or extra == "all"
Requires-Dist: graphyte (>=1.4,<2.0); extra == "graphite" or extra == "all"
Requires-Dist: munge[yaml,tomlkit] (>=1.2.0,<2.0.0)
Requires-Dist: pid (>=3,<4)
Requires-Dist: pluginmgr (>=1,<2)
Requires-Dist: python-daemon (>=2,<3)
Requires-Dist: pyzmq (>=15.3.0,<19); extra == "zeromq" or extra == "all"
Requires-Dist: requests (>=2.19.1,<3.0.0); extra == "graphite" or extra == "all"
Requires-Dist: rrdtool (>=0.1.14,<1); extra == "rrdtool" or extra == "all"
Requires-Dist: vodka (>=3.1,<4.0); extra == "standalone" or extra == "all"
Requires-Dist: whisper (>=0.9.15,<2); extra == "whisper" or extra == "all"
Project-URL: Repository, https://github.com/20c/vaping
Description-Content-Type: text/markdown


# 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)
[![LGTM Grade](https://img.shields.io/lgtm/grade/python/github/20c/vaping)](https://lgtm.com/projects/g/20c/vaping/alerts/)
[![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 was started after years of frustration from dealing with perl and
environment management for smokeping. It's a simple python daemon which uses
asyncio to poll for input and send output through plugins.

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


## Installation

```sh
pip install vaping
```

Note, you will need a compiler and python development libraries for some components.

On CentOS/RHEL:

```sh
yum install gcc python-devel
```


## 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.


