Thrameos / jpype

Thrameos personal sandbox for enhancements to jpype to send to originell.
Other
0 stars 1 forks source link

Getting started? #51

Closed ejfried closed 3 years ago

ejfried commented 4 years ago

Hi, I'm a Java guy and only a casual Python (and pyjnius) user. I saw @Thrameos's issue on the pyjnius project and am interested in comparing the two myself, but I'm having a hard time getting started. Is there a document for Python newbs that explains how to set up JPype that I'm missing?

Thrameos commented 4 years ago

I would recommend starting with the quickstart guide which gives you everything you need to be dangerous in translating from Java to Python. Then there is a installation guide to show how to install. Pretty much should be "pip install JPype1" on most systems, though we still need to get the 1.0.1 release pushed. Worst cast pull the recent release wheel for your system and call "pip install JPype1-{arch}.whl" to put it on your system. You may then need to deal with the issues of getting the JVM started which can range from dirt easy to horrible. The worst being people with horribly broken Java installs that refuse to find the libraries (though we have another guide for that). There is the users guide and the API reference which cover the details on using it. And if you are in for absolute punishment you can glace at developer guide which gives a glorious tour through the sausage factory down to how to track down and debug problems between layers.

As I said to the maintainer "I think I set the record for the most documentation per user, though it helps that the divisor is very small."

Thrameos commented 4 years ago

Did that resolve the issue?

ejfried commented 4 years ago

Yes, the quckstart guide was very helpful, thanks. Will try to contribute a patch for some typos there.

Thrameos commented 4 years ago

Thanks. Please make any corrections to quickstart.py which is used to build the quickstart.rst file. If you see anything unclear or needing addition instruction please feel free to ask. I had my son go through and proof read the guides, but they can always use some more work. Ey cundn't spel, effin ef mi lef deepent un et. Dyslexics untie!