https://github.com/sufremoak/asciiscript
https://github.com/sufremoak/asciiscript
ascii programming-language scripting-language
Last synced: 15 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/sufremoak/asciiscript
- Owner: SufremOak
- License: mit
- Created: 2025-04-21T20:39:58.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-04-21T20:50:32.000Z (about 1 month ago)
- Last Synced: 2025-04-21T21:38:03.694Z (about 1 month ago)
- Topics: ascii, programming-language, scripting-language
- Language: Shell
- Homepage:
- Size: 0 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AsciiScript
A modern, portable, and declarative scripting language designed for creating interactive documents and web content. AsciiScript features two implementations: a primary Shell Script (Bash) version and a high-performance C++ macro-based version.
## Implementations
### Shell Script (Primary)
- Core implementation in Bash
- Located in `/src/main.sh`
- Native string manipulation and pattern matching
- Easy to modify and extend
- Excellent Unix/Linux system integration
### C++ Macro (Performance)
- Alternative implementation for high-performance needs
- Located in `/cpp` directory
- Compile-time macro processing
- C++17 features for efficient parsing
- Cross-platform via CMake
## Features
- **Declarative Syntax**: Clean and intuitive syntax for content creation
- **Component-Based**: Reusable components for efficient development
- **Style Integration**: Built-in styling system similar to CSS
- **Modular System**: Import and use modules to extend functionality
- **Error Handling**: Robust error handling with try-catch blocks
- **Cross-Platform**: C++ based interpreter for maximum portability
## Installation
### Shell Script Version
```bash
git clone https://github.com/yourusername/AsciiScript.git
cd AsciiScript
chmod +x src/main.sh
./src/main.sh example.ascii
```
### C++ Version
```bash
git clone https://github.com/yourusername/AsciiScript.git
cd AsciiScript/cpp
mkdir build && cd build
cmake ..
make
./asciiscript example.ascii
```
## Quick Start
### Hello World Example
```python
ascii(type=script)
@script:
.function main() {
ascii.console(log => "Hello from AsciiScript!")
return self
}
```
### Creating a Document
```python
ascii(type=document(article))
@style: {
body {
font.family("Arial"),
margin(2em)
}
}
@content:
@Heading(1): "My First Document"
@paragraph:
"""
This is a simple AsciiScript document.
"""
&end(paragraph)
```
## Language Features
### Variables and Data Types
- Numbers
- Strings
- Booleans
- Arrays
- Objects
### Control Flow
- If statements
- While loops
- For loops
- Try-catch blocks
### Functions
- Named functions
- Anonymous functions
- Arrow functions
- Function parameters
### Modules
- Import system
- Module aliases
- Built-in modules
### Components
- Custom components
- Component props
- Nested components
## Built-in Modules
- `dom`: DOM manipulation utilities
- `formatter`: String formatting tools
- `structures`: Data structure implementations
- `test`: Unit testing framework
## Contributing
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## License
This project is licensed under the MIT License - see the LICENSE file for details.
## Credits
Created by Miguel Gargallo