معرفی شرکت ها
context-logging-1.1.0
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Tool for easy logging with current context information
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | context-logging-1.1.0 |
| نام | context-logging |
| نسخه کتابخانه | 1.1.0 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Evgeniy Afonasev |
| ایمیل نویسنده | ea.afonasev@gmail.com |
| آدرس صفحه اصلی | https://pypi.org/project/context_logging |
| آدرس اینترنتی | https://pypi.org/project/context-logging/ |
| مجوز | MIT |
# context_logging
[](https://pypi.org/project/context_logging)
[](https://pypi.org/project/context_logging)
[](https://pypistats.org/packages/context_logging)
[](https://codecov.io/gh/Afonasev/context_logging)
[](https://en.wikipedia.org/wiki/MIT_License)
[](https://github.com/ambv/black)
## Description
Tool for easy logging with current context information.
```python
from context_logging import current_context
logging.info('before context')
# 2019-07-25 19:49:43 INFO before context
with Context('my_context'):
current_context['var'] = 1
logging.info('in context')
# 2019-07-25 19:49:43 INFO in context {'var': 1}
# 2019-07-25 19:49:43 INFO 'my_context: executed in 00:00:01 {'var': 1}'
logging.info('after context')
# 2019-07-25 19:49:43 INFO after context
```
## Installation
pip install context_logging
## Usage
### Setup logging with context
```python
import logging
from context_logging import current_context, setup_log_record
logging.basicConfig(
format='%(asctime)s %(levelname)s %(name)s %(message)s %(context)s',
level=logging.INFO,
)
setup_log_record()
current_context['var'] = 1
logging.info('message')
# 2019-07-25 19:49:43,892 INFO root message {'var': 1}
```
### As contextmanager
```python
from context_logging import Context, current_context
with Context(var=1):
assert current_context['var'] == 1
assert 'var' not in current_context
```
### Any nesting of contexts is allowed
```python
with Context(var=1):
assert current_context == {'var': 1}
with Context(val=2, var=2):
assert current_context == {'val': 2, 'var': 2}
assert current_context == {'var': 1}
assert 'var' not in current_context
```
### As decorator
```python
@Context(var=1)
def f():
assert current_context['var'] == 1
f()
assert 'var' not in current_context
```
### With start/finish [DEPRECATED]
```python
ctx = Context(var=1)
assert 'var' not in current_context
ctx.start()
assert current_context['var'] == 1
ctx.finish()
assert 'var' not in current_context
```
### Add/remove values from current_context
```python
with Context():
assert 'var' not in current_context
current_context['var'] = 1
assert current_context['var'] == 1
```
### Explicit context name (else will be used path to the python module)
```python
with Context('my_context'):
pass
```
### Execution time logged on exit from context (it can be disabled with `log_execution_time=False` argument)
```python
with Context('my_context'):
time.sleep(1)
# INFO 'my_context: executed in 00:00:01',
```
Default value for log_execution_time param can be changed with env
export CONTEXT_LOGGING_LOG_EXECUTION_TIME_DEFAULT=0
### Exceptions from context are populated with current_context (it can be disabled with `fill_exception_context=False` argument)
```python
try:
with Context(var=1):
raise Exception(1)
except Exception as exc:
assert exc.args = (1, {'var': 1})
```
Default value for fill_exception_context param can be changed with env
export CONTEXT_LOGGING_FILL_EXEPTIONS_DEFAULT=0
### We can set data to root context that never will be closed
```python
from context_logging import root_context
root_context['env'] = 'test'
```
### If you want to pass context to other threads use [ContextVarExecutor](https://github.com/hellysmile/contextvars_executor)
```python
from context_logging import ContextVarExecutor
with ContextVarExecutor() as executor:
executor.submit(...)
# OR
loop.set_default_executor(ContextVarExecutor()) # for asyncio loop
```
## For developers
### Create venv and install deps
make init
### Install git precommit hook
make precommit_hook
### Run linters, autoformat, tests etc.
make pretty lint test
### Bump new version
make bump_major
make bump_minor
make bump_patch
نیازمندی
| مقدار | نام |
|---|---|
| >=0.0.1,<0.0.2 | contextvars_executor |
| >=1.2.10,<2.0.0 | deprecated |
| >=1,<2 | pydantic |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.7,<4.0 | Python |
نحوه نصب
نصب پکیج whl context-logging-1.1.0:
pip install context-logging-1.1.0.whl
نصب پکیج tar.gz context-logging-1.1.0:
pip install context-logging-1.1.0.tar.gz