[BUG] Poetry failing to recognize file directory

[roma2023]

What is the bug?

Running samples with Poetry fails on Windows 10 and Mac

How can one reproduce the bug?

1. Install Poetry in the home directory using pipx install poetry.
2. Navigate to the "opensearch-py/samples" directory. cd opensearch-py/samples
3. Install the project dependencies with poetry install.
4. Execute poetry run hello/hello.py.

What is the expected behavior?

Poetry should run the samples without any errors

What is your host/environment?

Windows 10, Docker 4.17.1 (101757)
macOS 10.15

Do you have any screenshots?

The result on Windows machine:

$ poetry run hello/hello.py
"hello" is not an internal or external
command, executable program, or batch file.
(base)

The result on the Mac machine:

[saimedhi]

I tested this on my mac and didn't face any error. Will try it again on some other machine

1. Installed Poetry in the home directory using pipx install poetry.
2. Navigated to the "opensearch-py/samples" directory. cd opensearch-py/samples
3. Installed the project dependencies with poetry install.
4. Executed poetry run hello/hello.py.

[saimedhi]

If anyone else is experiencing this issue, please feel free to leave a comment here. Thank you!

[dblock]

I think this may be broken (wrongly documented) on Windows. Does poetry run python hello/hello.py work?

It works on *nix because hello.py has a BOM of #!/usr/bin/env python and automatically invokes python.

@roma2023 if you can confirm, let's insert python everywhere we say poetry run ... in the docs? Will you please help?

[roma2023]

@dblock Yes, running poetry run python hello/hello.py works on Windows machine:

I can take up this issue and open a new PR or fix this at #486. Thank you!

[ReinGrad]

• The bug is that running samples with Poetry fails on Windows 10 and Mac when executing poetry run hello/hello.py. It results in a "command not found" error.

• The expected behavior is that Poetry should run the samples without any errors.

• It works as expected on Linux, but fails on Windows and Mac.

• A workaround is to run poetry run python hello/hello.py instead of just poetry run hello/hello.py. This works on Windows.

• The root cause seems to be that on Windows, the hello.py script doesn't have the proper shebang line to invoke python automatically.

• A fix proposed is to update the documentation to recommend running poetry run python instead of just poetry run on Windows.

• User @roma2023 volunteered to submit a PR to fix the documentation.

In summary, it's a documentation issue on Windows due to lack of a proper shebang line in the scripts, and the recommendation is to call python explicitly when using Poetry on Windows.