๐Ÿœ Lem-in: Ant Pathfinding Simulator

Advanced Go programming project showcasing algorithmic optimization, Unix system programming, and real-time ASCII visualization

Go Programming Algorithm Design Unix Pipes Real-time Visualization Git Collaboration

๐ŸŽฎ Live Terminal Demo

Watch how ants navigate through a complex network to find optimal paths:

Terminal โ€” lem-in demo
$ ./lem-in example.txt | ./visualizer
๐ŸŽจ Lem-in ASCII Art Visualizer
โœ… Farm loaded: 8 rooms, 3 ants
Which corresponds to the following representation:
_________________ / \ ____[5]----[3]--[1] | / | / | [6]---[0]----[4] / | \ ________/| / | \ / [2]/________/ [7]_________/
๐Ÿœ TURN 1: L1-3 L2-2
๐Ÿœ TURN 2: L1-4 L2-5 L3-3
๐Ÿœ TURN 3: L1-0 L2-6 L3-4
๐Ÿœ TURN 4: L2-0 L3-0
โœจ All ants have reached their destination!

๐Ÿ› ๏ธ Technical Features

๐Ÿง 

Advanced Algorithms

Implements depth-first search with path optimization to find the most efficient routes for multiple ants simultaneously, avoiding traffic jams and collisions.

๐Ÿ”ง

Unix System Programming

Uses Unix pipes for inter-process communication between the main simulator and visualizer, demonstrating mastery of system-level programming.

๐ŸŽจ

Real-time Visualization

Custom ASCII art engine renders animated visualization of ant movements through the colony, providing an engaging visual representation.

๐Ÿงช

Comprehensive Testing

Includes extensive unit tests, edge case handling, and detailed error reporting with 100% test coverage for reliable operation.

โšก Technology Stack

Go 1.21 Unix Pipes DFS Algorithm ASCII Art Git Collaboration Unit Testing Docker CI/CD

๐ŸŽฏ Skills Demonstrated

  • โœ… Algorithm Design: Complex pathfinding optimization
  • โœ… System Programming: Unix pipes and process communication
  • โœ… Collaborative Development: Git workflow with conflict resolution
  • โœ… Testing & Quality: Comprehensive test coverage
  • โœ… Documentation: Professional technical writing

๐Ÿ“Š Project Impact

โšก

Performance

Optimized algorithm finds shortest path combinations in milliseconds, handling complex networks with multiple routes efficiently.

๐Ÿค

Collaboration

Successfully collaborated using advanced Git workflow, resolved merge conflicts, and implemented bonus features seamlessly.

๐Ÿ†

Quality

Achieved 100% test coverage with comprehensive error handling and professional documentation following Go best practices.

๐Ÿš€

Innovation

Exceeded project requirements with impressive bonus visualization feature, demonstrating initiative and technical creativity.

๐Ÿ”— Links & Resources

Part of my DevOps and Software Development journey โ€ข Mohammad Naveed Iqbal Minhas

โ†‘