Metadata-Version: 2.1
Name: klio
Version: 21.12.0
Summary: Conventions for Python + Apache Beam 
Home-page: https://github.com/spotify/klio
Author: The klio developers
Author-email: opensource+klio@spotify.com
Maintainer: The klio developers
Maintainer-email: opensource+klio@spotify.com
License: UNKNOWN
Project-URL: Documentation, https://docs.klio.io
Project-URL: Bug Tracker, https://github.com/spotify/klio/issues
Project-URL: Source Code, https://github.com/spotify/klio
Keywords: klio,apache,beam,audio
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Multimedia
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Image Processing
Requires-Python: >=3.6, <3.9
Description-Content-Type: text/x-rst
Provides-Extra: docs
Provides-Extra: tests
Provides-Extra: audio
Provides-Extra: dev

The ``klio`` Library
====================

.. image:: https://img.shields.io/pypi/v/klio?color=%2300aa55&label=klio
   :target: https://pypi.org/project/klio
   :alt: Latest version of klio on PyPI

.. image:: https://github.com/spotify/klio/workflows/klio%20unit%20tests/badge.svg
   :target: https://github.com/spotify/klio/actions?query=workflow%3A%22klio+unit+tests%22
   :alt: Status of klio unit tests

.. start-klio-lib-intro

The library for implementing Klio-ified Apache Beam transforms with `decorators <https://docs.klio.io/en/latest/userguide/pipeline/utilities.html>`_, `helper transforms <https://docs.klio.io/en/latest/userguide/pipeline/transforms.html>`_, and leverage Klio's `message-handling logic <https://docs.klio.io/en/latest/userguide/pipeline/message.html>`_.

As the ``klio`` library is **not** meant to be installed directly, check out the `installation guide <https://docs.klio.io/en/latest/quickstart/installation.html>`_ for how to setup installation.
There is also the `user guide <https://docs.klio.io/en/latest/userguide/index.html>`_ and the `API documentation <https://docs.klio.io/en/latest/reference/lib/index.html>`_ for more information.



.. role:: violetemph


What is Klio?
-------------

.. start-intro

Klio is an :violetemph:`ecosystem` that allows you to process audio files – or any binary files – easily and at scale.

Klio jobs are :violetemph:`opinionated` data pipelines in Python (streaming or batch) built upon `Apache Beam <https://beam.apache.org/>`_ and tuned for audio and binary file processing.

Klio was built by Spotify to run our large-scale :violetemph:`audio intelligence systems` and is used by teams of engineers and audio researchers to help develop and deploy next generation audio algorithms.

.. end-intro

Read more about Klio `here <https://docs.klio.io/en/latest/userguide/index.html>`_.

Get Started
-----------

Check out our `Quick Start <https://docs.klio.io/en/latest/userguide/quickstart/index.html>`_ guide on how to start using Klio.


Resources
---------

.. start-resources

* Have a look at our `complete documentation <https://docs.klio.io/en/latest/index.html>`_.
* Check out our `contributors' guide <https://docs.klio.io/en/latest/contributors.html>`_.
* Join the ``#klio`` channel in the `Spotify FOSS Slack organization <https://slackin.spotify.com>`_.
* Read up on some of our `FAQs <https://docs.klio.io/en/latest/faqs/index.html>`_.
* Review our `Code of Conduct <https://github.com/spotify/klio/blob/master/CODE_OF_CONDUCT.rst>`_ - this is how we roll.

.. end-resources

Release Information
===================

21.12.0 (2021-12-14)
--------------------

.. start-21.12.0

Fixed
*****

* Fixed bug in metrics parsing when metrics configuration was set to a bool instead of a dict.

Removed
*******

* Removed deprecated Stackdriver log-based metrics client.

Changes
*******

* Updated documentation related to the native metrics client.
* ``KlioConfig`` is now loaded on workers from pickled main session instead of a bundled config file (See `PR 220 <https://github.com/spotify/klio/pull/220>`_).

.. end-21.12.0


.. _lib-21.9.0:


`Full Changelog <https://docs.klio.io/en/latest/reference/lib/changelog.html>`_.



