Merge pull request #6 from Kelocker/linux-mac-development

Linux mac development
Kelocker · Oct 3, 2024 · 90d3534 · 90d3534
2 parents c4e4c49 + 8a176df
commit 90d3534
Show file tree

Hide file tree

Showing 5 changed files with 336 additions and 59 deletions.
diff --git a/README.md b/README.md
@@ -3,10 +3,9 @@
 <h1>venvat</h1>
 
 <p align="center">
-  <img src="https://drive.google.com/uc?id=120eoXcHEWwuY0Wj5hsAZqMBOayuo8eIk" />
+  <img src="https://drive.google.com/uc?id=134ISLGGnBuv8OT2AsV5lR0nNIHNX38z1" alt="venvat-logo"/>
 </p>
 
-
 <p align="center">
   <a href="./CONTRIBUTING.md">
     <img src="https://img.shields.io/badge/Contributions-Welcome-brightgreen.svg?style=flat-square" alt="Contributing Badge"/>
@@ -25,27 +24,38 @@
 
 </div>
 
-- - -
+---
 
 ## Table of Contents
 
 1. [Package Disclaimer](#package-disclaimer)
 2. [Limitations](#limitations)
 3. [Introduction](#introduction)
-4. [Installation](#installation)
+4. [Venvat](#venvat)
+5. [Global](#global)
+6. [Venvat Global](#venvat-global)
+7. [Difference between Venvat and Venvat Global](#difference-between-venvat-and-venvat-global)
+8. [Installation for Venvat (Windows only)](#installation-for-venvat-windows-only)
     - [Requirements](#requirements)
     - [Installing Python](#installing-python)
     - [Installing pip](#installing-pip)
     - [Installing venvat](#installing-venvat)
-5. [Activating Your Virtual Environment](#activating-your-virtual-environment)
+    - [Activating Your Virtual Environment](#activating-your-virtual-environment)
     - [Specifying a Custom Virtual Environment](#specifying-a-custom-virtual-environment)
-6. [Security](#security)
-6. [Support](#support)
-7. [How to Contribute](#how-to-contribute)
-
-- - -
+9. [Installation for Venvat Global (Linux and macOS)](#installation-for-venvat-global-linux-and-macos)
+    - [Requirements](#requirements-1)
+    - [Installing Venvat Global](#installing-venvat-global)
+    - [How to Uninstall Venvat Global](#how-to-uninstall-venvat-global)
+    - [Configure Venv](#configure-venv)
+10. [Security](#security)
+11. [Support](#support)
+12. [How to Contribute](#how-to-contribute)
+13. [Feedback](#feedback)
+
+---
 
 ## Package Disclaimer
+
 The `venvat` package is provided "as is" without any warranties, express or implied. While every effort has been made to ensure the functionality and reliability of this package, the authors do not guarantee that it will be free of errors, bugs, or interruptions. By using this package, you agree that the authors will not be held liable for any damages or losses resulting from its use, including but not limited to data loss, system downtime, or any other negative consequences.
 
 This package is intended for educational and development purposes. It is not recommended for use in production environments without proper testing and validation by the user.
@@ -54,90 +64,212 @@ Users are solely responsible for determining the suitability of this package for
 
 In no event shall the authors or contributors be held liable for any damages arising in any way from the use of this project. Users of this project are solely responsible for compliance with any legal obligations, including but not limited to data privacy and intellectual property rights.
 
+---
+
 ## Limitations
 
 1. **Environment Compatibility**: The `venvat` package has been primarily tested on specific operating systems and environments. Compatibility with all versions of Windows or other operating systems is not guaranteed.
-
 2. **Virtual Environment Naming**: The package assumes a certain directory structure for virtual environments. Custom naming conventions or unconventional directory layouts may require additional configuration or modifications to the script.
-
 3. **Error Handling**: While the package includes basic error handling, it may not cover all edge cases. Users are encouraged to review and modify the code as needed to handle their specific scenarios.
-
 4. **Performance**: The package is designed for small to medium-sized projects. Performance in very large projects or in systems with significant load may vary and should be assessed by the user.
-
 5. **Security Considerations**: The package does not include advanced security features. Users should ensure that appropriate security measures are in place when using this package in any environment, especially those involving sensitive data or public-facing systems.
-
 6. **Support and Maintenance**: The `venvat` package is provided with limited support. Users are encouraged to contribute to its development and report any issues via the project's issue tracker. However, there is no guarantee of timely fixes or updates.
 
 By using this package, you agree to these terms and conditions. Learn more in the [LICENSE](https://github.com/Kelocker/venvat/blob/main/LICENSE).
 
+---
 
 ## Introduction
-Are you tired of typing long commands to activate Python virtual environments? **venvat** simplifies this process with a simple command. This tool is designed to streamline the activation of virtual environments, making your workflow more efficient.
 
-## Installation
+Are you tired of typing long commands to activate Python virtual environments? **venvat** simplifies this process with a single command. This tool is designed to streamline the activation of virtual environments, making your workflow more efficient.
+
+---
+
+## Venvat
+<p align="center">
+  <img src="https://drive.google.com/uc?id=134ISLGGnBuv8OT2AsV5lR0nNIHNX38z1" alt="venvat-logo"/>
+</p>
+
+<p align="center">
+  <img src="https://drive.google.com/uc?id=1QEo4IYj2iKWTNWk5wDCHkYh535m0Fmqa" alt="venvat-available-windows"/>
+</p>
+
+---
+
+## Global
+<p align="center">
+  <img src="https://drive.google.com/uc?id=1TnDq98b17is2vpmxYAUcfIt2mCJx1pbY" alt="global-environment" />
+</p>
+
+We are thrilled to announce that we are contributing to the global environment.
+
+---
+
+## Venvat Global
+
+<p align="center">
+  <img src="https://drive.google.com/uc?id=1Novbu8DEG1GoGINQK5pb19I2yGD40TzJ" alt="venvat-global-beta-version"/>
+</p>
+
+<p align="center">
+  <img src="https://drive.google.com/uc?id=1zH_oh-zisr8uPaBiFqWIta_M2UxnRb74" alt="global-venvat-beta-version now available for Linux and macOS"/>
+</p>
+
+---
+
+## Difference between Venvat and Venvat Global
+
+| Feature             | Venvat                            | Venvat Global              |
+|---------------------|-----------------------------------|----------------------------|
+| Downloads           | Downloads every time in a venv    | Download once globally     |
+| Supported Platform  | Windows only                      | Linux and macOS            |
+
+---
+
+## Installation for Venvat (Windows only)
 
 ### Requirements
+
 Before using **venvat**, ensure the following requirements are met:
 - **Python**: This tool requires Python 3.6 or newer. Install Python from [the official website](https://www.python.org/downloads/).
 - **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.
 
-
 ### Installing Python
-If you need to install Python, you can download it from the official site:
-
-Visit https://www.python.org/downloads/
 
+If you need to install Python, you can download it from the official site:
 
+[https://www.python.org/downloads](https://www.python.org/downloads)
 
 ### Installing pip
+
 If `pip` is not installed, you can install it by downloading `get-pip.py`:
 
 ```
 curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
 python get-pip.py
 ```
 
-
 ### Installing venvat
-To install venvat, run the following command:
+
+To install `venvat`, run the following command:
+
 ```
 pip install venvat
 ```
 
+---
 
 ## Activating Your Virtual Environment
 
-Once `venvat` is installed, you can easily activate your virtual environment. If you're using `venvat` for the first time or if you want to switch to a different virtual environment, you need to specify the name of your virtual environment. Here’s how:
+Once `venvat` is installed, you can easily activate your virtual environment. If you're using `venvat` for the first time or if you want to switch to a different virtual environment, you need to specify the name of your virtual environment.
 
+If your virtual environment is named `venv`, you can run:
 
-If your virtual environment is named `venv` you can run:
 ```
 venvat
 ```
 
 ### Specifying a Custom Virtual Environment
+
 If your virtual environment is not named `venv`, you will need to configure it the first time you use `venvat`:
 
 ```
 venvat --venv your-env-name
 ```
 
-Reseting your configuration:
+Resetting your configuration:
+
 ```
 venvat --reset
 ```
 
-For more feature, you can explore with:
+For more features, you can explore with:
+
 ```
 venvat --help
 ```
 
+---
+
+## Installation for Venvat Global (Linux and macOS)
+
+### Requirements
+
+- **Python**: You need Python 3.6 or newer. Install it from [the official website](https://www.python.org/downloads/).
+- **pip**: Ensure `pip` is installed. You can follow the same pip installation process as described earlier.
+
+### Installing Venvat Global
+
+To install `venvat` globally, run:
+
+```
+pip install venvat
+```
+
+Then, activate it based on your shell:
+
+For Bash:
+```
+source ~/.bashrc
+```
+
+For Zsh:
+```
+source ~/.zshrc
+```
+
+Restart your terminal to apply the changes.
+
+Now, `venvat
+
+` is available globally.
+
+*Optional* To uninstall `venvat` package, run:
+
+```
+pip uninstall venvat
+```
+
+### How to Uninstall Venvat Global
+
+To remove `venvat` from your shell configuration, run:
+
+```
+venvat --remove
+```
+
+### Configure Venv
+
+`venvat` assumes your virtual environment is named `venv`. If you're using a different name for your virtual environment, use:
+
+```
+venvat --venv your-venv-name
+```
+
+---
+
 ## Security
+
 For information on how to report security vulnerabilities, please see our [Security Policy](./SECURITY.md).
 
+---
 
 ## Support
-For questions, issues, or support with venvat, please open an issue on the [GitHub issues page](https://github.com/Kelocker/venvat/issues).
+
+For questions, issues, or support with `venvat`, please open an issue on the [GitHub issues page](https://github.com/Kelocker/venvat/issues).
+
+---
 
 ## How to Contribute
+
 Contributions are welcome! If you'd like to contribute, please fork the repository and create a feature branch. Pull requests are warmly encouraged. For more details, please refer to our [CONTRIBUTING.md](https://github.com/Kelocker/venvat/blob/main/CONTRIBUTING.md) and [Code of Conduct](https://github.com/Kelocker/venvat/blob/main/CODE_OF_CONDUCT.md).
+
+---
+
+## Feedback
+
+<p align="center">
+  <img src="https://drive.google.com/uc?id=1fbYzARRQkFIe0cx8bqnZHyIZUnllGY6w" />
+</p>
+
+We need your feedback! Feel free to share your thoughts and suggestions on the [Discussion page](https://github.com/Kelocker/venvat/discussions).
diff --git a/VERSION b/VERSION
@@ -1 +1 @@
-0.2.18
+0.3.23
diff --git a/scripts/venvat.ps1 b/scripts/venvat.ps1
@@ -2,15 +2,13 @@ param(
     [string]$venvName
 )
 
-# Check for help flag before proceeding
 if ($venvName -eq "--help") {
     Write-Host "Usage: venvat [--venv VENV_NAME] [--reset]" -ForegroundColor Yellow
     Write-Host "If no VENV_NAME is provided, venvat will consider 'venv' as your virtual environment name." -ForegroundColor Yellow
     Write-Host "Use '--reset' to clear the stored virtual environment configuration." -ForegroundColor Yellow
     exit
 }
 
-# Path to the config file
 $configPath = "venvat.config"
 
 function Safe-ReadConfig {
@@ -46,7 +44,6 @@ if ($venvName -eq "--venv") {
     }
 }
 
-# Reset venvat config
 if ($venvName -eq "--reset") {
     if (Test-Path $configPath) {
         Remove-Item $configPath -ErrorAction Ignore
@@ -57,27 +54,24 @@ if ($venvName -eq "--reset") {
     exit
 }
 
-# Determine virtual environment name
 if (-not $venvName -or $venvName -eq "") {
     $venvName = Safe-ReadConfig
     if (-not $venvName) {
-        $venvName = "venv"  # Default environment name
+        $venvName = "venv"
         Safe-WriteConfig $venvName
         Write-Host "No environment name provided, using default 'venv'." -ForegroundColor Yellow
     }
 }
 
-# Path to the virtual environment activation script
 $venvPath = ".\$venvName\Scripts\activate"
 
-# Check if the activation script exists
 if (Test-Path $venvPath) {
     Write-Host "Activating virtual environment '$venvName'..." -ForegroundColor Green
     & $venvPath
 } else {
     Write-Host "Virtual environment activation script not found at: $venvPath. Check the environment name and path." -ForegroundColor Red
     if (Test-Path $configPath) {
-        Remove-Item $configPath -ErrorAction Ignore  # Remove config if path is incorrect
+        Remove-Item $configPath -ErrorAction Ignore
         Write-Host "Invalid configuration removed." -ForegroundColor Yellow
     }
 }
diff --git a/setup.py b/setup.py
@@ -2,7 +2,7 @@
 
 setup(
     name='venvat',
-    version='0.2.18',
+    version='0.3.23',
     description='A script to activate Python virtual environments.',
     long_description=open('README.md').read(),
     long_description_content_type='text/markdown',