language-ruby 0.5.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 182d0456a2c73bdf225a70c643eb2c96feaf24dd0ffb11505d06f92536f39613
+  data.tar.gz: 9b0a7f5d97a9a076b711e7bf8872722d46a2906f98e988f9b661a150a5dcec00
+SHA512:
+  metadata.gz: f362c37edd49bbe9e34b5e62d8911d859a0bef58c68adc891db682a74f7b53de6153dccfb1acc163450e376eef0b66a07f11d398cc21e966486954d5d1fb8b2a
+  data.tar.gz: 36e9c2247fa179763e091499d2c4315e45bb302308e7460ac4b9fca3513bfad0ae7bfe4fbf95ea2071295b3d892874bc5b26248a2f19762c3a3d6e66a0f48812

data/.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true

data/.github/workflows/rspec.yml

@@ -0,0 +1,14 @@
+name: RSpec
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    name: RSpec
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v1
+      - uses: actions/setup-ruby@v1
+      - run: bundle install
+      - run: bundle exec rspec

data/.gitignore

@@ -0,0 +1,2 @@
+*.gem
+tmp/

data/.prettierrc

@@ -0,0 +1,3 @@
+{
+  "rubyPlugins": "plugin/trailing_comma"
+}

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/CHANGELOG.md

@@ -0,0 +1,55 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## 0.4.0 / 2022-10-21
+
+- Rewrite of how functions are called internally (no more `public_send`)
+- Call ruby functions from template/code
+
+## 0.3.1 / 2022-10-13
+
+- Fix Zeitwerk auto-loading issue
+
+## 0.3.0 / 2022-10-10
+
+- `bin/template` accepts `--timeout` (or `-t`) parameter
+- Adds `bin/code` with same options as `bin/template`
+- Prevent loose syntax like `{ a: }`, `[1,,,]` and `()`
+- Change precedence of defined? (to allow `defined?(name) ? name : nothing`)
+- Updates parsers to allow `while false end == nothing`
+- String interpolations like `"1 + 1 = {1 + 1}"`
+- `context(:name)` to get a function without calling it for instance
+- `.to_string` on all objects
+- `1 + "a"` and `"a" + 1.0` for instance now convert to strings
+- `Dictionnary#each` e.g. `{ a: 1 }.each { |k, v| print(k) }`
+- Fix context duplication issue that was preventing implementation of recursive
+  functions like Fibonacci
+
+## 0.2.4 / 2022-08-02
+
+- Add method `String#*`, e.g. `{"Dorian " \* 2}" -> "Dorian Dorian "
+- Add executable to gem, e.g. `template --help`
+
+## 0.2.3 / 2022-08-31
+
+- Add default timeout for code and template parsing and evaluation
+
+## 0.2.2 / 2022-08-31
+
+- Fix parsing error when the template is empty, e.g. ""
+
+## 0.2.1 / 2022-08-31
+
+- Fix parsing error on empty code like `Hello {`
+
+## 0.2.0 / 2022-08-30
+
+- Programming language capable of solving the first 5 Project Euler problems
+
+## 0.1.0 / 2022-07-28
+
+- Initial version with interpolation

data/Gemfile

@@ -0,0 +1,8 @@
+source "https://rubygems.org"
+
+gemspec name: "template-ruby"
+gemspec name: "code-ruby"
+
+gem "rspec"
+gem "syntax_tree", github: "dorianmariefr/syntax_tree"
+gem "ruby-prof"

data/Gemfile.lock

@@ -0,0 +1,48 @@
+GIT
+  remote: https://github.com/dorianmariefr/syntax_tree.git
+  revision: f7c9dc36a3d60c90a8d2411f123913b37319dc11
+  specs:
+    syntax_tree (5.0.1)
+      prettier_print (>= 1.1.0)
+
+PATH
+  remote: .
+  specs:
+    code-ruby (0.4.0)
+      zeitwerk (~> 2)
+    template-ruby (0.4.0)
+      zeitwerk (~> 2)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.5.0)
+    prettier_print (1.1.0)
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-core (3.12.0)
+      rspec-support (~> 3.12.0)
+    rspec-expectations (3.12.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-mocks (3.12.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.0)
+    ruby-prof (1.4.3)
+    zeitwerk (2.6.6)
+
+PLATFORMS
+  arm64-darwin-21
+
+DEPENDENCIES
+  code-ruby!
+  rspec
+  ruby-prof
+  syntax_tree!
+  template-ruby!
+
+BUNDLED WITH
+   2.3.18

data/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2022 Dorian Marié <dorian@dorianmarie.fr>
+
+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,103 @@
+# Template
+
+[![RSpec](https://github.com/dorianmariefr/template-ruby/actions/workflows/rspec.yml/badge.svg)](https://github.com/dorianmariefr/template-ruby/actions/workflows/rspec.yml)
+
+See [templatelang.com](https://templatelang.com) for the full documentation and
+live code editing.
+
+## The programming language
+
+Hi, I'm [Dorian Marié](https://dorianmarie.fr), I created Template to let users of my websites provide templates to customize their experience.
+
+Template is meant to be:
+
+- **Simple**: `Hello` and `Hello {name}`
+- **Safe**: Can be provided user input
+- **Powerful**: Functions, object-oriented, built-in methods
+
+Template is currently written in Ruby and embeddable as a Ruby gem.
+
+## Install
+
+### As a command line tool:
+
+```bash
+$ gem install template-ruby
+$ template --input "Hello {name}" --context '{ name: "Dorian" }'
+Hello Dorian
+$ template --input "1 + 2 = {1 + 2}"
+1 + 2 = 3
+```
+
+### As a Ruby gem:
+
+In a `Gemfile`:
+
+```ruby
+gem "template-ruby"
+```
+
+Then `$ bundle install`
+
+Then you can use Template like:
+
+```ruby
+Template.render("Hello {name}", '{ name: "Dorian" }')
+# => "Hello Dorian"
+Template.render("1 + 2 = {1 + 2}")
+# => "1 + 2 = 3"
+Template.render(input, context, io: StringIO.new, timeout: 10)
+```
+
+The context is a sub-language called Code, you can use it like:
+
+```ruby
+Code.evaluate("1 + 2") # => 3
+```
+
+## Future work
+
+- Extend standard library
+- Global methods from Ruby, e.g. `{markdown "**bold**"}`
+- Object methods from Ruby, e.g. `{"**bold**".markdown}`
+- Classes, e.g. `{class User end}`
+- Write JavaScript version
+- Write Crystal version
+
+## Contributing
+
+Feel free to open [issues](https://github.com/dorianmariefr/template-ruby/issues),
+and [pull requests](https://github.com/dorianmariefr/template-ruby/pulls).
+
+To develop locally:
+
+```text
+$ git clone https://github.com/dorianmariefr/template-ruby
+$ cd template-ruby
+$ bundle
+$ rspec
+$ bin/template -i docs/...
+```
+
+## Credits
+
+Thanks to [thoughtbot](https://thoughtbot.com) who let me work on this programming
+language as a Friday project.
+
+Thanks to [Kaspar Schiess](https://github.com/kschiess) who made
+[Parslet](https://kschiess.github.io/parslet/), the gem that helped me write the parser.
+
+Inspiration from [Ruby](https://www.ruby-lang.org/en/) and
+[Liquid](https://shopify.github.io/liquid/).
+
+## License
+
+MIT
+
+Copyright 2022 Dorian Marié <dorian@dorianmarie.fr>
+
+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/TODO

@@ -0,0 +1,17 @@
+- Class
+- Function parameters regular splat *args
+- Function parameters keyword splat **kargs
+- Function parameters block &block
+- Block parameters regular splat *args
+- Block parameters keyword splat **kargs
+- Block parameters block &block
+- Dictionnary regular splat { *args }
+- Dictionnary keyword splat { **kargs }
+- Dictionnary block { &block }
+- Dictionnary expand name { user } and { user: }
+- Rescue with exception name, rescue Code::Undefined
+- Rescue with exception catched, rescue => e
+- begin end
+- begin rescue end
+- begin rescue ensure end
+- begin rescue else end

data/bin/code

@@ -0,0 +1,76 @@
+#!/usr/bin/env ruby
+
+require "optparse"
+require_relative "../lib/template-ruby"
+
+options = { timeout: 0, profile: false }
+
+OptionParser
+  .new do |opts|
+    opts.banner = "Usage: bin/code [options]"
+
+    opts.on(
+      "-i INPUT",
+      "--input=INPUT",
+      "Input in the code language (String or File)"
+    ) do |input|
+      input = File.read(input) if File.exists?(input)
+
+      options[:input] = input
+    end
+
+    opts.on(
+      "-c CONTEXT",
+      "--context=CONTEXT",
+      "Context in the code language (String or File)"
+    ) do |context|
+      context = File.read(context) if File.exists?(context)
+
+      options[:context] = context
+    end
+
+    opts.on("-p", "--parse", "Get parser results for input") do |parse|
+      options[:parse] = parse
+    end
+
+    opts.on(
+      "-t TIMEOUT",
+      "--timeout=TIMEOUT",
+      "Set timeout in seconds"
+    ) { |timeout| options[:timeout] = timeout.to_f }
+
+    opts.on(
+      "--profile",
+      "Profile Ruby code"
+    ) do |timeout|
+      require "ruby-prof"
+      options[:profile] = true
+    end
+  end
+  .parse!
+
+input = options.fetch(:input, "")
+context = options.fetch(:context, "")
+
+if options[:profile]
+  RubyProf.start
+end
+
+if options[:parse]
+  pp ::Code::Parser.parse(input).to_raw
+else
+  print(
+    Code.evaluate(
+      input,
+      context,
+      io: $stdout,
+      timeout: options[:timeout]
+    ).to_s
+  )
+end
+
+if options[:profile]
+  result = RubyProf.stop
+  printer = RubyProf::FlatPrinter.new(result)
+  printer.print($stdout)
+end

data/bin/format

@@ -0,0 +1,3 @@
+#!/usr/bin/env fish
+
+stree write Gemfile lib/**/*.rb spec/**/*.rb bin/code-parser

data/bin/template

@@ -0,0 +1,85 @@
+#!/usr/bin/env ruby
+
+require "optparse"
+require_relative "../lib/template-ruby"
+
+options = { timeout: 0, profile: false, profiler: "text" }
+
+OptionParser
+  .new do |opts|
+    opts.banner = "Usage: template [options]"
+
+    opts.on(
+      "-i INPUT",
+      "--input=INPUT",
+      "Input in the template language (String or File)"
+    ) do |input|
+      input = File.read(input) if File.exists?(input)
+
+      options[:input] = input
+    end
+
+    opts.on(
+      "-c CONTEXT",
+      "--context=CONTEXT",
+      "Context in the code language (String or File)"
+    ) do |context|
+      context = File.read(context) if File.exists?(context)
+
+      options[:context] = context
+    end
+
+    opts.on("-p", "--parse", "Get parser results for input") do |parse|
+      options[:parse] = parse
+    end
+
+    opts.on(
+      "-t TIMEOUT",
+      "--timeout=TIMEOUT",
+      "Set timeout in seconds"
+    ) { |timeout| options[:timeout] = timeout.to_f }
+
+    opts.on(
+      "--profile",
+      "Profile Ruby code"
+    ) do |timeout|
+      require "ruby-prof"
+      options[:profile] = true
+    end
+
+    opts.on(
+      "--profiler TYPE",
+      "Profiler output type (text (default) or html)"
+    ) do |profiler|
+      require "ruby-prof"
+      options[:profile] = true
+      options[:profiler] = profiler
+    end
+  end
+  .parse!
+
+input = options.fetch(:input, "")
+context = options.fetch(:context, "")
+
+if options[:profile]
+  RubyProf.start
+end
+
+if options[:parse]
+  pp ::Template::Parser.parse(input).to_raw
+else
+  Template.render(input, context, io: $stdout, timeout: options[:timeout])
+end
+
+if options[:profile]
+  result = RubyProf.stop
+  if options[:profiler] == "text"
+    printer = RubyProf::FlatPrinter.new(result)
+    printer.print($stdout)
+  elsif options[:profiler] == "html"
+    printer = RubyProf::GraphHtmlPrinter.new(result)
+    printer.print($stdout)
+  else
+    abort "#{options[:profiler]} not recognized"
+  end
+end

data/bin/test

@@ -0,0 +1,17 @@
+#!/bin/bash
+
+set -e
+
+rspec
+
+for f in docs/**/*.template
+do
+  echo $f
+  bin/template -i $f -p > /dev/null
+done
+
+for f in docs/*.code
+do
+  echo $f
+  bin/code -i $f -p > /dev/null
+done

data/code-ruby.gemspec

@@ -0,0 +1,17 @@
+require_relative "lib/template/version"
+
+Gem::Specification.new do |s|
+  s.name = "code-ruby"
+  s.version = ::Template::Version
+  s.summary = "A programming language"
+  s.description = 'A programming language, like Code.evaluate("1 + 1") # => 2'
+  s.authors = ["Dorian Marié"]
+  s.email = "dorian@dorianmarie.fr"
+  s.files = `git ls-files`.split($/)
+  s.test_files = s.files.grep(%r{^(test|spec|features)/})
+  s.require_paths = ["lib"]
+  s.homepage = "https://github.com/dorianmariefr/template-ruby"
+  s.license = "MIT"
+
+  s.add_dependency "zeitwerk", "~> 2"
+end

data/docs/class.code

@@ -0,0 +1,9 @@
+class ApiClient
+  get = (url) => {
+    fetch(url)
+  }
+end
+
+class Twitter < ApiClient
+  self.base_url = "https://api.twitter.com"
+end

data/docs/euler/1.template

@@ -0,0 +1,10 @@
+{
+  sum = 0
+
+  1000.times do |i|
+    if i % 3 == 0 or i % 5 == 0
+      sum += i
+    end
+  end
+
+  sum

data/docs/euler/2.template

@@ -0,0 +1,16 @@
+{
+  a = 1
+  b = 2
+  sum = 2
+
+  while b < 4000000
+    c = a + b
+    a = b
+    b = c
+
+    if b % 2 == 0
+      sum += b
+    end
+  end
+
+  sum

data/docs/euler/3.template

@@ -0,0 +1,16 @@
+{
+  n = 600851475143
+  max = 0
+
+  i = 2
+
+  until n == 1
+    while n % i == 0
+      max = i
+      n = n / i
+    end
+
+    i += 1
+  end
+
+  max

data/docs/euler/4.template

@@ -0,0 +1,10 @@
+{
+
+  min = 1
+  max = 999
+
+  (min..max).map do |i|
+    ((min..max).to_list.reverse.detect do |j|
+      (i * j).to_string.reverse == (i * j).to_string
+    end || 0) * i
+  end.max

data/docs/euler/5.template

@@ -0,0 +1,13 @@
+{
+  min = 1
+  max = 20
+
+  step = [2, 3, 5, 7, 11, 13, 17].reduce do |acc, el|
+    acc * el
+  end
+
+  (step..(step * step)).step(step).detect do |i|
+    (min..max).all? do |j|
+      i % j == 0
+    end
+  end

data/docs/fibonnaci.template

@@ -0,0 +1,14 @@
+{
+  fibonnaci = (n) => {
+    if n < 2
+      n
+    else
+      fibonnaci(n - 1) + fibonnaci(n - 2)
+    end
+  }
+
+  (0..20).each do |i|
+    puts("fibonnaci({i}) = {fibonnaci(i)}")
+  end
+
+  nothing

data/docs/meetup.code

@@ -0,0 +1,12 @@
+url = fetch(:url) { "https://www.meetup.com/parisrb" }
+response = HTTP.get(url)
+times = response.css(".groupHome-eventsList-upcomingEvents time")
+times = times.map(&:datetime).map { |time| Time.from_epoch(time.to_integer) }
+
+times.each do |time|
+  if (1.day.from_now...(1.day.from_now + 1.hour)).include?(time)
+    Sms.send("Event in one day {url}")
+  elsif (2.hours.from_now...(1.hour.from_now)).include(time)
+    Sms.send("Event in two hours {url}")
+  end
+end

data/docs/precedence.template

@@ -0,0 +1,36 @@
+- Code
+- Statement
+- Equality
+- Splat
+- Class
+- While
+- If
+- IfModifier
+- OrKeyword
+- NotKeyword
+- Equal
+- Rescue
+- Ternary
+- Range
+- OrOperator
+- AndOperator
+- EqualityLower
+- Greater
+- BitwiseOr
+- BitwiseAnd
+- Shift
+- Addition
+- Multiplication
+- UnaryMinus
+- Power
+- Negation
+- Function
+- ChainedCall
+- Dictionnary
+- List
+- String
+- Number
+- Boolean
+- Nothing
+- Group
+- Call

data/docs/rain.code

@@ -0,0 +1,22 @@
+paris = { latitude: 48.8566, longitude: 2.4022 }
+latitude = fetch(:latitude) { paris.latitude }
+longitude = fetch(:longitude) { paris.longitude }
+duration = fetch(:duration) { 1.hour }
+hour = duration.from_now.hour
+
+response =
+  HTTP.get(
+    "https://api.open-meteo.com/v1/forecast",
+    parameters: {
+      latitude: latitude,
+      longitude: longitude,
+      hourly: :precipitation
+    }
+  )
+
+precipitation = response.hourly.precipitation[hour]
+precipitation = (precipitation * 100).to_integer
+
+if precipitation > 0
+  Sms.send("There will be {precipitation}% of precipitation in the next hour")
+end

data/docs/slack.code

@@ -0,0 +1,17 @@
+Slack.send("Who is leading the syncs?", channel: "#team-template")
+
+Twitter.send("What do you want to do this week?")
+
+Discord.send("Who will be the game master this week?")
+
+Email.send(
+  subject: "What did you do last week?",
+  from: "dorian@thoughtbot.com",
+  reply_to: "rob@thoughtbot.com"
+)
+
+Email.send(
+  subject: "What do you want to do this week?",
+  from: "dorian@thoughtbot.com",
+  reply_to: "rob@thoughtbot.com"
+)