Add module lazy loading in __init__ files

[JAM-Beni]

This commit was made to avoid loading all of the tables when not required. This brings down the memory usage from ~400Mib to ~2MiB.

Flake8 was applied apart from line length which was ignored. For coding references I used PEP 562 and the werkzeug library to ensure I was using proper reference points.

I tested this using the following Python script:

from memory_profiler import profile


@profile
def import_phevaluator():
    from phevaluator import evaluator
    print(evaluator.evaluate_cards('2d', '3d', '4d', '5d', '6d', '7d', '8d'))


@profile
def import_omaha_phevaluator():
    from phevaluator import evaluator_omaha
    print(evaluator_omaha.evaluate_omaha_cards('2d', '3d', '4d', '5d', '6d', '7d', '8d', '9d', 'Td'))


if __name__ == "__main__":
    import_phevaluator()
    import_omaha_phevaluator()

With the output:

7
Filename: test_script.py

Line #    Mem usage    Increment  Occurrences   Line Contents
=============================================================
     4     22.8 MiB     22.8 MiB           1   @profile
     5                                         def import_phevaluator():
     6     25.0 MiB      2.2 MiB           1       from phevaluator import evaluator
     7     25.0 MiB      0.0 MiB           1       print(evaluator.evaluate_cards('2d', '3d', '4d', '5d', '6d', '7d', '8d'))


7
Filename: test_script.py

Line #    Mem usage    Increment  Occurrences   Line Contents
=============================================================
    10     25.1 MiB     25.1 MiB           1   @profile
    11                                         def import_omaha_phevaluator():
    12    423.1 MiB    398.1 MiB           1       from phevaluator import evaluator_omaha
    13    423.1 MiB      0.0 MiB           1       print(evaluator_omaha.evaluate_omaha_cards('2d', '3d', '4d', '5d', '6d', '7d', '8d', '9d', 'Td'))

These tests were surface level, please validate my work further as I am still not fully familiar with this library.

[JAM-Beni]

Side note: I left from . import hash as hash_ # FIXME: "hash" collides to built-in function as is due to the FIXME comment

[HenryRLee]

Thanks you for your work!

The tests have all passed. The code looks good to me.

Let me ask @azriel1rf to see if there are any additional thoughts.

[HenryRLee]

Hi @azriel1rf , do you also have some time to look at this PR? Any comments are welcome.

[azriel1rf]

@JAM-Beni Thank you for your contribution.
@HenryRLee Currently, I'm facing personal constraints that prevent me from engaging in OSS. I value your efforts and look forward to contributing again soon. Apologies for any inconvenience, and I appreciate your understanding.

[HenryRLee]

Hey @azriel1rf , no worries! All the best for your new role!

[HenryRLee]

The PR is good to merge. Thanks @JAM-Beni for your contribution!

[azriel1rf]

Hey @azriel1rf , no worries! All the best for your new role!

Thanks for your kind message, @henryLee. I'm in the process of obtaining the necessary permissions, and once that's settled, I'm eager to return to contributing to the OSS. It might take a bit of time, but I'm looking forward to rejoining the community.