femcode/DEVELOPMENT_LOG.md

# Femcode Development Log

This log details the features implemented and significant changes made to the Femcode programming language.

## Project Context and Structure

This project, `femboy-coding-language`, is located at the root directory `/home/k1tty/dev/gemini-cli/femboy-coding-language`.

-   `femboy-terminoligy.txt`: A text file containing the custom keywords and their meanings used in Femcode.
-   `femcode/`: This is the main project directory for the Femcode interpreter.
    -   `femcode/femterpreter`: A shell script located in the `femcode/` directory that acts as a wrapper to run compiled Femcode programs. It executes the compiled Linux executable (`femcode/dist/femcode_linux`).
    -   `femcode/src/`: Contains the core source code for the Femcode interpreter.
        -   `femcode/src/lexer.py`: Responsible for lexical analysis, breaking down the source code into tokens.
        -   `femcode/src/parser.py`: Responsible for syntactic analysis, building an Abstract Syntax Tree (AST) from the tokens.
        -   `femcode/src/interpreter.py`: Responsible for semantic analysis and execution of the AST.
        -   `femcode/src/main.py`: The entry point for the interpreter, handling file input and orchestrating the lexing, parsing, and interpretation process.
    -   `femcode/docs/`: Contains documentation for the Femcode language.
        -   `femcode/docs/README.md`: Comprehensive documentation of the Femcode language, including syntax, features, and usage instructions.
    -   `femcode/examples/`: Contains example Femcode programs demonstrating various language features.
    -   `femcode/build/`: Directory created by PyInstaller during the build process, containing intermediate build files.
    -   `femcode/dist/`: Directory created by PyInstaller, containing the compiled standalone executables.
        -   `femcode/dist/femcode_linux`: The compiled Linux executable of the Femcode interpreter.
    -   `femcode/venv/`: A Python virtual environment used for managing project dependencies (e.g., PyInstaller).

## Implemented Features & Changes

### 1. Core Language Setup
- **Description:** Established the foundational lexical analysis, parsing, and interpretation framework for Femcode.
- **Files Modified:**
    - `femcode/src/lexer.py`
    - `femcode/src/parser.py`
    - `femcode/src/interpreter.py`

### 2. Dictionaries and Property Access
- **Description:** Added support for creating dictionary (object) data structures and accessing their properties using dot notation.
- **Keywords/Syntax:** `{}` (dictionary literal), `.` (property access)
- **Files Modified:**
    - `femcode/src/lexer.py`
    - `femcode/src/parser.py`
    - `femcode/src/interpreter.py`
    - `femcode/examples/dictionaries.fem`

### 3. Input/Output (`ask` built-in function)
- **Description:** Introduced a built-in function `ask` to prompt the user for input, enhancing interactivity.
- **Keywords/Syntax:** `ask(prompt_string)`
- **Files Modified:**
    - `femcode/src/interpreter.py`
    - `femcode/examples/io.fem`

### 4. Built-in Functions (`len`, `type`)
- **Description:** Added utility built-in functions `len` for getting the length of strings/lists and `type` for determining the type of a value.
- **Keywords/Syntax:** `len(value)`, `type(value)`
- **Files Modified:**
    - `femcode/src/interpreter.py`
    - `femcode/examples/built_ins.fem`

### 5. `femterpreter` Wrapper Script
- **Description:** Created a standalone executable wrapper script to run Femcode programs directly from the command line, simplifying execution and removing the need to specify `python3 main.py`.
- **Files Modified:**
    - `femcode/femterpreter` (new file)
    - `femcode/src/main.py`

### 6. Enhanced Data Types
#### Floating-Point Numbers
- **Description:** Extended numerical support to include decimal values, allowing for more precise calculations.
- **Files Modified:**
    - `femcode/src/lexer.py`
    - `femcode/src/parser.py`

#### Null/None Type
- **Description:** Introduced a specific keyword to represent the absence of a value.
- **Keywords/Syntax:** `Ghosted`
- **Files Modified:**
    - `femcode/src/lexer.py`
    - `femcode/src/parser.py`

### 7. Advanced Control Flow
#### `for` Loops
- **Description:** Implemented iteration over sequences (lists and strings), enabling more flexible looping constructs.
- **Keywords/Syntax:** `Tomgirl` (for loop keyword)
- **Files Modified:**
    - `femcode/src/lexer.py`
    - `femcode/src/parser.py`
    - `femcode/src/interpreter.py`
    - `femcode/examples/loops_advanced.fem`

#### `break` and `continue` Statements
- **Description:** Added statements to provide more granular control over loop execution, allowing early exit or skipping iterations.
- **Keywords/Syntax:** `Break`, `Continue`
- **Files Modified:**
    - `femcode/src/lexer.py`
    - `femcode/src/parser.py`
    - `femcode/src/interpreter.py`
    - `femcode/examples/loops_advanced.fem`

### 8. Error Handling (`try-except`)
- **Description:** Implemented basic error handling mechanisms to gracefully manage runtime errors and prevent program crashes.
- **Keywords/Syntax:** `Twink` (try block), `Bimboy` (except block)
- **Files Modified:**
    - `femcode/src/lexer.py`
    - `femcode/src/parser.py`
    - `femcode/src/interpreter.py`
    - `femcode/examples/error_handling.fem`

### 9. Syntactic Sugar
#### Compound Assignment Operators
- **Description:** Added shorthand operators for common arithmetic assignments, improving code conciseness.
- **Keywords/Syntax:** `+=`, `-=`, `*=`, `/=`
- **Files Modified:**
    - `femcode/src/lexer.py`
    - `femcode/src/parser.py`
    - `femcode/src/interpreter.py`
    - `femcode/examples/syntactic_sugar.fem`

#### Increment/Decrement Operators
- **Description:** Introduced operators for easily increasing or decreasing numerical variables by one.
- **Keywords/Syntax:** `++`, `--`
- **Files Modified:**
    - `femcode/src/lexer.py`
    - `femcode/src/parser.py`
    - `femcode/src/interpreter.py`
    - `femcode/examples/syntactic_sugar.fem`

### 10. Documentation Updates
- **Description:** Continuously updated the `README.md` documentation to accurately reflect all new features, syntax, and usage instructions, including the `femterpreter` script.
- **Files Modified:**
    - `femcode/docs/README.md`