code-ruby 4.0.0 → 4.0.1

data/lib/code/object/global.rb

@@ -5,7 +5,8 @@ class Code
     class Global < Object
       CLASS_DOCUMENTATION = {
         name: "Global",
-        description: "dispatches top-level functions, constructors, and control flow helpers.",
+        description:
+          "dispatches top-level functions, constructors, and control flow helpers.",
         examples: [
           "globals.keys.include?(:puts)",
           "classes.keys.include?(:List)",
@@ -29,7 +30,8 @@ class Code
         },
         {
           name: "dictionary",
-          description: "store named values in a dictionary and read them by key.",
+          description:
+            "store named values in a dictionary and read them by key.",
           source: "user = { name: :Dorian, age: 31 } user.name",
           expected: ":Dorian",
           command: "bin/code 'user = { name: :Dorian, age: 31 } user.name'"
@@ -76,7 +78,8 @@ class Code
           },
           {
             title: "Find built-in functions",
-            action: "use globals, functions, instance_functions, and class_functions from inside Code.",
+            action:
+              "use globals, functions, instance_functions, and class_functions from inside Code.",
             example: GETTING_STARTED_EXAMPLES.fetch(4)
           }
         ],
@@ -90,254 +93,178 @@ class Code
       FUNCTIONS = {
         "Base64" => {
           name: "Base64",
-          description: "returns the Base64 class when called without arguments, otherwise calls Base64.new.",
-          examples: [
-            "Base64",
-            "Base64.new",
-            "Base64.new(nothing)"
-          ]
+          description:
+            "returns the Base64 class when called without arguments, otherwise calls Base64.new.",
+          examples: %w[Base64 Base64.new Base64.new(nothing)]
         },
         "Boolean" => {
           name: "Boolean",
-          description: "returns the Boolean class when called without arguments, otherwise calls Boolean.new.",
-          examples: [
-            "Boolean",
-            "Boolean.new",
-            "Boolean.new(nothing)"
-          ]
+          description:
+            "returns the Boolean class when called without arguments, otherwise calls Boolean.new.",
+          examples: %w[Boolean Boolean.new Boolean.new(nothing)]
         },
         "Class" => {
           name: "Class",
-          description: "returns the Class class when called without arguments, otherwise calls Class.new.",
-          examples: [
-            "Class",
-            "Class.new",
-            "Class.new(nothing)"
-          ]
+          description:
+            "returns the Class class when called without arguments, otherwise calls Class.new.",
+          examples: %w[Class Class.new Class.new(nothing)]
         },
         "Code" => {
           name: "Code",
-          description: "returns the Code class when called without arguments, otherwise calls Code.new.",
-          examples: [
-            "Code",
-            "Code.new",
-            "Code.new(nothing)"
-          ]
+          description:
+            "returns the Code class when called without arguments, otherwise calls Code.new.",
+          examples: %w[Code Code.new Code.new(nothing)]
         },
         "Context" => {
           name: "Context",
-          description: "returns the Context class when called without arguments, otherwise calls Context.new.",
-          examples: [
-            "Context",
-            "Context.new",
-            "Context.new(nothing)"
-          ]
+          description:
+            "returns the Context class when called without arguments, otherwise calls Context.new.",
+          examples: %w[Context Context.new Context.new(nothing)]
         },
         "Cryptography" => {
           name: "Cryptography",
-          description: "returns the Cryptography class when called without arguments, otherwise calls Cryptography.new.",
-          examples: [
-            "Cryptography",
-            "Cryptography.new",
-            "Cryptography.new(nothing)"
-          ]
+          description:
+            "returns the Cryptography class when called without arguments, otherwise calls Cryptography.new.",
+          examples: %w[Cryptography Cryptography.new Cryptography.new(nothing)]
         },
         "Date" => {
           name: "Date",
-          description: "returns the Date class when called without arguments, otherwise calls Date.new.",
-          examples: [
-            "Date",
-            "Date.new",
-            "Date.new(nothing)"
-          ]
+          description:
+            "returns the Date class when called without arguments, otherwise calls Date.new.",
+          examples: %w[Date Date.new Date.new(nothing)]
         },
         "Decimal" => {
           name: "Decimal",
-          description: "returns the Decimal class when called without arguments, otherwise calls Decimal.new.",
-          examples: [
-            "Decimal",
-            "Decimal.new",
-            "Decimal.new(nothing)"
-          ]
+          description:
+            "returns the Decimal class when called without arguments, otherwise calls Decimal.new.",
+          examples: %w[Decimal Decimal.new Decimal.new(nothing)]
         },
         "Dictionary" => {
           name: "Dictionary",
-          description: "returns the Dictionary class when called without arguments, otherwise calls Dictionary.new.",
-          examples: [
-            "Dictionary",
-            "Dictionary.new",
-            "Dictionary.new(nothing)"
-          ]
+          description:
+            "returns the Dictionary class when called without arguments, otherwise calls Dictionary.new.",
+          examples: %w[Dictionary Dictionary.new Dictionary.new(nothing)]
         },
         "Duration" => {
           name: "Duration",
-          description: "returns the Duration class when called without arguments, otherwise calls Duration.new.",
-          examples: [
-            "Duration",
-            "Duration.new",
-            "Duration.new(nothing)"
-          ]
+          description:
+            "returns the Duration class when called without arguments, otherwise calls Duration.new.",
+          examples: %w[Duration Duration.new Duration.new(nothing)]
         },
         "Function" => {
           name: "Function",
-          description: "returns the Function class when called without arguments, otherwise calls Function.new.",
-          examples: [
-            "Function",
-            "Function.new",
-            "Function.new(nothing)"
-          ]
+          description:
+            "returns the Function class when called without arguments, otherwise calls Function.new.",
+          examples: %w[Function Function.new Function.new(nothing)]
         },
         "Html" => {
           name: "Html",
-          description: "returns the Html class when called without arguments, otherwise calls Html.new.",
-          examples: [
-            "Html",
-            "Html.new",
-            "Html.new(nothing)"
-          ]
+          description:
+            "returns the Html class when called without arguments, otherwise calls Html.new.",
+          examples: %w[Html Html.new Html.new(nothing)]
         },
         "Http" => {
           name: "Http",
-          description: "returns the Http class when called without arguments, otherwise calls Http.new.",
-          examples: [
-            "Http",
-            "Http.new",
-            "Http.new(nothing)"
-          ]
+          description:
+            "returns the Http class when called without arguments, otherwise calls Http.new.",
+          examples: %w[Http Http.new Http.new(nothing)]
         },
         "Ics" => {
           name: "Ics",
-          description: "returns the Ics class when called without arguments, otherwise calls Ics.new.",
-          examples: [
-            "Ics",
-            "Ics.new",
-            "Ics.new(nothing)"
-          ]
+          description:
+            "returns the Ics class when called without arguments, otherwise calls Ics.new.",
+          examples: %w[Ics Ics.new Ics.new(nothing)]
         },
         "IdentifierList" => {
           name: "IdentifierList",
-          description: "returns the IdentifierList class when called without arguments, otherwise calls IdentifierList.new.",
-          examples: [
-            "IdentifierList",
-            "IdentifierList.new",
-            "IdentifierList.new(nothing)"
+          description:
+            "returns the IdentifierList class when called without arguments, otherwise calls IdentifierList.new.",
+          examples: %w[
+            IdentifierList
+            IdentifierList.new
+            IdentifierList.new(nothing)
           ]
         },
         "Integer" => {
           name: "Integer",
-          description: "returns the Integer class when called without arguments, otherwise calls Integer.new.",
-          examples: [
-            "Integer",
-            "Integer.new",
-            "Integer.new(nothing)"
-          ]
+          description:
+            "returns the Integer class when called without arguments, otherwise calls Integer.new.",
+          examples: %w[Integer Integer.new Integer.new(nothing)]
         },
         "Json" => {
           name: "Json",
-          description: "returns the Json class when called without arguments, otherwise calls Json.new.",
-          examples: [
-            "Json",
-            "Json.new",
-            "Json.new(nothing)"
-          ]
+          description:
+            "returns the Json class when called without arguments, otherwise calls Json.new.",
+          examples: %w[Json Json.new Json.new(nothing)]
         },
         "List" => {
           name: "List",
-          description: "returns the List class when called without arguments, otherwise calls List.new.",
-          examples: [
-            "List",
-            "List.new",
-            "List.new(nothing)"
-          ]
+          description:
+            "returns the List class when called without arguments, otherwise calls List.new.",
+          examples: %w[List List.new List.new(nothing)]
         },
         "Nothing" => {
           name: "Nothing",
-          description: "returns the Nothing class when called without arguments, otherwise calls Nothing.new.",
-          examples: [
-            "Nothing",
-            "Nothing.new",
-            "Nothing.new(nothing)"
-          ]
+          description:
+            "returns the Nothing class when called without arguments, otherwise calls Nothing.new.",
+          examples: %w[Nothing Nothing.new Nothing.new(nothing)]
         },
         "Number" => {
           name: "Number",
-          description: "returns the Number class when called without arguments, otherwise calls Number.new.",
-          examples: [
-            "Number",
-            "Number.new",
-            "Number.new(nothing)"
-          ]
+          description:
+            "returns the Number class when called without arguments, otherwise calls Number.new.",
+          examples: %w[Number Number.new Number.new(nothing)]
         },
         "Object" => {
           name: "Object",
-          description: "returns the Object class when called without arguments, otherwise calls Object.new.",
-          examples: [
-            "Object",
-            "Object.new",
-            "Object.new(nothing)"
-          ]
+          description:
+            "returns the Object class when called without arguments, otherwise calls Object.new.",
+          examples: %w[Object Object.new Object.new(nothing)]
         },
         "Parameter" => {
           name: "Parameter",
-          description: "returns the Parameter class when called without arguments, otherwise calls Parameter.new.",
-          examples: [
-            "Parameter",
-            "Parameter.new",
-            "Parameter.new(nothing)"
-          ]
+          description:
+            "returns the Parameter class when called without arguments, otherwise calls Parameter.new.",
+          examples: %w[Parameter Parameter.new Parameter.new(nothing)]
         },
         "Range" => {
           name: "Range",
-          description: "returns the Range class when called without arguments, otherwise calls Range.new.",
-          examples: [
-            "Range",
-            "Range.new",
-            "Range.new(nothing)"
-          ]
+          description:
+            "returns the Range class when called without arguments, otherwise calls Range.new.",
+          examples: %w[Range Range.new Range.new(nothing)]
         },
         "Smtp" => {
           name: "Smtp",
-          description: "returns the Smtp class when called without arguments, otherwise calls Smtp.new.",
-          examples: [
-            "Smtp",
-            "Smtp.new",
-            "Smtp.new(nothing)"
-          ]
+          description:
+            "returns the Smtp class when called without arguments, otherwise calls Smtp.new.",
+          examples: %w[Smtp Smtp.new Smtp.new(nothing)]
         },
         "String" => {
           name: "String",
-          description: "returns the String class when called without arguments, otherwise calls String.new.",
-          examples: [
-            "String",
-            "String.new",
-            "String.new(nothing)"
-          ]
+          description:
+            "returns the String class when called without arguments, otherwise calls String.new.",
+          examples: %w[String String.new String.new(nothing)]
         },
         "Time" => {
           name: "Time",
-          description: "returns the Time class when called without arguments, otherwise calls Time.new.",
-          examples: [
-            "Time",
-            "Time.new",
-            "Time.new(nothing)"
-          ]
+          description:
+            "returns the Time class when called without arguments, otherwise calls Time.new.",
+          examples: %w[Time Time.new Time.new(nothing)]
         },
         "Url" => {
           name: "Url",
-          description: "returns the Url class when called without arguments, otherwise calls Url.new.",
-          examples: [
-            "Url",
-            "Url.new",
-            "Url.new(nothing)"
-          ]
+          description:
+            "returns the Url class when called without arguments, otherwise calls Url.new.",
+          examples: %w[Url Url.new Url.new(nothing)]
         },
         "classes" => {
           name: "classes",
-          description: "returns documentation for built-in classes exposed by globals.",
-          examples: [
-            "classes",
-            "classes.keys.include?(:List)",
-            "classes.fetch(:String).description"
+          description:
+            "returns documentation for built-in classes exposed by globals.",
+          examples: %w[
+            classes
+            classes.keys.include?(:List)
+            classes.fetch(:String).description
           ]
         },
         "break" => {
@@ -361,15 +288,12 @@ class Code
         "context" => {
           name: "context",
           description: "returns the current evaluation context dictionary.",
-          examples: [
-            "context",
-            "context.keys",
-            "context.has_key?(:context)"
-          ]
+          examples: %w[context context.keys context.has_key?(:context)]
         },
         "evaluate" => {
           name: "evaluate",
-          description: "evaluates a string as Code source and returns its result.",
+          description:
+            "evaluates a string as Code source and returns its result.",
           examples: [
             "evaluate(\"1 + 2\")",
             "evaluate(\":hello\")",
@@ -378,25 +302,28 @@ class Code
         },
         "getting_started" => {
           name: "getting_started",
-          description: "returns a short guide with runnable examples and commands.",
-          examples: [
-            "getting_started.title",
-            "getting_started.steps.first.command",
-            "getting_started.examples.map(&:name)"
+          description:
+            "returns a short guide with runnable examples and commands.",
+          examples: %w[
+            getting_started.title
+            getting_started.steps.first.command
+            getting_started.examples.map(&:name)
           ]
         },
         "globals" => {
           name: "globals",
-          description: "returns documentation for top-level functions and constructors.",
-          examples: [
-            "globals",
-            "globals.keys.include?(:List)",
-            "globals.fetch(:puts).description"
+          description:
+            "returns documentation for top-level functions and constructors.",
+          examples: %w[
+            globals
+            globals.keys.include?(:List)
+            globals.fetch(:puts).description
           ]
         },
         "next" => {
           name: "next",
-          description: "exits the current block iteration and returns an optional value.",
+          description:
+            "exits the current block iteration and returns an optional value.",
           examples: [
             "[1].map { next }",
             "[1].map { next 2 }",
@@ -406,38 +333,23 @@ class Code
         "p" => {
           name: "p",
           description: "writes inspected values to output and returns nothing.",
-          examples: [
-            "p(:hello)",
-            "p(1, 2)",
-            "p([1, 2])"
-          ]
+          examples: ["p(:hello)", "p(1, 2)", "p([1, 2])"]
         },
         "print" => {
           name: "print",
           description: "writes values to output without adding a newline.",
-          examples: [
-            "print(:hello)",
-            "print(1, 2)",
-            "print(\"hello\")"
-          ]
+          examples: ["print(:hello)", "print(1, 2)", "print(\"hello\")"]
         },
         "puts" => {
           name: "puts",
-          description: "writes values to output with newlines and returns nothing.",
-          examples: [
-            "puts(:hello)",
-            "puts(1, 2)",
-            "puts(\"hello\")"
-          ]
+          description:
+            "writes values to output with newlines and returns nothing.",
+          examples: ["puts(:hello)", "puts(1, 2)", "puts(\"hello\")"]
         },
         "read" => {
           name: "read",
           description: "reads one line from input.",
-          examples: [
-            "read",
-            "name = read",
-            "read.to_string"
-          ]
+          examples: ["read", "name = read", "read.to_string"]
         },
         "redo" => {
           name: "redo",
@@ -459,7 +371,8 @@ class Code
         },
         "return" => {
           name: "return",
-          description: "exits the current function and returns an optional value.",
+          description:
+            "exits the current function and returns an optional value.",
           examples: [
             "() => { return }",
             "() => { return 1 }",

data/lib/code/object/html.rb

@@ -51,7 +51,8 @@ class Code
         },
         "raw" => {
           name: "raw",
-          description: "parses markup into an html fragment without escaping text.",
+          description:
+            "parses markup into an html fragment without escaping text.",
           examples: [
             "Html.raw(\"<strong>hello</strong>\")",
             "Html.raw(Html.text(:hello))",
@@ -80,7 +81,8 @@ class Code
         },
         "map" => {
           name: "map",
-          description: "returns a list by calling a function for each html node.",
+          description:
+            "returns a list by calling a function for each html node.",
           examples: [
             "Html.raw(\"<p>a</p><p>b</p>\").css(\"p\").map((node) => { node.to_string })",
             "Html.raw(\"<p>a</p>\").css(:p).map((node, index) => { index })",

data/lib/code/object/http.rb

@@ -5,7 +5,8 @@ class Code
     class Http < Object
       CLASS_DOCUMENTATION = {
         name: "Http",
-        description: "sends http requests and returns dictionaries with request and response details.",
+        description:
+          "sends http requests and returns dictionaries with request and response details.",
         examples: [
           "Http.get(\"http://httpbin.org/status/200\").success?",
           "Http.post(\"http://httpbin.org/status/200\", body: :hello).request.body",
@@ -15,7 +16,8 @@ class Code
       CLASS_FUNCTIONS = {
         "get" => {
           name: "get",
-          description: "sends a get request and returns the response dictionary.",
+          description:
+            "sends a get request and returns the response dictionary.",
           examples: [
             "Http.get(\"http://httpbin.org/status/200\").code",
             "Http.get(\"http://httpbin.org/status/200\", query: { q: :ruby }).url",
@@ -24,7 +26,8 @@ class Code
         },
         "head" => {
           name: "head",
-          description: "sends a head request and returns the response dictionary.",
+          description:
+            "sends a head request and returns the response dictionary.",
           examples: [
             "Http.head(\"http://httpbin.org/status/200\").code",
             "Http.head(\"http://httpbin.org/status/204\").status",
@@ -33,7 +36,8 @@ class Code
         },
         "post" => {
           name: "post",
-          description: "sends a post request with optional body, form data, and headers.",
+          description:
+            "sends a post request with optional body, form data, and headers.",
           examples: [
             "Http.post(\"http://httpbin.org/status/200\", body: :hello).request.body",
             "Http.post(\"http://httpbin.org/status/200\", data: { a: 1 }).success?",
@@ -51,7 +55,8 @@ class Code
         },
         "delete" => {
           name: "delete",
-          description: "sends a delete request and returns the response dictionary.",
+          description:
+            "sends a delete request and returns the response dictionary.",
           examples: [
             "Http.delete(\"http://httpbin.org/status/200\").success?",
             "Http.delete(\"http://httpbin.org/status/200\", body: :hello).request.body",
@@ -60,7 +65,8 @@ class Code
         },
         "options" => {
           name: "options",
-          description: "sends an options request and returns the response dictionary.",
+          description:
+            "sends an options request and returns the response dictionary.",
           examples: [
             "Http.options(\"http://httpbin.org/status/200\").method",
             "Http.options(\"http://httpbin.org/status/204\").code",
@@ -69,7 +75,8 @@ class Code
         },
         "trace" => {
           name: "trace",
-          description: "sends a trace request and returns the response dictionary.",
+          description:
+            "sends a trace request and returns the response dictionary.",
           examples: [
             "Http.trace(\"http://httpbin.org/status/200\").method",
             "Http.trace(\"http://httpbin.org/status/204\").code",
@@ -288,7 +295,9 @@ class Code
         validate_payload_size!(password, label: "http password")
         validate_payload_size!(query, label: "http query")
         validate_payload_size!(body, label: "http request body")
-        validate_payload_size!(data.as_json.to_query, label: "http form data") if data.present?
+        if data.present?
+          validate_payload_size!(data.as_json.to_query, label: "http form data")
+        end
 
         url = original_url
         url = "#{url}?#{query}" if query.present?
@@ -307,12 +316,9 @@ class Code
         http.ipaddr = resolved_ip
         http.use_ssl = true if uri.scheme == "https"
         default_timeout = http_timeout(timeout, DEFAULT_TIMEOUT)
-        open_timeout_value =
-          http_timeout(open_timeout, default_timeout)
-        read_timeout_value =
-          http_timeout(read_timeout, default_timeout)
-        write_timeout_value =
-          http_timeout(write_timeout, default_timeout)
+        open_timeout_value = http_timeout(open_timeout, default_timeout)
+        read_timeout_value = http_timeout(read_timeout, default_timeout)
+        write_timeout_value = http_timeout(write_timeout, default_timeout)
 
         http.open_timeout = open_timeout_value if open_timeout_value
         http.read_timeout = read_timeout_value if read_timeout_value
@@ -383,27 +389,26 @@ class Code
         else
           status = STATUS_CODES.key(code) || :ok
           response_headers = response.each_header.to_h
-          request_headers = request.to_hash.transform_values do |values|
-            List.new(values)
-          end
+          request_headers =
+            request.to_hash.transform_values { |values| List.new(values) }
           body = response_body.to_s
 
           Dictionary.new(
-            code: code,
-            status: status,
-            body: body,
-            headers: response_headers,
-            method: verb,
-            url: url,
+            :code => code,
+            :status => status,
+            :body => body,
+            :headers => response_headers,
+            :method => verb,
+            :url => url,
             "success?" => code.between?(200, 299),
             "redirect?" => code.between?(300, 399),
-            request: {
+            :request => {
               method: verb,
               url: url,
               headers: request_headers,
               body: request.body.to_s
             },
-            response: {
+            :response => {
               code: code,
               status: status,
               headers: response_headers,
@@ -421,7 +426,8 @@ class Code
 
       def self.same_origin?(new_uri, original_uri)
         new_uri.scheme == original_uri.scheme &&
-          new_uri.hostname.to_s.downcase == original_uri.hostname.to_s.downcase &&
+          new_uri.hostname.to_s.downcase ==
+            original_uri.hostname.to_s.downcase &&
           new_uri.port == original_uri.port
       end
 

data/lib/code/object/ics.rb

@@ -5,7 +5,8 @@ class Code
     class Ics < Object
       CLASS_DOCUMENTATION = {
         name: "Ics",
-        description: "parses icalendar text and exposes events as dictionaries.",
+        description:
+          "parses icalendar text and exposes events as dictionaries.",
         examples: [
           "Ics.parse(\"BEGIN:VCALENDAR\\nBEGIN:VEVENT\\nSUMMARY:meet\\nEND:VEVENT\\nEND:VCALENDAR\")",
           "Ics.parse(\"BEGIN:VCALENDAR\\nVERSION:2.0\\nEND:VCALENDAR\")",