{"id":25732438,"url":"https://github.com/vigo/lsvirtualenvs","last_synced_at":"2025-05-07T19:02:15.098Z","repository":{"id":136720890,"uuid":"139144252","full_name":"vigo/lsvirtualenvs","owner":"vigo","description":"Small commandline tool for `virtualenvwrapper`","archived":false,"fork":false,"pushed_at":"2023-09-18T02:31:22.000Z","size":84,"stargazers_count":4,"open_issues_count":6,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-31T13:05:04.063Z","etag":null,"topics":["golang","virtualenvwrapper"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vigo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-06-29T12:01:44.000Z","updated_at":"2023-08-09T06:28:16.000Z","dependencies_parsed_at":"2024-06-20T07:23:16.176Z","dependency_job_id":"2d1b3680-1382-434f-8861-cfc200cedd3d","html_url":"https://github.com/vigo/lsvirtualenvs","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vigo%2Flsvirtualenvs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vigo%2Flsvirtualenvs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vigo%2Flsvirtualenvs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vigo%2Flsvirtualenvs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vigo","download_url":"https://codeload.github.com/vigo/lsvirtualenvs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252940883,"owners_count":21828766,"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":["golang","virtualenvwrapper"],"created_at":"2025-02-26T03:41:02.983Z","updated_at":"2025-05-07T19:02:14.829Z","avatar_url":"https://github.com/vigo.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Version](https://img.shields.io/badge/version-0.3.3-yellow.svg)\n![Go](https://img.shields.io/badge/golang-1.16.3-black.svg)\n[![Documentation](https://godoc.org/github.com/vigo/lsvirtualenvs?status.svg)](https://pkg.go.dev/github.com/vigo/lsvirtualenvs)\n[![Go Report Card](https://goreportcard.com/badge/github.com/vigo/lsvirtualenvs)](https://goreportcard.com/report/github.com/vigo/lsvirtualenvs)\n[![Build Status](https://travis-ci.org/vigo/lsvirtualenvs.svg?branch=main)](https://travis-ci.org/vigo/lsvirtualenvs)\n![Go Build Status](https://github.com/vigo/lsvirtualenvs/actions/workflows/go.yml/badge.svg)\n![GolangCI-Lint Status](https://github.com/vigo/lsvirtualenvs/actions/workflows/golang-lint.yml/badge.svg)\n[![Verify Docker Build](https://github.com/vigo/lsvirtualenvs/actions/workflows/verify-docker-build.yml/badge.svg)](https://github.com/vigo/lsvirtualenvs/actions/workflows/verify-docker-build.yml)\n![Docker Build Status](https://github.com/vigo/lsvirtualenvs/actions/workflows/dockerhub.yml/badge.svg)\n[![codecov](https://codecov.io/gh/vigo/lsvirtualenvs/branch/main/graph/badge.svg?token=qHG6ergs9n)](https://codecov.io/gh/vigo/lsvirtualenvs)\n![Powered by Rake](https://img.shields.io/badge/powered_by-rake-blue?logo=ruby)\n\n# List Virtual Environments for `virtualenvwrapper`\n\nIf you use `virtualenvwrapper` you’ll love this :)\n\nDue to `virtualenvwrapper`’s `lsvirtualenv`’s super slow speed and lack of\ninformation, I made this simple cli-tool with `golang`.\n\n---\n\n## Requirements\n\nI’m assuming that you are already using [virtualenvwrapper][virtualenvwrapper]\nand you have `WORKON_HOME` environment variable is already exists in your\nshell environment.\n\n---\n\n## Installation\n\nYou can install from the source;\n\n```bash\n$ go install github.com/vigo/lsvirtualenvs@latest\n```\n\nThis will build and install binary of `lsvirtualenvs` under `$GOPATH/bin` path.\n\nor, you can install from `brew`:\n\n```bash\n$ brew tap vigo/lsvirtualenvs\n$ brew install lsvirtualenvs\n```\n\n\n### Build from source\n\nCheck your `go env GOPATH` then check sources;\n\n```bash\n$ ls \"$(go env GOPATH)/src/\"\ncloud.google.com  github.com  go.opencensus.io  golang.org  google.golang.org\n\n# if github.com does not exists, create the folder via\n# $ mkdir \"$(go env GOPATH)/src/github.com\"\n\n$ mkdir \"$(go env GOPATH)/src/github.com/vigo\" # need for run/build operations\n$ cd \"$(go env GOPATH)/src/github.com/vigo\"\n$ git clone git@github.com:vigo/lsvirtualenvs.git\n$ cd lsvirtualenvs/\n$ go build\n$ ls \"$(go env GOPATH)/bin\" # you should see `lsvirtualenvs` binary\n$ lsvirtualenvs -h\n```\n\n## Usage\n\n```bash\n$ lsvirtualenvs -h\n\nusage: lsvirtualenvs [-flags]\n\nlists existing virtualenvs which are created via \"mkvirtualenv\" command.\n\n  flags:\n\n  -c, -color          enable colored output\n  -s, -simple         just list environment names, overrides -c, -i\n  -i, -index          add index number to output\n      -version        display version information (X.X.X)\n```\n\nUsage examples:\n\n```bash\n$ lsvirtualenvs -h\n$ lsvirtualenvs -c\n$ lsvirtualenvs -color\n$ lsvirtualenvs -c -i\n$ lsvirtualenvs -color -index\n$ lsvirtualenvs -s\n$ lsvirtualenvs -simple\n```\n\nExample output:\n\n```bash\n$ lsvirtualenvs\nyou have 2 environments available\n\ntextmate................... 3.8.0\ntrash...................... 3.8.0\n\n$ lsvirtualenvs -i\nyou have 2 environments available\n\n[0001] textmate................... 3.8.0\n[0002] trash...................... 3.8.0\n\n$ lsvirtualenvs -c -i # colored output with index\n```\n\nRun tests via;\n\n```bash\n$ go test -v ./...\n```\n\n---\n\n## Docker\n\nhttps://hub.docker.com/r/vigo/lsvirtualenvs/\n\nNote that, `lsvirtualenvs` requires `WORKON_HOME` environment variable which is\nnot available inside of the docker container :) This is just an example / concept\nof dockerized version of the application :)\n\n```bash\n$ docker run --read-only -v \"${WORKON_HOME}\":/venvs --env WORKON_HOME=/venvs vigo/lsvirtualenvs\n$ docker run --read-only -v \"${WORKON_HOME}\":/venvs --env WORKON_HOME=/venvs vigo/lsvirtualenvs -h\n```\n\nIf you run it from container, currently, it’s not possible to get python\nversions of the existing environments.\n\n---\n\n## Rake Tasks\n\n```bash\n$ rake -T\n\nrake default            # show avaliable tasks (default task)\nrake docker:lint        # lint Dockerfile\nrake release[revision]  # release new version major,minor,patch, default: patch\nrake test[verbose]      # run tests\n```\n\n---\n\n## Change Log\n\n**2022-07-09**\n\n- Add docker build/push action\n- Fix docker platform issue\n\n**2022-02-24**\n\n- `Dockerfile` is lint-free now!\n- `lsvirtualenvs` runs perfectly from container now!\n\n**2022-02-15**\n\n- Add `LSVIRTUALENVS_COLOR_ALWAYS` environment variable check. Set `LSVIRTUALENVS_COLOR_ALWAYS=1` for\n  colored output all the time\n- Add GolangCI-Lint checker\n\n**2021-05-09**\n\n- Add github action for go build status\n- Changed `master` branch to `main`\n- Add missing information to `-h` help\n- Add Rake tasks\n\n**2021-01-06**\n\n- Complete make-over from scratch, removed `sync.Map()`, used channels\n- Fix information on README\n\n**2018-07-05**\n\n- Due to @fatih’s warning, removed `Lock()` and used `sync.Map()`\n- Version 2.1.1\n\n**2018-07-04**\n\n- App refactored\n- Unit tests are completed\n- Version 2.0.1\n\n**2018-07-02**\n\n- Basic unit testing\n\n**2018-07-01**\n\n- Code refactor\n\n**2018-06-29**\n\n- First release\n- Addition: `--version`\n\n**2018-06-28**\n\n- Initial commit\n\n---\n\n## Contributor(s)\n\n* [Uğur \"vigo\" Özyılmazel](https://github.com/vigo) - Creator, maintainer\n\n---\n\n## Contribute\n\nAll PR’s are welcome!\n\n1. `fork` (https://github.com/vigo/lsvirtualenvs/fork)\n1. Create your `branch` (`git checkout -b my-feature`)\n1. `commit` yours (`git commit -am 'Add garlic and yogurt'`)\n1. `push` your `branch` (`git push origin my-feature`)\n1. Than create a new **Pull Request**!\n\n---\n\n## License\n\nThis project is licensed under MIT\n\n---\n\n\n[virtualenvwrapper]: https://virtualenvwrapper.readthedocs.io/en/latest/","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvigo%2Flsvirtualenvs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvigo%2Flsvirtualenvs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvigo%2Flsvirtualenvs/lists"}