{"id":19544461,"url":"https://github.com/selectnull/ave","last_synced_at":"2026-04-16T18:44:49.350Z","repository":{"id":3378523,"uuid":"4426244","full_name":"selectnull/ave","owner":"selectnull","description":"ActivateVirtualEnv","archived":false,"fork":false,"pushed_at":"2024-02-06T10:13:00.000Z","size":10,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-24T02:55:37.151Z","etag":null,"topics":["python","shell","virtualenv"],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/selectnull.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"publiccode":null,"codemeta":null}},"created_at":"2012-05-23T22:42:50.000Z","updated_at":"2024-02-06T10:13:04.000Z","dependencies_parsed_at":"2024-11-11T03:29:04.117Z","dependency_job_id":"9d657a21-6f5e-48f0-9ca3-72482a048821","html_url":"https://github.com/selectnull/ave","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/selectnull%2Fave","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/selectnull%2Fave/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/selectnull%2Fave/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/selectnull%2Fave/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/selectnull","download_url":"https://codeload.github.com/selectnull/ave/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240801037,"owners_count":19859727,"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":["python","shell","virtualenv"],"created_at":"2024-11-11T03:29:00.846Z","updated_at":"2026-04-16T18:44:44.321Z","avatar_url":"https://github.com/selectnull.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"ave - Activate Virtual Environment\n==================================\n\nave is small shell (bash, zsh) function to help out with activation of Python's\nvirtual environments; the name stands for Activate Virtual Environment (which\nis almost all it does).\n\n\nHow to use it?\n--------------\n\nave was created out of my personal needs of organizing projects and need to\ntype less. There are two ways in which ave can be used.  If you type ``ave``\nwith no arguments, it will start from current directory and search for virtual\nenvironment by ``cd`` ing upwards thru parent directories or by looking inside\n``~/$WORKON_HOME``.  When virtual environment is found, it is activated\n(sourced).  Called with an argument, it will do the same and optionally ``cd``\nto project directory if it's held under source control (git, mercurial or svn).\n\nThe above is all ``ave`` does, but it's easier to understand with following\nexample. Let's assume we have this directory structure:\n\n    # this is where we store our projects\n    ~/projects/\n        common-env/\n            project_1/\n            project_2/\n            project_3/\n        project_a/\n        project_b/\n        project_c/\n\n    # this is where we store virtual environments\n    ~/$WORKON_HOME/\n        common-env/\n        project_a/\n        project_b/\n        project_c/\n\n    # temp directory to work with throwaway stuff\n    ~/tmp/\n\n### Multiple projects based on common virtual environment\n\nThese are projects that are all based on the same virtual environment,\n``common-env`` in the example:\n\n    ave ~/projects/common-env/project_1\n\nor\n\n    cd ~/projects/common-env/project_1\n    ave\n\nAfter any of those commands, ``common-env`` is activated and current\ndirectory is changed to ``project_1``.\n\n### One project per virtual environment\n\nEach project has its own virtual environment:\n\n    ave ~/projects/project_a\n\nor\n\n    cd ~/projects/project_a\n    ave\n\nWith bash (or any other shell) and tab completion, very few keystrokes\nare needed.\n\n### Playground and throwaway environmets\n\nThere is often a need to test new libraries. You want to quickly make an\nenvironment, type out some code (directly in python shell or by creating\na file), play with it and delete it.\n\n    virtualenv ~/tmp/foo-playground\n    cd ~/tmp/foo-playground\n    ave\n\n    pip install foo\n    python\n    # import foo and play with it\n\n    # enough play, go to work\n    rm -rf ~/foo-playground\n\nThis way you are not cluttering ``WORKON_HOME`` directory even if you don't\ndelete temporary environmets right away after use (which I usually don't).\n\n\nHow to install it?\n------------------\n\n### Via pip\n\nInstall for user:\n\n    pip install ave --user\n\nor if you want to install globally:\n\n    sudo pip install ave\n\n### Manually\n\nClone the repository and source ave.sh script from your .bashrc or .profile.\n\n### Configure it\n\n    # define directory to put virtual environments\n    export WORKON_HOME=~/.venvs\n\n    # source ave function\n    source /path/to/ave.sh\n\n\nWhat about virtualenvwrapper?\n-----------------------------\n\nBy all means, virtualenvwrapper is mature and well tested software.\nIt works great and is recommended by many pythonistas. It does so much\nmore than ave and if you need its functionality, you should check it out.\n\nave uses the same ``WORKON_HOME`` evnironment variable so it's compatible\nwith virtualenvwrapper, both can be used at the same time.\n\nave is simple to the point that this documentation is longer than the\ncomplete ave code. I like simple.\n\n\nLicence\n-------\n\nave is MIT licensed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fselectnull%2Fave","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fselectnull%2Fave","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fselectnull%2Fave/lists"}