Shell Manager / ឧបករណ៍គ្រប់គ្រង Shell

ឧបករណ៍គ្រប់គ្រង Shell

ឧបករណ៍ដែលបង្កើតឡើងដោយ Python សម្រាប់គ្រប់គ្រង និងដំណើរការ shell scripts ជាមួយនឹងការជ្រើសរើសអន្តរកម្ម និងការគ្រប់គ្រងការអនុញ្ញាតដោយស្វ័យប្រវត្តិ។ ល្អសម្រាប់អ្នកអភិវឌ្ឍន៍ដែលប្រើ shell scripts ញឹកញាប់សម្រាប់កិច្ចការអភិវឌ្ឍន៍ដូចជាការផ្លាស់ប្តូរអ្នកប្រើ Git ការកំណត់ឡើងវិញនូវ IDE និងការគ្រប់គ្រងមូលដ្ឋានទិន្នន័យ។

🚀 មុខងារ

ការជ្រើសរើស Script អន្តរកម្ម: រុករក និងដំណើរការ .sh scripts ពីថត shell_file/ បានយ៉ាងងាយស្រួលដោយប្រើចំណុចប្រទាក់ប៊ូតុងវិទ្យុដែលយល់បាន។
ការគ្រប់គ្រងការអនុញ្ញាតដោយស្វ័យប្រវត្តិ: ស្នើឱ្យធ្វើឱ្យ scripts អាចដំណើរការបានមុនពេលដំណើរការ ធានាការដំណើរការរលូន។
ការរៀបចំការអនុញ្ញាតច្រើន: ឧបករណ៍ម្តងមួយដងដើម្បីធ្វើឱ្យ shell scripts ទាំងអស់អាចដំណើរការបានជាមួយនឹងការបញ្ជាក់ជាក្រុម ឬបុគ្គល។
សុវត្ថិភាព និងអនាមិក: តែងតែស្នើមុនពេលផ្លាស់ប្តូរការអនុញ្ញាត គ្រប់គ្រងកំហុសយ៉ាងរលូនជាមួយនឹងសារកំហុសច្បាស់លាស់។
ការរួមបញ្ចូល uv: ដំណើរការយ៉ាងរលូនជាមួយនឹង uv Python package manager សម្រាប់ការអភិវឌ្ឍន៍ Python ទំនើប។
ការរុករកដោយព្រួញ: ការគាំទ្រ keyboard ពេញលេញជាមួយនឹងព្រួញសម្រាប់ការរុករក និងការជ្រើសរើស។

📁 រចនាសម្ព័ន្ធគម្រោង

sh_manager/
├── main.py                 # ចំណុចចូលកម្មវិធីគោល
├── make_executable.py      # ឧបករណ៍ការអនុញ្ញាតច្រើន
├── pyproject.toml          # ការកំណត់រចនាសម្ព័ន្ធ និងការពឹងផ្អែកគម្រោង
├── uv.lock                 # ឯកសារ lock សម្រាប់ uv package manager
├── data/
│   └── git_user_configs.json  # ការកំណត់រចនាសម្ព័ន្ធអ្នកប្រើ Git
└── shell_file/
    ├── switch_git_user.sh      # ឧបករណ៍ផ្លាស់ប្តូរអ្នកប្រើ Git
    ├── reset_intellijidea.sh   # Script កំណត់ឡើងវិញនូវ IntelliJ IDEA
    └── reset_navicate.sh       # Script កំណត់ឡើងវិញនូវ Navicat database

🛠️ ការដំឡើង

តម្រូវការមុន

macOS តែប៉ុណ្ណោះ: ឧបករណ៍នេះត្រូវបានរចនាឡើងសម្រាប់ macOS តែប៉ុណ្ណោះ
Python 3.11.11 ឬខ្ពស់ជាង
uv package manager (ណែនាំ)

ការរៀបចំ

Clone ឬទាញយក repository នេះ
ចូលទៅកាន់ថតគម្រោង
ដំឡើងការពឹងផ្អែកដោយប្រើ uv:
```
uv sync
```

🚀 ការប្រើប្រាស់

ការដំណើរការកម្មវិធីគោល

ចាប់ផ្តើមឧបករណ៍គ្រប់គ្រង shell script អន្តរកម្ម:

# ប្រើ uv
uv run main.py

ការរៀបចំការអនុញ្ញាតច្រើន

ធ្វើឱ្យ shell scripts ទាំងអស់អាចដំណើរការបានក្នុងម្តង:

# ប្រើ uv
uv run make_executable.py

# ឬដំឡើង និងដំណើរការជា script
uv run make-executable

📋 Scripts ដែលមាន

1. `switch_git_user.sh`

ផ្លាស់ប្តូររវាងការកំណត់រចនាសម្ព័ន្ធអ្នកប្រើ Git ផ្សេងៗគ្នាដែលកំណត់ក្នុង data/git_user_configs.json។

ការកំណត់រចនាសម្ព័ន្ធបច្ចុប្បន្ន:

@username (username@example.com)
@username2 (username2@example.com)

2. `reset_intellijidea.sh`

កំណត់ឡើងវិញនូវការកំណត់ និង cache របស់ IntelliJ IDEA។ មានប្រយោជន៍សម្រាប់ដោះស្រាយបញ្ហា IDE។

3. `reset_navicate.sh`

កំណត់ឡើងវិញនូវការកំណត់ការតភ្ជាប់មូលដ្ឋានទិន្នន័យ Navicat និង cache។

🖥️ កម្មវិធីដែលអាចកំណត់ឡើងវិញបាន

JetBrains IDE Suite

ឧបករណ៍ reset_intellijidea.sh អាចកំណត់ឡើងវិញបានគ្រប់កម្មវិធី JetBrains ដូចជា:

IntelliJ IDEA - Java IDE

Database Management Tools

ឧបករណ៍ reset_navicate.sh អាចកំណត់ឡើងវិញបាន:

Navicat Premium (ជំនាន់ 15, 16, 17) - ឧបករណ៍គ្រប់គ្រងមូលដ្ឋានទិន្នន័យ

ការកំណត់ឡើងវិញរួមបញ្ចូល:

ការកំណត់រចនាសម្ព័ន្ធ និង cache
ការលុបពេលវេលាសាកល្បង
ការកំណត់ឡើងវិញនូវការកំណត់អ្នកប្រើប្រាស់
ការលុបឯកសារ preferences និង plist

🎮 ចំណុចប្រទាក់អន្តរកម្ម

កម្មវិធីផ្តល់ចំណុចប្រទាក់ប៊ូតុងវិទ្យុដែលយល់បាន:

ព្រួញ ↑/↓: រុករករវាង scripts
ព្រួញ →: ជ្រើសរើស script (ការជ្រើសរើសប៊ូតុងវិទ្យុ)
Enter: ដំណើរការ script ដែលបានជ្រើសរើស
q: ចាកចេញពីកម្មវិធី

ឧទាហរណ៍ចំណុចប្រទាក់:

ប្រើ ↑/↓ ដើម្បីផ្លាស់ទី, → ដើម្បីជ្រើសរើស, Enter ដើម្បីដំណើរការ, q ដើម្បីចាកចេញ។

> [x] switch_git_user.sh
  [ ] reset_intellijidea.sh
  [ ] reset_navicate.sh

រុករកដោយព្រួញ។ ជ្រើសរើសដោយ →, ដំណើរការដោយ Enter, ចាកចេញដោយ q។

🔧 ការកំណត់រចនាសម្ព័ន្ធ

ការកំណត់រចនាសម្ព័ន្ធអ្នកប្រើ Git

កែសម្រួល data/git_user_configs.json ដើម្បីបន្ថែម ឬកែប្រែ profile អ្នកប្រើ Git:

ចំណាំ: ប្រសិនបើឯកសារ git_user_configs.json មិនមានទេ សូមចម្លងពី data/git_user_configs_example.json ទៅ data/git_user_configs.json និងកែសម្រួលតាមតម្រូវការរបស់អ្នក។

[
  {
    "name": "ឈ្មោះរបស់អ្នក",
    "email": "email.របស់អ្នក@example.com"
  }
]

ការបន្ថែម Scripts ថ្មី

ដាក់ .sh script របស់អ្នកក្នុងថត shell_file/
ត្រូវប្រាកដថា script មាន shebang ត្រឹមត្រូវ (#!/bin/bash) និងការអនុញ្ញាត
Script នឹងបង្ហាញដោយស្វ័យប្រវត្តិក្នុងចំណុចប្រទាក់ជ្រើសរើស

🛡️ មុខងារសុវត្ថិភាព

ការបញ្ជាក់ការអនុញ្ញាត: តែងតែស្នើមុនពេលធ្វើឱ្យឯកសារអាចដំណើរការបាន
ការគ្រប់គ្រងកំហុស: ការគ្រប់គ្រងកំហុសយ៉ាងរលូនជាមួយនឹងសារកំហុសច្បាស់លាស់
ការដំណើរការមានសុវត្ថិភាព: Scripts ដំណើរការក្នុងបរិស្ថានដែលគ្រប់គ្រងបាន
ការផ្ទៀងផ្ទាត់ការបញ្ចូល: ការផ្ទៀងផ្ទាត់ត្រឹមត្រូវនូវការបញ្ចូលរបស់អ្នកប្រើ

🔧 ការអភិវឌ្ឍន៍

ការរៀបចំគម្រោង

# ដំឡើងការពឹងផ្អែកអភិវឌ្ឍន៍
uv sync

# ដំណើរការកម្មវិធីគោល
uv run main.py

# ដំណើរការឧបករណ៍ការអនុញ្ញាត
uv run make_executable.py

ការពឹងផ្អែក

Python 3.11.11+: មុខងារ និងដំណើរការ Python ទំនើប
Standard Library តែប៉ុណ្ណោះ: មិនត្រូវការការពឹងផ្អែកខាងក្រៅ
uv: ការគ្រប់គ្រង package Python ទំនើប

📝 អាជ្ញាប័ណ្ណ

គម្រោងនេះគឺជា open source និងមានជាមួយអាជ្ញាប័ណ្ណ MIT។

🤝 ការរួមចំណែក

Fork repository
បង្កើត feature branch
ធ្វើការផ្លាស់ប្តូររបស់អ្នក
ធ្វើតេស្តយ៉ាងហ្មត់ចត់
ដាក់ស្នើ pull request

🐛 ការដោះស្រាយបញ្ហា

បញ្ហាទូទៅ

Script មិនអាចដំណើរការបាន:

ដំណើរការ uv run make-executable ដើម្បីរៀបចំការអនុញ្ញាត
ឬដំណើរការដោយដៃ chmod +x shell_file/your_script.sh

ការអនុញ្ញាតត្រូវបានបដិសេធ:

ត្រូវប្រាកដថាអ្នកមានការអនុញ្ញាតសរសេរទៅថត shell_file/
ពិនិត្យមើលថា script files មិនមែនជា read-only

Script មិនត្រូវបានរកឃើញ:

ផ្ទៀងផ្ទាត់ថា script មាននៅក្នុងថត shell_file/
ពិនិត្យមើលថា file មាន extension .sh

📞 ការគាំទ្រ

សម្រាប់បញ្ហា សំណួរ ឬការរួមចំណែក សូមបើក issue នៅលើ repository គម្រោង។

Shell Manager

A Python-based tool for managing and running shell scripts with interactive selection and automatic permission handling. Perfect for developers who frequently use shell scripts for development tasks like Git user switching, IDE resets, and database management.

🚀 Features

Interactive Script Selection: Easily browse and run .sh scripts from the shell_file/ directory using an intuitive radio-button interface.
Automatic Permission Handling: Prompts to make scripts executable before running, ensuring smooth execution.
Bulk Permission Setup: One-time utility to make all shell scripts executable with batch or individual confirmation.
Safe & Secure: Always asks before changing permissions; handles errors gracefully with proper error messages.
uv Integration: Works seamlessly with the uv Python package manager for modern Python development.
Arrow Key Navigation: Full keyboard support with arrow keys for navigation and selection.

📁 Project Structure

sh_manager/
├── main.py                 # Main application entry point
├── make_executable.py      # Bulk permission utility
├── pyproject.toml          # Project configuration and dependencies
├── uv.lock                 # Lock file for uv package manager
├── data/
│   └── git_user_configs.json  # Git user configurations
└── shell_file/
    ├── switch_git_user.sh      # Git user switching utility
    ├── reset_intellijidea.sh   # IntelliJ IDEA reset script
    └── reset_navicate.sh       # Navicat database reset script

🛠️ Installation

Prerequisites

macOS Only: This tool is designed specifically for macOS
Python 3.11.11 or higher
uv package manager (recommended)

Setup

Clone or download this repository
Navigate to the project directory
Install dependencies using uv:
```
uv sync
```

🚀 Usage

Running the Main Application

Start the interactive shell script manager:

# Using uv
uv run main.py

# Or install and run as a script
uv run sh-manager

Bulk Permission Setup

Make all shell scripts executable at once:

# Using uv
uv run make_executable.py

# Or install and run as a script
uv run make-executable

📋 Available Scripts

1. `switch_git_user.sh`

Switches between different Git user configurations defined in data/git_user_configs.json.

Current configurations:

@username (username@example.com)
@username2 (username2@example.com)

2. `reset_intellijidea.sh`

Resets IntelliJ IDEA settings and caches. Useful for resolving IDE issues.

3. `reset_navicate.sh`

Resets Navicat database connection settings and caches.

🖥️ Applications That Can Be Reset

JetBrains IDE Suite

The reset_intellijidea.sh tool can reset all JetBrains applications including:

IntelliJ IDEA - Java IDE

Database Management Tools

The reset_navicate.sh tool can reset:

Navicat Premium (Versions 15, 16, 17) - Database management tool

Reset Includes:

Settings and cache reset
Trial period reset
User configuration reset
Preferences and plist file cleanup

🎮 Interactive Interface

The application provides an intuitive radio-button interface:

↑/↓ Arrow Keys: Navigate between scripts
→ Arrow Key: Select a script (radio button selection)
Enter: Run the selected script
q: Quit the application

Example interface:

Use ↑/↓ to move, → to select, Enter to run, q to quit.

> [x] switch_git_user.sh
  [ ] reset_intellijidea.sh
  [ ] reset_navicate.sh

Navigate with arrow keys. Select with →, run with Enter, quit with q.

🔧 Configuration

Git User Configurations

Edit data/git_user_configs.json to add or modify Git user profiles:

Note: If the git_user_configs.json file doesn't exist, copy from data/git_user_configs_example.json to data/git_user_configs.json and modify according to your needs.

[
  {
    "name": "Your Name",
    "email": "your.email@example.com"
  }
]

Adding New Scripts

Place your .sh script in the shell_file/ directory
Make sure the script has proper shebang (#!/bin/bash) and permissions
The script will automatically appear in the selection interface

🛡️ Security Features

Permission Confirmation: Always asks before making files executable
Error Handling: Graceful error handling with informative messages
Safe Execution: Scripts run in a controlled environment
Input Validation: Proper validation of user inputs

🔧 Development

Project Setup

# Install development dependencies
uv sync

# Run the main application
uv run main.py

# Run the permission utility
uv run make_executable.py

Dependencies

Python 3.11.11+: Modern Python features and performance
Standard Library Only: No external dependencies required
uv: Modern Python package management

📝 License

This project is open source and available under the MIT License.

🤝 Contributing

Fork the repository
Create a feature branch
Make your changes
Test thoroughly
Submit a pull request

🐛 Troubleshooting

Common Issues

Script not executable:

Run uv run make-executable to set up permissions
Or manually run chmod +x shell_file/your_script.sh

Permission denied:

Ensure you have write permissions to the shell_file/ directory
Check that the script files are not read-only

Script not found:

Verify the script exists in the shell_file/ directory
Check that the file has a .sh extension

📞 Support

For issues, questions, or contributions, please open an issue on the project repository.

Name		Name	Last commit message	Last commit date
Latest commit History 4 Commits
data		data
shell_file		shell_file
.DS_Store		.DS_Store
.gitignore		.gitignore
.python-version		.python-version
LICENSE		LICENSE
README.md		README.md
main.py		main.py
make_executable.py		make_executable.py
pyproject.toml		pyproject.toml
uv.lock		uv.lock

Folders and files

Latest commit

History

Repository files navigation

Shell Manager / ឧបករណ៍គ្រប់គ្រង Shell

ឧបករណ៍គ្រប់គ្រង Shell

🚀 មុខងារ

📁 រចនាសម្ព័ន្ធគម្រោង

🛠️ ការដំឡើង

តម្រូវការមុន

ការរៀបចំ

🚀 ការប្រើប្រាស់

ការដំណើរការកម្មវិធីគោល

ការរៀបចំការអនុញ្ញាតច្រើន

📋 Scripts ដែលមាន

1. switch_git_user.sh

2. reset_intellijidea.sh

3. reset_navicate.sh

🖥️ កម្មវិធីដែលអាចកំណត់ឡើងវិញបាន

JetBrains IDE Suite

Database Management Tools

ការកំណត់ឡើងវិញរួមបញ្ចូល:

🎮 ចំណុចប្រទាក់អន្តរកម្ម

🔧 ការកំណត់រចនាសម្ព័ន្ធ

ការកំណត់រចនាសម្ព័ន្ធអ្នកប្រើ Git

ការបន្ថែម Scripts ថ្មី

🛡️ មុខងារសុវត្ថិភាព

🔧 ការអភិវឌ្ឍន៍

ការរៀបចំគម្រោង

ការពឹងផ្អែក

📝 អាជ្ញាប័ណ្ណ

🤝 ការរួមចំណែក

🐛 ការដោះស្រាយបញ្ហា

បញ្ហាទូទៅ

📞 ការគាំទ្រ

Shell Manager

🚀 Features

📁 Project Structure

🛠️ Installation

Prerequisites

Setup

🚀 Usage

Running the Main Application

Bulk Permission Setup

📋 Available Scripts

1. switch_git_user.sh

2. reset_intellijidea.sh

3. reset_navicate.sh

🖥️ Applications That Can Be Reset

JetBrains IDE Suite

Database Management Tools

Reset Includes:

🎮 Interactive Interface

🔧 Configuration

Git User Configurations

Adding New Scripts

🛡️ Security Features

🔧 Development

Project Setup

Dependencies

📝 License

🤝 Contributing

🐛 Troubleshooting

Common Issues

📞 Support

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

1. `switch_git_user.sh`

2. `reset_intellijidea.sh`

3. `reset_navicate.sh`

1. `switch_git_user.sh`

2. `reset_intellijidea.sh`

3. `reset_navicate.sh`

Packages