This product SEEMS like it wants to be a really great library. But, without documentation, or at least example programs which use it, there is no way in hell I can claim how good it is.
One thing is for sure, installing it was a whole lot easier than Net::SSH. For starters, it actually _completed_ the installation process. Net::SSH and Net::SFTP both deadlocked on me while executing the tests for dependencies. And, installation was very fast.
The top-level API seems to behave as one would expect. However, attempting to use Net::SSH2::File methods is proving most challenging. In my particular case, creating a file on the remote end of the SFTP connection yields "Resource temporarily unavailable" errors constantly, and no apparent fix.
Googling and Binging yields no results.
Please. WE. NEED. DOCUMENTATION.