clasp - অ্যাপস স্ক্রিপ্ট CLI

1. ভূমিকা

অ্যাপস স্ক্রিপ্ট সিএলআই, অথবা clasp , এমন একটি টুল যা আপনাকে স্থানীয়ভাবে অ্যাপস স্ক্রিপ্ট প্রকল্প তৈরি, সম্পাদনা এবং স্থাপন করতে দেয়। এটি আপনাকে কমান্ড লাইন থেকে শিট, ডক্স, ফর্ম এবং স্লাইডের মতো পণ্যগুলির জন্য ওয়েব অ্যাপ এবং অ্যাড-অন তৈরি এবং প্রকাশ করতে দেয়। script.google.com ব্যবহার করে অথবা আপনার কম্পিউটারে স্থানীয়ভাবে অ্যাপস স্ক্রিপ্ট তৈরি করার দুটি উপায় রয়েছে। আমরা পরবর্তীটি শিখব, অ্যাপস স্ক্রিপ্টের জন্য কমান্ড লাইন টুল, clasp কীভাবে ব্যবহার করবেন।

ফিচার

  • ডেভেলপ লোকালি। clasp আপনাকে আপনার নিজের কম্পিউটারে কোড লিখতে এবং কাজ শেষ হয়ে গেলে অ্যাপস স্ক্রিপ্টে আপলোড করতে দেয়। আপনি বিদ্যমান অ্যাপস স্ক্রিপ্ট প্রকল্পগুলি ডাউনলোড করতে এবং তারপরে স্থানীয়ভাবে সম্পাদনা করতে পারেন। কোডটি স্থানীয় হয়ে গেলে, আপনি অ্যাপস স্ক্রিপ্ট প্রকল্পগুলিতে কাজ করার জন্য গিটের মতো আপনার প্রিয় ডেভেলপমেন্ট সরঞ্জামগুলি ব্যবহার করতে পারেন।
  • ডিপ্লয়মেন্ট ভার্সন পরিচালনা করুন । আপনার প্রকল্পের একাধিক ডিপ্লয়মেন্ট তৈরি করুন, আপডেট করুন এবং দেখুন।
  • স্ট্রাকচার কোড. clasp স্বয়ংক্রিয়ভাবে script.google.com-এ আপনার ফ্ল্যাট প্রজেক্টকে ফোল্ডারে রূপান্তর করে। উদাহরণস্বরূপ:
# On script.google.com:
├── tests/slides.gs
└── tests/sheets.gs

# Locally:
├── tests/
│   ├─ slides.gs
│   └─ sheets.gs

তুমি কি শিখবে

এই কোডল্যাবটি আপনাকে দেখাবে কিভাবে clasp দিয়ে ৩টি গুরুত্বপূর্ণ কাজ করতে হয়:

  • নতুন অ্যাপস স্ক্রিপ্ট প্রকল্প কীভাবে তৈরি করবেন
  • বিদ্যমান প্রকল্পগুলি কীভাবে ক্লোন, টান এবং পুশ করবেন
  • আপনার স্ক্রিপ্টের স্থাপনা কীভাবে পরিচালনা করবেন

2. শুরু করা

CLI ডাউনলোড করা হচ্ছে

Apps Script CLI ( clasp ) এর জন্য Node.js ইনস্টল করা প্রয়োজন। Node.js এখানে ইনস্টল করুন

একবার আপনার নোড হয়ে গেলে, বিশ্বব্যাপী CLI ইনস্টল করুন (উপনাম clasp ):

npm i @google/clasp -g

৩. অ্যাপস স্ক্রিপ্ট এপিআই সক্ষম করুন

Clasp ব্যবহার করার আগে, আপনাকে Apps Script IDE-তে Google Apps Script API সক্ষম করতে হবে।

৪. লগইন করুন

লগইন

চলো ক্ল্যাস্প চেষ্টা করে দেখি! তোমার মনে রাখা উচিত একমাত্র কমান্ড হল clasp

clasp

কমান্ড লাইন টুল ব্যবহার শুরু করার আগে, আমাদের লগ ইন করতে হবে। এই কমান্ডটি চালান:

clasp login

অথবা যদি SSH ব্যবহার করেন:

clasp login --no-localhost

এই মুহুর্তে, আপনাকে Google-এ লগ ইন করতে বলা হবে। CLI দিয়ে আপনার তৈরি যেকোনো প্রকল্প এই Google অ্যাকাউন্টের সাথে যুক্ত থাকবে।

৫. একটি নতুন প্রকল্প তৈরি করুন

একটি স্বতন্ত্র প্রকল্প তৈরি করুন

নিম্নলিখিত কমান্ড ব্যবহার করে একটি স্বতন্ত্র Google Apps Script প্রকল্প তৈরি করে শুরু করুন:

mkdir clasp_codelab;
cd clasp_codelab;
clasp create --title "Clasp Codelab"  --type standalone;

আপনি "clasp_codelab" ফোল্ডারে একটি অ্যাপস স্ক্রিপ্ট প্রজেক্ট তৈরি করেছেন!

(ঐচ্ছিক বিকল্প) একটি বিদ্যমান প্রকল্প ক্লোন করুন

গুগল স্লাইডস অ্যাড-অনের জন্য একটি কন্টেইনার-বাউন্ড স্ক্রিপ্ট তৈরি করার চেষ্টা করা যাক।

এটি করার জন্য, slides.google.com এ যান এবং একটি নতুন উপস্থাপনা তৈরি করুন। উপস্থাপনার নাম পরিবর্তন করে " clasp Codelab Test " করুন। স্লাইড মেনু বারে, এক্সটেনশন মেনুতে, " Apps Script " নির্বাচন করুন।

এটি script.google.com এ আপনার Apps Script প্রকল্পটি খুলবে।

আপনার প্রকল্পের জন্য একটি নতুন ডিরেক্টরি তৈরি করুন, এবং এতে cd

mkdir clasp_codelab_test
cd clasp_codelab_test

একটি প্রজেক্ট ক্লোন করার জন্য, আমাদের Script ID প্রয়োজন। আপনি /projects/ পরে অ্যাপস স্ক্রিপ্ট প্রজেক্ট URL-এ এই আইডিটি খুঁজে পেতে পারেন। মানটি কপি করুন এবং নিম্নলিখিত কমান্ডে পেস্ট করুন:

clasp clone <scriptID>

আউটপুটটি এইরকম দেখা উচিত...

অনুসরণ

এখন আপনি আপনার বর্তমান ডিরেক্টরিতে প্রকল্পটি ডাউনলোড করেছেন। Code.gs (একটি খালি ফাংশন) এর বিষয়বস্তু দেখতে আপনার প্রিয় সম্পাদক ব্যবহার করুন।

৬. ফাইল টানা এবং ঠেলে দেওয়া

script.google.com-এ কোড সম্পাদনা করুন

এখন যেহেতু আপনি একটি প্রজেক্ট ক্লোন করতে সক্ষম, আসুন শিখি কিভাবে ফাইল টানতে হয় এবং পুশ করতে হয়। আমরা আপনাকে script.google.com এর মাধ্যমে ক্লাউডে সম্পাদনা করার ধাপগুলি দেখাবো এবং আপনার কম্পিউটারে স্থানীয়ভাবে টেনে আনবো। আসুন ক্লাউডে স্ক্রিপ্টটি খুলি:

clasp open-script

এখন যেহেতু আমরা অনলাইন এডিটরে আছি, আমরা কিছু কোড অনলাইনে সম্পাদনা করব যা আমরা পরে clasp ব্যবহার করে আনব।

একটি নতুন অ্যাপস স্ক্রিপ্ট ফাইল তৈরি করতে, এডিটরের বাম দিকে Files এর পাশে, একটি ফাইল যোগ করুন এ ক্লিক করুন। একটি ফাইল যোগ করুন > স্ক্রিপ্টutils/strings নামটি লিখুন। নতুন তৈরি ফাইল, utils/strings.gs , এ কোডটি নিম্নলিখিতটি দিয়ে প্রতিস্থাপন করুন:

var world = "世界";

Code.gs এ, বিদ্যমান কোডটি নিম্নলিখিত কোড দিয়ে প্রতিস্থাপন করুন:

function hello() {
  Logger.log("Hello, " + world);
}

উপরে, সংরক্ষণ করুন এ ক্লিক করুন সংরক্ষণ করুন .

ফাংশনটি চালানোর জন্য, এডিটরের উপরে, ফাংশন ড্রপডাউন তালিকা থেকে hello নির্বাচন করুন এবং Run এ ক্লিক করুন।

এক্সিকিউশন লগের নীচে অভিবাদনটি প্রদর্শিত হবে।

স্থানীয়ভাবে কোড সম্পাদনা করুন

চলুন, আমরা শেষবার যেখানে প্রোজেক্টটি ক্লোন করেছিলাম সেই কমান্ড লাইনে ফিরে যাই। আপনি হয়তো লক্ষ্য করবেন যে আমাদের কোডটি এখন অনলাইন এডিটরের সাথে সিঙ্ক্রোনাইজড নয়। এটি ঠিক করার জন্য, আসুন আমাদের অনলাইন প্রোজেক্ট থেকে কোডটি বের করি।

clasp pull

এখন কোডে ফিরে যান। আপনার লক্ষ্য করা উচিত যে আমাদের ইউটিলিটির জন্য একটি ফোল্ডার রয়েছে। clasp CLI স্বয়ংক্রিয়ভাবে স্ল্যাশ অক্ষর / কে স্থানীয় ফাইল সিস্টেমের ফোল্ডারে রূপান্তর করে।

আপনার পছন্দের টেক্সট এডিটরে, util/strings.gs এ যান এবং world ভেরিয়েবলের নামটি mondo দিয়ে প্রতিস্থাপন করুন। এছাড়াও, world এর পরিবর্তে mondo দিয়ে Code.gs আপডেট করুন। script.google.com এ আপডেট করা কোডটি আপডেট করতে, আপনার সম্পাদিত কোডটি পুশ করুন।

clasp push

আর ব্যস! আপনার কোড এখন script.google.com এ আপডেট করা হয়েছে।

৭. সংস্করণ এবং স্থাপনা

clasp আপনাকে সংস্করণ এবং স্থাপনা পরিচালনা করতে দেয়। প্রথমে, কিছু শব্দভাণ্ডার:

  • সংস্করণ : একটি স্ক্রিপ্ট প্রকল্পের একটি "স্ন্যাপশট"। একটি সংস্করণকে স্থাপনার জন্য ব্যবহৃত একটি পঠনযোগ্য শাখা হিসাবে বিবেচনা করা যেতে পারে।
  • ডিপ্লয়মেন্ট : একটি স্ক্রিপ্ট প্রকল্পের প্রকাশিত সংস্করণ (প্রায়শই অ্যাড-অন বা ওয়েব অ্যাপ হিসেবে)। একটি সংস্করণ নম্বর প্রয়োজন।

আমাদের স্ক্রিপ্টের একটি সংস্করণ তৈরি করা যাক:

clasp create-version "First version"

[version] এর পরিবর্তে আমরা তৈরি করা লগ করা সংস্করণ স্ট্রিং ব্যবহার করে, আমরা স্ক্রিপ্টটি স্থাপন করতে পারি:

clasp create-deployment 1 "First deployment"

clasp deploy কমান্ড আপনার ম্যানিফেস্টটি দেখে এবং একটি নতুন সংস্করণযুক্ত ডিপ্লয়মেন্ট তৈরি করে। আপনার কোডটি এখন এক্সিকিউটেবল হিসাবে ডিপ্লয় করা হয়েছে। ডিপ্লয়মেন্ট গাইডে এই সম্পর্কে আরও জানুন।

৮. এই তো!

আমরা আশা করি অ্যাপস স্ক্রিপ্ট সিএলআই অ্যাপস স্ক্রিপ্ট প্রকল্পগুলি পরিচালনা করতে আপনাকে সাহায্য করার জন্য একটি সহজ হাতিয়ার।

আমরা যা কভার করেছি

  • নতুন অ্যাপস স্ক্রিপ্ট প্রকল্প কীভাবে তৈরি করবেন
  • বিদ্যমান প্রকল্পগুলি কীভাবে ক্লোন, পুশ এবং টানবেন
  • আপনার স্ক্রিপ্টের স্থাপনা কীভাবে পরিচালনা করবেন

Clasp GitHub- এ উপলব্ধ এবং নতুন বৈশিষ্ট্য এবং প্যাচগুলিতে স্বাগত।

তুমি কী বানাও তা দেখার জন্য আমরা অধীর আগ্রহে অপেক্ষা করছি!