Giter VIP home page Giter VIP logo

timy's Introduction

timy

Python 3.4 Python 3.5 Python 3.6 Python 3.7

CircleCI Codecov

Minimalist measurement of python code time

timy comes with a different idea of the built-in module timeit. It adds flexibility and different ways of measuring code time, using simple context managers and function decorators.

Installing

pip install timy

Usage

Decorating a function

Let's say you have a calculate function and you want to keep track of its execution time

import timy

@timy.timer()
def calculate(n, r):
    """
    Divide, multiply and sum 'n' to every number in range 'r'
    returning the result list
    """
    return [i / n * n + n for i in range(r)]

Whenever you call that function, the execution time will be tracked

calculate(5, 10000000)
>> Timy executed (calculate) for 1 time(s) in 1.529540 seconds
>> Timy best time was 1.529540 seconds

Changing the ident and adding loops to the execution

import timy

@timy.timer(ident='My calculation', loops=10)
def calculate(n, r):
    return [i / n * n + n for i in range(r)]
    
calculate(5, 10000000)
>> My calculation executed (calculate) for 10 time(s) in 15.165313 seconds
>> My calculation best time was 1.414186 seconds

Tracking specific points along your code

The with statement can also be used to measure code time

Named tracking points can be added with the track function

import timy

with timy.Timer() as timer:
    N = 10000000
    for i in range(N):
        if i == N/2:
            timer.track('Half way')
            
>> Timy (Half way) 0.557577 seconds
>> Timy 0.988087 seconds            

Another usage of tracking in a prime factors function

def prime_factors(n):
    with timy.Timer('Factors') as timer:
        i = 2
        factors = []
        def add_factor(n):
            factors.append(n)
            timer.track('Found a factor')

        while i * i <= n:
            if n % i == 0:
                add_factor(i)
                n //= i
            else:
                i += 1
        return factors + [n]

factors = prime_factors(600851475143)
print(factors)

>> Factors (Found a factor) 0.000017 seconds
>> Factors (Found a factor) 0.000376 seconds
>> Factors (Found a factor) 0.001547 seconds
>> Factors 0.001754 seconds
>> [71, 839, 1471, 6857]

Configuring

Importing timy config

from timy.settings import timy_config

Enable or disable timy trackings

You can enable or disable timy trackings with the tracking value.

The default value of tracking is True

timy_config.tracking = False

Changing the way timy outputs information

You can choose between print or logging for all timy outputs by setting the value of tracking_mode.

The default value of tracking_mode is TrackingMode.PRINTING.

from timy.settings import (
    timy_config,
    TrackingMode
)

timy_config.tracking_mode = TrackingMode.LOGGING

timy logs at the INFO level, which is not printed or stored by default. To configure the logging system to print all INFO messages do

import logging
logging.basicConfig(level=logging.INFO)

or to configure the logging system to print only timy's INFO messages do

import logging
logging.basicConfig()
logging.getLogger('timy').level=logging.INFO

Contribute

Contributions are always welcome, but keep it simple and small.

License

This project is licensed under the MIT License - see the LICENSE file for details

timy's People

Contributors

micparke avatar mikepqr avatar ramonsaraiva avatar rasbt avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

timy's Issues

Add logging

Add logging

User Story

As a developer, i want to be able to log the tracking output instead of printing it.

Overview

Sometimes logging is preferred rather than printing, add a log functionality and settings to enable or disable both of the options.

Acceptance Criteria

  • Add log functionality
  • Add settings to enable or disable printing and logging

seconds is printed twice.

Tested with both Python 2.7 and 3.5 and on multiple devices.

>>>import timy
>>> 
>>> @timy.timer()
... def hello():
...     l = [x for x in range(0,1000)]
...     return l
... 
>>> hello()
Timy executed (hello) for 1 time in 0.000184 seconds seconds
Timy best time was 0.000184 seconds seconds

This doesn't happen with with statement

>>> import timy
>>> 
>>> with timy.Timer() as timer:
...     l = [x for x in range(0,10000)]
...     
... 
Timy 0.001751 seconds

process_time vs time

Hi there. Really like this lean approach using decorators. I am wondering though if it wouldn't be better to use time.process_time instead of time.time? Or maybe this could be toggled by another decorator function argument like time="total" vs time="process" or so. What are your thoughts on this?

Feedback

You should move code out of __init__.py. That should usually be left empty.
Also, are you aware of the timeit module?

$ python -m timeit -s 'foo = 5' -- 'foo + 1'
10000000 loops, best of 3: 0.044 usec per loop

You asked for feedback

[18:08:16] <woodoo> please, feedback on https://github.com/ramonsaraiva/timy
[18:08:24] *** Quits: woodoo (~ramon@unaffiliated/woodoo) (Client Quit)

Git hash is not being sent in codecov

Description

Check why git hash is not being sent on codecov, probably related to the docker image being used, seems like it does not have git.

Acceptance Criteria

  • No errors during tox and tests reports are uploaded properly with git hash

prime factors example in readme

the example does not return the prime factors of n

try this instead

def prime_factors(n):
    with timy.Timer('Factors') as timer:
        i = 2
        factors = []
        def add_factor(n):
            factors.append(n)
            timer.track('Found a factor')

        while i * i <= n:
            if n % i == 0:
                add_factor(i)
                n //= i
            else:
                i += 1
        return factors + [n]

factors = prime_factors(600851475143)
print(factors)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.