Skip to content

README.md

Latest commit

 

History

History
226 lines (178 loc) · 6.79 KB

README.md

File metadata and controls

226 lines (178 loc) · 6.79 KB

Unix Toolbox Evolution 🧰→🚀

From simple scripts to powerful system tools - A hands-on journey through Unix/Linux system programming and automation, evolving complexity with each project.

License: MIT Bash C Platform

📖 Overview

This repository documents my evolution from writing basic Bash one-liners to developing sophisticated system utilities in C. Each level builds upon previous knowledge, creating a comprehensive toolbox for Unix/Linux system management.

🗺️ Evolution Path

Level 1: Shell Basics

Basic automation and file management

  • Simple file operations
  • System information scripts
  • Basic text processing

Level 2: Scripting Logic

Useful utilities with error handling

  • Backup systems
  • Process monitoring
  • Configuration management

Level 3: C Foundations

System programming introduction

  • File analysis tools
  • Process information
  • Memory usage monitors

Level 4: Integration

Combining Bash and C for efficiency

  • Performance monitors
  • System health dashboards
  • Automated maintenance tools

Level 5: Advanced Toolbox

Production-ready system tools

  • Security scanners
  • Network monitors
  • Custom system utilities

📁 Repository Structure

unix-toolbox-evolution/
│
├── level-1-shell-basics/          # Beginner Bash scripts
│   ├── file-cleaner/             # Simple temp file cleaner
│   ├── system-info/              # Basic system information
│   └── text-processor/           # AWK/SED examples
│
├── level-2-scripting-logic/      # Intermediate utilities
│   ├── backup-manager/           # Automated backup system
│   ├── process-watcher/          # Process monitoring tool
│   └── config-manager/           # Dotfile management
│
├── level-3-c-foundations/        # C system programming
│   ├── file-analyzer/            # File statistics in C
│   ├── memory-monitor/           # RAM usage tool
│   └── process-lister/           # ps-like utility
│
├── level-4-integration/          # Bash + C projects
│   ├── system-dashboard/         # Combined monitoring tool
│   ├── performance-logger/       # System metrics collector
│   └── auto-maintenance/         # Smart cleanup system
│
├── level-5-advanced-toolbox/     # Complex system tools
│   ├── security-scanner/         # File integrity checker
│   ├── network-monitor/          # Connection watcher
│   └── custom-commands/          # Enhanced Unix utilities
│
├── playground/                   # Experiments and tests
├── docs/                         # Learning notes and references
├── README.md
├── templates/                    # Starter templates
└── .evolution-log               # Personal progress tracker

🚀 Getting Started

Quick Start

# Clone the repository
git clone https://github.com/DavFilsDev/unix-toolbox-evolution.git
cd unix-toolbox-evolution

# Start with Level 1
cd level-1-shell-basics/file-cleaner
./cleanmytemp.sh --help

# Or jump to any level
cd level-3-c-foundations/file-analyzer
make && ./analyze /path/to/file

Prerequisites

  • Linux/macOS/WSL (Unix-like environment)
  • Bash 4.0 or higher
  • GCC/Clang for C projects (Level 3+)
  • Basic terminal familiarity

🎓 What I'm Learning

Core Skills

  • ✅ Unix philosophy and tool design
  • ✅ Bash scripting and automation
  • ✅ C system programming
  • ✅ Error handling and robustness
  • ✅ Performance optimization

System Concepts

  • ✅ Filesystem and permissions
  • ✅ Process management
  • ✅ Memory and resource monitoring
  • ✅ Networking basics
  • ✅ Security principles

Development Practices

  • ✅ Git and version control
  • ✅ Documentation writing
  • ✅ Testing and debugging
  • ✅ Code organization
  • ✅ Open source contribution

🛠️ Tool Evolution Examples

Example 1: File Cleaner Evolution

# Level 1: Basic cleaner
find /tmp -type f -mtime +7 -delete

# Level 2: With logging and safety
./cleaner.sh --dry-run --log /var/log/cleanup.log

# Level 3: C version for speed
./fastclean --parallel --exclude "*.important"

# Level 5: Intelligent cleaner
./smartclean --learn --auto --notify

Example 2: System Monitor Evolution

# Level 1: Simple Bash
top -n 1 | grep "Cpu"

# Level 3: C program for efficiency
./cpumon --interval 1 --format json

# Level 4: Integrated dashboard
./sysdash --web --port 8080

# Level 5: Alerting system
./monitor --threshold 80% --alert email --action "scale-services"

📚 Learning Resources

Each level contains:

  • Project README with objectives and learnings
  • Code comments explaining key concepts
  • Challenge exercises to extend functionality
  • Further reading links for deep dives

🎯 How to Use This Repository

For Learners:

  1. Start at Level 1, even if you know basics (reinforces fundamentals)
  2. Complete all projects in a level before moving to next
  3. Modify and extend each project with your own features
  4. Document your learnings in the .evolution-log

For Developers:

  • Use as reference for Unix tool development
  • Copy templates for new projects
  • Study the progression patterns
  • Contribute your own tools or improvements

🔄 Evolution Principles

  1. Start Simple: Minimum viable tool first
  2. Iterate: Add features gradually
  3. Refactor: Improve code quality at each stage
  4. Document: Explain the "why" not just the "how"
  5. Share: Make tools useful for others

🤝 Contributing

This is a personal learning journey, but contributions are welcome! See CONTRIBUTING.md for guidelines.

📝 License

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

🌟 Evolution Status

timeline
    title Toolbox Evolution Timeline
    section Level 1
        Shell Basics     : File operations<br>System info
    section Level 2
        Scripting Logic  : Backup systems<br>Process monitoring
    section Level 3
        C Foundations    : File analysis<br>Memory tools
    section Level 4
        Integration      : Dashboards<br>Maintenance
    section Level 5
        Advanced Tools   : Security<br>Networking
Loading

"The Unix philosophy is to write programs that do one thing and do it well." – This repository is my journey to embody that philosophy through practical, evolving tools.

👨‍💻 Author

David RATIANDRAIBE Cybersecurity & AI-Oriented Engineer (Student) Madagascar 🇲🇬