Metadata-Version: 2.4
Name: coralogix_logger
Version: 2.1.1
Summary: Coralogix Python SDK
Home-page: http://www.coralogix.com/
Download-URL: https://github.com/coralogix/python-coralogix-sdk/archive/master.zip
Author: Coralogix Ltd.
Author-email: info@coralogix.com
Maintainer: Coralogix Ltd.
Maintainer-email: info@coralogix.com
License: Apache Version 2.0
Keywords: Coralogix,Logging,Logger
Classifier: Development Status :: 5 - Production/Stable
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Manufacturing
Classifier: Intended Audience :: Telecommunications Industry
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Internet :: Log Analysis
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Logging
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: System :: Networking :: Monitoring
Classifier: Topic :: Utilities
Requires-Python: >=3.5
License-File: LICENSE
Requires-Dist: requests>=2.24.0
Provides-Extra: development
Requires-Dist: wheel>=0.31.0; extra == "development"
Requires-Dist: twine>=3.3.0; extra == "development"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: download-url
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: maintainer
Dynamic: maintainer-email
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

Coralogix Python SDK
====================

.. image:: https://img.shields.io/pypi/v/coralogix_logger.svg
    :target: https://pypi.python.org/pypi/coralogix_logger

.. image:: https://img.shields.io/pypi/l/coralogix_logger.svg
    :target: https://raw.githubusercontent.com/coralogix/python-coralogix-sdk/master/LICENSE

.. image:: https://img.shields.io/pypi/pyversions/coralogix_logger.svg
    :target: https://pypi.python.org/pypi/coralogix_logger

.. image:: https://img.shields.io/pypi/wheel/coralogix_logger.svg
    :target: https://pypi.python.org/pypi/coralogix_logger

.. image:: https://img.shields.io/pypi/status/coralogix_logger.svg
    :target: https://pypi.python.org/pypi/coralogix_logger

.. image:: https://travis-ci.org/coralogix/python-coralogix-sdk.svg?branch=master
    :target: https://travis-ci.org/coralogix/python-coralogix-sdk

.. image:: https://readthedocs.org/projects/python-coralogix-sdk/badge/?version=latest
    :target: https://python-coralogix-sdk.readthedocs.io/en/latest/

.. image:: https://codecov.io/gh/coralogix/python-coralogix-sdk/branch/master/graph/badge.svg
   :target: https://codecov.io/gh/coralogix/python-coralogix-sdk

.. image:: https://api.codeclimate.com/v1/badges/474f12c23edee33936b9/maintainability
   :target: https://codeclimate.com/github/coralogix/python-coralogix-sdk/maintainability

.. image:: https://api.codeclimate.com/v1/badges/474f12c23edee33936b9/test_coverage
   :target: https://codeclimate.com/github/coralogix/python-coralogix-sdk/test_coverage

.. image:: https://img.shields.io/github/issues/coralogix/python-coralogix-sdk.svg
    :target: https://github.com/coralogix/python-coralogix-sdk

.. image:: https://img.shields.io/github/issues-pr/coralogix/python-coralogix-sdk.svg
    :target: https://github.com/coralogix/python-coralogix-sdk

.. image:: https://img.shields.io/github/contributors/coralogix/python-coralogix-sdk.svg
    :target: https://github.com/coralogix/python-coralogix-sdk/graphs/contributors

This package provides logging suites integrated with `Coralogix` logs analytics platform.
To see how to use it, please read `Coralogix Python SDK Docs <https://coralogix.com/docs/integrations/sdks/python-sdk/>`_.

Region Selection
================

The SDK requires a Coralogix region to be specified. You can specify the region in two ways:

1. **Environment Variable**: Set the ``CORALOGIX_REGION`` environment variable to one of the supported regions.

2. **Code Parameter**: Pass the ``region`` parameter when initializing the logger.

**Note**: The region is mandatory. If no region is provided (neither as a parameter nor via environment variable), the SDK will raise a ``ValueError``.

Supported regions:
- **AP1** - Mumbai (AWS: ap-south-1)
- **AP2** - Singapore (AWS: ap-southeast-1)
- **AP3** - Jakarta (AWS: ap-southeast-3)
- **EU1** - Ireland (AWS: eu-west-1)
- **EU2** - Stockholm (AWS: eu-north-1)
- **US1** - Ohio (AWS: us-east-2)
- **US2** - N. Virginia (AWS: us-east-1)

Example usage:

.. code-block:: python

    from coralogix.handlers import CoralogixLogger

    # Using region parameter
    logger = CoralogixLogger(
        private_key="YOUR_PRIVATE_KEY",
        app_name="MyApp",
        subsystem="backend",
        region="EU1"
    )

    # Or set via environment variable
    # export CORALOGIX_REGION=EU1
