virtualshell 1.1.2__tar.gz → 1.1.4__tar.gz

{virtualshell-1.1.2 → virtualshell-1.1.4}/.gitignore

@@ -8,4 +8,5 @@ test/
 dist/
 .venv*
 test_run*
-test_sync_timeout.py
+test_performance_bridge.py
+ZEROCOPY_BRIDGE.md

{virtualshell-1.1.2 → virtualshell-1.1.4}/CMakeLists.txt

@@ -73,3 +73,4 @@ install(TARGETS _core
   ARCHIVE DESTINATION virtualshell
 )
 
+

{virtualshell-1.1.2 → virtualshell-1.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: virtualshell
-Version: 1.1.2
+Version: 1.1.4
 Summary: High-performance PowerShell bridge (C++ pybind11 backend)
 Keywords: powershell,automation,shell,cpp,pybind11
 Author: Kim-Andre Myrvold
@@ -302,9 +302,70 @@ Every API surface (sync/async/script) accepts `timeout` overrides and optional e
 
 ---
 
+## Zero-Copy Bridge (Windows only)
+
+For high-throughput data transfer between Python and PowerShell, the Zero-Copy Bridge uses shared memory to eliminate serialization overhead. Ideal for large binary data, files, or high-frequency transfers.
+
+```python
+from virtualshell import Shell, ZeroCopyBridge, PSObject
+
+with Shell(timeout_seconds=60) as shell:
+    with ZeroCopyBridge(shell) as bridge:
+        # Python → PowerShell
+        data = b"Large binary data" * 100000
+        bridge.send(data, "$myData", timeout=30.0)
+        res = shell.run("$myData.Length")
+        print(f"PowerShell received {res.out.strip()} bytes")
+    
+        # PowerShell → Python
+        shell.run("$response = [byte[]]::new(1048576)")
+        data = bridge.receive("$response", timeout=30.0)
+        print(f"Python received {len(data)} bytes")
+```
+
+For more complex scenarios involving PowerShell objects, you can serialize/deserialize them using the built-in methods:
+
+```python
+with Shell(timeout_seconds=60) as shell:
+    # Get processes from PowerShell
+    shell.run("$processes = Get-Process | Select-Object -First 5 -Property Name, Id, WorkingSet64")
+
+    with ZeroCopyBridge(shell) as bridge:
+        # Send the process list to Python
+        bridge.serialize("processes", out_var="bytes")
+        ps_bytes_raw: bytes = bridge.receive("bytes")
+
+        # Convert bytes to PSObject in Python
+        ps_obj = PSObject.from_bytes(ps_bytes_raw)
+
+        # Print each process info
+        for process in ps_obj["Items"]:
+            print(f"Process Name: {process['Name']}, ID: {process['Id']}, Memory: {process['WorkingSet64']} bytes")
+
+        # Modify the process names in Python
+        for process in ps_obj["Items"]:
+            process["Name"] = f"Modified_{process['Name']}"
+        
+        # Send modified object back to PowerShell
+        bridge.send(ps_obj.to_bytes(), "processes")
+        bridge.deserialize("processes")
+        
+        # Verify changes in PowerShell
+        res = shell.run("$processes | Where-Object { $_.Name -like 'Modified_*' }")
+        print("\nModified Processes in PowerShell:")
+        print(res.out)
+
+```
+
+**Performance:** 5-150 MB/s depending on data size. Requires `win_pwsh.dll` (Windows only).
+
+See [Zero-Copy Bridge guide](wiki/Usage/Zero-Copy%20Bridge.md) for complete documentation.
+
+---
+
 ## PowerShell object proxies
 
-`Shell.generate_psobject` reflects a PowerShell object into a Python `Protocol`, while `Shell.make_proxy` creates a live proxy that forwards attribute access back into PowerShell. Together they give you IDE-friendly, type-hinted automation.
+`Shell.generate_psobject` reflects a PowerShell object into a Python `Protocol`, while `Shell.make_proxy` creates a live proxy that forwards attribute access back into PowerShell. Together they give you IDE-friendly, type-hinted automation. This is still an experimental feature and may not cover all edge cases.
 
 ```python
 from virtualshell import Shell
@@ -340,6 +401,8 @@ Detailed guides live in the wiki: [generate_psobject](wiki/Usage/generate_psobje
 | `Shell.script_async(...)` | Async counterpart of `script`. |
 | `Shell.save_session()` | Persist the current session to an XML snapshot. |
 | `Shell.pwsh(text)` | Safely echo a literal PowerShell string (auto quoting). |
+| `Shell.make_proxy(type_name, object_expression, *, depth=4)` | Create a live PowerShell object proxy. |
+| `Shell.generate_psobject(type_expression, output_path)` | Generate a Python `Protocol` for a PowerShell object type. |
 
 More helpers live in the wiki, including session restore, batching, and diagnostic tips.
 
@@ -354,18 +417,21 @@ shell = Shell(
     powershell_path="C:/Program Files/PowerShell/7/pwsh.exe",
     working_directory="C:/automation",
     environment={"MY_FLAG": "1"},
+    timeout_seconds=10,
+    auto_restart_on_timeout=True,
+    stdin_buffer_size=64 * 1024,
     initial_commands=[
         "$ErrorActionPreference = 'Stop'",
         "$ProgressPreference = 'SilentlyContinue'",
     ],
-    timeout_seconds=10,
-    auto_restart_on_timeout=True,
+    set_UTF8=True,
+    strip_results=False,
 )
 
 shell.start()
 ```
 
-Configuration is applied before the process starts. You can inspect or replace it later with `shell._core.get_config()` or rebuild the shell.
+Configuration is applied before the process starts. You can inspect later with `shell._core.get_config()`.
 
 ---
 

{virtualshell-1.1.2 → virtualshell-1.1.4}/README.md

@@ -83,9 +83,70 @@ Every API surface (sync/async/script) accepts `timeout` overrides and optional e
 
 ---
 
+## Zero-Copy Bridge (Windows only)
+
+For high-throughput data transfer between Python and PowerShell, the Zero-Copy Bridge uses shared memory to eliminate serialization overhead. Ideal for large binary data, files, or high-frequency transfers.
+
+```python
+from virtualshell import Shell, ZeroCopyBridge, PSObject
+
+with Shell(timeout_seconds=60) as shell:
+    with ZeroCopyBridge(shell) as bridge:
+        # Python → PowerShell
+        data = b"Large binary data" * 100000
+        bridge.send(data, "$myData", timeout=30.0)
+        res = shell.run("$myData.Length")
+        print(f"PowerShell received {res.out.strip()} bytes")
+    
+        # PowerShell → Python
+        shell.run("$response = [byte[]]::new(1048576)")
+        data = bridge.receive("$response", timeout=30.0)
+        print(f"Python received {len(data)} bytes")
+```
+
+For more complex scenarios involving PowerShell objects, you can serialize/deserialize them using the built-in methods:
+
+```python
+with Shell(timeout_seconds=60) as shell:
+    # Get processes from PowerShell
+    shell.run("$processes = Get-Process | Select-Object -First 5 -Property Name, Id, WorkingSet64")
+
+    with ZeroCopyBridge(shell) as bridge:
+        # Send the process list to Python
+        bridge.serialize("processes", out_var="bytes")
+        ps_bytes_raw: bytes = bridge.receive("bytes")
+
+        # Convert bytes to PSObject in Python
+        ps_obj = PSObject.from_bytes(ps_bytes_raw)
+
+        # Print each process info
+        for process in ps_obj["Items"]:
+            print(f"Process Name: {process['Name']}, ID: {process['Id']}, Memory: {process['WorkingSet64']} bytes")
+
+        # Modify the process names in Python
+        for process in ps_obj["Items"]:
+            process["Name"] = f"Modified_{process['Name']}"
+        
+        # Send modified object back to PowerShell
+        bridge.send(ps_obj.to_bytes(), "processes")
+        bridge.deserialize("processes")
+        
+        # Verify changes in PowerShell
+        res = shell.run("$processes | Where-Object { $_.Name -like 'Modified_*' }")
+        print("\nModified Processes in PowerShell:")
+        print(res.out)
+
+```
+
+**Performance:** 5-150 MB/s depending on data size. Requires `win_pwsh.dll` (Windows only).
+
+See [Zero-Copy Bridge guide](wiki/Usage/Zero-Copy%20Bridge.md) for complete documentation.
+
+---
+
 ## PowerShell object proxies
 
-`Shell.generate_psobject` reflects a PowerShell object into a Python `Protocol`, while `Shell.make_proxy` creates a live proxy that forwards attribute access back into PowerShell. Together they give you IDE-friendly, type-hinted automation.
+`Shell.generate_psobject` reflects a PowerShell object into a Python `Protocol`, while `Shell.make_proxy` creates a live proxy that forwards attribute access back into PowerShell. Together they give you IDE-friendly, type-hinted automation. This is still an experimental feature and may not cover all edge cases.
 
 ```python
 from virtualshell import Shell
@@ -121,6 +182,8 @@ Detailed guides live in the wiki: [generate_psobject](wiki/Usage/generate_psobje
 | `Shell.script_async(...)` | Async counterpart of `script`. |
 | `Shell.save_session()` | Persist the current session to an XML snapshot. |
 | `Shell.pwsh(text)` | Safely echo a literal PowerShell string (auto quoting). |
+| `Shell.make_proxy(type_name, object_expression, *, depth=4)` | Create a live PowerShell object proxy. |
+| `Shell.generate_psobject(type_expression, output_path)` | Generate a Python `Protocol` for a PowerShell object type. |
 
 More helpers live in the wiki, including session restore, batching, and diagnostic tips.
 
@@ -135,18 +198,21 @@ shell = Shell(
     powershell_path="C:/Program Files/PowerShell/7/pwsh.exe",
     working_directory="C:/automation",
     environment={"MY_FLAG": "1"},
+    timeout_seconds=10,
+    auto_restart_on_timeout=True,
+    stdin_buffer_size=64 * 1024,
     initial_commands=[
         "$ErrorActionPreference = 'Stop'",
         "$ProgressPreference = 'SilentlyContinue'",
     ],
-    timeout_seconds=10,
-    auto_restart_on_timeout=True,
+    set_UTF8=True,
+    strip_results=False,
 )
 
 shell.start()
 ```
 
-Configuration is applied before the process starts. You can inspect or replace it later with `shell._core.get_config()` or rebuild the shell.
+Configuration is applied before the process starts. You can inspect later with `shell._core.get_config()`.
 
 ---
 

{virtualshell-1.1.2 → virtualshell-1.1.4}/cpp/include/py_bridge.hpp

@@ -245,7 +245,6 @@ inline py::object make_py_runtime_error(const std::string& msg) {
     return builtins.attr("RuntimeError")(py::str(msg));
 }
 
-// ---- replace your make_py_future_from_std_future<T> with this version ----
 template <class T>
 py::object make_py_future_from_std_future(std::future<T> fut, py::object py_callback /* may be None */) {
     // Create the Python Future now (under GIL).

{virtualshell-1.1.2 → virtualshell-1.1.4}/cpp/include/py_proxy.hpp

@@ -21,8 +21,25 @@ public:
     pybind11::dict schema() const;
 
     const std::string& type_name() const noexcept { return typeName_; }
-    struct MethodMeta { bool awaitable{false}; };
-    struct PropertyMeta { bool writable{false}; };
+
+        struct ParamMeta {
+        std::string name;
+        std::string typeName;
+        bool isOut{false};
+        bool isByRef{false};
+        bool isArray{false};
+    };
+
+    struct MethodMeta {
+        bool awaitable{false};
+        bool returnsVoid{false};
+        std::string returnType;
+        std::vector<ParamMeta> params;
+    };
+
+    struct PropertyMeta { 
+        bool writable{false}; 
+    };
     struct SchemaRecord {
         std::unordered_map<std::string, MethodMeta> methods;
         std::unordered_map<std::string, PropertyMeta> properties;

{virtualshell-1.1.2 → virtualshell-1.1.4}/cpp/include/virtual_shell.hpp

@@ -93,6 +93,8 @@ private:
     std::deque<uint64_t>  inflightOrder_;    ///< FIFO order of in-flight command IDs
     std::atomic<uint32_t> pendingTimeoutSentinels_{0}; ///< Expected stderr timeout sentinels to discard
 
+    std::atomic<int64_t> pid_{-1}; ///< Process ID of the PowerShell host
+
     /**
      * @internal
      * @brief Remove and return the CmdState for a given ID.
@@ -150,6 +152,10 @@ public:
         return shared_from_this();
     }
 
+    int64_t getProcessId() const {
+        return pid_.load(std::memory_order_acquire);
+    }
+
     /**
      * @brief Construct a new VirtualShell with the given configuration.
      * 

{virtualshell-1.1.2 → virtualshell-1.1.4}/cpp/src/binder.cpp

@@ -232,6 +232,8 @@ PYBIND11_MODULE(_core, m) {
         .def("get_config",   &VirtualShell::getConfig, py::return_value_policy::reference_internal)
         .def("update_config",&VirtualShell::updateConfig, py::arg("config"))
 
+        .def("get_process_id", &VirtualShell::getProcessId)
+
         .def("is_restarting", &VirtualShell::isRestarting)
         .def("get_shared_ptr", &VirtualShell::getSharedPtr)
         .def("make_proxy",
@@ -274,7 +276,7 @@ PYBIND11_MODULE(_core, m) {
     }, "Create a new VirtualShell instance", py::arg("config"));
 
     // Metadata
-    m.attr("__version__") = "1.1.2";
+    m.attr("__version__") = "1.1.4";
     m.attr("__author__")  = "Kim-Andre Myrvold";
 }
 

{virtualshell-1.1.2 → virtualshell-1.1.4}/cpp/src/powershell_process.cpp

@@ -25,7 +25,7 @@ using namespace std::chrono_literals;
 namespace virtualshell {
 namespace core {
 namespace {
-constexpr std::size_t kReadBufferSize = 64 * 1024;
+constexpr std::size_t kReadBufferSize = 64 * 1024 * 10; // 640 KB read buffer size   
 
 std::string quote_argument(const std::string& value) {
     if (value.empty()) {