Detect audio output (prefer "pulse") (Fix #35: correct audio device not found on linux).

[Poikilos]

• Adds some docstrings (Google Style, such as for building documentation using Sphinx)
• List audio devices and detect the output device by preferring "pulse" as the audio device name (See preferred_device_names in PyaudioHandler docstring)
  • Makes the example work on Ubuntu Studio 24.04 (using pipewire+jack)
• Adds an option to play from a separate audio file (See separate_wave in PyaudioHandler docstring).
• Use a audio_devices list of device info dictionaries (such as for programs to select the audio output themselves by changing preferred_device_names to one of the names).

Tasks:

• [ ] Needs to be tested under alsa and portaudio (add "alsa" to the end of the preferred_device_names?)

[anrayliu]

Hey, thanks for the pull request!

Before I merge it, I would like to ask a few questions because I'm too well versed in this.

Firstly, are you on linux? I don't have a linux machine right now and am unable to test pyvidplayer2 there. If so, how was the experience? Did everything work properly?

Second, why did you make a custom logger instead of using the default warnings logger?

And lastly, I'm still confused about the features you've added. Can you explain a little bit more what pulse is?

Again, thanks for your contribution. I would love to collaborate!

[Poikilos]

Ok, I've made an issue to answer the questions so the information is not lost. I added "Fix #35" to the PR name so it will be closed if this is merged. I hope this helps.