|
1 | 1 | # Setup Guide |
2 | 2 |
|
3 | | -## Prerequisites |
| 3 | +## Table of content |
| 4 | +1. [Installation for Venvat (Windows only)](#installation-for-venvat-windows-only) |
| 5 | + - [Requirements](#requirements) |
| 6 | + - [Installing Python](#installing-python) |
| 7 | + - [Installing pip](#installing-pip) |
| 8 | + - [Installing venvat](#installing-venvat) |
| 9 | + - [Activating Your Virtual Environment](#activating-your-virtual-environment) |
| 10 | + - [Specifying a Custom Virtual Environment](#specifying-a-custom-virtual-environment) |
| 11 | +2. [Installation for Venvat Global (Linux and macOS)](#installation-for-venvat-global-linux-and-macos) |
| 12 | +3. [Clone repository](#Clone-repository) |
4 | 13 |
|
5 | | -- Python 3.6 or later |
6 | | -- pip package manager |
7 | 14 |
|
8 | 15 | ## Installation |
| 16 | +## Installation for Venvat (Windows only) |
9 | 17 |
|
| 18 | +### Requirements |
| 19 | + |
| 20 | +Before using **venvat**, ensure the following requirements are met: |
| 21 | +- **Python**: This tool requires Python 3.6 or newer. Install Python from [the official website](https://www.python.org/downloads/). |
| 22 | +- **Virtual Environment**: You should have a virtual environment already set up in your project. `venvat` is designed to activate these environments, not to create them. |
| 23 | + |
| 24 | +### Installing Python |
| 25 | + |
| 26 | +If you need to install Python, you can download it from the official site: |
| 27 | + |
| 28 | +[https://www.python.org/downloads](https://www.python.org/downloads) |
| 29 | + |
| 30 | +### Installing pip |
| 31 | + |
| 32 | +If `pip` is not installed, you can install it by downloading `get-pip.py`: |
| 33 | + |
| 34 | +``` |
| 35 | +curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py |
| 36 | +python get-pip.py |
| 37 | +``` |
| 38 | + |
| 39 | +### Installing venvat |
| 40 | + |
| 41 | +To install `venvat`, run the following command: |
| 42 | + |
| 43 | +``` |
| 44 | +pip install venvat |
| 45 | +``` |
| 46 | + |
| 47 | +--- |
| 48 | + |
| 49 | +## Activating Your Virtual Environment |
| 50 | + |
| 51 | +Once `venvat` is installed, you can easily activate your virtual environment. |
| 52 | + |
| 53 | +If your virtual environment is named `venv`, you can run: |
| 54 | + |
| 55 | +``` |
| 56 | +venvat |
| 57 | +``` |
| 58 | + |
| 59 | +*Important* : Venvat recognise `venv` as default name of the virtual environment |
| 60 | + |
| 61 | +### Specifying a Custom Virtual Environment |
| 62 | + |
| 63 | +If your virtual environment is not named `venv`, you will need to configure it for the first time: |
| 64 | + |
| 65 | +``` |
| 66 | +venvat --venv your-env-name |
| 67 | +``` |
| 68 | + |
| 69 | +Resetting your configuration: |
| 70 | + |
| 71 | +``` |
| 72 | +venvat --reset |
| 73 | +``` |
| 74 | + |
| 75 | +For more features, you can explore with: |
| 76 | + |
| 77 | +``` |
| 78 | +venvat --help |
| 79 | +``` |
| 80 | + |
| 81 | +--- |
| 82 | + |
| 83 | +## Installation for Venvat Global (Linux and macOS) |
| 84 | + |
| 85 | +### Requirements |
| 86 | + |
| 87 | +- **Python**: You need Python 3.6 or newer. Install it from [the official website](https://www.python.org/downloads/). |
| 88 | +- **pip**: Ensure `pip` is installed. You can follow the same pip installation process as described earlier. |
| 89 | + |
| 90 | +### Installing Venvat Global |
| 91 | + |
| 92 | +To install `venvat` globally, run: |
| 93 | + |
| 94 | +``` |
| 95 | +pip install venvat |
| 96 | +``` |
| 97 | + |
| 98 | +Then, activate it based on your shell: |
| 99 | + |
| 100 | +For Bash: |
| 101 | +``` |
| 102 | +source ~/.bashrc |
| 103 | +``` |
| 104 | + |
| 105 | +For Zsh: |
| 106 | +``` |
| 107 | +source ~/.zshrc |
| 108 | +``` |
| 109 | + |
| 110 | +Restart your terminal to apply the changes. |
| 111 | + |
| 112 | +Now, `venvat` is available globally. |
| 113 | + |
| 114 | + |
| 115 | +## Clone repository |
10 | 116 | 1. Clone the repository: |
11 | 117 | ``` |
12 | 118 | git clone https://github.com/Kelocker/venvat.git |
|
0 commit comments