quecto_calc 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3f56437ed3d312aa5c0508c4e787d2b33cb0ea8f6943fa6198ff201d8fc6f579
+  data.tar.gz: c089f9abbc586cada86442f88c6fdbd9c063609613643388bca93ed6e5eb87a3
+SHA512:
+  metadata.gz: 3ec5be8c5bcbbba76dcea6a2b13cd75ce58a4f96d67d1cc2861cc909f9194982b25b15762a22200a7cab3ccb312fbecf7b55c6fee219369fcd14898832b2ae51
+  data.tar.gz: 41348a16b6f58ecadc075f9e06e74e3f96dbdd1f61b5e1d8b8c10b9bccc8a3b06eb170bfb5e36e61905fe7e580bc25dfb1f6dadd01f24aaba22668870614dcd7

data/.gitignore

@@ -0,0 +1,8 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rubocop.yml

@@ -0,0 +1,10 @@
+Style/StringLiterals:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+Layout/LineLength:
+  Max: 120

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+### 0.1.0 / 2023-02-17
+
+* Initial release.

data/Gemfile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in quecto_calc.gemspec
+gemspec
+
+gem "rake", "~> 13.0"
+
+gem "minitest", "~> 5.0"
+
+gem "rubocop", "~> 0.80"

data/Gemfile.lock

@@ -0,0 +1,42 @@
+PATH
+  remote: .
+  specs:
+    quecto_calc (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    minitest (5.16.3)
+    parallel (1.22.1)
+    parser (3.1.3.0)
+      ast (~> 2.4.1)
+    rainbow (3.1.1)
+    rake (13.0.6)
+    regexp_parser (2.6.1)
+    rexml (3.2.5)
+    rubocop (0.93.1)
+      parallel (~> 1.10)
+      parser (>= 2.7.1.5)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8)
+      rexml
+      rubocop-ast (>= 0.6.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (1.24.0)
+      parser (>= 3.1.1.0)
+    ruby-progressbar (1.11.0)
+    unicode-display_width (1.8.0)
+
+PLATFORMS
+  x86_64-linux
+
+DEPENDENCIES
+  minitest (~> 5.0)
+  quecto_calc!
+  rake (~> 13.0)
+  rubocop (~> 0.80)
+
+BUNDLED WITH
+   2.2.3

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2023 Mate
+
+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,81 @@
+# QuectoCalc
+
+A simple calculator that evaluates primitive arithmetic expressions represented in a text form, simular to the Ruby's native method _eval_.
+
+Although QuectoCalc could perform only a _very_ limited set of operations, it parses input expressions in a way that resembles a run of a real interpreter. QuectoCalc performs lexical analysis, builds an abstract syntax tree (AST), and then evaluates the expression based on the AST. Thus, it’s functionality could be expanded later on.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'quecto_calc'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install quecto_calc
+
+## Usage
+
+obj.evaluate(expression [, constants]) -> result
+
+#### Arguments
+
++ _expression_ [String]
+
+    Expression to evaluate.
+
++ _constants_ [Hash{ String => Numeric }]
+
+    Constant names and their respective values.
+
+#### Returns
+
++ _result_ [Numeric]
+
+## Supported operators
+
++ _-_
+
+    Subtraction.
+
++ _+_ 
+
+    Addition.
+
+## Examples:
+
+```ruby
+require "quecto_calc"
+
+calc = QuectoCalc.new
+
+# Evaluate an expression:
+calc.evaluate("1 + 2 + 3 + 4 + 5 - 6") # => 9
+
+# Evaluate an expression with constants:
+foo = 9000
+bar = 1234
+calc.evaluate("foo - bar", { "foo" => foo, "bar" => bar }) # => 7766
+```
+
+## Development
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/8bit-mate/quecto_calc.
+
+## Acknowledges
+
+The lexer and the parser were inspired by the David Callanan's "[Make Your Own Programming Language](https://github.com/davidcallanan/py-myopl-code)" series.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[test rubocop]

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "quecto_calc"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/quecto_calc/bin_op_node.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+#
+# Stores a node with a binary operation (between two numbers).
+#
+class BinOpNode
+  attr_reader :left_node, :operator, :right_node
+
+  def initialize(left_node, operator, right_node)
+    @left_node = left_node
+    @operator = operator
+    @right_node = right_node
+  end
+end

data/lib/quecto_calc/char_rules.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+#
+# Provides character rules that are used by the lexer.
+#
+module CharRules
+  NUM_CHAR = /[[:digit:]]/.freeze # characters that could form a number: digits only
+  CONST_FIRST_CHAR = /[[:alpha:]]/.freeze # characters that could be used as a 1st char. in the constant name
+  CONTS_CHAR = /[[:alpha:][:digit:]_]/.freeze # characters that could form a constant: letters, digits, underscore char.
+
+  ADD_CHAR = "+"  # character that marks an addition operator
+  SUB_CHAR = "-"  # character that marks an subtraction operator
+
+  IGNOR_CHAR = /\s/.freeze # characters that are ignored: all whitespace
+end

data/lib/quecto_calc/evaluator.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+require_relative "quecto_error"
+require_relative "token_types"
+
+#
+# Evaluates expression from the abstract syntax tree.
+#
+class Evaluator
+  include TokenTypes
+
+  #
+  # Initialize an evaluator instance.
+  #
+  # @param [Hash{ String => Numeric }] consts
+  #   List of constants and their values to put in the expression.
+  #
+  def initialize(consts = {})
+    @consts = consts
+  end
+
+  #
+  # @param [BinOpNode, NumberNode] node
+  #
+  def visit(node)
+    send("_visit_#{node.class}", node)
+  end
+
+  private
+
+  #
+  # Retrieve result of a binary operation node.
+  #
+  # @param [BinOpNode] node
+  #
+  # @return [Numeric]
+  #   Result of the binary operation.
+  #
+  def _visit_BinOpNode(node)
+    left = visit(node.left_node)
+    right = visit(node.right_node)
+
+    case node.operator.type
+    when TT_PLUS
+      left + right
+    when TT_MINUS
+      left - right
+    end
+  end
+
+  #
+  # Retrieve value of a number node.
+  #
+  # @param [NumberNode] node
+  #
+  # @return [Numeric]
+  #
+  def _visit_NumberNode(node)
+    case node.token.type
+    when TT_INT
+      node.token.value
+    when TT_CONST
+      _init_constant(node)
+    end
+  end
+
+  #
+  # Replace constant with an associated value.
+  #
+  # @param [NumberNode] node
+  #   A numeric node with @token of TT_CONST type.
+  #
+  # @return [Numeric]
+  #
+  # @raise [CalcError]
+  #   Raises if constant is not found in the @consts.
+  #
+  def _init_constant(node)
+    if @consts.key?(node.token.value)
+      @consts[node.token.value]
+    else
+      error_msg = "undefined constant '#{node.token.value}'"
+      raise CalcError, error_msg
+    end
+  end
+end

data/lib/quecto_calc/lexer.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+require_relative "char_rules"
+require_relative "quecto_error"
+require_relative "token"
+require_relative "token_types"
+
+#
+# Performs lexical analysis of a given string.
+#
+class Lexer
+  include TokenTypes
+  include CharRules
+
+  #
+  # Initialize a lexer instance.
+  #
+  # @param [String] str
+  #   String to parse.
+  #
+  def initialize(str)
+    @str = str
+    @pos = 0
+    @cur_char = nil
+
+    _next_char
+  end
+
+  #
+  # Create a list of tokens from a string.
+  #
+  # @return [Array<Token>] tokens
+  #
+  # @raise [IllegalCharError]
+  #   Raises when @str has an unsupported character.
+  #
+  def build_tokens
+    tokens = []
+
+    until @cur_char.nil?
+      if @cur_char == ADD_CHAR
+        tokens.append(Token.new(type: TT_PLUS))
+      elsif @cur_char == SUB_CHAR
+        tokens.append(Token.new(type: TT_MINUS))
+      elsif @cur_char.match?(NUM_CHAR)
+        num = Token.new(type: TT_INT, value: _build_word(NUM_CHAR).to_i)
+        tokens.append(num)
+      elsif @cur_char.match?(CONST_FIRST_CHAR)
+        num = Token.new(type: TT_CONST, value: _build_word(CONTS_CHAR))
+        tokens.append(num)
+      elsif @cur_char.match?(IGNOR_CHAR)
+        # Ignore whitespace.
+      else
+        error_msg = "illegal character '#{@cur_char}' at the position: #{@pos - 1}"
+        raise IllegalCharError, error_msg
+      end
+      _next_char
+    end
+
+    tokens.append(Token.new(type: TT_EOF))
+
+    tokens
+  end
+
+  private
+
+  #
+  # Build a 'word' out of a sequence of characters.
+  #
+  # A 'word' is a sequence of characters followed one by another without break characters (e.g. a space or a supported
+  # math operator: '+', '-', etc).
+  #
+  # A 'word' could be represented in a form of:
+  #
+  # 1. a sequence of alphabetical characters optionally mixed with digits and joined into one string using a connective
+  # character '_'. Examples:
+  #   - 'ruby' (a sequence of alphabetical characters only);
+  #   - 'foobar9000' (a mix of alphabetical characters and digits);
+  #   - 'this_is_a_3rd_example' (long string joined with a connective character).
+  #
+  # 2. an integer number, e.g.: '31337' (a sequence of digits without break characters).
+  #
+  # @param [Regexp] regexp
+  #   Defines that kind of character sequence the method should be looking for: NUM_CHAR (search for a digit) or
+  #   CONTS_CHAR (search for a constant).
+  #
+  # @return [String] word
+  #
+  def _build_word(regexp)
+    word = ""
+
+    until @cur_char.nil?
+      break unless @cur_char.match?(regexp)
+
+      word += @cur_char
+      _next_char
+    end
+    _next_char
+
+    @pos -= 1
+    word
+  end
+
+  #
+  # Process next character in the string.
+  #
+  def _next_char
+    @cur_char = @pos < @str.length ? @str[@pos] : nil
+    @pos += 1
+  end
+end

data/lib/quecto_calc/number_node.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+#
+# Stores a node with a numeric value.
+#
+class NumberNode
+  attr_reader :token
+
+  def initialize(token)
+    @token = token
+  end
+end

data/lib/quecto_calc/parser.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+require_relative "bin_op_node"
+require_relative "number_node"
+require_relative "quecto_error"
+require_relative "token_types"
+
+#
+# Parses list of tokens to build an abstract syntax tree.
+#
+class Parser
+  include TokenTypes
+
+  #
+  # Initialize a parser instance.
+  #
+  # @param [Array<Token>] tokens
+  #   List of tokens to parse.
+  #
+  def initialize(tokens)
+    @tokens = tokens
+    @cur_token = @tokens[0]
+    @idx = 0
+  end
+
+  #
+  # Parse list of tokens.
+  #
+  def parse
+    _expr
+  end
+
+  private
+
+  #
+  # Buid a node for the expression.
+  #
+  # @return [BinOpNode, NumberNode] left
+  #   Node for an expression. The left.class corresponds to the expression type: a single number or a binary operation
+  #   (an operation between two numbers).
+  #
+  def _expr
+    # retrieve left part of the expression:
+    left = _term
+
+    while BIN_OPS.include?(@cur_token.type)
+      # retrieve operator between two number nodes:
+      op_tok = @cur_token
+
+      # retrieve right part of the expression:
+      _next_token
+      right = _term
+
+      left = BinOpNode.new(left, op_tok, right)
+    end
+
+    left
+  end
+
+  #
+  # Search for a term in the expression.
+  #
+  # @return [NumberNode] token
+  #   Found term.
+  #
+  # @raise [InvalidSyntaxError]
+  #
+  def _term
+    if TERMS.include?(@cur_token.type)
+      token = NumberNode.new(@cur_token)
+    else
+      error_msg = "expected TT_INT or TT_LBL, but got #{@cur_token.type}"
+      raise InvalidSyntaxError, error_msg
+    end
+
+    _next_token
+    token
+  end
+
+  #
+  # Process next token.
+  #
+  def _next_token
+    @idx += 1
+    @cur_token = @tokens[@idx] if @idx < @tokens.length
+  end
+end

data/lib/quecto_calc/quecto_error.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+#
+# Errors rised by the quecto_calc.
+#
+class QuectoError < ::StandardError
+  attr_reader :error_name, :message
+
+  def initialize(error_name, message)
+    @error_name = error_name
+    @message = message
+  end
+end
+
+#
+# Raised by the lexer if an illegal character is found.
+#
+class IllegalCharError < QuectoError
+  attr_reader :message
+
+  def initialize(message = "")
+    super("Illegal Character:", message)
+  end
+end
+
+#
+# Raised by the parser if an illegal syntax is found.
+#
+class InvalidSyntaxError < QuectoError
+  attr_reader :message
+
+  def initialize(message = "")
+    super("Syntax Error:", message)
+  end
+end
+
+#
+# Raised by the evaluator on an illegal operation.
+#
+class CalcError < QuectoError
+  attr_reader :message
+
+  def initialize(message = "")
+    super("Runtime Error:", message)
+  end
+end

data/lib/quecto_calc/token.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+#
+# Stores a token generated by the lexer.
+#
+class Token
+  attr_reader :type, :value
+
+  def initialize(type:, value: nil)
+    @type = type
+    @value = value
+  end
+end

data/lib/quecto_calc/token_types.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+#
+# Provides supported token types.
+#
+module TokenTypes
+  TT_INT = :TT_INT     # integer number
+  TT_CONST = :TT_CONST # constant (placeholder for a numeric value)
+  TT_PLUS = :TT_PLUS   # addition operator
+  TT_MINUS = :TT_MINUS # subtraction operator
+  TT_EOF = :TT_EOF     # end of input
+
+  TERMS = [TT_INT, TT_CONST].freeze
+
+  BIN_OPS = [TT_PLUS, TT_MINUS].freeze
+end

data/lib/quecto_calc/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+class QuectoCalc
+  VERSION = "0.1.0"
+end

data/lib/quecto_calc.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+require_relative "quecto_calc/evaluator"
+require_relative "quecto_calc/lexer"
+require_relative "quecto_calc/parser"
+require_relative "quecto_calc/version"
+
+#
+# A simple calculator that evaluates primitive arithmetic expressions represented in a text form.
+#
+# Supported operators:
+#   + -- add a number
+#   - -- subtract a number.
+#
+# Supported types:
+#   Integer;
+#   Constant (a string placeholder for an Integer).
+#
+# Parser/lexer stuff was inspired by the David Callanan's "Make Your Own Programming Language" series
+# @ https://github.com/davidcallanan/py-myopl-code
+#
+class QuectoCalc
+  #
+  # Evaluate an expression.
+  #
+  # @param [String] expr
+  #   Expression to parse and evaluate.
+  #
+  # @option [Hash{ String => Numeric }] consts
+  #   List on constants and their values to put in the expression.
+  #
+  def evaluate(expr, consts = {})
+    tokens = build_tokens(expr)
+    ast = build_ast(tokens)
+    evaluate_ast(ast, consts)
+  rescue QuectoError => e
+    puts "#{e.error_name} #{e.message}"
+  end
+
+  #
+  # Get a list of tokens from the string.
+  #
+  # @param [String] expr
+  #
+  def build_tokens(expr)
+    Lexer.new(expr).build_tokens
+  end
+
+  #
+  # Build an abstract syntax tree from a list of tokens.
+  #
+  # @param [Array<Token>] tokens
+  #
+  def build_ast(tokens)
+    Parser.new(tokens).parse
+  end
+
+  #
+  # Evaluate expression from the AST.
+  #
+  # @param [NumberNode, BinOpNode] ast
+  #   Expression (in a form of AST) to evaluate.
+  #
+  # @option [Hash{ String => Numeric }] consts
+  #   List on constants and their values to put in the expression.
+  #
+  def evaluate_ast(ast, consts = {})
+    evaluator = Evaluator.new(consts)
+    evaluator.visit(ast)
+  end
+end

data/quecto_calc.gemspec

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require_relative "lib/quecto_calc/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "quecto_calc"
+  spec.version       = QuectoCalc::VERSION
+  spec.authors       = ["Mate"]
+  #spec.email         = ["mate@example.com"]
+
+  spec.summary       = "A very simple calculator."
+  spec.description   = "Evaluates primitive arithmetic expressions represented in a text form."
+  spec.homepage      = "https://github.com/8bit-mate/quecto_calc.rb/"
+  spec.license       = "MIT"
+  spec.required_ruby_version = Gem::Requirement.new(">= 3.0.0")
+
+  spec.metadata["allowed_push_host"] = "https://rubygems.org/"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "https://github.com/8bit-mate/quecto_calc.rb/blob/main/CHANGELOG.md"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  # Uncomment to register a new dependency of your gem
+  # spec.add_dependency "example-gem", "~> 1.0"
+
+  # For more information and examples about making a new gem, checkout our
+  # guide at: https://bundler.io/guides/creating_gem.html
+end

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification
+name: quecto_calc
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Mate
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2023-02-17 00:00:00.000000000 Z
+dependencies: []
+description: Evaluates primitive arithmetic expressions represented in a text form.
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/quecto_calc.rb
+- lib/quecto_calc/bin_op_node.rb
+- lib/quecto_calc/char_rules.rb
+- lib/quecto_calc/evaluator.rb
+- lib/quecto_calc/lexer.rb
+- lib/quecto_calc/number_node.rb
+- lib/quecto_calc/parser.rb
+- lib/quecto_calc/quecto_error.rb
+- lib/quecto_calc/token.rb
+- lib/quecto_calc/token_types.rb
+- lib/quecto_calc/version.rb
+- quecto_calc.gemspec
+homepage: https://github.com/8bit-mate/quecto_calc.rb/
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org/
+  homepage_uri: https://github.com/8bit-mate/quecto_calc.rb/
+  source_code_uri: https://github.com/8bit-mate/quecto_calc.rb/
+  changelog_uri: https://github.com/8bit-mate/quecto_calc.rb/blob/main/CHANGELOG.md
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.3
+signing_key: 
+specification_version: 4
+summary: A very simple calculator.
+test_files: []