{"id":16164813,"url":"https://github.com/aperezdc/virtualz","last_synced_at":"2025-03-18T23:30:35.495Z","repository":{"id":142776974,"uuid":"51991222","full_name":"aperezdc/virtualz","owner":"aperezdc","description":"Virtualfish-alike Python virtualenv wrapper for Zsh","archived":false,"fork":false,"pushed_at":"2024-04-03T14:32:54.000Z","size":28,"stargazers_count":9,"open_issues_count":0,"forks_count":4,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-02-28T12:47:05.589Z","etag":null,"topics":["plugin","python","virtualenv","zsh"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aperezdc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2016-02-18T08:12:54.000Z","updated_at":"2025-02-27T07:38:20.000Z","dependencies_parsed_at":"2024-04-16T14:48:17.897Z","dependency_job_id":null,"html_url":"https://github.com/aperezdc/virtualz","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aperezdc%2Fvirtualz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aperezdc%2Fvirtualz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aperezdc%2Fvirtualz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aperezdc%2Fvirtualz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aperezdc","download_url":"https://codeload.github.com/aperezdc/virtualz/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243955511,"owners_count":20374369,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["plugin","python","virtualenv","zsh"],"created_at":"2024-10-10T02:47:57.713Z","updated_at":"2025-03-18T23:30:35.198Z","avatar_url":"https://github.com/aperezdc.png","language":"Shell","readme":"# VirtualZ\n\nA [Z shell](http://zsh.org) wrapper for Ian Bicking's\n[virtualenv](https://virtualenv.pypa.io/en/latest/), loosely based on Adam\nBrenecki's [virtualfish](https://github.com/adambrenecki/virtualfish) for the\n[Fish shell](http://fishshell.com).\n\n\n## Quickstart\n\nOnce installed, VirtualZ provides the `vz` command. Try the following:\n\n```\nvz new myvirtualenv\necho ${VIRTUAL_ENV}\nwhich python\nvz new othervirtualenv\necho ${VIRTUAL_ENV}\nvz deactivate\nvz rm myvirtualenv\nvz rm othervirtualenv\n```\n\n### Additional Options\n\nWhen creating a new environment, the additional parameters passed to the `vz\nnew` command are passed down to the `virtualenv` command. For example, this\ncan be used to specify which `python` executable to use:\n\n```\nvz new env-with-pypy -p /usr/bin/pypy\n```\n\nor to allow usage of packages installed system-wide:\n\n```\nvz new with-system-pkgs --system-site-packages\n```\n\n\n## Installation \u0026 Setup\n\nThe recommended way is to use a plugin manager. By default, the location where VirtualZ looks for virtualenvs is `~/.virtualenvs`. This can be changed by setting the desired path in the `${VIRTUALZ_HOME}` variable.\n\nWith [zgen](https://github.com/tarjoilija/zgen), add the following to your `.zshrc`:\n\n```sh\nzgen load aperezdc/virtualz\n```\n\n\n### Virtualenv name in the prompt\n\nWhen a virtualenv is active, the following variables are defined:\n\n- `VIRTUAL_ENV` contains the full path to the active environment.\n- `VIRTUAL_ENV_NAME` contains the name of the active environment.\n\nFor example, the following will prepend the name of the current virtualenv to your existing prompt, but only if there's an environment active:\n\n```sh\nPROMPT='${VIRTUAL_ENV_NAME:+${VIRTUAL_ENV_NAME} }${PROMPT}'\n```\n","funding_links":[],"categories":["Plugins","Shell"],"sub_categories":["ZSH on Windows","Zinit (née zplugin)"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faperezdc%2Fvirtualz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faperezdc%2Fvirtualz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faperezdc%2Fvirtualz/lists"}