Metadata-Version: 2.4
Name: python-pidgin
Version: 1.0.0
Summary: An open-source, culturally expressive programming language built as a strict superset of Python.
Author-email: Pygin Creator <author@example.com>
License-Expression: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown

# Pygin

Pygin is an open-source, culturally expressive programming language built as a strict superset of Python. It replaces traditional Python keywords with intuitive, natural Nigerian Pidgin vocabulary (`yarn`, `na`, `check`) while maintaining 100% compatibility with the underlying Python runtime environment.

By prioritizing Python’s native indentation, code styling, and comment structures, Pygin avoids the overhead of foreign syntactic structures, ensuring that learning and writing Pygin feels completely seamless to anyone familiar with Python ecosystems.

## Installation

You can install Pygin locally directly from the source directory using pip:

```bash
pip install -e .
```

This will make the `pygin` command globally available on your machine.

## Usage

Once installed, you can run any Pygin (`.pg`) script by simply passing it to the `pygin` CLI:

```bash
pygin my_script.pg
```

## Syntax Dictionary

Pygin preserves all native Python behaviors. Here are the core keyword mappings:

| Pygin Keyword | Python Equivalent | Purpose / Behavior |
|---|---|---|
| `na` | *(Omitted)* | Optional declarative indicator for readability (e.g. `na x = 5`). |
| `check` | `if` | Opens a conditional branch evaluating a Boolean expression. |
| `unless` | `elif` | Secondary conditional logic branch. |
| `otherwise` | `else` | Fallback execution branch. |
| `small pass` | `<` | Less-than comparison operator. |
| `big pass` | `>` | Greater-than comparison operator. |
| `yarn` | `print` | Native standard output function. |
| `gist` | `def` | Function/Method definition keyword. |
| `give_am` | `return` | Statement to pass data out of a function block. |
| `wuruwuru` | `while` | Indefinite execution loop. |
| `per_person` | `for` | Definite iteration loop. |
| `inside` | `in` | Membership checking operator / structural loop iterator. |
| `real_talk` | `True` | Boolean True. |
| `lie` | `False` | Boolean False. |

## Example Script

```python
# Setup basic parameters
na monthly_pay = 75000
na minimum_wage = 70000

# Logic validation block
check monthly_pay small pass minimum_wage:
    yarn("God dey, things go better!")
otherwise:
    yarn("Oga, do giveaway!")
```
