feat: Enhance environment connection error handling

[Mr-Sunglasses]

fix: #455

Add PodmanConnectionError to improve debugging of connection failures when
initializing client from environment variables. The new error provides:

• Detailed error messages with connection host and environment state
• Preservation of original exception information
• Better context for common failure modes (invalid config, connection failures)

Previously, raw exceptions from connection attempts could be confusing to
diagnose, especially when involving environment variables. This change makes it
clearer what went wrong during client initialization.

[openshift-ci]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: Mr-Sunglasses
Once this PR has been reviewed and has the lgtm label, please assign umohnani8 for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

• OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[Mr-Sunglasses]

Hey @inknos , I've fixed all the suggested changes on PR: #472 in this PR because that was messed up and thanks @D3vil0p3r for your suggestion, I really helped me in resolving this issue.

[inknos]

Thanks, I'll look into it. Since the first time you committed, many things have changed in the codebase and we reformatted and dropped quite a lot of old code. I'll help you with this to fix the remaining issues. it should be a matter of passing the lint and few other things :)

[Mr-Sunglasses]

Thanks, I'll look into it. Since the first time you committed, many things have changed in the codebase and we reformatted and dropped quite a lot of old code. I'll help you with this to fix the remaining issues. it should be a matter of passing the lint and few other things :)

Sure thanks @inknos , looking forward to your review and also happy to resolve more bugs 😄

[inknos]

hey. @Mr-Sunglasses I was working on #510 to fix the tests flake that hit the packit jobs, and now they should be good (it was about the infinite running tests). I also published 5.4.0 within the same PR and that should fix all the red lights 🤞🏻 . you might want to pull main, rebase and push your commits again :)

[Mr-Sunglasses]

hey. @Mr-Sunglasses I was working on #510 to fix the tests flake that hit the packit jobs, and now they should be good (it was about the infinite running tests). I also published 5.4.0 within the same PR and that should fix all the red lights 🤞🏻 . you might want to pull main, rebase and push your commits again :)

Sure @inknos thanks a lot, it'll do that right away :-)

Let's hope for the best that all tests pass 🧿🤞🏻