cmosskillav2 0.2.3

Python Terminal Emulator with Enhanced Developer Utilities

CMosSkillAV2 Terminal Emulator

A Python package that provides an enhanced terminal emulator with built-in file operations, Python execution, and developer utilities.

Features

• File Operations: Built-in commands for managing files and directories (cd, ls, mkdir, touch, rm, cat)
• Python Execution: Run Python scripts or execute Python code directly in the terminal
• Package Management: Manage Python packages with built-in pip integration
• Syntax Highlighting: Color-coded output for better readability
• Tab Completion: Command and path completion with Tab key
• Command History: Navigate through previously entered commands

Installation

pip install cmosskillav2

Usage

After installation, you can start the terminal emulator with:

cmosskillav2

Or you can run it as a module:

python -m cmosskillav2

Auto-Launch Features

CMosSkillAV2 version 0.2.2 introduces powerful and reliable auto-launch capabilities:

1. Auto-Import Launch

When imported in interactive Python sessions, the terminal automatically launches:

# In an interactive Python session
import cmosskillav2  # The terminal will automatically launch

You can disable this behavior by setting:

export CMOSSKILLAV2_AUTO_LAUNCH=0

2. Auto-Console Launch

After installation, CMosSkillAV2 automatically activates whenever you start a new Python console/REPL without having to explicitly import it. This makes it instantly available in any Python interactive session.

This works in:

• Standard Python REPL (python without arguments)
• Interactive Python sessions (python -i script.py)
• IPython and Jupyter environments
• Any Python environment with PYTHONINSPECT set

You can disable the auto-console feature by setting:

export CMOSSKILLAV2_AUTO_CONSOLE=0

Both auto-launch features are especially useful for enhancing Python REPL environments, IPython, and Jupyter notebooks with terminal capabilities.

How Auto-Console Works

The package uses a dual approach for maximum reliability:

1. sitecustomize.py: Installed in the site-packages directory, this module is automatically imported when Python starts. It detects interactive mode and can trigger the terminal.

2. .pth file mechanism: A special .pth file with embedded Python code that executes when Python starts, providing a secondary activation method.

The system intelligently examines the Python environment to determine if it's appropriate to launch the terminal, avoiding activation during package installation, testing, or when running scripts non-interactively.

Advanced Configuration Options

CMosSkillAV2 provides several environment variables to control its behavior:

# Disable automatic launch when importing the package
export CMOSSKILLAV2_AUTO_LAUNCH=0

# Disable automatic launch in Python console
export CMOSSKILLAV2_AUTO_CONSOLE=0

# Enable debug output for tracing activation logic
export CMOSSKILLAV2_DEBUG=1

# Force terminal launch even in non-interactive mode (for testing)
export CMOSSKILLAV2_FORCE_LAUNCH=1

Debugging Auto-Launch Features

You can enable debugging output for the auto-launch functionality by setting:

export CMOSSKILLAV2_DEBUG=1

This will display detailed information about the Python environment and the decision-making process for auto-launching the terminal.

Demo Scripts

The package includes demo scripts that show how the auto-launch features work:

# Display auto-launch capabilities and configuration options
python demo_autolaunch.py

# Test interactive mode (terminal should launch after script completes)
python -i demo_autolaunch.py

# Test auto-launch detection and troubleshooting
python test_auto_console.py

# Test with debug output
CMOSSKILLAV2_DEBUG=1 python -i test_auto_console.py

Available Commands

File Operations

• cd [directory] - Change directory
• ls [directory] - List directory contents
• mkdir [-p] directory - Create directory
• touch file [file2 ...] - Create empty file(s)
• rm [-r] file_or_directory - Remove file(s) or directory
• cat file [file2 ...] - Display file contents

Python Execution

• python script.py [args] - Execute Python script file
• >>> [python_code] - Execute Python code inline
• pyshell - Start interactive Python shell

Package Management

• pip install package - Install Python package
• pip uninstall package - Uninstall Python package
• pip list - List installed packages
• pip freeze - Output installed packages in requirements format

Shell Built-ins

• help [command] - Display help for commands
• exit or quit - Exit the shell
• clear - Clear the terminal screen

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.