qemu-compose


Nameqemu-compose JSON
Version 0.6.2 PyPI version JSON
download
home_pageNone
Summarydocker-compose style composer for qemu
upload_time2025-07-20 12:18:20
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseNone
keywords qemu qemu-compose qemu_compose
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            
# qemu-compose

qemu-compose aims to provide a docker-compose style composer for qemu command, with advanced scripting feature as well as http support for cloud init or general purpose provisioning.

Bring up a qemu VM by providing a qemu-compose.yml and run `qemu-compose up`

## Advantages

 - Very simple and robust, written of several pure python scripts, depends on `qemu` commands only.
 - No libvirt stuff, no daemon process, no xml config, no complex abstraction, just a simple wrapper around qemu args.
 - support `before_script` and `after_script` for setup and cleanup
 - support `boot_commands` for vm provisioning (implemented using tty communication, gui not supported yet, and use jsonlisp for expressive power which apparently is turing-complete)
 - support `http_serve` for cloudinit
 - env interpolation for advanced configuration

## Installation

```
$ pip install qemu-compose
```

## Examples and Screenshot

bring up ubuntu cloudimg qemu vm and run a interactive shell


```
$ cd ./script/ubuntu-cloudimg__amd64/
$ qemu-compose up
```

Demo:

[![asciicast](https://raw.githubusercontent.com/zTrix/qemu-compose/refs/heads/main/assets/726386.svg)](https://asciinema.org/a/726386)

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "qemu-compose",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "qemu, qemu-compose, qemu_compose",
    "author": null,
    "author_email": "Wenlei Zhu <i@ztrix.me>, Zhen Tang <tangzhen23@foxmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/65/5e/bd1864a7dee3d64a2253fde6ffdd6bd186dcd4208e1fec22137c910ef7bb/qemu_compose-0.6.2.tar.gz",
    "platform": null,
    "description": "\n# qemu-compose\n\nqemu-compose aims to provide a docker-compose style composer for qemu command, with advanced scripting feature as well as http support for cloud init or general purpose provisioning.\n\nBring up a qemu VM by providing a qemu-compose.yml and run `qemu-compose up`\n\n## Advantages\n\n - Very simple and robust, written of several pure python scripts, depends on `qemu` commands only.\n - No libvirt stuff, no daemon process, no xml config, no complex abstraction, just a simple wrapper around qemu args.\n - support `before_script` and `after_script` for setup and cleanup\n - support `boot_commands` for vm provisioning (implemented using tty communication, gui not supported yet, and use jsonlisp for expressive power which apparently is turing-complete)\n - support `http_serve` for cloudinit\n - env interpolation for advanced configuration\n\n## Installation\n\n```\n$ pip install qemu-compose\n```\n\n## Examples and Screenshot\n\nbring up ubuntu cloudimg qemu vm and run a interactive shell\n\n\n```\n$ cd ./script/ubuntu-cloudimg__amd64/\n$ qemu-compose up\n```\n\nDemo:\n\n[![asciicast](https://raw.githubusercontent.com/zTrix/qemu-compose/refs/heads/main/assets/726386.svg)](https://asciinema.org/a/726386)\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "docker-compose style composer for qemu",
    "version": "0.6.2",
    "project_urls": null,
    "split_keywords": [
        "qemu",
        " qemu-compose",
        " qemu_compose"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "666978d4dfe4b76cf23183ba743edb89088f61d00018b2f5a0166dace10cb4b4",
                "md5": "c74244786d9b18fc66e306659420d9e1",
                "sha256": "ccf0b4b2b0af146aff78cf0c6f1233fb8d389c9f5012647eb581ccb3050d2527"
            },
            "downloads": -1,
            "filename": "qemu_compose-0.6.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "c74244786d9b18fc66e306659420d9e1",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 104496,
            "upload_time": "2025-07-20T12:18:19",
            "upload_time_iso_8601": "2025-07-20T12:18:19.401029Z",
            "url": "https://files.pythonhosted.org/packages/66/69/78d4dfe4b76cf23183ba743edb89088f61d00018b2f5a0166dace10cb4b4/qemu_compose-0.6.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "655ebd1864a7dee3d64a2253fde6ffdd6bd186dcd4208e1fec22137c910ef7bb",
                "md5": "7ce14e87e3cfbb61f8c46fbaa7f1d69f",
                "sha256": "ff0f891f1c435553cdc4ac306e4e704d6fe6e94b677ced7b360e23b01c38f2b7"
            },
            "downloads": -1,
            "filename": "qemu_compose-0.6.2.tar.gz",
            "has_sig": false,
            "md5_digest": "7ce14e87e3cfbb61f8c46fbaa7f1d69f",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 88412,
            "upload_time": "2025-07-20T12:18:20",
            "upload_time_iso_8601": "2025-07-20T12:18:20.823884Z",
            "url": "https://files.pythonhosted.org/packages/65/5e/bd1864a7dee3d64a2253fde6ffdd6bd186dcd4208e1fec22137c910ef7bb/qemu_compose-0.6.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-20 12:18:20",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "qemu-compose"
}
None
Elapsed time: 1.21444s