রুবি টেমপ্লেট ইন্টারপ্রেটার তৈরি: লেক্সার থেকে এক্সিকিউশন পর্যন্ত

আমরা আশা করি আপনার স্ট্রুপওয়াফেলগুলো কফির উপরে গরম করা হয়েছে কারণ আজ আমরা জিনিসপত্র গিঁটানো করব চিপচিপে স্ট্রুপ দিয়ে (সিরপ যেটি স্ট্রুপওয়াফেলের দুটি আধাকে একসাথে আটকে রাখে)। আমাদের সিরিজের প্রথম দুটি পর্বে, আমরা একটি লেক্সার এবং একটি পার্সার বানিয়েছিলাম এবং এখন, আমরা ইন্টারপ্রেটার যোগ করছি এবং জিনিসপত্র একসাথে গিঁটাচ্ছি স্ট্রুপ ঢেলে দিয়ে।

উপকরণ

ঠিক আছে! রান্নাঘর প্রস্তুত করি বেকিং-এর জন্য এবং টেবিলে আমাদের উপকরণ রাখি। আমাদের ইন্টারপ্রেটার দুটি উপকরণ বা ইনফরমেশন পিস نیاز তার কাজ করার জন্য: পূর্বে জেনারেট করা অ্যাবস্ট্র্যাক্ট সিনট্যাক্স ট্রি (AST) এবং ডেটা যা আমরা টেমপ্লেটে এম্বেড করতে চাই। আমরা এই ডেটাকে environment বলব। AST ট্রাভার্স করার জন্য, আমরা ভিজিটর প্যাটার্ন ব্যবহার করে ইন্টারপ্রেটার ইমপ্লিমেন্ট করব। একটি ভিজিটর (অতএব আমাদের ইন্টারপ্রেটার) একটি জেনেরিক visit মেথড ইমপ্লিমেন্ট করে যা একটি নোড প্যারামিটার হিসেবে নেয়, সেটি প্রসেস করে এবং সম্ভবত visit মেথড আবার কল করে নোডের কিছু (বা সব) চাইল্ড নোডের সাথে, কারেন্ট নোডের জন্য যা সেঞ্জিবল।

module Magicbars class Interpreter attr_reader :root, :environment def self.render(root, environment = {}) new(root, environment).render end def initialize(root, environment = {}) @root = root @environment = environment end def render visit(root) end def visit(node) # Process node end end end

module Magicbars def self.render(template, environment = {}) tokens = Lexer.tokenize(template) ast = Parser.parse(tokens) Interpreter.render(ast, environment) end end

Magicbars.render('Welcome to {{name}}', name: 'Ruby Magic') # => nil

module Magicbars class Interpreter # ... def visit(node) short_name = node.class.to_s.split('::').last send("visit_#{short_name}", node) end end end

module Magicbars class Interpreter # ... def visit_Template(node) # Process template nodes end def visit_Content(node) # Process content nodes end def visit_Expression(node) # Process expression nodes end def visit_Identifier(node) # Process identifier nodes end end end

def visit_Template(node) node.statements.map { |statement| visit(statement) }.join end

def visit_Content(node) node.content end

def visit_Expression(node) key = visit(node.identifier) environment.fetch(key, '') end

def visit_Identifier(node) node.value end

Magicbars.render('Welcome to {{name}}', name: 'Ruby Magic') # => Welcome to Ruby Magic

ব্লক এক্সপ্রেশন ইন্টারপ্রেট করা

আমরা একটি সিম্পল gsub যা করতে পারত তার জন্য অনেক কোড লিখলাম। তাই একটি বেশি কমপ্লেক্স উদাহরণে যাই।

Welcome to {{name}}! {{#if subscribed}} Thank you for subscribing to our mailing list. {{else}} Please sign up for our mailing list to be notified about new articles! {{/if}} Your friends at {{company_name}}

def visit_BlockExpression(node) key = visit(node.identifier) if environment[key] node.statements.map { |statement| visit(statement) }.join else node.inverse_statements.map { |statement| visit(statement) }.join end end

def visit_Array(nodes) nodes.map { |node| visit(node) } end

def visit_Template(node) visit(node.statements).join end def visit_BlockExpression(node) key = visit(node.identifier) if environment[key] visit(node.statements).join else visit(node.inverse_statements).join end end

Magicbars.render(template, { name: 'Ruby Magic', subscribed: true, company_name: 'AppSignal' }) # => Welcome to Ruby Magic! # # # Please sign up for our mailing list to be notified about new articles! # # # Your friends at AppSignal

হেল্পার মেথড সাপোর্ট যোগ করা

টেমপ্লেটে ফিরে দেখলে, আমরা লক্ষ্য করি ব্লক এক্সপ্রেশনে একটি if আছে। subscribed-এর ভ্যালু এনভায়রনমেন্টে লুকআপ করার বদলে, visit_BlockExpression if-এর ভ্যালু লুকআপ করছে। যেহেতু এনভায়রনমেন্টে সেটি নেই, কলটি nil রিটার্ন করে, যা ফলস। আমরা এখানে রুকতে পারি এবং ডিক্লেয়ার করতে পারি যে আমরা হ্যান্ডেলবার্স নকল করে মুস্তাছে, এবং টেমপ্লেট থেকে if রিমুভ করে ডিজায়ার্ড রেজাল্ট পেতে পারি।

Welcome to {{name}}! {{#subscribed}} Thank you for subscribing to our mailing list. {{else}} Please sign up for our mailing list to be notified about new articles! {{/subscribed}} Your friends at {{company_name}}

def helpers @helpers ||= { reverse: ->(value) { value.to_s.reverse }, debug: ->(value) { value.class } } end

def visit_Expression(node) key = visit(node.identifier) if helper = helpers[key] arguments = visit(node.arguments).map { |k| environment[k] } return helper.call(*arguments) end environment[key] end

Magicbars.render('Welcome to {{reverse name}}', name: 'Ruby Magic') # => Welcome to cigaM ybuR Magicbars.render('Welcome to {{debug name}}', name: 'Ruby Magic') # => Welcome to String

def helpers @helpers ||= { if: ->(value, block:, inverse_block:) { value ? block.call : inverse_block.call }, unless: ->(value, block:, inverse_block:) { value ? inverse_block.call : block.call }, # ... } end 

def visit_BlockExpression(node) key = visit(node.identifier) if helper = helpers[key] arguments = visit(node.arguments).map { |k| environment[k] } return helper.call( *arguments, block: -> { visit(node.statements).join }, inverse_block: -> { visit(node.inverse_statements).join } ) end if environment[key] visit(node.statements).join else visit(node.inverse_statements).join end end

Magicbars.render(template, { name: 'Ruby Magic', subscribed: true, company_name: 'AppSignal' }) # => Welcome to Ruby Magic! # # # Thank you for subscribing to our mailing list. # # # Your friends at AppSignal

শুধু সারফেস ছুঁইয়েছি

এই তিন-পর্বের সিরিজে, আমরা একটি টেমপ্লেটিং ল্যাঙ্গুয়েজ তৈরি করার বেসিক কভার করেছি। এই কনসেপ্টগুলো ইন্টারপ্রেটেড প্রোগ্রামিং ল্যাঙ্গুয়েজ (যেন রুবি) তৈরি করতেও ব্যবহার করা যায়। স্বীকার করছি, আমরা কিছু জিনিস গ্লস ওভার করেছি (যেন প্রপার এরর হ্যান্ডলিং 🙀) এবং আজকের প্রোগ্রামিং ল্যাঙ্গুয়েজের আন্ডারপinnings-এর সারফেস মাত্র ছুঁইয়েছি। আমরা আশা করি আপনি সিরিজটি এনজয় করেছেন এবং আপনি যদি আরও চান, Ruby Magic লিস্ট সাবস্ক্রাইব করুন। আপনি যদি এখন স্ট্রুপওয়াফেলের জন্য भूখে থাকেন, আমাদের এক লাইন দিন এবং আমরা হয়তো আপনাকে সেগুলো দিয়ে ফুয়েল করতে পারি!