kolom 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8084dc8f75a72f28ad9212eafe9a387ca383eb5fd1ab71fda1c4107fd50814bb
+  data.tar.gz: d8fcac58ab1e568ac42ccd5cfd228fdd892fa6d626c458dde04734c15c27410f
+SHA512:
+  metadata.gz: 9f9c4d2d4e6c2372c0b3aaab54044f85994588a524509f02992d4f1be3b6eaba1e0590ea7c38e20f523110ded125934c2340dc00a57f38d708ef95ebea466d39
+  data.tar.gz: 1d909743efb103685499c7d11de05fcb93aa72af982307c333ed7dba7abcaaa253f8756cadc5bb4c1f5ccbd3f2a91e51504a62919f6a6f49bf3e963895ec1087

data/.rubocop.yml

@@ -0,0 +1,8 @@
+AllCops:
+  TargetRubyVersion: 3.1
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 smakthe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,192 @@
+# কলম Language
+
+কলম (Kolom) is a toy scripting language that uses Bengali keywords instead of English. It's implemented as a Ruby gem and compiles to Ruby, leveraging Ruby's powerful metaprogramming capabilities.
+
+## Installation
+
+```bash
+gem install kolom
+```
+
+Or add this line to your application's Gemfile:
+
+```ruby
+gem 'kolom'
+```
+
+And then execute:
+
+```bash
+bundle install
+```
+
+## Usage
+
+### Running কলম Programs
+
+You can run a কলম script file:
+
+```bash
+kolom path/to/your/script.kl
+```
+
+Or execute কলম code directly:
+
+```bash
+kolom -e 'লেখো "নমস্কার বিশ্ব!"'
+```
+
+### Using the REPL
+
+You can start an interactive REPL:
+
+```bash
+kolom
+```
+
+### Example Program
+
+Here's a simple example of a কলম program:
+
+```
+# Conditional logic
+যদি সংখ্যাসমষ্টি.আকার > 3 
+  বলো("অনেক সংখ্যা আছে!")
+নইলে
+  বলো("অল্প সংখ্যা আছে।")
+শেষ
+
+# String methods
+বাক্য = "বাংলা ভাষা"
+বাক্য = বাক্য.সংযোগ(" সুন্দর")
+বলো বাক্য
+লেখো("শব্দ গণনা: #{বাক্য.বিভাগ(' ').আকার}\n")
+```
+
+### Common Methods
+
+Use of common methods in a কলম program:
+
+```
+# Array operations
+সংখ্যাসমষ্টি = [1, 2, 3, 4, 5]
+লেখো("সংখ্যাসমষ্টি: #{সংখ্যাসমষ্টি}\n")
+বলো("প্রথম সংখ্যা: #{সংখ্যাসমষ্টি[0]}")
+
+# Loop through array
+সংখ্যাসমষ্টি.প্রত্যেক কর |ন|
+  লেখো("#{ন} এর বর্গ: #{ন * ন}\n")
+শেষ
+
+# Using map (প্রয়োগ)
+দ্বিগুণ = সংখ্যাসমষ্টি.প্রয়োগ কর |ন|
+  ন * 2
+শেষ
+
+বলো("দ্বিগুণ সংখ্যা: #{দ্বিগুণ}")
+
+# Hash operations
+ফল = {
+  "আপেল" => "লাল",
+  "কলা" => "হলুদ",
+  "আঙ্গুর" => "বেগুনি"
+}
+
+বলো("রঙ:")
+ফল.প্রত্যেক_চাবি কর |নাম|
+  লেখো("#{নাম}: #{ফল[নাম]}\n")
+শেষ
+
+# Function definition
+সংজ্ঞা যোগফল(ক, খ)
+  ক + খ
+শেষ
+
+লেখো("যোগফল: #{যোগফল(5, 7)}")
+```
+
+### Object Oriented Programming
+
+We can also perform Object Oriented Programming in a কলম program:
+
+```
+# Define a class
+শ্রেণী ব্যক্তি
+  সংজ্ঞা সংস্থাপন(নাম, বয়স)
+    @নাম = নাম
+    @বয়স = বয়স
+  শেষ
+
+  সংজ্ঞা পরিচয়_দাও
+    লেখো("আমার নাম #{@নাম} এবং আমার বয়স #{@বয়স} বছর।")
+  শেষ
+শ্রেণী
+
+# Create an instance
+আমি = ব্যক্তি.নতুন("করিম", 30)
+আমি.পরিচয়_দাও
+```
+
+## Keywords and Methods
+
+কলম provides Bengali equivalents for common Ruby keywords and methods:
+
+### Keywords
+
+| Kolom | Ruby |
+|---------|------|
+| শ্রেণী | class |
+| সংজ্ঞা | def |
+| যদি | if |
+| নইলে | else |
+| তাহলে | then |
+| কর | do |
+| জন্য | for |
+| যখন | when |
+| ও | and |
+| বা | or |
+| না | not |
+| সত্য | true |
+| মিথ্যা | false |
+| ফেরত | return |
+
+### Methods
+
+| Kolom | Ruby |
+|---------|------|
+| লেখো | print |
+| দৈর্ঘ্য | length |
+| সংযোগ | concat |
+| বিভাগ | split |
+| নিবেশ | push |
+| নিরসন | pop |
+| সম্বদ্ধ | join |
+| প্রয়োগ | map |
+| প্রত্যেক | each |
+| আকার | size |
+
+## Features
+
+- Translation of Bengali keywords to Ruby equivalents
+- Support for core Ruby types (String, Array, Hash)
+- Dynamic method handling using metaprogramming
+- Interactive REPL with command history
+- Support for file-based scripts
+- Error handling and debugging
+
+## Advanced Features
+
+- Dynamic method definition
+- Method aliasing in Bengali
+- Method tracing for debugging
+- DSL support
+- Lazy evaluation using Fiber
+- Concurrent execution with Threads
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub.
+
+## License
+
+The gem is available as open source under the terms of the MIT License.

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: :rubocop

data/lib/kolom/core_extensions.rb

@@ -0,0 +1,64 @@
+module Kolom
+  module CoreExtensions
+    # Define extensions for String class
+    module StringMethods
+      def method_missing(method_name, *args, &block)
+        bengali_method = Kolom::KEYWORDS.key(method_name.to_s)
+        if bengali_method
+          send(Kolom::KEYWORDS[bengali_method].to_sym, *args, &block)
+        else
+          super
+        end
+      end
+
+      def respond_to_missing?(method_name, include_private = false)
+        Kolom::KEYWORDS.key(method_name.to_s) || super
+      end
+    end
+
+    # Define extensions for Array class
+    module ArrayMethods
+      def method_missing(method_name, *args, &block)
+        bengali_method = Kolom::KEYWORDS.key(method_name.to_s)
+        if bengali_method
+          send(Kolom::KEYWORDS[bengali_method].to_sym, *args, &block)
+        else
+          super
+        end
+      end
+
+      def respond_to_missing?(method_name, include_private = false)
+        Kolom::KEYWORDS.key(method_name.to_s) || super
+      end
+    end
+
+    # Define extensions for Hash class
+    module HashMethods
+      def method_missing(method_name, *args, &block)
+        bengali_method = Kolom::KEYWORDS.key(method_name.to_s)
+        if bengali_method
+          send(Kolom::KEYWORDS[bengali_method].to_sym, *args, &block)
+        else
+          super
+        end
+      end
+
+      def respond_to_missing?(method_name, include_private = false)
+        Kolom::KEYWORDS.key(method_name.to_s) || super
+      end
+    end
+  end
+end
+
+# Extend core Ruby classes to respond to Bengali method names
+class String
+  include Kolom::CoreExtensions::StringMethods
+end
+
+class Array
+  include Kolom::CoreExtensions::ArrayMethods
+end
+
+class Hash
+  include Kolom::CoreExtensions::HashMethods
+end

data/lib/kolom/keymap.json

@@ -0,0 +1,71 @@
+{
+    "ও" : "and", 
+    "ভাঙ্গা" : "break", 
+    "ঘটনা" : "case", 
+    "শ্রেণী" : "class", 
+    "নতুন": "new",
+    "সংজ্ঞা" : "def", 
+    "সংজ্ঞায়িত?" : "defined?", 
+    "সংস্থাপন" : "initialize",
+    "কর" : "do", 
+    "নইলে" : "else", 
+    "অন্যথা" : "elsif", 
+    "শেষ" : "end", 
+    "নিশ্চিত" : "ensure", 
+    "মিথ্যা" : "false", 
+    "জন্য" : "for", 
+    "যদি" : "if", 
+    "মধ্যে" : "in", 
+    "কক্ষ" : "module", 
+    "পরবর্তী" : "next",      
+    "শূন্য" : "nil",         
+    "না" : "not",           
+    "বা" : "or",            
+    "পুনরায়" : "redo",       
+    "উদ্ধার" : "rescue",      
+    "পুনঃচেষ্টা" : "retry", 
+    "ফেরত" : "return", 
+    "স্বয়ং" : "self", 
+    "অতি" : "super", 
+    "সত্য" : "true", 
+    "অসংজ্ঞায়িত" : "undef", 
+    "যদিনা" : "unless", 
+    "যতক্ষণনা" : "until", 
+    "যখন" : "when", 
+    "যতক্ষণ" : "while", 
+    "প্রদান" : "yield", 
+    "লেখো" : "print", 
+    "বলো" : "puts", 
+    "দৈর্ঘ্য" : "length", 
+    "উল্টো" : "reverse", 
+    "সংযোগ" : "concat",             
+    "বিভাগ" : "split",              
+    "ছাঁট" : "strip",             
+    "বদল" : "gsub",               
+    "অন্তর্ভুক্ত?" : "include?", 
+    "আকার" : "size", 
+    "নিবেশ" : "push", 
+    "নিরসন" : "pop", 
+    "প্রাগ্নিবেশ" : "shift", 
+    "প্রাগ্নিরসন" : "unshift", 
+    "সম্বদ্ধ" : "join", 
+    "সাজানো" : "sort",            
+    "সূচক" : "index",             
+    "নির্বাচন" : "select", 
+    "বাতিল" : "reject",           
+    "প্রয়োগ" : "map",            
+    "সংগ্রহ" : "collect", 
+    "সমতল" : "flatten",           
+    "চাবি" : "keys",              
+    "মান" : "values",             
+    "চাবি_আছে?" : "has_key?",     
+    "চাবি?" : "key?",             
+    "মান_আছে?" : "has_value?", 
+    "আন" : "fetch",              
+    "নাশ" : "delete",            
+    "একত্র" : "merge",             
+    "প্রত্যেক" : "each",           
+    "প্রত্যেক_চাবি" : "each_key",   
+    "প্রত্যেক_মান" : "each_value",  
+    "খালি?" : "empty?" 
+  }

data/lib/kolom/metaprogramming.rb

@@ -0,0 +1,61 @@
+module Kolom
+  # Advanced features for metaprogramming
+  module MetaProgramming
+    # Dynamic method generation
+    def self.define_dynamic_method(obj, method_name, &block)
+      obj.define_singleton_method(method_name, &block)
+    end
+    
+    # Method aliasing in Bengali
+    def self.create_alias(obj, new_name, old_name)
+      obj.singleton_class.class_eval do
+        alias_method new_name.to_sym, old_name.to_sym
+      end
+    end
+    
+    # Method tracing for debugging
+    def self.trace_method(klass, method_name)
+      original_method = klass.instance_method(method_name)
+      
+      klass.class_eval do
+        define_method(method_name) do |*args, &block|
+          puts "Calling: #{method_name} with #{args.inspect}"
+          result = original_method.bind(self).call(*args, &block)
+          puts "Result: #{result.inspect}"
+          result
+        end
+      end
+    end
+    
+    # DSL support
+    class DSLContext
+      def initialize
+        @data = {}
+      end
+      
+      def method_missing(method_name, *args, &block)
+        if block_given?
+          @data[method_name] = instance_exec(&block)
+        elsif args.size > 0
+          @data[method_name] = args.size == 1 ? args.first : args
+        else
+          @data[method_name]
+        end
+      end
+      
+      def respond_to_missing?(method_name, include_private = false)
+        true
+      end
+      
+      def evaluate(&block)
+        instance_eval(&block)
+        @data
+      end
+    end
+    
+    def self.create_dsl(&block)
+      context = DSLContext.new
+      context.evaluate(&block)
+    end
+  end
+end

data/lib/kolom/repl.rb

@@ -0,0 +1,31 @@
+require 'readline'
+
+module Kolom
+  class REPL
+
+    def initialize
+      @interpreter = Interpreter.new
+      @history = []
+    end
+    
+    def start
+      loop do
+        line = Readline.readline("কলম> ", true)
+        break if line.nil? || line.strip == 'বাহির'
+        
+        begin
+          result, output = @interpreter.evaluate(line)
+          puts output unless output.empty?
+          puts "=> #{result.inspect}" unless result.nil?
+        rescue => e
+          puts "Error: #{e.message}"
+          puts e.backtrace.join("\n")
+        end
+        
+        @history << line
+      end
+      
+      puts "ধন্যবাদ!"
+    end
+  end
+end

data/lib/kolom.rb

@@ -0,0 +1,61 @@
+require "json"
+require "stringio"
+
+# Kolom is a Ruby interpreter that allows you to write Ruby-like code using Bengali keywords.
+module Kolom
+  VERSION = ENV["KOLUM_VERSION"] || "0.1.0"
+
+  # Bengali translations of Ruby keywords
+  keymap_filepath = File.join(File.dirname(__FILE__), "kolom/keymap.json")
+  keymap_file = File.open(keymap_filepath)
+  KEYWORDS = JSON.load(keymap_file).freeze
+
+  # Inverse mapping for translating back
+  RUBY_KEYWORDS = KEYWORDS.invert
+
+  # Load  all files in the kolom directory
+  Dir.glob(File.join(__dir__, "kolom", "*.rb")).each do |file_path|
+    # Construct the relative path like "kolom/filename" and require it
+
+    require_relative File.join("kolom", File.basename(file_path, ".rb"))
+  rescue LoadError => e
+    warn "Failed to load #{File.join("kolom", File.basename(file_path, ".rb"))}: #{e.message}"
+  end
+
+  # The Interpreter class is responsible for executing the translated Ruby code.
+  class Interpreter
+    attr_reader :env, :output
+
+    def initialize
+      @env = {}
+      @output = StringIO.new
+      # setup_global_environment
+    end
+
+    def evaluate(code)
+      ruby_code = translate_to_ruby(code)
+
+      # Create an instance of DSLContext
+      dsl_context = Kolom::MetaProgramming::DSLContext.new
+
+      # Evaluate the translated code in the DSL context
+      result = dsl_context.instance_eval(ruby_code)
+
+      # Return the result and any output
+      [result, @output.string]
+    end
+
+    def translate_to_ruby(code)
+      # This is a simple token-based translation
+      # In a real implementation, a proper parser might be used
+
+      # Replace Bengali keywords with Ruby keywords
+      KEYWORDS.each do |bengali, ruby|
+        # We need to be careful with word boundaries
+        code = code.gsub(/\b#{bengali}\b/, ruby)
+      end
+
+      code
+    end
+  end
+end

metadata

@@ -0,0 +1,53 @@
+--- !ruby/object:Gem::Specification
+name: kolom
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- smakthe
+bindir: bin
+cert_chain: []
+date: 2025-04-06 00:00:00.000000000 Z
+dependencies: []
+description: A toy scripting language with Bengali keywords that compiles to Ruby
+email:
+- scmakra99@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rubocop.yml"
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/kolom.rb
+- lib/kolom/core_extensions.rb
+- lib/kolom/keymap.json
+- lib/kolom/metaprogramming.rb
+- lib/kolom/repl.rb
+- sig/kolom.rbs
+homepage: https://github.com/smakthe/kolom
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/smakthe/kolom
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.5
+specification_version: 4
+summary: কলম - A Bengali scripting language
+test_files: []