Metadata-Version: 2.4
Name: cyanox-lang
Version: 0.1.0
Summary: Cyanox - A simple and elegant programming language
Home-page: https://github.com/yourusername/cyanox
Author: Cyan Code
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pyttsx3
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Cyanox Programming Language

Cyanox is a simple and elegant programming language designed for education and community learning.

## Features

- **Simple Syntax**: Easy to learn for beginners
- **Voice Output**: Built-in `speak()` function for audio feedback
- **Variable Support**: Dynamic typing with optional type hints
- **Functions**: Define and call custom functions
- **Conditionals**: If/elif/else statements with intuitive syntax
- **Syntax Highlighting**: Full VS Code integration with custom theme

## Installation

### Prerequisites

- Python 3.6+
- VS Code (for syntax highlighting)

### Install from PyPI

```bash
pip install cyanox-lang
```

### Install VS Code Extension

Search for "Cyanox Syntax" in VS Code Extensions marketplace, or install from:
- [VS Code Marketplace](https://marketplace.visualstudio.com)

## Quick Start

### 1. Create a Cyanox file

Create a file named `hello.cn`:

```cyanox
write("Hello, Cyanox!")
speak("Hello from Cyan Code")
```

### 2. Run the file

```bash
cyanox hello.cn
```

## Language Guide

### Variables

```cyanox
let name = "Alice"
let int age = 25
let message = "I am learning Cyanox"
```

### Output

```cyanox
write("Hello, World!")
write(42)
```

### Audio Output

```cyanox
speak("This is spoken text")
```

### Input

```cyanox
input("Enter your name: ")
```

### Functions

```cyanox
def greet(name) = write("Hello, " + name)
greet("Alice")
```

### Conditionals

```cyanox
if age > 18 then write("Adult")
elif age > 13 then write("Teenager")
else write("Child")
```

### Operators

- Arithmetic: `+`, `-`, `*`, `/`, `//`, `%`, `**`
- Comparison: `==`, `!=`, `<`, `<=`, `>`, `>=`
- Logical: `and`, `or`, `not`

### Comments

```cyanox
# This is a comment
write("Code continues")
```

## Examples

### Example 1: Simple Program

```cyanox
let greeting = "Welcome to Cyanox"
write(greeting)
speak(greeting)
```

### Example 2: Variables and Math

```cyanox
let int a = 10
let int b = 20
let int sum = a + b
write("Sum: " + sum)
```

### Example 3: Functions

```cyanox
def add(x, y) = x + y
let result = add(5, 3)
write("5 + 3 = " + result)
```

### Example 4: Conditionals

```cyanox
let int score = 85
if score >= 90 then write("Grade: A")
elif score >= 80 then write("Grade: B")
elif score >= 70 then write("Grade: C")
else write("Grade: F")
```

## VS Code Integration

After installing both the PyPI package and the VS Code extension:

1. Open any `.cn` file in VS Code
2. Click the "Run" button in the top right, or press `Ctrl+Shift+R`
3. Output appears in the integrated terminal

## Project Structure

```
cyanox-lang/
├── cyanox/
│   ├── __init__.py
│   ├── cli.py           # Command-line interface
│   └── interpretor.py   # Language interpreter
├── setup.py
└── README.md
```

## Contributing

Contributions are welcome! Here are some ways you can help:

- Report bugs and issues
- Suggest new features
- Improve documentation
- Add examples
- Contribute code improvements

## Community

Join our community to share ideas, ask questions, and discuss Cyanox:

- GitHub Issues: Report bugs and suggest features
- Discussions: Share ideas and ask questions

## License

This project is licensed under the MIT License - see the LICENSE file for details.

## Changelog

### Version 0.1.0 (Initial Release)

- Basic language features: variables, functions, conditionals
- Built-in functions: `write()`, `input()`, `speak()`
- VS Code extension with syntax highlighting
- PyPI package for CLI usage

## Support

For issues, questions, or suggestions:

1. Check existing GitHub issues
2. Open a new issue with detailed information
3. Include example code that demonstrates the problem

---

Happy coding with Cyanox! 🎉
