bugfix: install pth

Author: t3tra-dev

README.ja.md

@@ -58,6 +58,17 @@ python -m jvm --install-stub
 python -m jvm --uninstall-stub
 ```
 
+### PTH ファイルインストール
+
+仮想環境で自動的に JVM インポートを有効にする .pth ファイルをインストール:
+
+```bash
+# 自動インポート用の jvm.pth ファイルをインストール
+python -m jvm --install-pth
+```
+
+これにより、仮想環境の `site-packages` ディレクトリに `jvm.pth` ファイルが作成され、Python 起動時に自動的に JVM モジュールがインポートされ、手動初期化なしでシームレスに Java クラスをインポートできるようになります。
+
 ### 機能
 
 **型スタブ管理:**
@@ -67,6 +78,12 @@ python -m jvm --uninstall-stub
 - **自動生成**: 必要に応じて JVM インストールから新しいスタブを生成
 - **仮想環境検出**: venv、virtualenv、conda、その他の Python 環境マネージャーと連携
 
+**PTH ファイル管理:**
+
+- **PTH ファイルインストール**: Python 起動時に自動的に JVM モジュールをインポートする `jvm.pth` ファイルを仮想環境に作成
+- **自動インポート**: 手動の JVM 初期化なしでシームレスな Java クラスインポートを実現
+- **仮想環境安全性**: アクティブな仮想環境内でのみ動作し、分離されたセットアップを保証
+
 **サポートされるパッケージ:**
 
 - `java.lang` - Java コアクラス (String、System、Object 等)
@@ -91,6 +108,9 @@ pip install jvm
 # IDEサポート用の型スタブをインストール
 python -m jvm --install-stub
 
+# または自動JVMインポート用のPTHファイルをインストール
+python -m jvm --install-pth
+
 # IDEで自動補完が利用可能になります
 from java.lang import System  # IDEが利用可能なメソッドを表示
 ```
@@ -104,18 +124,21 @@ python -m jvm --help
 出力:
 
 ```
-usage: jvm [-h] (--install-stub | --uninstall-stub)
+usage: jvm [-h] (--install-stub | --uninstall-stub | --install-pth)
 
 JVM-PyBind: Python bindings for JVM with type stub management
 
 options:
   -h, --help         show this help message and exit
   --install-stub     Install JDK type stubs to the current virtual environment
   --uninstall-stub   Remove JDK type stubs from the current virtual environment
+  --install-pth      Install jvm.pth file to enable automatic JVM import in
+                     virtual environment
 
 Examples:
   python -m jvm --install-stub     Install JDK type stubs to virtual environment
   python -m jvm --uninstall-stub   Remove JDK type stubs from virtual environment
+  python -m jvm --install-pth      Install jvm.pth file to enable automatic JVM import
 ```
 
 ### カスタム Java クラスの使用 (実験的機能)

README.md

@@ -58,6 +58,17 @@ Remove type stubs when no longer needed:
 python -m jvm --uninstall-stub
 ```
 
+### PTH File Installation
+
+Install a .pth file to enable automatic JVM import in your virtual environment:
+
+```bash
+# Install jvm.pth file for automatic import
+python -m jvm --install-pth
+```
+
+This creates a `jvm.pth` file in your virtual environment's `site-packages` directory that automatically imports the JVM module when Python starts, enabling seamless Java class imports without manual initialization.
+
 ### Features
 
 **Type Stub Management:**
@@ -67,6 +78,12 @@ python -m jvm --uninstall-stub
 - **Auto-generation**: Generates fresh stubs from your JVM installation if needed
 - **Virtual environment detection**: Works with venv, virtualenv, conda, and other Python environment managers
 
+**PTH File Management:**
+
+- **Install PTH file**: Creates a `jvm.pth` file in your virtual environment that automatically imports the JVM module at Python startup
+- **Automatic import**: Enables seamless Java class imports without manual JVM initialization
+- **Virtual environment safety**: Only works within active virtual environments for isolated setup
+
 **Supported Packages:**
 
 - `java.lang` - Core Java classes (String, System, Object, etc.)
@@ -91,6 +108,9 @@ pip install jvm-pybind
 # Install type stubs for IDE support
 python -m jvm --install-stub
 
+# OR install PTH file for automatic JVM import
+python -m jvm --install-pth
+
 # Now you get autocompletion in your IDE
 from java.lang import System  # IDE will show available methods
 ```
@@ -104,18 +124,21 @@ python -m jvm --help
 Output:
 
 ```
-usage: jvm [-h] (--install-stub | --uninstall-stub)
+usage: jvm [-h] (--install-stub | --uninstall-stub | --install-pth)
 
 JVM-PyBind: Python bindings for JVM with type stub management
 
 options:
   -h, --help         show this help message and exit
   --install-stub     Install JDK type stubs to the current virtual environment
   --uninstall-stub   Remove JDK type stubs from the current virtual environment
+  --install-pth      Install jvm.pth file to enable automatic JVM import in
+                     virtual environment
 
 Examples:
   python -m jvm --install-stub     Install JDK type stubs to virtual environment
   python -m jvm --uninstall-stub   Remove JDK type stubs from virtual environment
+  python -m jvm --install-pth      Install jvm.pth file to enable automatic JVM import
 ```
 
 ### Working with Custom Java Classes (Experimental)

pyproject.toml

@@ -1,10 +1,9 @@
 [project]
 name = "jvm-pybind"
-version = "0.1.0rc2"
+version = "0.1.0rc3"
 description = "JVM bindings for Python that enable seamless integration between Python and Java code through JNI (Java Native Interface)."
 readme = "README.md"
 authors = [{ name = "t3tra-dev", email = "[email protected]" }]
-license = { text = "MIT" }
 classifiers = [
   # How mature is this project? Common values are
   #   3 - Alpha

src/jvm/__init__.py

@@ -25,4 +25,4 @@
     "__version__",
 ]
 
-__version__ = "0.1.0rc2"
+__version__ = "0.1.0rc3"

src/jvm/cli.py

@@ -221,6 +221,26 @@ def uninstall_stubs(self) -> bool:
         logger.info("✓ Stub uninstallation completed!")
         return True
 
+    def install_pth(self) -> bool:
+        """JVM .pth ファイルインストール"""
+        site_packages = self.venv_detector.detect_venv()
+        if not site_packages:
+            self._log_venv_error()
+            return False
+
+        pth_file = site_packages / "jvm.pth"
+        logger.info(f"Installing jvm.pth to: {pth_file}")
+
+        try:
+            with open(pth_file, "w", encoding="utf-8") as f:
+                f.write("import jvm\n")
+            logger.info("✓ jvm.pth file installed successfully!")
+            logger.info("Now you can use 'from java.lang import System' directly in any Python script")
+            return True
+        except Exception as e:
+            logger.error(f"Failed to create jvm.pth file: {e}")
+            return False
+
 
 def create_parser() -> argparse.ArgumentParser:
     """Create command line argument parser"""
@@ -232,6 +252,7 @@ def create_parser() -> argparse.ArgumentParser:
 Examples:
   python -m jvm --install-stub     Install JDK type stubs to virtual environment
   python -m jvm --uninstall-stub   Remove JDK type stubs from virtual environment
+  python -m jvm --install-pth      Install jvm.pth file to enable automatic JVM import
         """,
     )
 
@@ -246,6 +267,11 @@ def create_parser() -> argparse.ArgumentParser:
         action="store_true",
         help="Remove JDK type stubs from the current virtual environment",
     )
+    group.add_argument(
+        "--install-pth",
+        action="store_true",
+        help="Install jvm.pth file to enable automatic JVM import in virtual environment",
+    )
     return parser
 
 
@@ -261,6 +287,8 @@ def main() -> int:
             success = installer.install_stubs(force_regenerate=False)
         elif args.uninstall_stub:
             success = installer.uninstall_stubs()
+        elif args.install_pth:
+            success = installer.install_pth()
         else:
             parser.print_help()
             return 1

src/jvm/typeconv.py

@@ -33,9 +33,15 @@ def to_python(jvm: JVM, jobject: Any) -> object:
     if isinstance(jobject, (dict, list, tuple, set)):
         return jobject
 
+    # Try to get object class first
     try:
-        cls = jvm.jni.GetObjectClass(jobject)  # noqa
+        jvm.jni.GetObjectClass(jobject)
     except (TypeError, ValueError, ctypes.ArgumentError):
+        # If we can't get the class but jobject looks like a valid JNI reference,
+        # create an ObjectProxy anyway
+        if isinstance(jobject, (int, ctypes.c_void_p)) and jobject != 0:
+            from .proxy import ObjectProxy
+            return ObjectProxy(jvm, jobject)
         return jobject
 
     # String
@@ -60,4 +66,6 @@ def to_python(jvm: JVM, jobject: Any) -> object:
             raise RuntimeError("Could not find Integer.intValue method")
         return int(jvm.jni.CallIntMethod(jobject, mid))
 
-    return jobject
+    # For any other Java object, create an ObjectProxy
+    from .proxy import ObjectProxy
+    return ObjectProxy(jvm, jobject)