v0.0.3 Return correct Type and Repr after first use

[glenn-jocher]

🛠️ PR Summary

_{Made with ❤️ by Ultralytics Actions}

🌟 Summary

Update to the autoimport package improving LazyLoader functionality, with test enhancements and version bump. 🚀

📊 Key Changes

• Updated LazyLoader to copy critical module attributes (__file__, __path__, etc.) for better compatibility.
• Enhanced LazyLoader.__repr__() for improved clarity when modules aren't loaded.
• Updated tests to ensure LazyLoader correctly integrates with standard imports.
• Expanded test documentation, offering both pytest (recommended) and unittest testing options.
• Incremented package version from 0.0.2 to 0.0.3.

🎯 Purpose & Impact

• 🛠️ Improved Module Compatibility: Ensures LazyLoader works seamlessly with external tools and libraries that rely on module attributes.
• 📄 More Informative Debugging: Clearer representations of LazyLoader instances simplify debugging.
• ✅ Testing Flexibility: Users now have multiple testing options, making it easier to adopt best practices or work with built-in tools.
• 🔄 Version Bump: Indicates backward-compatible changes and improved stability.

This update enhances reliability and usability for developers leveraging the autoimport package. 🌟

[UltralyticsAssistant]

👋 Hello @glenn-jocher, thank you for submitting a ultralytics/autoimport 🚀 PR! To ensure a seamless integration of your changes, please review the following checklist:

• ✅ Define a Purpose: Clearly explain the purpose of your fix or feature in your PR description, and link to any relevant issues. Your summary looks great, but feel free to refine it further if needed.
• ✅ Synchronize with Source: Ensure your PR is synchronized with the ultralytics/autoimport main branch. If it's behind, update it by clicking the 'Update branch' button or running git pull and git merge main locally before pushing again.
• ✅ Ensure CI Checks Pass: Confirm that all Ultralytics Continuous Integration (CI) tests are passing. If any checks fail, please review and address the issues to meet our contribution requirements.
• ✅ Update Documentation: If your PR introduces or modifies functionality, ensure the corresponding documentation is updated accordingly.
• ✅ Add Tests: For your changes, consider adding or updating tests where appropriate, and confirm that all tests successfully pass.
• ✅ Sign the CLA: If this is your first PR for Ultralytics, please review and sign our Contributor License Agreement by leaving a comment stating, "I have read the CLA Document and I sign the CLA."
• ✅ Minimize Changes: Limit your changes to those essential for your update. Lean and clean code is key! "Perfection is achieved, not when there is nothing more to add, but when there is nothing left to take away." — Antoine de Saint-Exupéry

This is an automated response to help streamline the review process. An Ultralytics engineer will review your submission and provide additional feedback soon.

For additional guidance, please refer to our Contributing Guide. Let us know if you have any questions or need assistance. Thank you for contributing to Ultralytics! 🚀🎉

[glenn-jocher]

Test script

import time
from autoimport import lazy

with lazy():
    t0 = time.perf_counter()
    import torch  # Import is deferred until first use
    print(f"\nInitial import time: {time.perf_counter() - t0:.3f}s")  # Example output: 0.000s
    print(f"Initial type: {type(torch)}")
    print(f"Initial print: {str(torch)}")

t1 = time.perf_counter()
torch.cuda.is_available()  # Package is actually loaded here
print(f"\nFirst use time: {time.perf_counter() - t1:.3f}s")  # Example output: 0.462s
print(f"First use type: {type(torch)}")
print(f"First use print: {str(torch)}")

Currently returns this, module type is incorrect which may impact code bases that check using i.e. isinstance(x, module)

Initial import time: 0.000s
Initial type: <class 'autoimport.main.LazyLoader'>
Initial print: <LazyLoader for 'torch'>

First use time: 0.496s
First use type: <class 'autoimport.main.LazyLoader'>
First use print: <module 'torch' from '/Users/glennjocher/PycharmProjects/.venv/lib/python3.12/site-packages/torch/__init__.py'>

[glenn-jocher]

Ok I think this is working now. After latest commit:

Initial import time: 0.000s
Initial type: <class 'autoimport.main.LazyLoader'>
Initial print: <LazyLoader for 'torch'>

First use time: 0.494s
First use type: <class 'module'>
First use print: <module 'torch' from '/Users/glennjocher/PycharmProjects/.venv/lib/python3.12/site-packages/torch/__init__.py'>

[UltralyticsAssistant]

🎉 PR Merged! Huge thanks, @glenn-jocher, for this fantastic update to autoimport! 🚀 Your work improving LazyLoader functionality and expanding test clarity positively impacts both usability and developer experience. The meticulous care you invested in compatibility and debugging is a game-changer for the community. 🙌

As Leonardo da Vinci once said, "Details make perfection, and perfection is not a detail." Your contributions embody this truth—thank you for your dedication. Here's to making tools smarter and the developer's journey smoother! 🌟