๐Ÿ’• CoupleScript

The world's most romantic programming language - where every program is a love story!

What is CoupleScript?

CoupleScript is a fun, relationship-themed programming language that uses marriage and love metaphors to make programming more enjoyable and relatable. Built completely from scratch with no dependencies on existing languages!

# Your first love story in code! ๐Ÿ’• marry husband "Alex" marry wife "Emma" remember "Meet our lovely couple: " + husband + " and " + wife argue love: remember "They lived happily ever after! ๐ŸŽ‰" anniversary year in couple[1, 2, 3, 4, 5]: remember "Year " + year + ": Still in love! ๐Ÿ’–" makeup: remember "Every relationship has its challenges... ๐Ÿ’ช"

Why Fall in Love with CoupleScript?

๐Ÿ’

Completely Independent

No Python, C, or JavaScript dependencies. Built from scratch with pure assembly language.

๐ŸŽญ

Romantic Keywords

marry, propose, accept, argue, makeup, remember - programming with the language of love.

๐Ÿ”ง

Self-Hosting

The compiler is written in CoupleScript itself! A true testament to the language's power.

โšก

Lightning Fast

Assembly-based virtual machine ensures your love stories run at the speed of light.

๐ŸŒ

Cross-Platform

Works on Windows, Linux, macOS, and Docker. Love knows no boundaries!

๐Ÿณ

Docker Ready

Run anywhere with Docker support. No dependencies, perfect for education and demos!

๐Ÿงช

Comprehensive Testing

Production-grade test suite with CI/CD pipeline ensures reliability and quality.

๐Ÿ“š

Educational

Learn programming through romantic metaphors that make concepts memorable and fun.

Language Features

๐Ÿ’• Keywords & Concepts

  • marry - Variable declaration/assignment
  • divorce - Variable deletion
  • propose - Function definition
  • accept - Function call
  • argue - Conditional statements (if)
  • makeup - Else clause
  • remember - Print/output
  • anniversary - Loop construct

๐Ÿ’– Data Types

  • love - Boolean true
  • hate - Boolean false
  • heart - Numbers
  • words - Strings
  • couple - Arrays/Lists
  • memory - Objects/Dictionaries

See Love in Action

Hello World
marry message "Hello, World!" remember message
Hello, World!
Functions
propose greet(name): remember "Hello, " + name + "!" accept greet("Alice")
Hello, Alice!
Conditionals
marry age 25 argue age > 18: remember "Adult" makeup: remember "Minor"
Adult
Loops
marry favorites couple["Pizza", "Movies", "Travel"] anniversary item in favorites: remember "๐Ÿ’ " + item
๐Ÿ’ Pizza ๐Ÿ’ Movies ๐Ÿ’ Travel

Start Your Love Story

๐Ÿณ Easiest Way: Docker (No Installation!)

Run CoupleScript instantly without installing anything!

docker build -t couplescript https://github.com/rahul05ranjan/couple-script.git docker run -it --rm couplescript
๐Ÿ“– Docker Guide Perfect for education, testing, and quick demos!
1

Clone the Repository

git clone https://github.com/rahul05ranjan/couple-script.git cd couple-script
2

Install Prerequisites

Windows: NASM + Visual Studio Build Tools or WSL

Linux: sudo apt install build-essential nasm

macOS: xcode-select --install

3

Build CoupleScript

make all
4

Test Your Installation

# Run comprehensive tests make test # Windows users run_tests.bat
5

Start Coding Love!

# Windows couplescript.bat examples/hello.couple # Linux/macOS ./couplescript examples/hello.couple

CoupleScript by the Numbers

100%
Independent
28
Tests Passing
20+
Romantic Keywords
3
Platforms Supported
โˆž
Love Level

Join the Romance

CoupleScript is all about spreading love through code. Join our community of romantic programmers!

CI/CD Pipeline Active - 28 automated tests ensure code quality and reliability