Automating Virtual Environment Creation in Python

Creating virtual environments is a crucial practice in Python development to isolate project dependencies and avoid conflicts. This challenge asks you to write a Python script that automates the creation of virtual environments, taking the environment name as input and ensuring the environment is properly set up. This is useful for streamlining project setup and maintaining consistent development environments.

Problem Description

You are tasked with creating a Python script that takes a virtual environment name as a command-line argument and automatically creates a virtual environment with that name using the venv module. The script should:

1. Accept a command-line argument: The script must accept a single argument representing the desired name of the virtual environment.
2. Create the virtual environment: Use the venv module to create a virtual environment with the specified name in the current working directory.
3. Handle errors gracefully: If the virtual environment creation fails (e.g., due to insufficient permissions or an invalid environment name), the script should print an informative error message to the console and exit with a non-zero exit code.
4. Provide confirmation: Upon successful creation, the script should print a confirmation message to the console indicating that the virtual environment has been created.

Expected Behavior:

When executed with a valid environment name, the script should create a directory with that name containing the virtual environment files. If the environment already exists, the script should print an error message and exit.

Examples

Example 1:

Input: python create_venv.py my_project_env
Output: Created virtual environment 'my_project_env'

Explanation: The script creates a virtual environment named "my_project_env" in the current directory.

Example 2:

Input: python create_venv.py existing_env
Output: Error: Virtual environment 'existing_env' already exists.

Explanation: The script detects that a virtual environment named "existing_env" already exists and prints an error message.

Example 3:

Input: python create_venv.py invalid-env-name
Output: Error: Invalid virtual environment name.  Name must contain only alphanumeric characters and underscores.

Explanation: The script detects an invalid environment name and prints an error message.

Constraints

• The virtual environment name must contain only alphanumeric characters (a-z, A-Z, 0-9) and underscores (_).
• The script must be executable from the command line.
• The script should handle the case where a virtual environment with the specified name already exists.
• The script should exit with a non-zero exit code (e.g., 1) if an error occurs.
• The script should not create the virtual environment outside the current working directory.

Notes

• Consider using the argparse module for parsing command-line arguments.
• The venv module is part of the Python standard library, so no external dependencies are required.
• You can use os.path.exists() to check if a directory already exists.
• Think about how to validate the input environment name to ensure it's a valid directory name. Regular expressions can be helpful for this.
• Remember to handle potential OSError exceptions that might occur during virtual environment creation (e.g., due to permissions issues).