Feat: Add new 'toogle' option for Sidepad

[brunoorsolon]

Description

UPDATED:
This also includes the changes originally proposed by https://github.com/Esscraye in the PR: #1353

This pull request adds some new features to the Sidepad:, a new option called --toggle which is stateful and allows a single shortcut to open/close sidepad (if called when sidepad is not initialized, the scripts automatically does so), possibility to have sidepad on the leff tor right side of the screen (and one command to switch from one side to the other), sidepad gets focused when open.

Coming from https://github.com/Esscraye in the PR: #1353

• Sidepad can now be on the left or right side of the screen. Default is left
• Sidepad gets windo focus when you open it and loses focus when you hide it.

In addition to that I have created a smooth transition parameter --switch-sides that allows the sidepad to move to the other edge of the screen without having ti kill it and restart.

Changes

• Improved
• Bug Fixes
• Feature
• Documentation
• Other

Context

I didn't like that it required 3 shortcuts for init -> show -> hide, so I thought this could be a cool improvement of the original one. I have made sure to keep compatibility with the old code just in case you still want to keep the same options.

I didn't change any standard calls to Sidepad from waybar or from the original shortcuts (I have done so in my local system, but I though that would be a little too much for this small PR for now).

The sidepad position idea came from the other PR, i just had the idea of making the side switching more "instant" instead of kill/restart.

How Has This Been Tested?

• Tested on Arch Linux/Based Distro.
• Tested on Fedora Linux/Based Distro.
• Tested on openSuse.

Checklist

Please ensure your pull request meets the following requirements:

• My code follows the style guidelines of this project.
• I have performed a self-review of my code.
• I have commented on my code, particularly in hard-to-understand areas.
• My changes do not introduce new warnings.
• I have added tests that prove my fix is effective or that my feature works.
• I have made corresponding changes to the documentation
• New and existing unit tests pass locally with my changes.

Screenshots

Switch sides and toggle demo: video

Related Issues

N/A

Additional Notes

N/A

[brunoorsolon]

So, I was looking into this PR: #1353 and I simply loved the idea
I took the time to adapt that into my local system so I figured I could just add it here too.

I have adapted a little bit of the logic but the credits for the idea and original implementation goes to https://github.com/Esscraye
One cool thing that I have added is an option to instantly switch sides. This way you don't need to restart the sidepad in order for it to move around.

I am editing the PR's description right now to include all this, properly documenting the new flags etc.