আপনার স্কুবা ডাইভিং সুইট पहনুন এবং আপনার স্টেনসিল প্যাক করুন, আমরা আজ টেমপ্লেটগুলোর মধ্যে ডুব করছি!

বেশিরাগ সফ্টওয়ার যা ওয়েব পেজ রেন্ডার করে বা ইমেইল জেনারেট করে, টেমপ্লেটিং ব্যবহার করে ভেরিয়েবল ডেটা টেক্সট ডকুমেন্টে এম্বেড করতে। ডকুমেন্টের মূল কাঠামো প্রায়শই একটি স্ট্যাটিক টেমপ্লেটে সেট আপ করা থাকে প্লেসহোল্ডারসহ ডেটার জন্য। ভেরিয়েবল ডেটা, যেন ইউজার নাম বা ওয়েব পেজ কন্টেন্ট, পেজ রেন্ডার করার সময় প্লেসহোল্ডারগুলো রিপ্লেস করে। আমাদের টেমপ্লেটিং-এ ডুবের জন্য, আমরা Mustache-এর একটি সাবসেট ইমপ্লিমেন্ট করব, একটি টেমপ্লেটিং ল্যাঙ্গুয়েজ যা অনেক প্রোগ্রামিং ল্যাঙ্গুয়েজে উপলব্ধ। এই épisোডে, আমরা টেমপ্লেটিং-এর বিভিন্ন পদ্ধতি ইনভেস্টিগেট করব। আমরা স্ট্রিং কনক্যাটেনেশন থেকে শুরু করব, এবং আমাদের নিজস্ব লেক্সার লিখে শেষ করব যাতে আরও কমপ্লেক্স টেমপ্লেট সম্ভব হয়।

নেটিভ স্ট্রিং ইন্টারপোলেশন ব্যবহার করা

একটি মিনিমাল উদাহরণ দিয়ে শুরু করি। আমাদের অ্যাপ্লিকেশনের একটি ওয়েলকাম মেসেজ প্রয়োজন যেটি একটি প্রজেক্ট নাম ইনক্লুড করে। এটি করার কুইকেস্ট পথ হলো রুবির বিল্ট-ইন স্ট্রিং ইন্টারপোলেশন ফিচার ব্যবহার করা।

name = "Ruby Magic" template = "Welcome to #{name}" # => Welcome to Ruby Magic

name = "Ruby Magic" template = "Welcome to %{name}" sprintf(template, name: name) # => "Welcome to Ruby Magic" template % { name: name } # => "Welcome to Ruby Magic"

টেমপ্লেটিং-এর Regexp পদ্ধতি

উপরের সমাধান কাজ করে, কিন্তু এটি ফুল-প্রুফ নয়, এবং এটি আমরা সাধারণত চাই তার চেয়ে বেশি ফাংশনালিটি এক্সপোজ করে। একটি উদাহরণ দেখি:

name = "Ruby Magic" template = "Welcome to %d" sprintf(template, name: name) # => TypeError (can't convert Hash into Integer)

name = "Ruby Magic" template = "Welcome to {{name}}" assigns = { "name" => name } template.gsub(/{{(\w+)}}/) { assigns[$1] } # => Welcome to Ruby Magic

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}}

একটি টেমপ্লেটিং ল্যাঙ্গুয়েজ বিল্ড করা

একটি টেমপ্লেটিং ল্যাঙ্গুয়েজ ইমপ্লিমেন্ট করা অন্যান্য প্রোগ্রামিং ল্যাঙ্গুয়েজ ইমপ্লিমেন্ট করার সাথে সাদৃশ্য। ঠিক একটি স্ক্রিপ্টিং ল্যাঙ্গুয়েজের মত, একটি টেমপ্লেট ল্যাঙ্গুয়েজকে তিনটি কম্পোনেন্ট প্রয়োজন: একটি লেক্সার, একটি পার্সার, এবং একটি ইন্টারপ্রেটার। আমরা এগুলো একে একে দেখব।

লেক্সার

প্রথম টাস্ক যা আমাদের ট্যাকল করতে হবে সেটি বলা হয় টোকেনাইজেশন, বা লেক্সিক্যাল অ্যানালিসিস। প্রক্রিয়াটি খুব সাদৃশ্য ন্যাচারাল ল্যাঙ্গুয়েজে ওয়ার্ড ক্যাটেগরি আইডেন্টিফাই করার সাথে। একটি উদাহরণ নিন Ruby is a lovely language। সেন্টেন্সটি পাঁচটি শব্দ দিয়ে গঠিত যেগুলো ভিন্ন ক্যাটেগরির। সেগুলোর ক্যাটেগরি আইডেন্টিফাই করতে, আপনি একটি ডিকশনারি নেবেন এবং প্রতিটি শব্দের ক্যাটেগরি লুকআপ করবেন, যার ফলে একটি লিস্ট আউটপুট হবে এরকম: Noun, Verb, Article, Adjective, Noun। ন্যাচারাল ল্যাঙ্গুয়েজ প্রসেসিং এগুলোকে "Parts of Speech" বলে। ফরম্যাল ল্যাঙ্গুয়েজে—যেন প্রোগ্রামিং ল্যাঙ্গুয়েজ— সেগুলোকে টোকেনস বলা হয়। একটি লেক্সার কাজ করে টেমপ্লেট পড়ে এবং টেক্সটের স্ট্রিমকে প্রতিটি ক্যাটেগরির জন্য একটি সেট রেগুলার এক্সপ্রেশন দিয়ে ম্যাচ করে একটি নির্দিষ্ট অর্ডারে। প্রথম যে ম্যাচ করে সেটি টোকেনের ক্যাটেগরি ডিফাইন করে এবং রিলেভেন্ট ডেটা আট্যাচ করে। এই ছোট থিওরির সাথে, চলুন আমাদের টেমপ্লেট ল্যাঙ্গুয়েজের জন্য একটি লেক্সার ইমপ্লিমেন্ট করি। জিনিসপত্র একটু সহজ করতে, আমরা StringScanner ব্যবহার করব strscan রিকোয়ার করে রুবির স্ট্যান্ডার্ড লাইব্রেরি থেকে। (বিবিএ, আমাদের কাছে StringScanner-এ একটি চমৎকার ইন্ট্রো আছে আমাদের একটা পূর্ববর্তী এডিশনে।) প্রথম ধাপ হিসেবে, চলুন একটি মিনিমাল ভার্সন বানাই যা সব কিছু CONTENT-এ আইডেন্টিফাই করে। আমরা এটি করি একটি নতুন StringScanner ইনস্ট্যান্স তৈরি করে এবং সেটিকে এর কাজ করার দিয়ে একটি until লুপ দিয়ে যেটি শুধু থামবে যখন স্ক্যানার স্ট্রিং-এর শেষে পৌঁছাবে। এখন, আমরা শুধু এটিকে প্রতিটি ক্যারেক্টার ম্যাচ করতে দিই (.*) মাল্টিপল লাইনের ওপর ( m মডিফায়ার) এবং এর জন্য একটা CONTENT টোকেন রিটার্ন করি। আমরা একটি টোকেন রিপ্রেজেন্ট করি একটি অ্যারে দিয়ে যেটির প্রথম এলিমেন্ট টোকেন নাম এবং সেকেন্ড এলিমেন্ট যেকোনো ডেটা। আমাদের খুব বেসিক লেক্সার এরকম দেখে:

require 'strscan' module Magicbars class Lexer def self.tokenize(code) new.tokenize(code) end def tokenize(code) scanner = StringScanner.new(code) tokens = [] until scanner.eos? tokens << [:CONTENT, scanner.scan(/.*?/m)] end tokens end end end

Magicbars::Lexer.tokenize("Welcome to {{name}}") => [[:CONTENT, "Welcome to {{name}}"]]

until scanner.eos? if scanner.scan(/{{/) tokens << [:OPEN_EXPRESSION] elsif scanner.scan(/}}/) tokens << [:CLOSE] elsif scanner.scan(/.*?/m) tokens << [:CONTENT, scanner.matched] end end

until scanner.eos? if scanner.scan(/{{/) tokens << [:OPEN_EXPRESSION] elsif scanner.scan(/}}/) tokens << [:CLOSE] elsif scanner.scan_until(/.*?(?={{|}})/m) tokens << [:CONTENT, scanner.matched] end end

Magicbars::Lexer.tokenize("Welcome to {{name}}") => [[:CONTENT, "Welcome to "], [:OPEN_EXPRESSION], [:CONTENT, "name"], [:CLOSE]]

একটি স্টেট মেশিন

এটি করতে, আমরা লেক্সারকে একটি স্টেট মেশিনে রূপান্তর করি দুটি ভিন্ন স্টেটের সাথে। এটি default স্টেটে শুরু হয়। যখন এটি একটি OPEN_EXPRESSION টোকেন পায়, এটি expression স্টেটে মুভ করে এবং সেখানে থাকে যতক্ষণ না এটি একটি CLOSE টোকেন পায় যেটি এটিকে আবার default স্টেটে ট্রানজিশন করিয়ে দেয়। আমরা স্টেট মেশিন ইমপ্লিমেন্ট করি কিছু মেথড যোগ করে যেগুলো একটি অ্যারে ব্যবহার করে কারেন্ট স্টেট ম্যানেজ করতে।

def stack @stack ||= [] end def state stack.last || :default end def push_state(state) stack.push(state) end def pop_state stack.pop end

if state == :default if scanner.scan(/{{/) tokens << [:OPEN_EXPRESSION] push_state :expression elsif scanner.scan_until(/.*?(?={{)/m) tokens << [:CONTENT, scanner.matched] end elsif state == :expression if scanner.scan(/}}/) tokens << [:CLOSE] pop_state elsif scanner.scan(/[\w\-]+/) tokens << [:IDENTIFIER, scanner.matched] end end

Magicbars::Lexer.tokenize("Welcome to {{name}}") # => [[:CONTENT, "Welcome to "], [:OPEN_EXPRESSION], [:IDENTIFIER, "name"], [:CLOSE]]

আমাদের জন্য কঠিন করে নেওয়া

চলুন একটি আরও অ্যাডভান্সড উদাহরণে যাই। এই একটিতে একাধিক এক্সপ্রেশন, সেইসাথে একটি ব্লক আছে।

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}}

if state == :default if scanner.scan(/{{#/) tokens << [:OPEN_BLOCK] push_state :expression elsif scanner.scan(/{{\//) tokens << [:OPEN_END_BLOCK] push_state :expression elsif scanner.scan(/{{else/) tokens << [:OPEN_INVERSE] push_state :expression elsif scanner.scan(/{{/) tokens << [:OPEN_EXPRESSION] push_state :expression elsif scanner.scan_until(/.*?(?={{)/m) tokens << [:CONTENT, scanner.matched] else tokens << [:CONTENT, scanner.rest] scanner.terminate end elsif state == :expression if scanner.scan(/\s+/) # Ignore whitespace elsif scanner.scan(/}}/) tokens << [:CLOSE] pop_state elsif scanner.scan(/[\w\-]+/) tokens << [:IDENTIFIER, scanner.matched] else scanner.terminate end end

[ [:CONTENT, "Welcome to "], [:OPEN_EXPRESSION], [:IDENTIFIER, "name"], [:CLOSE], [:CONTENT, "!\n\n"], [:OPEN_BLOCK], [:IDENTIFIER, "if"], [:IDENTIFIER, "subscribed"], [:CLOSE], [:CONTENT, "\n Thank you for subscribing to our mailing list.\n"], [:OPEN_INVERSE], [:CLOSE], [:CONTENT, "\n Please sign up for our mailing list to be notified about new articles!\n"], [:OPEN_END_BLOCK], [:IDENTIFIER, "if"], [:CLOSE], [:CONTENT, "\n\nYour friends at "], [:OPEN_EXPRESSION], [:IDENTIFIER, "company_name"], [:CLOSE], [:CONTENT, "\n"] ]

আগামী পথ

আমরা আমাদের নিজস্ব টেমপ্লেটিং ল্যাঙ্গুয়েজের দিকে যাত্রা শুরু করলাম স্ট্রিং ইন্টারপোলেশন ব্যবহার করে বেসিক টেমপ্লেটিং সিস্টেম ইমপ্লিমেন্ট করার বিভিন্ন পদ্ধতি দেখে। যখন আমরা প্রথম অপ্রোচের লিমিট হিট করলাম, আমরা একটি প্রপার টেমপ্লেটিং সিস্টেম ইমপ্লিমেন্ট করা শুরু করলাম। এখনও, আমরা একটি লেক্সার ইমপ্লিমেন্ট করেছি যা টেমপ্লেট অ্যানালাইস করে এবং বিভিন্ন টাইপের টোকেন বের করে। RubyMagic-এর একটি আগামী এডিশনে, আমরা যাত্রা চালিয়ে যাব পার্সার এবং ইন্টারপ্রেটার ইমপ্লিমেন্ট করে ইন্টারপোলেটেড স্ট্রিং জেনারেট করতে।