Metadata-Version: 2.1
Name: timber
Version: 2.1.0
Summary: timber.io client API library
Home-page: https://github.com/timberio/timber-python
Author: Timber Technologies, Inc.
Author-email: help@timber.io
License: MIT
Download-URL: https://github.com/timberio/timber-python/tarball/2.1.0
Keywords: api,timber,logging,client
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/markdown
Requires-Dist: requests (>=2.18.4)
Requires-Dist: msgpack (>=0.5.6)

# 🌲 Timber - Great Python Logging Made Easy

<p align="center">
  <a href="https://timber.io" target="_blank" align="center">
    <img src="https://res.cloudinary.com/timber/image/upload/v1552328675/banner.jpg" width="900">
  </a>
  <br>
</p>

[![ISC License](https://img.shields.io/badge/license-ISC-ff69b4.svg)](LICENSE.md)
[![Pypi](https://img.shields.io/pypi/v/timber.svg)](https://pypi.python.org/pypi/timber)
[![Python Support](https://img.shields.io/pypi/pyversions/timber.svg)](https://pypi.python.org/pypi/django-analytical)
[![Build Status](https://travis-ci.org/timberio/timber-python.svg?branch=master)](https://travis-ci.org/timberio/timber-python)

[Timber.io](https://timber.io) is a hosted service for aggregating logs across your entire stack -
[any language](https://docs.timber.io/setup/languages),
[any platform](https://docs.timber.io/setup/platforms),
[any data source](https://docs.timber.io/setup/log_forwarders).

Unlike traditional logging tools, Timber integrates with language runtimes to automatically
capture in-app context, turning your text-based logs into rich structured events.
Timber integrates with Python through this library. And Timber's
[rich free-form query tools](https://docs-new.timber.io/usage/live-tailing#query-syntax) and
[real-time tailing](https://docs-new.timber.io/usage/live-tailing), make drilling down into
important stats easier than ever.

---

### Features

* Simple integration. Integrates with the Python `logging` library.
* Support for structured logging and events.
* Support for context.
* Automatically captures useful context.
* Performant, light weight, with a thoughtful design.

---

### Get Started

* **[Installation](https://docs.timber.io/setup/languages/python#installation)**
* **[Configuration](https://docs.timber.io/setup/languages/python#configuration)**
* **[Usage](https://docs.timber.io/setup/languages/python#usage)**
* **[Guides](https://docs.timber.io/setup/languages/python#guides)**
* **[Automatic Context](https://docs.timber.io/setup/languages/python#automatic-context)**
* **[Performance](https://docs.timber.io/setup/languages/python#performance)**

---

<p align="center">
<a href="https://timber.io">Timber</a> &bull;
<a href="https://docs.timber.io">Docs</a> &bull;
<a href="https://timber.io/pricing">Pricing</a> &bull;
<a href="https://timber.io/terms">Security</a> &bull;
<a href="https://timber.io/privacy">Compliance</a>
</p>

