Metadata-Version: 2.1
Name: tictactoc
Version: 0.2.0
Summary: tictactoc 
Author-email: Felipe Maza <felipe@felipem.com>
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Development Status :: 1 - Planning
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: pytest >= 7
Requires-Dist: flit ; extra == "dev"
Requires-Dist: black ; extra == "dev"
Requires-Dist: pre-commit ; extra == "dev"
Requires-Dist: sphinx ; extra == "dev"
Requires-Dist: myst-nb ; extra == "dev"
Requires-Dist: sphinx_rtd_theme ; extra == "dev"
Project-URL: repository, https://github.com/felipem775/tictactoc
Provides-Extra: dev

# tictactoc

A simple library to be able to control the time that certain parts of the code take

## Installation and use

To install this module use:

```sh
pip install tictactoc
```

Run tests to validate:

```sh
tictactoc-tests
```

## Usage

Basic use, start and end.

```py
from tictactoc import tictactoc

tictactoc.tic() # Start
print(tictactoc.toc()) # Finish
```

Using tac in loops.
We can do a tac in each iteration. When we finnish the loop, we do a toc skipping this time.

```py
from time import sleep
from tictactoc import tictactoc

tictactoc.tic("my loop")

my_loop=[1,2]

for element in my_loop:
    sleep(0.1)
    tictactoc.tac("my loop")

result = tictactoc.toc("my loop", skip_toc=True)

print(f"total: {result["total"]}, each iteration: {', '.join(map(str,result["steps"]))}")
```

## Credits

Developed and maintained by felipem775. [Contributions](CONTRIBUTING.md) are welcomed.

