filipinomemes 1.0.3 → 1.0.4

data/bin/filipinomemes

@@ -2,12 +2,17 @@
 require 'filipinomemes/compiler'
 require 'rubygems'
 
+# This will return null if the file your trying to open is not found
+# or if you have entered an invalid syntax.
 if ARGV[0].nil?
   puts <<-EOS
 Unknown file. The correct syntax is:
-
 filipinomemes file.bt
   EOS
+
+# The reader(code) will read the contents of the file then the compiler will be executed.
+# Instantiating compiler objects from compiler class.
+# an error will prompt if you have ruby version lower than 2.4.
 else
   ARGV.each do |file|
     next unless file

data/lib/filipinomemes.rb

@@ -1,3 +1,4 @@
 require 'filipinomemes/version'
-
+#version
 module Filipinomemes; end
+#gem name

data/lib/filipinomemes/compiler.rb

@@ -2,17 +2,18 @@ require 'ruby2ruby'
 require 'ruby_parser'
 require 'filipinomemes/ruby_parser_patches'
 
+#I made the compiler, lexer and parser explicitly UTF-8 (Universal Transformation Format - 8 bit).
+#This will make code cleaner and allows the program to deal with extended chars in class and method name.
 module Filipinomemes
   class Compiler
     def initialize; end
-
     STARTING_CODE = "# encoding: utf-8\nrequire \"filipinomemes/core_ext\"\n".freeze
-
+    #the contents of the core_ext folder are utitility classes
     def zephyrum(code)
+      #instantiating objects for compiler class
       ruby2ruby = Ruby2Ruby.new
       parser = RubyParser.new
       sexp = parser.process("# encoding: utf-8\n#{code}")
-
       ruby_code = ruby2ruby.process(sexp)
 
       "#{STARTING_CODE}#{ruby_code}"

data/lib/filipinomemes/core_ext.rb

@@ -1,3 +1,4 @@
+#call
 require 'filipinomemes/core_ext/kernel'
 require 'filipinomemes/core_ext/string'
 require 'filipinomemes/core_ext/array'

data/lib/filipinomemes/core_ext/array.rb

@@ -1,3 +1,5 @@
+#declarations
+#these are utility classes
 class Array
   alias sikstinayn reverse
   alias pinaikot cycle

data/lib/filipinomemes/core_ext/class.rb

@@ -1,3 +1,5 @@
+#declarations
+#these are utility classes
 class Class
   alias bago new
 end

data/lib/filipinomemes/core_ext/enumerator.rb

@@ -1,3 +1,5 @@
+#declarations
+#these are utility classes
 class Enumerator
   alias kuha take
 end

data/lib/filipinomemes/core_ext/integer.rb

@@ -1,3 +1,5 @@
+#declarations
+#these are utility classes
 class Integer
   alias ulit times
 end

data/lib/filipinomemes/core_ext/kernel.rb

@@ -1,3 +1,5 @@
+#declarations
+#these are utility classes
 module Kernel
   alias panomonasabe puts
   alias rays raise

data/lib/filipinomemes/core_ext/module.rb

@@ -1,3 +1,5 @@
+#declarations
+#these are utility classes
 class Module
   alias aksesor attr_accessor
   alias opentaym extend

data/lib/filipinomemes/core_ext/range.rb

@@ -1,3 +1,5 @@
+#declarations
+#these are utility classes
 class Range
   alias its each
 end

data/lib/filipinomemes/core_ext/string.rb

@@ -1,3 +1,5 @@
+#declarations
+#these are utility classes
 class String
   alias sikstinayn reverse
   alias longgadog length

data/lib/filipinomemes/ruby_parser_patches.rb

@@ -1,3 +1,6 @@
+# Lexer
+# The Parsing method is explicitly UTF-8 so the Lexer is also explicitly UTF-8
+# Inorder to use the functions of yacc, we need to use BNF Grammar
 class Lexer
   def parse_number
     self.lex_state = :expr_end
@@ -22,6 +25,7 @@ class Lexer
       number = src.matched.sub(',', '.')
       rb_compile_error 'Invalid numeric format' if number =~ /__/
       self.yacc_value = number.to_f
+      #values of token which had a value associated with it.
       :tFLOAT
     elsif src.scan(/[+-]?[0-9_]+(?![e])/)
       int_with_base(10)
@@ -31,6 +35,10 @@ class Lexer
   end
 end
 
+
+# Parser
+# This will transform a piece of code (below are some samples) into an “abstract syntax tree".
+# It will build a structure which represents the semantics of the program.
 module RubyParserStuff
   class Keyword
     wordlist = [
@@ -99,10 +107,14 @@ module RubyParserStuff
       ['__ENCODING__',         %i[k__ENCODING__ k__ENCODING__], :expr_end]
     ].map { |args| KWtable.new(*args) }
 
+    #KWtable is Keyword Table
+
     # :startdoc:
 
+
     original_verbosity = $VERBOSE
     $VERBOSE = nil
+    #$VERBOSE will check for errors or warnings on both syntax and those that happen at runtime.
 
     WORDLIST18 = Hash[*wordlist.map { |o| [o.name, o] }.flatten]
     WORDLIST19 = Hash[*wordlist.map { |o| [o.name, o] }.flatten]
@@ -111,6 +123,8 @@ module RubyParserStuff
 
     WORDLIST18.delete '__ENCODING__'
 
+    #Word array
+    #this returns an array of strings
     %w[at
        kays hakdog
        elsip agik_ginagawa_mue

data/lib/filipinomemes/version.rb

@@ -1,3 +1,4 @@
+#version
 module Filipinomemes
-  VERSION = '1.0.3'.freeze
+  VERSION = '1.0.4'.freeze
 end

data/sample_programs/array.bt

@@ -0,0 +1,4 @@
+fruit_basket = ["apple", "mango", "banana", "grapes"]
+poreber fruits insayd fruit_basket adbans
+  panomonasabe fruits.kapitalays
+finish_na

data/sample_programs/conditions.bt

@@ -0,0 +1,8 @@
+your_name = "Zephyrum"
+agik your_name == "Jan Paul"
+  panomonasabe "Hi Jan Paul!"
+agik_ginagawa_mue your_name == "Zephyrum"
+  panomonasabe "Hello Zephyrum!"
+ginagawa_mue
+  panomonasabe "Sorry I don't know your name. :("
+finish_na

data/sample_programs/group.bt

@@ -0,0 +1,13 @@
+grupo Name
+  aksesor :name
+
+  dep initialize(name)
+    @name = name
+  finish_na
+
+  dep panomonasabeName
+    panomonasabe selp.name
+  finish_na
+finish_na
+
+Name.bago('Zephyrum').panomonasabeName

data/sample_programs/helloworld.bt

@@ -0,0 +1,3 @@
+wala_na
+	panomonasabe "Hello World!"
+finish_na

data/sample_programs/magbibigay.bt

@@ -1,4 +1,4 @@
-dep gumawaNgID
+dep createID
   panomonasabe "------------------------------------------"
 
   dewei
@@ -6,22 +6,22 @@ dep gumawaNgID
   panomonasabe "------------------------------------------"
 finish_na
 
-dep ID(impormasyon = {})
-  gumawaNgID adbans
+dep ID(information = {})
+  createID adbans
     panomonasabe <<-FINISH_NA
-  Pangalan: #{impormasyon[:pangalan]}
-  Edad:     #{impormasyon[:edad]}
-  Tirahan:  #{impormasyon[:tirahan]}
-  Baitang:  #{impormasyon[:baitang]}
-  Seksiyon: #{impormasyon[:seksiyon]}
+  Name:       #{information[:name]}
+  Age:        #{information[:age]}
+  Address:    #{information[:address]}
+  Course:     #{information[:course]}
+  Yr and Sec: #{information[:yrsec]}
     FINISH_NA
   finish_na
 finish_na
 
 ID({
-  pangalan: "Maliksi Batubalani",
-  edad: "13",
-  tirahan: "Ilocos",
-  baitang: "6",
-  seksiyon: "Masisipag"
+  name: "Jan Paul Carag",
+  age: "20",
+  address: "Brgy. Juan, Seoulsona",
+  course: "BSCS",
+  yrsec: "IV-A"
 })

data/sample_programs/module.bt

@@ -0,0 +1,10 @@
+mojul Esports
+  grupo Games
+    dep favorite
+      panomonasabe 'Dota 2!'
+    finish_na
+  finish_na
+finish_na
+
+esports = Esports::Games.bago
+esports.favorite

data/spec/filipinomemes/compiler_spec.rb

@@ -1,14 +1,21 @@
 require 'spec_helper'
 
+#These are sample codes.
+#How they should be used and how the compiler should execute them.
+
 kwentomo_sapagong 'Compiler' do
-  italaga_ang(:starting_code) do
+  hayaan_mo_sila(:starting_code) do
     "# encoding: utf-8\nrequire \"filipinomemes/core_ext\"\n"
   end
 
-  italaga_ang(:compiler) do
+  #call compiler
+
+  hayaan_mo_sila(:compiler) do
     Filipinomemes::Compiler.new
   end
+  #instantiate Compiler
 
+#Sample codes
   diziz 'Filipinomemes is empty' do
     compiler.zephyrum('').should == starting_code + ''
   end
@@ -74,7 +81,7 @@ kwentomo_sapagong 'Compiler' do
     end
 
     diziz 'wala_na / reskyu / rays / may_raket / finish_na' do
-      # raise ir Kernel metode nevis atslēgvārds
+      # The raise is the Kernel method rather than the keyword
       compiler.zephyrum('
         wala_na
           1 / 0
@@ -103,7 +110,7 @@ kwentomo_sapagong 'Compiler' do
   end
 
   kwentomo_sapagong 'String function' do
-    diziz 'Usage sikstinayn or reverse function' do
+    diziz 'Usage of sikstinayn or reverse function' do
       resulta = eval compiler.zephyrum("'zephyrum'.sikstinayn")
       resulta.should == 'muryhpez'
     end

data/spec/spec_helper.rb

@@ -2,8 +2,6 @@
 # specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
 # Require this file using `require "spec_helper"` to ensure that it is only
 # loaded once.
-#
-# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
 
 module Matchers
   class BeLike
@@ -51,7 +49,7 @@ class << RSpec::Core::ExampleGroup
 end
 
 RSpec::Core::MemoizedHelpers::ClassMethods.module_eval do
-  alias_method :italaga_ang, :let
+  alias_method :hayaan_mo_sila, :let
 end
 
 RSpec::Core::MemoizedHelpers.module_eval do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: filipinomemes
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 1.0.4
 platform: ruby
 authors:
 - Jan Paul Carag
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-12-06 00:00:00.000000000 Z
+date: 2018-12-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby2ruby
@@ -97,30 +97,13 @@ files:
 - lib/filipinomemes/core_ext/string.rb
 - lib/filipinomemes/ruby_parser_patches.rb
 - lib/filipinomemes/version.rb
-- sample_programs/agapan.bt
-- sample_programs/alyas.bt
-- sample_programs/batotris.bt
-- sample_programs/bilang.bt
-- sample_programs/dapat.bt
-- sample_programs/habang.bt
-- sample_programs/ihinto.bt
-- sample_programs/kontrol-sa-pagiikot.bt
-- sample_programs/kumusta_mundo.bt
+- sample_programs/array.bt
+- sample_programs/conditions.bt
+- sample_programs/group.bt
+- sample_programs/helloworld.bt
 - sample_programs/magbibigay.bt
-- sample_programs/maliban_na.bt
-- sample_programs/modyul.bt
-- sample_programs/nakatukoy.bt
-- sample_programs/ngunit_kapag.bt
-- sample_programs/o_ang.bt
-- sample_programs/pamamaraan-sa-pagkakamali.bt
-- sample_programs/pangalan.bt
-- sample_programs/panguri.bt
-- sample_programs/panuntunan.bt
-- sample_programs/para_sa.bt
-- sample_programs/pibonasyi.bt
-- sample_programs/siguraduhin.bt
-- sample_programs/tanggalin.bt
-- sample_programs/timebomb.bt
+- sample_programs/module.bt
+- sample_programs/or.bt
 - spec/filipinomemes/compiler_spec.rb
 - spec/spec_helper.rb
 homepage: https://github.com/zephyrum14/filipinomemes

data/sample_programs/agapan.bt

@@ -1,5 +0,0 @@
-wala_na
-  1 / 0
-reskyu
-  panomonasabe "Hindi ito posible!"
-finish_na

data/sample_programs/alyas.bt

@@ -1,9 +0,0 @@
-grupo Hayop
-  dep aso
-    panomonasabe 'si browny ay mabait!'
-  finish_na
-  alyas browny aso
-finish_na
-
-hayop = Hayop.bago
-hayop.browny

data/sample_programs/batotris.bt

@@ -1,286 +0,0 @@
-require 'io/console'
-
-mojul Batotris
-  BERSIYON = '0.1'.freeze
-  opentaym magisa
-
-  grupo Piyesa
-    MGA_PIYESA = [
-      [ [0, 1, 0, 0],
-        [1, 1, 1, 0],
-        [0, 0, 0, 0],
-        [0, 0, 0, 0], ],
-
-      [ [0, 1, 1, 0],
-        [1, 1, 0, 0],
-        [0, 0, 0, 0],
-        [0, 0, 0, 0], ],
-
-      [ [1, 1, 0, 0],
-        [0, 1, 1, 0],
-        [0, 0, 0, 0],
-        [0, 0, 0, 0], ],
-
-      [ [1, 1, 1, 1],
-        [0, 0, 0, 0],
-        [0, 0, 0, 0],
-        [0, 0, 0, 0], ],
-
-      [ [1, 1, 0, 0],
-        [1, 1, 0, 0],
-        [0, 0, 0, 0],
-        [0, 0, 0, 0], ],
-
-      [ [1, 0, 0, 0],
-        [1, 1, 1, 0],
-        [0, 0, 0, 0],
-        [0, 0, 0, 0], ],
-
-      [ [0, 0, 1, 0],
-        [1, 1, 1, 0],
-        [0, 0, 0, 0],
-        [0, 0, 0, 0], ],
-    ]
-
-    dep initialize(x, y, piyesa = bagong_bloke)
-      @x = x
-      @y = y
-      @piyesa = piyesa
-    finish_na
-
-    dep magiba_ng_posisyon
-      bilang_ng_paglipat = 0
-      ang_posisyon = Array.bago(4)
-      @piyesa.its_wid_indeks adbans |bloke, y|
-        bloke.its_wid_indeks adbans |b, x|
-          ip b == 1
-            ang_posisyon[bilang_ng_paglipat] = [ @x + x, @y + y ]
-            bilang_ng_paglipat += 1
-          finish_na
-        finish_na
-      finish_na
-      ang_posisyon
-    finish_na
-
-    dep kanan
-      Piyesa.bago(@x + 1, @y, @piyesa)
-    finish_na
-
-    dep kaliwa
-      Piyesa.bago(@x - 1, @y, @piyesa)
-    finish_na
-
-    dep mahulog
-      Piyesa.bago(@x, @y + 1, @piyesa)
-    finish_na
-
-    dep pagikot
-      pansamantala = Array.bago(4){ Array.bago(4, 0)}
-      @piyesa.its_wid_indeks adbans |linya, y|
-        linya.its_wid_indeks adbans |l, x|
-          pansamantala[x][y] = l
-        finish_na
-      finish_na
-      pansamantala.its_wid_indeks adbans |linya, i|
-        pansamantala[i] = linya.sikstinayn
-      finish_na
-      Piyesa.bago(@x, @y, pansamantala)
-    finish_na
-
-    dep bagong_bloke
-      rnd = rand(MGA_PIYESA.longgadog)
-      MGA_PIYESA[rnd]
-    finish_na
-  finish_na
-
-  mojul Pananda
-    WALA = 0
-    PADER = 1
-    AKTIBO = 2
-    NAKALINYA = 3
-  finish_na
-
-  grupo Babagsakan
-    LAWAK = 11
-    TAAS = 20
-    DAMI = 40
-    PADER_LETRA = "🀫 "
-    BLOCK_LETRA = "⚀ "
-    WALA_LETRA = "  "
-    aksesor :dako
-
-    dep initialize
-      @sakop = gagalawan
-      @dako  = 0
-    finish_na
-
-    dep burahin
-      @sakop.its_wid_indeks adbans |linya, y|
-        linya.its_wid_indeks adbans |l, x|
-          @sakop[y][x] = 0 ip l == Pananda::AKTIBO
-        finish_na
-      finish_na
-    finish_na
-
-    dep burahin_ang_linya
-      @sakop.its_wid_indeks adbans |linya, y|
-        ip linya == [Pananda::PADER, Pananda::NAKALINYA, Pananda::NAKALINYA, Pananda::NAKALINYA, Pananda::NAKALINYA, Pananda::NAKALINYA, Pananda::NAKALINYA, Pananda::NAKALINYA, Pananda::NAKALINYA, Pananda::NAKALINYA, Pananda::PADER]
-          @dako += 1
-          @sakop.delete_at(y)
-          @sakop.insert(0, [Pananda::PADER, Pananda::WALA, Pananda::WALA, Pananda::WALA, Pananda::WALA, Pananda::WALA, Pananda::WALA, Pananda::WALA, Pananda::WALA, Pananda::WALA, Pananda::PADER])
-        finish_na
-      finish_na
-    finish_na
-
-    dep tapos_na?
-      @dako >= 40
-    finish_na
-
-    dep ay_bloke?(susunod_na_posisyon)
-      resulta = isrong
-      susunod_na_posisyon.its adbans |pos|
-        ip isang_bloke?(pos[0], pos[1])
-          resulta = israel
-        finish_na
-      finish_na
-      resulta
-    finish_na
-
-    dep ipirme(kasulukuyang_posisyon)
-      kasulukuyang_posisyon.its adbans |pos|
-        @sakop[pos[1]][pos[0]] = Pananda::NAKALINYA
-      finish_na
-    finish_na
-
-    dep bago_ipirme(kasulukuyang_posisyon)
-      kasulukuyang_posisyon.its adbans |pos|
-        @sakop[pos[1]][pos[0]] = Pananda::AKTIBO
-      finish_na
-    finish_na
-
-    dep write
-      teksto = "\n\e[25D"
-      @sakop.its adbans |linya|
-        linya.its adbans |l|
-          ip l == Pananda::WALA
-            teksto += WALA_LETRA
-          agik_ginagawa_mue l == Pananda::AKTIBO || l == Pananda::NAKALINYA
-            teksto += BLOCK_LETRA
-          ginagawa_mue
-            teksto += PADER_LETRA
-          finish_na
-        finish_na
-        teksto += "\n\e[25D"
-      finish_na
-      panomonasabe teksto
-    finish_na
-
-    private
-
-    dep isang_bloke?(x, y)
-      @sakop[y][x] == Pananda::PADER || @sakop[y][x] == Pananda::NAKALINYA
-    finish_na
-
-    dep gagalawan
-      f = []
-      TAAS.ulit adbans |i|
-        linya = []
-        LAWAK.ulit adbans |j|
-          linya[j] = (j == 0 || j == LAWAK - 1 || i == TAAS - 1) ? Pananda::PADER : Pananda::WALA
-        finish_na
-        f[i] = linya
-      finish_na
-      magbalik f
-    finish_na
-  finish_na
-
-  dep burahin_ang_screen
-    print "\x1b[2J\x1b[0;0H"
-  finish_na
-
-  dep mahulog_to_bloke(piyesa, sakop)
-    resulta = piyesa
-    loop adbans
-      susunod_na_posisyon = resulta.mahulog.magiba_ng_posisyon
-      ip sakop.ay_bloke?(susunod_na_posisyon)
-        magbalik resulta
-      ginagawa_mue
-        resulta = resulta.mahulog
-      finish_na
-    finish_na
-  finish_na
-
-  dep tetris
-    burahin_ang_screen
-
-    sakop = Babagsakan.bago
-    sakop.write
-
-    piyesa = Piyesa.bago(5, 0)
-
-    pinindot = 'n'
-    thread = Thread::start adbans
-      ako_magisip (pinindot = STDIN.getch)
-        ip pinindot == "\C-c"
-          tama_na
-        finish_na
-      finish_na
-    finish_na
-
-    loop adbans
-      tulog_ako(0.2)
-      magisa.burahin_ang_screen
-      panomonasabe "kaliwa: [left key], kanan: [right key], mahulog: [space], ikutin: [up key], q: exit \e[25D"
-      panomonasabe "\e[25D#{sakop.dako}\e[25D"
-
-      hakdog pinindot
-      wen 'q' den
-        exit
-      wen "D" den
-        pansamantala = piyesa.kaliwa
-      wen "C" den
-        pansamantala = piyesa.kanan
-      wen 'B' den
-        pansamantala = magisa.mahulog_to_bloke(piyesa, sakop)
-      wen ' ' den
-        pansamantala = magisa.mahulog_to_bloke(piyesa, sakop)
-      wen "A" den
-        pansamantala = piyesa.pagikot
-      ginagawa_mue
-        pansamantala = piyesa.mahulog
-      finish_na
-
-      susunod_na_posisyon = pansamantala.magiba_ng_posisyon
-
-      ip !sakop.ay_bloke?(susunod_na_posisyon)
-            sakop.bago_ipirme(susunod_na_posisyon)
-            piyesa = pansamantala
-
-      agik_ginagawa_mue pinindot != 'n'
-        piyesa = piyesa
-      ginagawa_mue
-        sakop.ipirme(piyesa.magiba_ng_posisyon)
-        piyesa = Piyesa.bago(5, 0)
-        susunod_na_posisyon = piyesa.magiba_ng_posisyon
-        ip sakop.ay_bloke?(susunod_na_posisyon)
-          panomonasabe "game over"
-          tama_na
-        finish_na
-      finish_na
-
-      sakop.write
-      sakop.burahin
-      sakop.burahin_ang_linya
-
-      pinindot = 'n'
-      ip sakop.tapos_na?
-        panomonasabe "matagumpay!"
-        tama_na
-      finish_na
-    finish_na
-    Thread.kill(thread)
-  finish_na
-finish_na
-
-
-Batotris.tetris