Metadata-Version: 2.4
Name: riddz
Version: 1.0.2
Summary: A friendly Hinglish scripting language for the next generation of developers.
Author: Riddhi Dhawan
License: MIT
Project-URL: Homepage, https://pypi.org/project/riddz/
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Dynamic: requires-python

# Riddz - The Hinglish Scripting Language

Riddz is a programming language built for the generation that thinks in Hinglish. It combines a familiar C-style syntax with the natural expressiveness of Hinglish keywords.

## Overview
Riddz is not just a language; it is a bridge. It is designed for developers who want to write logic that reads like a conversation. Whether you are building simple scripts or complex algorithms, Riddz makes the process intuitive.

## Key Features
- High-level Hinglish keywords for logic and control flow.
- Support for complex data structures like Arrays.
- Built-in functions for I/O and timing.
- Friendly error reporting system in Hinglish.
- Lightweight and installable via pip.

## Installation
Use the standard package manager to install Riddz:
```bash
pip install riddz
```

## Quick Start
Create a file named `hello.rdz` and write some code:

```text
// Variables and Input
rakho user_name = pucho("Enter your name: ");
bolo "Welcome to the world of Riddz, " + user_name + "!";

// List Management
rakho my_apps = ["Insta", "WhatsApp", "GitHub"];
dikhao "My daily apps are: " + my_apps;

// Logic Check
agar (user_name == "Riddhi") {
    dikhao "Admin access granted.";
} warna {
    dikhao "Guest login successful.";
}
```

## Solving DSA in Riddz (Fibonacci)
Riddz supports recursion and complex logic. Here is how you solve the Fibonacci sequence:

```text
banao fibonacci(n) {
    agar (n <= 1) {
        wapas n;
    }
    wapas fibonacci(n - 1) + fibonacci(n - 2);
}

rakho limit = 10;
dikhao "Fibonacci Series for first " + limit + " numbers:";

maan i = 0;
jabtak (i < limit) {
    dikhao fibonacci(i);
    i = i + 1;
}
```

## Syntax Reference
| English | Riddz Keyword |
| :--- | :--- |
| Variable | `maan`, `rakho` |
| Output | `dikhao`, `bolo` |
| Input | `pucho` |
| Function | `kaam`, `banao` |
| If / Else | `agar`, `warna` |
| Loop | `jabtak` |
| Return | `wapas` |
| Booleans | `sach`, `sahi`, `galat` |
| Null | `kuch_nahi`, `khali` |

## Contribution
Riddz is an evolving language. We welcome contributions to expand the vocabulary and optimize the engine.

---
Maintained by Riddhi Dhawan.
