Skip to content

GITHUB-RELEASE-TEMPLATE.md

Latest commit

 

History

History
165 lines (124 loc) · 4.51 KB

GITHUB-RELEASE-TEMPLATE.md

File metadata and controls

165 lines (124 loc) · 4.51 KB
Raw

Yeep Programming Language v2.0.2 🎉

Patch Release: Complete System-Wide Installation

Yeep v2.0.2 is the complete, production-ready version featuring professional system-wide installation capabilities, colorized REPL, and comprehensive documentation. This patch release ensures version consistency across all components.

🚀 Key Features

✨ System-Wide Installation

  • Windows: Smart admin/user detection with automatic PATH management
  • Linux/macOS: Standard Unix installation with shell integration
  • One-Command Install: Simple install.bat or sudo ./install.sh
  • Clean Uninstall: Automatic uninstaller generation

🎨 Professional REPL

  • Colorized Output: Beautiful ANSI colors and formatting
  • Built-in Commands: help, version, clear, examples
  • Smart Features: Auto-semicolon, error recovery, cross-platform

📦 Complete Package

  • Ready-to-Use: Pre-built executable v2.0.2 included
  • Full Documentation: Installation guides, language spec, examples
  • VSCode Extension: Professional syntax highlighting
  • 29+ Examples: Sample programs to get started

📥 Installation

Quick Install

Windows:

# Extract ZIP file, then run as Administrator:
install.bat

Linux/macOS:

# Extract archive, then:
sudo ./install.sh    # System-wide
# OR
./install.sh         # User-only

Verification

yeep --version       # Should show v2.0.2
yeep --help         # Show usage information
yeep                # Start interactive REPL

📋 What's Included

  • ✅ yeep.exe - Main executable (v2.0.2)
  • ✅ install.bat/install.sh - Cross-platform installers
  • ✅ Complete documentation - README, installation guide, language spec
  • ✅ 29+ example programs - Learn by example
  • ✅ Source code - Full C++17 implementation
  • ✅ VSCode extension - Professional development environment
  • ✅ Build scripts - Compile from source
  • ✅ Test utilities - Installation testing tools

🆕 New in v2.0.2

Version Consistency

  • All version strings correctly show v2.0.2
  • Executable, documentation, and package all aligned
  • Professional semantic versioning

System Integration

  • System-wide installation with PATH management
  • Professional installer/uninstaller scripts
  • Cross-platform compatibility (Windows, Linux, macOS)
  • Smart privilege detection and fallback

User Experience

  • Colorized REPL with built-in commands
  • Professional welcome screen and help system
  • Enhanced error handling and recovery
  • Consistent cross-platform behavior

Developer Experience

  • Clean, modern C++17 codebase
  • Streamlined build system
  • Comprehensive documentation
  • Professional VSCode extension

🔧 Technical Details

  • Languages: C++17
  • Platforms: Windows 10+, Linux, macOS 10.14+
  • Dependencies: GCC 7.0+ or Clang 5.0+
  • Package Size: ~390KB
  • Memory Usage: <5MB typical

🐛 Fixes in v2.0.2

  • ✅ Version consistency across all components
  • ✅ Proper semantic versioning (patch release)
  • ✅ Package integrity verification
  • ✅ Build system improvements

📖 Documentation

  • README.md - Main documentation
  • INSTALLATION.md - Complete installation guide
  • QUICK-START.md - Get started in 5 minutes
  • LANGUAGE_SPEC.md - Language reference
  • USER_GUIDE.md - Usage guide with examples

🔄 Upgrading

From any previous version:

  1. Uninstall old version (if any)
  2. Download and extract v2.0.2
  3. Run installer
  4. Restart terminal/command prompt
  5. Verify: yeep --version should show 2.0.2

💡 Usage Examples

# Interactive REPL
yeep

# Run a script
yeep examples/hello_working.yeep

# Try the calculator example
yeep examples/calculator_example.yeep

# Explore built-in help
yeep
> help
> examples
> version

🔮 Coming Next

  • Package manager integration (Chocolatey, Homebrew)
  • Language server protocol support
  • Enhanced built-in functions
  • Performance optimizations
  • IDE integrations

📥 Downloads

Platform File Size SHA256
Windows x64 yeep-v2.0.2-windows-x64.zip 390KB See .sha256 file

System Requirements:

  • Windows 10+ with MinGW-w64 or MSYS2
  • Linux with GCC 7.0+ or Clang 5.0+
  • macOS 10.14+ with Xcode Command Line Tools

Installation: Extract and run install.bat (Windows) or sudo ./install.sh (Linux/macOS)

🎉 Ready to code with Yeep v2.0.2!

For issues, questions, or contributions, please visit the GitHub repository.