%global _empty_manifest_terminate_build 0
Name:		python-citibox-gcloud-logger
Version:	0.5.1
Release:	1
Summary:	Citibox Google cloud logging tools
License:	MIT License
URL:		https://citibox.com
Source0:	https://mirrors.nju.edu.cn/pypi/web/packages/31/94/6009251bcd6aab7e3de1937db3fcf6d4f2b525475141f82f0b1d4b9658f8/citibox-gcloud-logger-0.5.1.tar.gz
BuildArch:	noarch


%description
# gcloud-logger
Python log wrapper for gcloud logging format

## How to use it?

Create your filter classes as needed, extending BaseContextFilter i.e.
````python
from citibox.gcloudlogger import BaseContextFilter


class MyTestFilter(BaseContextFilter):
    def __init__(self):
        super().__init__()
        self.some_attribute = "Some Value"

    @staticmethod
    def filter_name():
        return "my_test_filter"


    def to_dict(self) -> dict:
        return {
            "some_attribute": self.some_attribute
        }
````

Get logger from generated dict:
1. Import logging required
    ```python
    import logging
    from logging.config import dictConfig
    ```
2. Import GCloudLogConfig:
    ```python
    from citibox.gcloudlogger import GCloudLogConfig
    ```

3. Instance the library with your custom filters and set the logger config:
    ```python
    my_log_config = GCloudLogConfig(MyTestFilter)
    dictConfig(my_log_config.config)
    ```
4. Use the logger as normally:
    ```python
   logger = logging.getLogger()

   logger.info("something good is happening")
    ```

 Also, you can add more loggers if needed:
 ```python
    import logging
    from logging.config import dictConfig
    from citibox.gcloudlogger import GCloudLogConfig

    my_log_config = GCloudLogConfig(AnyFilter)
    my_log_config.add_logger("new_logger", level=logging.INFO)
    dictConfig(my_log_config.config) 
```

And, add filters after the creation of the log config class:
```python
    import logging
    from logging.config import dictConfig
    from citibox.gcloudlogger import GCloudLogConfig

    my_log_config = GCloudLogConfig(AnyFilter)
    my_log_config.add_filter(AnotherFilterClass)
```

### Using Middlewares
#### Falcon
There is a Falcon middleware ready for logging Request and Response.
Use [Falcon middlewares](https://falcon.readthedocs.io/en/stable/api/middleware.html) adding the included class:
```python
import falcon
from citibox.gcloudlogger.contrib.falcon import FalconMiddleware

app = falcon.API(middleware=[FalconMiddleware()])
```

#### Django
in your config file add:
```python
MIDDLEWARE = [
    'citibox.gcloudlogger.contrib.django.DjangoMiddleware',
    ...
]
```




%package -n python3-citibox-gcloud-logger
Summary:	Citibox Google cloud logging tools
Provides:	python-citibox-gcloud-logger
BuildRequires:	python3-devel
BuildRequires:	python3-setuptools
BuildRequires:	python3-pip
%description -n python3-citibox-gcloud-logger
# gcloud-logger
Python log wrapper for gcloud logging format

## How to use it?

Create your filter classes as needed, extending BaseContextFilter i.e.
````python
from citibox.gcloudlogger import BaseContextFilter


class MyTestFilter(BaseContextFilter):
    def __init__(self):
        super().__init__()
        self.some_attribute = "Some Value"

    @staticmethod
    def filter_name():
        return "my_test_filter"


    def to_dict(self) -> dict:
        return {
            "some_attribute": self.some_attribute
        }
````

Get logger from generated dict:
1. Import logging required
    ```python
    import logging
    from logging.config import dictConfig
    ```
2. Import GCloudLogConfig:
    ```python
    from citibox.gcloudlogger import GCloudLogConfig
    ```

3. Instance the library with your custom filters and set the logger config:
    ```python
    my_log_config = GCloudLogConfig(MyTestFilter)
    dictConfig(my_log_config.config)
    ```
4. Use the logger as normally:
    ```python
   logger = logging.getLogger()

   logger.info("something good is happening")
    ```

 Also, you can add more loggers if needed:
 ```python
    import logging
    from logging.config import dictConfig
    from citibox.gcloudlogger import GCloudLogConfig

    my_log_config = GCloudLogConfig(AnyFilter)
    my_log_config.add_logger("new_logger", level=logging.INFO)
    dictConfig(my_log_config.config) 
```

And, add filters after the creation of the log config class:
```python
    import logging
    from logging.config import dictConfig
    from citibox.gcloudlogger import GCloudLogConfig

    my_log_config = GCloudLogConfig(AnyFilter)
    my_log_config.add_filter(AnotherFilterClass)
```

### Using Middlewares
#### Falcon
There is a Falcon middleware ready for logging Request and Response.
Use [Falcon middlewares](https://falcon.readthedocs.io/en/stable/api/middleware.html) adding the included class:
```python
import falcon
from citibox.gcloudlogger.contrib.falcon import FalconMiddleware

app = falcon.API(middleware=[FalconMiddleware()])
```

#### Django
in your config file add:
```python
MIDDLEWARE = [
    'citibox.gcloudlogger.contrib.django.DjangoMiddleware',
    ...
]
```




%package help
Summary:	Development documents and examples for citibox-gcloud-logger
Provides:	python3-citibox-gcloud-logger-doc
%description help
# gcloud-logger
Python log wrapper for gcloud logging format

## How to use it?

Create your filter classes as needed, extending BaseContextFilter i.e.
````python
from citibox.gcloudlogger import BaseContextFilter


class MyTestFilter(BaseContextFilter):
    def __init__(self):
        super().__init__()
        self.some_attribute = "Some Value"

    @staticmethod
    def filter_name():
        return "my_test_filter"


    def to_dict(self) -> dict:
        return {
            "some_attribute": self.some_attribute
        }
````

Get logger from generated dict:
1. Import logging required
    ```python
    import logging
    from logging.config import dictConfig
    ```
2. Import GCloudLogConfig:
    ```python
    from citibox.gcloudlogger import GCloudLogConfig
    ```

3. Instance the library with your custom filters and set the logger config:
    ```python
    my_log_config = GCloudLogConfig(MyTestFilter)
    dictConfig(my_log_config.config)
    ```
4. Use the logger as normally:
    ```python
   logger = logging.getLogger()

   logger.info("something good is happening")
    ```

 Also, you can add more loggers if needed:
 ```python
    import logging
    from logging.config import dictConfig
    from citibox.gcloudlogger import GCloudLogConfig

    my_log_config = GCloudLogConfig(AnyFilter)
    my_log_config.add_logger("new_logger", level=logging.INFO)
    dictConfig(my_log_config.config) 
```

And, add filters after the creation of the log config class:
```python
    import logging
    from logging.config import dictConfig
    from citibox.gcloudlogger import GCloudLogConfig

    my_log_config = GCloudLogConfig(AnyFilter)
    my_log_config.add_filter(AnotherFilterClass)
```

### Using Middlewares
#### Falcon
There is a Falcon middleware ready for logging Request and Response.
Use [Falcon middlewares](https://falcon.readthedocs.io/en/stable/api/middleware.html) adding the included class:
```python
import falcon
from citibox.gcloudlogger.contrib.falcon import FalconMiddleware

app = falcon.API(middleware=[FalconMiddleware()])
```

#### Django
in your config file add:
```python
MIDDLEWARE = [
    'citibox.gcloudlogger.contrib.django.DjangoMiddleware',
    ...
]
```




%prep
%autosetup -n citibox-gcloud-logger-0.5.1

%build
%py3_build

%install
%py3_install
install -d -m755 %{buildroot}/%{_pkgdocdir}
if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
pushd %{buildroot}
if [ -d usr/lib ]; then
	find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst
fi
if [ -d usr/lib64 ]; then
	find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst
fi
if [ -d usr/bin ]; then
	find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst
fi
if [ -d usr/sbin ]; then
	find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst
fi
touch doclist.lst
if [ -d usr/share/man ]; then
	find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst
fi
popd
mv %{buildroot}/filelist.lst .
mv %{buildroot}/doclist.lst .

%files -n python3-citibox-gcloud-logger -f filelist.lst
%dir %{python3_sitelib}/*

%files help -f doclist.lst
%{_docdir}/*

%changelog
* Wed May 31 2023 Python_Bot <Python_Bot@openeuler.org> - 0.5.1-1
- Package Spec generated