From: duerst via ruby-core <ruby-core@...>
Date: 2023-05-04T04:03:10+00:00
Subject: [ruby-core:113402] [Ruby master Feature#19015] Language extension by a heredoc

Issue #19015 has been updated by duerst (Martin D�rst).





@pyromaniac I think the main problem would be how to handle namespacing. With single letters, the chance of collision is very high. How does Elixir handle this?



----------------------------------------

Feature #19015: Language extension by a heredoc

https://bugs.ruby-lang.org/issues/19015#change-102973



* Author: ko1 (Koichi Sasada)

* Status: Open

* Priority: Normal

----------------------------------------

This propose new heredoc extension with `<<!LANG` like



```ruby

doc = <<!LANG

  # description written in lang LANG

  foo bar

LANG

```



and it is translated to:



```ruby

doc = heredoc_extension_LANG(heredoc_text, binding)

```



## Example



```ruby

require 'erb'



def heredoc_extension_erb str, b

  ERB.new(str).run(b)

end



name = 'ko1'



html = <<!erb

<div>Hello <%= name %></div>

erb



puts html #=> <div>Hello ko1</div>

```



## Background / considerations



* Sometimes we write Ruby syntax string with `<<RUBY` and this proposal inspired by it.

* it is similar to shebang (`#!LANG` in shell)

* [Elixir's custom sigil](https://elixir-lang.org/getting-started/sigils.html) translates `~u(...)` translates to `sigil_u(...)`. This is why it translated to `heredoc_extension_LANG(...)` private method call.

* JavaScript has JSX but I don't think it is fit to the Ruby language.

* Heredoc is Ruby's chaos part and already confusing a lot. Additional chaos doesn't matter.

* `<<!foo` is valid syntax but now I don't think it is not used. gem codesearch doesn't find the usage.

* Sorry I couldn't wait 1st/Apr.



## Implementation



I attached the experimental implementation which only supports `erb` (because I couldn't find how to get delimiter to determine a method name :p).





---Files--------------------------------

heredoc_extension.patch (2.7 KB)





-- 

https://bugs.ruby-lang.org/

 ______________________________________________
 ruby-core mailing list -- ruby-core@ml.ruby-lang.org
 To unsubscribe send an email to ruby-core-leave@ml.ruby-lang.org
 ruby-core info -- https://ml.ruby-lang.org/mailman3/postorius/lists/ruby-core.ml.ruby-lang.org/