Metadata-Version: 2.1
Name: tympy
Version: 0.0.12
Summary: A package to compare the execution times of two Python scripts.
Home-page: https://github.com/inidal/tympy
Author: Nidal Iguer
Author-email: Nidal Iguer <hello@inidal.dev>
Project-URL: Homepage, https://github.com/inidal/tympy
Project-URL: Issues, https://github.com/inidal/tympy/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

The `compare` function is designed to compare the execution speed of different Python functions on a set of files. It takes three arguments:

1. `FILEPATHS` (List of Strings): This argument accepts a list of file paths. Each file path should point to a Python file that you want to analyze.

2. `FUNCTIONS` (String or List of Strings): This argument can be either a single function name (as a string) or a list of function names (as a list of strings). If you pass a single function name, it will be applied to all files. If you pass a list of function names, the number of function names should match the number of files.

3. `ARGS` (List of Strings, Tuple, or List of Tuples): This argument can be one argument (as a string), one argument (as a tuple), or multiple arguments (as a list of tuples). If you pass a single argument, it will be applied to all functions. If you pass multiple arguments, the number of arguments should match the number of functions, and each argument should be passed as a tuple.

Here is an example of how to use the `compare` function:

```python
compare(["file1.py", "file2.py"], "my_function", [("arg1",), ("arg2",)])
```

In this example, the `compare` function will apply the `my_function` function with the arguments `arg1` and `arg2` to the files `file1.py` and `file2.py`, respectively.

When comparing multiple files that perform similar tasks, it's important to note that they may have slight differences. Here's a suggested approach:

- **File Selection**: Select the files you wish to compare.
- **Function Identification**: Verify if the functions within these files have similar names. If not, create a list that maps the functions to their corresponding files based on their positioning.
- **Argument Verification**: Check if there are any arguments that need to be passed to these functions.

---
* EXAMPLES

```python
compareSpeed(["test3.py", "test4.py"], 
           ["my_function", "word_function"], 
           [("tst3", 4, 7, 9), ("tst4", 4, 9, 7)])
```

```python
compareSpeed(["metadata_extractor_v1.py", "metadata_extractor_v2.py"], 
           ["get_metadata", "getMetadata"], 
           "https://www.coursera.org/learn/machine-learning-with-python")
```
