# **💎 Silicon.py (v1.0.2 BETA)**

**Silicon** is a custom-built, high-logic programming language designed for structured data manipulation and iterative logic. Built with the "Industrial Library" philosophy, Silicon separates data into distinct namespaces (vars, arrs, funcs) to ensure maximum memory clarity and zero variable shadowing.

# Introducing silicord. The newest way to easily build Discord bots.
**Silicord** is currently in a huge Work In Progress, but we've released v1.0.0 BETA to recieve feedback.

## **🚀 Installation**

Silicon is available on PyPI. Install it globally or in your virtual environment:

`pip install silicon.py`

## **🛠 Usage**

Silicon uses the `.sil` extension. Once installed, you can execute your scripts using the sili command:

`sili your\_script.sil`

## **🏗 Language Syntax**

Silicon introduces a unique **Action-Library** syntax. To modify data, you must call the action through the appropriate library.

### **1\. Variables and Arrays**

Definitions and assignments are distinct steps. This ensures intentional memory allocation.

\~\~ Define your data \~\~  
```
define(type:Var \= playerName)  
define(type:Arr \= inventory)
```

\~\~ Set values using the Library:Action syntax \~\~  
```
vars.playerName:Set("Architect")  
arrs.inventory:Set("Hammer", "Shield", "Silicon Core")
```

### **2\. The `cond()` Logic (v0.2.2+)**

Silicon v0.2.2 replaced the traditional if with the unified `cond()` system. It supports single-pass conditions (`if`) and loops (`during`).

**Supported Logic Operators:**

* `alt;` (OR)  
* `also;` (AND)  
* `not;` (NOT)

```
cond(during vars.health \> 0):  
    log(console, "Character is alive...")  
      
    cond(if vars.energy \< 10 also; vars.hasPotion \== true):  
        log(console, "Energy low\! Drinking potion...")  
    :end  
:end
```

## **📑 Roadmap**

* \[x\] **v0.2.2**: Unified cond() logic and semantic operators (alt;, also;).  
* \[x\] **v0.2.3**: Official rebranding to **Silicon**, .sil extension, and sili CLI.
* \[x\] **v0.2.4**: Added `README.md` for better guides of use.
* \[x\] **v0.2.5**: Updated `README.md` for better guides of use.
* \[x\] **v0.2.6**: Updated console logging to [SILICON].
* \[x\] **v0.2.7**: Allowed usage of `sili --version`.
* \[x\] **v1.0.0**: [BETA] Introduced silicord Discord bot builder with new Integrations `intes` library. Because silicord is W.I.P., expect a lot of bugs and crashes. **We recommend you do not upgrade until a full, stable version of silicon.py v1.0.0 and silicord is released.**
* \[x\] **v1.0.1** [BETA] fixed Bot not starting due to immediate shut down.
* \[x\] **v1.0.2** [BETA] fixed Bot not stopping due to not force exit.
* \[x\] **v1.1.0** [BETA] Improved `:Send()` and `Reply()` logic. Also added `:GetAuthor:GetName()` logic.