dopeshell-cli 0.1.0

A dope shell for hackers

🔥 DopeShell

    ██████╗  ██████╗ ██████╗ ███████╗     ███████╗██╗  ██╗███████╗██╗     ██╗     
    ██╔══██╗██╔═══██╗██╔══██╗██╔════╝     ██╔════╝██║  ██║██╔════╝██║     ██║     
    ██║  ██║██║   ██║██████╔╝█████╗       ███████╗███████║█████╗  ██║     ██║     
    ██║  ██║██║   ██║██╔═══╝ ██╔══╝       ╚════██║██╔══██║██╔══╝  ██║     ██║     
    ██████╔╝╚██████╔╝██║     ███████╗     ███████║██║  ██║███████╗███████╗███████╗
    ╚═════╝  ╚═════╝ ╚═╝     ╚══════╝     ╚══════╝╚═╝  ╚═╝╚══════╝╚══════╝╚══════╝

A minimalistic, cross-platform shell with custom command mapping

---

📖 Introduction

DopeShell is a lightweight, custom shell implementation written in Python that provides essential file system operations with a sleek interface. Built with extensibility in mind, it features a modular component architecture and cross-platform compatibility for both Windows and Linux systems.

✨ Key Features

• 🖥️ Cross-Platform - Works seamlessly on Windows and Linux
• 🏗️ Modular Design - Clean separation with engine/components structure
• 🎨 Custom Commands - Intuitive command names for common operations
• 🔧 Extensible - Easy to add new commands via component system
• ⚡ Lightweight - Minimal dependencies, maximum performance

---

🛠️ Installation

Install via Pip (Recommended)

You can easily install DopeShell using pip:

pip install dopeshell-cli

Manual Installation (For Development)

1. Clone the repository

   git clone https://github.com/muhammadhaseebiqbal-dev/dopeshell.git
   cd dopeshell
   

2. Install dependencies

   pip install .
   

3. Run DopeShell

   dopeshell
   

---

📝 Command List

Basic Commands

Command	Format	Description
sd	sd	List all files and folders in the current directory
fd	fd <path>	Change directory to the specified path (relative or absolute)
wd	wd	Display the current working directory path
whoami	whoami	Display the current user account name
wipe	wipe	Clear the console screen
halt	halt	Exit and terminate the current shell session

File Operations

Command	Format	Description
proc	proc <file>	Read and display file contents
proc	proc -n <file>	Read file with line numbers
proc	proc <file1> <file2> >>> <output>	Concatenate multiple files into one
proc	proc > <file>	Write user input to a file (overwrite)
proc	proc >> <file>	Append user input to a file

File Management

Command	Format	Description
cpy	cpy <source> <destination>	Copy file or directory from source to destination
mov	mov <source> <destination>	Move file or directory from source to destination
rn	rn <old_name> <new_name>	Rename files or folders
snap	snap <path>	Delete files or directories

Network Commands

Command	Format	Description
ping	ping <host>	Test network connectivity to a host
curl	curl <url>	Fetch and display content from a URL
dsp	dsp <url>	Download file from URL (DopeShell Package Manager)

Help

Command	Format	Description
--helpme	--helpme	Display list of all supported commands

---

💡 Usage Examples

# Navigate to a directory
fd Documents

# List files
sd

# Read a file
proc myfile.txt

# Copy a file
cpy file.txt backup/file.txt

# Move a file
mov file.txt documents/file.txt

# Rename a file
rn oldname.txt newname.txt

# Delete a file
snap unwanted.txt

# Check network connectivity
ping google.com

# Download a file
dsp https://example.com/file.zip

---

🤝 Contributing

Want to contribute? Check out our CONTRIBUTING.md for guidelines on how to help improve DopeShell!

---

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

👨‍💻 Author

Muhammad Haseeb Iqbal
GitHub: @muhammadhaseebiqbal-dev