So it detects if there's a single folder inside the zip containing all the files or all the files directly inside the zip? That's useful!

Reminds me of Minecraft texture packs back in the day where nobody really understand how to make a texture pack and all used Ms paint and this was a common issue as clicking "add to .zip" on the folder would make a containing folder and not work. This would mean each user would have to extract it and have folders in their resource pack folder instead of zips.
This... worked, but when the client(basically a large QOL mod) ~50% of people used added the ability to put texture packs in folders to organize them it treated the unzipped packs like a folder so they stopped working.

Warning

Never extract archives from untrusted sources without prior inspection. It is possible that files are created outside of path, e.g. members that have absolute filenames starting with "/" or filenames with two dots "..".

https://docs.python.org/3/library/tarfile.html#tarfile.TarFile.extractall

I would be careful if using this as a general purpose tool.

A better alternative would likely be to use the regular command-line tools which have been hardened to this type of thing (and are likely much faster) and then just inspect the result. Always create a wrapper directory, then if the result is only one directory inside of that move it out, otherwise just keep the wrapper. I would recommend that the other updates their tool to do this rather than the current approach.

Good luck with the project.

I want to request a not-feature: One time I extracted an archive with an odd command that ended up dumping all its contents without directories straight into the base folder of the archive without a way to undo that. Please don't make that possible with your tool. 😂

I had to manually clean up the directory.

Unzip tools should always do it in a new folder.

I can deal with home/ZipName/ZipName. I have no patience whatsoever for a program dumping randomly-dated files onto an existing directory.

Do the simplest thing that could possibly work.

Very nice! This is definitely an annoying problem.

I'm not trusting this to Python though.