TimeGuardian

TimeGuardian

TimeGuardian - это пакет Python, предназначенный для измерения и регистрации времени выполнения и использования памяти функций. Этот пакет особенно полезен для мониторинга и оптимизации производительности в приложениях Python.

Функции

• Декораторы для функций времени и использования памяти регистрации.
• Настраиваемая журнала для времени выполнения и использования памяти с богатым форматированием.
• Условное ведение журнала на основе времени выполнения и порогов использования памяти.

Установка

Установите TimeGuardian прямо из PIP:

pip install timeguardian

Или установите из исходного кода:

 cd path/to/TimeGuardian
pip install . 

Использование

Импортируйте TimeGuardian из пакета timeguardian и используйте его в качестве декоратора на ваших функциях, чтобы измерить время их выполнения и использование памяти.

Основное использование

 from timeguardian import TimeGuardian

# To measure execution time and/or memory usage
@ TimeGuardian . measure
def my_function ():
    # function implementation

# Custom name logging
@ TimeGuardian . measure ( name = "CustomName" )
def another_function ():
    # function implementation


# Custom logging with name, time and memory
@ TimeGuardian . measure ( name = "CustomName" , elapsed = True , memory = True ) #(elapsed in ms, memory in bytes)
def another_function ():
    # function implementation

Расширенное использование

Мониторинг производительности с условной регистрацией:

 from timeguardian import TimeGuardian

# Monitor and log only if execution time or memory usage exceeds the specified limits (time in ms, memory in bytes)
@ TimeGuardian . monitor ( elapsed = 200 , memory = 1024 )
def monitored_function ():
    # function implementation 

Установка глобальных единиц для измерения времени и памяти

Пакет TimeGuardian позволяет устанавливать глобальные единицы для измерений времени и памяти. Эта функция позволяет настраивать время выполнения и использование памяти.

Использование

1. Установите единицы : Используйте TimeGuardian.set_time_unit(unit) и TimeGuardian.set_memory_unit(unit) чтобы установить глобальные единицы для измерения времени и памяти. Параметр unit должен быть строкой, указывающей на желаемый блок (например, «MS» для миллисекундов, «S» для секунд, «байтов» для байтов, «kb» для килобитов, «Mb» для мегабайтов).

2. Украшивайте функции : примените @TimeGuardian.measure Decorator к вашим функциям. Этот декоратор будет использовать глобально установленные единицы для измерения и регистрации времени выполнения и использования памяти.

Пример

 from decorators import TimeGuardian

# Set the units for time and memory measurements
TimeGuardian . set_time_unit ( 'ms' )  # Set time unit to milliseconds
TimeGuardian . set_memory_unit ( 'MB' )  # Set memory unit to megabytes

@ TimeGuardian . measure ( elapsed = True , memory = True , name = "Sample Function" )
def sample_function ():
    # Function implementation
    ...

# Call the decorated function
sample_function ()

В этом примере sample_function измеряется и регистрируется в миллисекундах для времени и мегабайт для использования памяти.

Внося

Вклад в TimeGuardian приветствуются!

Лицензия

Этот проект лицензирован по лицензии MIT - для получения подробной информации см. Файл лицензии.