Limitations of the Russian Module

This document outlines the current limitations of the Russian language module for Raku and explains what is and isn't possible with the current implementation.

Overview

The Russian module provides over 200 Russian function names covering most aspects of Raku programming. However, due to technical limitations in the Rakudo compiler, it cannot currently provide full syntax modifications for control structures and declarations.

What Works

Function Names

All core Raku functions can be called using Russian names:

• скажи instead of say

• печать instead of print

• сумма instead of sum

• And 200+ more functions

Constants

Russian names for common constants:

• истина for True

• ложь for False

• пусто for Nil

• бесконечность for Inf

Custom Operators

The module includes Russian-named operators that work as infix, prefix, and postfix operators:

use Russian;

# Arithmetic operators
5 плюс 3                    # returns 8
10 минус 4                  # returns 6
6 умножить 7                # returns 42
2 степень 8                 # returns 256

# Comparison operators
5 больше 3                  # returns True
10 равно 10                 # returns True
"привет" строка_равна "привет"  # returns True

# Logical operators
истина и ложь               # returns False
истина или ложь             # returns True
не истина                   # returns False

# String operators
"Привет" соедини " мир!"    # returns "Привет мир!"

# Range operators
1 до 5                      # returns 1..5
1 до_искл 5                 # returns 1..^5

What Doesn't Work

Control Structures

Cannot use Russian keywords for control flow:

• если instead of if

• иначе instead of else

• для instead of for

• пока instead of while

• дано instead of given

• когда instead of when

Declarations

Cannot use Russian keywords for declarations:

• мой instead of my

• наш instead of our

• класс instead of class

• роль instead of role

• модуль instead of module

• подпрограмма instead of sub

• метод instead of method

Type Constraints

Cannot use Russian names in type declarations:

• Строка instead of Str

• Целое instead of Int

• Массив instead of Array

Technical Background

The Slang Mechanism

Raku supports "slangs" (sub-languages) that can modify the grammar to support different syntaxes. This is how Raku can support regex syntax, quote constructs, and potentially other language syntaxes.

Rakudo Issue #2404

There is a known bug in the Rakudo compiler (GitHub issue #2404) that prevents custom slangs from working properly. This bug blocks the implementation of full Russian syntax support.

Current Workaround

The module uses Raku's EXPORT mechanism to provide Russian-named functions. This approach:

• Works reliably

• Covers most practical programming needs

• Is compatible with all Raku versions

• Cannot modify core syntax

• Cannot change keywords

Future Possibilities

Once Rakudo issue #2404 is resolved, it will be possible to implement:

1. Full Grammar Modifications

   • Russian keywords for all control structures

   • Russian keywords for declarations

   • Russian syntax for class definitions

2. Seamless Integration

   # This would become possible:
   класс Человек {
       имеет $.имя;
       метод приветствие() {
           скажи "Привет, меня зовут $.имя";
       }
   }
   
   мой $person = Человек.new(:имя("Иван"));
   если $person.имя {
       $person.приветствие();
   }

3. Mixed Language Support

   • Ability to mix Russian and English syntax

   • Gradual migration paths for codebases

Practical Impact

Despite these limitations, the Russian module is still highly useful:

1. Teaching Programming: Students can learn programming concepts using Russian function names

2. Domain-Specific Code: Mathematical and scientific computing can use familiar Russian terminology

3. Gradual Adoption: Teams can start using Russian functions while keeping English syntax

4. Documentation: Code comments and documentation can be entirely in Russian

Examples of Current Usage

What You Can Write Today

use Russian;

# Functions work perfectly
скажи "Привет, мир!";
my @числа = 1..10;
скажи "Сумма: ", сумма(@числа);
скажи "Квадраты: ", отобразить({ $_ ** 2 }, @числа);

# Constants work
my $правда = истина;
if $правда {
    скажи "Это правда!";
}

# Mathematical functions
скажи "Синус π/2 = ", синус(пи/2);
скажи "Корень из 16 = ", корень(16);

What You Cannot Write (Yet)

# This syntax is NOT currently supported:
мое $имя = "Слава";
если $имя равно "Слава" {
    скажи "Здравствуй, Слава!";
} иначе {
    скажи "Кто ты?";
}

для 1..5 -> $н {
    скажи "Число: $н";
}

Conclusion

While the Russian module cannot currently provide complete Russian syntax for Raku, it successfully provides Russian names for hundreds of functions, making it valuable for Russian-speaking programmers. The limitations are technical rather than conceptual, and full support will be possible once the underlying compiler issue is resolved.