doglang 1.0.0a0
A dog-themed programming language interpreter
Requires Python: >=3.6

# DogLang Programming Language

# 🐕 Welcome to DogLang!

DogLang is a fun, interpreted programming language I created with syntax inspired by our canine friends. With keywords like `bark` for printing, `wagtail` for loops, and `sniff` for conditionals, it brings a playful approach to coding.

## 🚀 Join the Pack!

This is an open-source hobby project that welcomes contributors of all experience levels. Whether you're a seasoned developer or just starting out:

- Experiment with the language
- Suggest new "dog-themed" features
- Help improve documentation
- Add new functionality
- Fix bugs

The goal is to create something enjoyable while learning about language design and interpretation. Pull requests and issues are very welcome on GitHub!

## Overview

DogLang is a programming language with the following components:
- Lexical analyzer (Tokenizer)
- Syntax analyzer (Parser)
- Semantic analyzer
- Symbol table for variable management
- Interpreter for code execution

## Language Features

- Variable assignments
- Arithmetic operations
- Conditional statements (sniff)
- Loop constructs (wagtail)
- Print statements (bark)
- Input (fetch)
- Comparison operators

## Syntax Guide

### Variables and Assignment
```
a = 10;
```

### Print Statement
```
bark(variable_name);
```

### Loop Statement
```
wagtail(condition) {
  // loop body
}
```

### Conditional Statement
```
sniff(condition) {
  // if true
} else {
  // if false
}
```

### Input Statement
```
a = fetch("Enter a value:");
```

## Examples

### Basic Loop Example
```
a = 0;
wagtail(a<100) { 
  bark(a);
  a = a+10;
}
```
This program initializes a variable `a` to 0, then loops while `a` is less than 100, printing the value of `a` and incrementing it by 10 each iteration.

### Conditional Example
```
a = 10;
sniff(a%2==0) {
  bark("Even");
} else {
  bark("Odd");
}
```
This program checks if variable `a` is even or odd and prints the result.

### Input Example
```
a = fetch("Enter the number");
wagtail(a<10) {
  bark(a);
  a = a+1;
}
```
This program asks the user for a number and then counts from that number up to 10.

## How to Use DogLang

### Installation

#### From GitHub
Clone this repository to your local machine:
```
git clone https://github.com/pallavrai/doglang.git
cd doglang
```

#### From PyPI
Install DogLang directly using pip:
```
pip install doglang
```

### Running a DogLang Program

#### If installed from GitHub:
1. From a file:
   ```
   python doglang.py -f your_program.doggy
   ```

2. Directly from the command line:
   ```
   python doglang.py -e "a=10; bark(a);"
   ```

#### If installed from pip:
1. From a file:
   ```
   doglang -f your_program.doggy
   ```

2. Directly from the command line:
   ```
   doglang -e "a=10; bark(a);"
   ```

### Additional Options
- To view the tokens generated from your code:
  ```
  doglang -f your_program.doggy --tokens
  ```

## File Extensions
DogLang programs use the `.doggy` file extension.

## Language Reference

### Keywords
- `bark`: Print a value
- `wagtail`: Loop construct
- `sniff`: Conditional statement
- `fetch`: Input from user
- `else`: Alternative branch for conditionals

### Operators
- Arithmetic: `+`, `-`, `*`, `/`, `%`
- Comparison: `==`, `!=`, `>`, `<`, `>=`, `<=`
- Assignment: `=`

## Tips for Writing DogLang Programs
1. Each statement should end with a semicolon (optional in some contexts)
2. Blocks of code are enclosed in curly braces `{}`
3. Variables don't need type declarations - they're inferred automatically

## Limitations
- Currently only supports integer and string data types
- No function definitions
- Limited error reporting

## Project Structure
- `Tokenizer.py`: Lexical analyzer
- `SyntaxAnalyser.py`: Parser
- `SemanticAnalyser.py`: Semantic analyzer
- `main.py`: Interpreter implementation
- `SymbolTable.py`: Symbol table for variable management