Salam Language

A new programming language empowering developers in Persian and Arabic-speaking communities.
Unlock the joy of coding—accessible, intuitive, and culturally resonant.

---

✨ Introduction

Salam Language, inspired by the word salam (سلام), meaning peace, is the first Persian/Arabic-based programming language.
It is designed for simplicity, accessibility, and inclusivity—bridging the gap between developers and technology in Persian, Arabic, and related linguistic communities.

Why Choose Salam?

• 🌍 Localized for Persian and Arabic Speakers: Write and read code in your native language.
• 🧑‍🎓 Beginner-Friendly: Salam makes programming approachable for everyone, including students and new developers.
• 💻 Powerful Tools: Easy to use, but with robust capabilities for all your coding needs.

Key Features

• ✏️ Intuitive scripting and code compilation.
• 🚀 Docker support for seamless development.
• 🔧 Linting and code checks for best practices.
• 🔄 Built-in commands for versioning and updates.

---

🚀 Getting Started

To explore Salam, run the following commands:

$ ./salam
Welcome to Salam Programming Language!
Salam is the first Persian/Iranian computer scripting language.

Usage Examples

• Execute a Script:

  ./salam <filename>

• Compile and Run Code:

  ./salam code <content> <output_dir>

• Lint Scripts:

  ./salam lint <filename> <output_dir>

• Version Check:

  ./salam version

• Update Salam:

  ./salam update

For a detailed guide, visit our official site: salamlang.ir

---

🐳 Using Salam with Docker

Run Salam in an isolated and consistent Docker environment.

Step 1: Pull the Image

Download the Salam Docker image:

docker pull basemax/salam:latest

Step 2: Run the Image

Start an interactive session:

docker run --rm -it basemax/salam

Build Locally (Optional)

1. Clone the Salam repository:

   git clone https://github.com/SalamLang/Salam
   cd Salam

2. Build the Docker image:

   docker build -f docker/Dockerfile -t salam .

3. Verify the image:

   docker images salam

---

Running Scripts

Mount a Local Script

docker run --rm -it -v $(pwd):/scripts salam ./salam /scripts/your_script.salam

Inline Code Execution

docker run --rm -it salam ./salam code "صفحه: محتوا = «سلام دنیا از سلام» تمام"

Explore Salam Commands

• Check Version:

  docker run --rm -it salam ./salam version

• Update Salam:

  docker run --rm -it salam ./salam update

• Lint Scripts:
  Lint a File:

  docker run --rm -it -v $(pwd):/scripts salam ./salam lint /scripts/your_script.salam /output

  Lint Inline Code:

  docker run --rm -it salam ./salam lint code "some salam code"

---

🤝 Contributing

We welcome contributions from the community!

• 📖 Read our Contributing Guide.
• 🌟 Follow our Code of Conduct.

Together, let’s make coding accessible to all.

---

© 2024 Salam Language Team
For inquiries or feedback, visit: salamlang.ir