{"name":"@deckyard/vmware","description":"A client for the vSphere Automation REST API of vCenter","versions":{"0.1.0":{"version":"0.1.0","kind":"git","url":"https://github.com/deckyard/deck-vmware.git","ref":"0.1.0","commit":"9bfecdc4cf3ac882dade689cc97bb6c00fa5b3af","checksum":"","yanked":false,"license":"LGPL-3.0-only","requires":{},"engines":{"jennifer":"\u003e=0.25.0"},"capabilities":["net"],"keywords":["vmware","vsphere","vcenter","esxi","virtualization"],"description":"A client for the vSphere Automation REST API of vCenter","publishedAt":"1793738806","repoId":1444809843,"repoOwnerId":346943577,"repoOwner":"deckyard"}},"readme":"# @deckyard/vmware\n\n[![test](https://github.com/deckyard/deck-vmware/actions/workflows/test.yml/badge.svg)](https://github.com/deckyard/deck-vmware/actions/workflows/test.yml)\n[![Documentation](https://img.shields.io/badge/docs-github%20pages-blue)](https://deckyard.github.io/deck-vmware/)\n[![release](https://img.shields.io/github/v/release/deckyard/deck-vmware)](https://github.com/deckyard/deck-vmware/releases/latest)\n\nA [Jennifer](https://jennifer-lang.dev/) client for the vSphere Automation\nREST API of vCenter (`/api`, vCenter 7.0 U2 and newer). `get`, `post`,\n`put`, `patch` and `delete` reach every endpoint; typed verbs cover the\ninventory (VMs, hosts, clusters, datacenters, datastores, networks, folders,\nresource pools), creating, cloning, deploying and deleting VMs, tasks,\nguest customization, CPU, memory, disks and NICs, tags, VM power, the\nguest's addresses, and running programs in the guest. A standalone ESXi host\nserves only the SOAP API and is not supported.\n\n**[Documentation](https://deckyard.github.io/deck-vmware/)**\n\n## Install\n\n```sh\njvc add @deckyard/vmware\n```\n\nOr unpack `src/` from a release archive (`deckyard-vmware-\u003cversion\u003e.tar.gz`)\ninto `vendor/deckyard/vmware/`.\n\n## Usage\n\n```jennifer\nuse io;\nimport \"@deckyard/vmware/\" as vmware;\n\ndef c as vmware.Client init vmware.client(\"vcenter.example.com\");\n$c = vmware.withCaCert($c, fs.readBytes(\"vmca-root.pem\"));\n$c = vmware.login($c, \"automation@vsphere.local\", os.getEnv(\"VC_PASSWORD\"));\n\ndef f as vmware.VmFilter;\n$f.powerStates = [vmware.POWERED_OFF];\nfor (def vm in vmware.vms($c, $f)) {\n    io.printf(\"%s %s\\n\", $vm.vm, $vm.name);\n}\nvmware.powerOn($c, vmware.vmByName($c, \"web01\").vm);\n\n$c = vmware.logout($c);\n```\n\n## Requirements\n\nJennifer 0.25.0 or newer and the default `jennifer` binary: the deck needs\nthe `net` capability, which `jennifer-tiny` lacks.\n\n## Development\n\n```sh\ntools/check-all.sh                   # the full gate, as CI runs it\njennifer test src/vmware_test.j      # the test overlay, offline\ntools/check-docs.sh                  # docs against the code\ntools/pack.sh dist                   # build the release archive\n```\n\nThe tests answer from a fake server on a loopback port. The examples need a\nreal vCenter; see their headers.\n\n## Licence\n\nLGPL-3.0-only, see [LICENSE](LICENSE). Copyright (C) 2026 mplx \u0026lt;mplx@jennifer-lang.dev\u0026gt;.\n\nVMware, vSphere, vCenter and ESXi are trademarks of Broadcom. This deck is\nnot affiliated with or endorsed by Broadcom.\n"}