ምዕራፍ 3 በአብዛኛው የማይለዋወጡ ገጾች

3.2.1 የመነጩ ቛሚ ገጾች

የቛሚ ገጾች ስራን ለመጀመር፣ በመጀመሪያ በምዕራፍ 2 ላይ መወጣጫን ለማመንጨት የተጠቀምንበትን፣ የሬይልስ የ‘አመንጪ (generate) ትእዛዝን በመጠቀም፣ አንድ መቆጣጠሪያን እናመነጫለን፡፡ ቛሚ ገጾችን ለማስተናገድ አንድ መቆጣጠሪያ ስለምንሰራ Quami Getss Controller ብለን እንጠራዋለን፤ ይህ ቋሚገጾችም (QuamiGetss) ቅርጸ-ግመል (CamelCase) ተብሎ በሚጠራው የአጻጻፍ ዘዴ የተዘጋጀ ስም ነው (ለበለጠ መረጃ በምስል 3.3 ላይ የተሰጠውን ስእላዊ መግለጫ ተመልከቱ)። በተጨማሪም በንዑስ ፊደላት የተዘጋጁ፣ ሶስት ተግባሮችን አብረን እናካትታለን፣ እነሱም:- ለመነሻ ገጹ የ‘መነሻ (menesha) ተግባር፣ ለእርዳታ ገጹ የ‘እርዳታ (erdata) ተግባር እና ለስለኛ ገጹ ደግሞ የ‘ስለኛ (silegna) ተግባር ይሆናሉ። የሬይልስ የ‘አመንጪ (generate) ትእዛዝ፣ አንድ የተግባሮች ዝርዝር አማራጪን ይወስዳል፤ ስለዚህ የመነሻ ገጽን እና የእርዳታ ገጽ ተግባሮችን ለመስራት፣ እነሱን በማዘዥያ መስመሩ ላይ በቀጥታ እናካትት እና ስለኛ ገጽን ግን ሆን ብለን እንተወዋለን፤ ስለሆነም በክፍል 3.3 ላይ እሱን እንዴት አድርገን ማካተት እንደምንችል ለማየት ይረዳናል። የቋሚ ገጾች መቆጣጠሪያውን የሚያመነጨው ትእዛዝ፣ በዝርዝር 3.7 ላይ ተመልክቷል።

$ rails generate controller QuamiGetss menesha erdata
      create  app/controllers/quami_getss_controller.rb
       route  get 'quami_getss/menesha'
get 'quami_getss/erdata'
      invoke  erb
      create    app/views/quami_getss
      create    app/views/quami_getss/menesha.html.erb
      create    app/views/quami_getss/erdata.html.erb
      invoke  test_unit
      create    test/controllers/quami_getss_controller_test.rb
      invoke  helper
      create    app/helpers/quami_getss_helper.rb
      invoke    test_unit
      invoke  assets
      invoke    scss
      create      app/assets/stylesheets/quami_getss.scss

በነገራችን ላይ ሬይልስ አ (rails g) የ‘ሬይልስ አመንጪ (rails generate) አቋራጪ እንደሆነ ማወቁ አስፈላጊ ነው፤ ይህም በሬይልስ ከተደገፉት ብዙ አቋራጮች ውስጥ አንዱ ነው (ሰንጠረዥ 3.1)። ነገሮችን ግልጽ ለማድረግ፣ ይህ ስልጠና ሁልጊዜ ሙሉውን ትእዛዝ ይጠቀማል፤ ነገር ግን አብዛኞቹ የሬይልስ አበልጻጊወች በግላቸው በሚሰሩበት ጊዜ፣ በሰንጠረዥ 3.1⁷ ውስጥ ከሚታዩት አቋራጮች መካከል አንዱን ወይም ከዚያ በላይ ይጠቀማሉ።

ምስል 3.3: ቅርጸ ግመል እና ቅርጸ እባብ የተባሉትን የአጻጻፍ ስልቶች የሚያሳይ ስእላዊ መግለጫ።

ከመቀጠላችን በፊት፣ ጊትን እየተጠቀማችሁ ከሆነ፣ የቋሚ ገጾች መቆጣጠሪያውን ወደ ሩቁ ማከማቻ ማከሉ አንድ ጥሩ ሃሳብ ነው፡-

$ git add -A
$ git commit -m "አንድ የቋሚ ገጾች መቆጣጠሪያ ማከል"
$ git push -u origin  ቛሚ-ገጾች

የመጨረሻው ትእዛዝ የ‘ ቛሚ-ገጾች ርዕስ ቅርንጫፍን ወደ ጊትሃብ ለመግፋት ያመቻቻል፡፡ ከዚያ በኋላ ለሚደረጉ ተከታታይ ግፊቶች ሌሎች ነጋሪአሴቶቻቸውን በመተው፣ ይህንን የመሰለ አጪር ትእዛዝ መጻፍ ይችላል፡-

$ git push

ከላይ ያሉት የማቀላቀል እና የመግፋት ቅደም ተከተሎች፣ በእለተለት የብልጸጋ ስራየ ላይ የምከተላቸውን ዓይነት ልማዳዊ የአሰራር ንድፍን ያሳያሉ፤ ነገር ግን ከአሁን በኋላ እንደዚህ ዓይነት ልማዳዊ እና የበለጸገ የማቀላቀል ስልት መጠቀሙን አቆመዋለሁ። (ይህን ስልጠና በምትከታተሉበት ጊዜ የሚመከረው በእያንዳንዱ ክፍል መጨረሻ ላይ፣ አንድ የጊት ማቀላቀልን እንዳታደርጉ ነው።)

በዝርዝር 3.7 ውስጥ የመቆጣጠሪያውን ስም አንድ የቅርጸ-ግመል የአጻጻፍ ስልትን በመጠቀም እንደጻፍን አስተውሉ (እንዲህ ተብሎ የተጠራበት ምክንያት፣ የአጻጻፍ ስልቱ የሞንጎልያ ግመል ሻኛን ስለሚመስል ነው።) ይህም ቅርጸ-እባብ (Snake Case) ተብሎ በሚጠራው የአጻጻፍ ስልት የተጻፈ አንድ የመቆጣጠሪያ ፋይል እንዲፈጠር ያደርጋል። ስለዚህ QuamiGetss የተባለ መቆጣጠሪያ አንድ ቋሚ_ገጾች_መቆጣጠሪያ.አርቢ (quami_getss_controller.rb) የተባለ ፋይል እንዲፈጠር ያደርጋል ማለት ነው። ይህ አንድ የተለመደ አሰራር ስለሆነ ነው እንጅ፣ በእርግጥም በማዘዥያ መስመር ላይ ቅርጸ-እባብን እንዲህ አድርገን ብንጠቀምም አንድ ዓይነት ውጤትን ይሰጠናል (ምስል 3.3):-

$ rails generate controller quami_getss ...

ይህ ትእዛዝም አንድ ቋሚ_ገጾች_መቆጣጠሪያ.አርቢ (quami_getss_controller.rb) የተባለ መቆጣጠሪያን ያመነጫል። ሩቢ የክፍል ስሞችን ለመሰየም ቅርጸ-ግመልን ስለሚጠቀም (ክፍል 4.4) የኔም ምርጫ እንደዛው ቅርጸ-ግመልን በመጠቀም መቆጣጠሪያወችን መሰየም ነው፤ ነገር ግን ይሄ የምርጫ ጉዳይ ነው። (የሩቢ ፋይል ስሞች ቅርጸ-እባብን ብቻ ስለሚጠቀሙ፣ የሬይልስ ኮድ ማመንጫ ኮዱን በሚያመነጪበት ጊዜ፣ በቅርጸ-ግመል የተጻፈውን ጽሑፍ የ‘ታች-ሰረዝ (underscore) ዘዴን በመጠቀም ወደ ቅርጸ-እባብ ይቀይረዋል።)

በነገራችን ላይ የሆነ ኮድን በምታመነጩበት ጊዜ፣ አንድ ስህተት ብትፈጽሙ፣ ሂደቱን እንዴት መቀልበስ እንደምትችሉ ማወቁ ጠቃሚ ነው፡፡ በሬይልስ ውስጥ ነገሮችን እንዴት መቀልበስ እንደሚቻል የሚያሳዩ አንዳንድ ስልቶችን በሳጥን 3.1 ላይ ተመልከቱ፡፡

  $ rails generate controller QuamiGetss menesha erdata
  $ rails destroy  controller QuamiGetss menesha erdata

  $ rails generate model User name:string email:string

  $ rails destroy model User

  $ rails db:migrate

  $ rails db:rollback

  $ rails db:migrate VERSION=0

በዝርዝር 3.7 ውስጥ የመነጨው የቋሚ ገጾች መቆጣጠሪያ የማዘዋወርያ ፋይሉን (ማለት አዋቅር/ማዘዋወርያወች/አርቢ‘ን (config/routes.rb)) በራስሰር ያዘምነዋል፣ ይህንን ፋይልም መጀመሪያ በክፍል 1.2.4 ውስጥ ለሰላምታ አፕልኬሽኑ (ዝርዝር 1.15) የስር ማዘዋወርያ ስናዘጋጅ ተመልክተነዋል፣ እና በቅርብ ጊዜም በዝርዝር 3.6 ውስጥ አይተነዋል። የማዘዋወርያዎች ፋይሉ፣ በዓ.አ.ሃ.አወች እና በድረ-ገጾች መካከል ያለውን ዝምድና የሚበይነውን ማዘዋወርያ፣ የመተግበር ሃላፊነት አለበት (በምስል 2.12 ውስጥ ተመልክቷል)። የማዘዋወርያዎቹ ፋይል በ‘አዋቅር (config) ማውጫ ውስጥ ይገኛል፣ ይህም ሬይልስ ለአፕልኬሽኑ ማዋቀሪያ የሚያስፈልገኡትን ፋይሎች የሚያስቀምጥበት ቦታ ነው (ምስል 3.4)።

ምስል 3.4: የማሳያ አፕልኬሽን የ‘አዋቅር (config) ማውጫ ይዞታዎች።

በዝርዝር 3.7 ውስጥ የ‘መነሻ (menesha) እና የ‘እርዳታ (erdata) ተግባሮችን ስላካተትን፣ በዝርዝር 3.8 ውስጥ እንደሚታየው፣ የማዘዋወርያዎች ፋይል ቀድሞውኑ ለእያንዳንዱ ማዘዋወሪያ አንድ ደንብን ይዟል።

Rails.application.routes.draw do
  get  'quami_getss/menesha'
  get  'quami_getss/erdata'
  root 'application#selamta'
end

ይሄ ደንብ:-

get 'quami_getss/menesha'

ቋሚ ገጾች መቆጣጠሪያ ውስጥ የ‘/ቋሚ_ገጾች/መነሻ (/quami_getss/menesha) ዓ.አ.ሃ.አ መጠይቆችን ለ‘መነሻ (menesha) ተግባር ያመላክታል። በተጨማሪም፣ እኛ ማዛወርያውን አንድ የ‘ዓግኝ (GET) መጠይቅን እንዲመልስ የ‘አግኝ (get) ተግባርን በመጠቀም እናዘጋጅዋለን፣ ይህም በሃይለ ጽሑፍ ማዘዋወሪያ ስምምነት ከሚደገፉት መሰረታዊ የሃ.ጽ.ማ.ስ ግሶች (HTTP verbs) ውስጥ አንዱ ነው (ሳጥን 3.2)። በእኛ ሁኔታ ይህ ማለት ቋሚ ገጾች መቆጣጠሪያ ውስጥ አንድ የ‘መነሻ (menesha) ተግባርን ስናመነጪ በ‘/ቋሚ_ገጾች/መነሻ (/quami_getss/menesha) አድራሻ ላይ አንድ ገጽን በራስሰር እናገኛለን ማለት ነው። ውጤቱን ለማየት በክፍል 1.2.2 ውስጥ እንደተገለጸው፣ አንድ የሬይልስ ማበልጸጊያ የድር አገልጋይን አስጀምሩ:-

$ rails server

ከዚያ ወደ /ቋሚ_ገጾች/መነሻ (/quami_getss/menesha) ሂዱ (ምስል 3.5)።

ምስል 3.5: ጥሬው የመነሻ ገጽ ትይታ (/quami_getss/menesha)።

ይህ ገጽ ከየት እንደመጣ ለማወቅ፣ በአንድ የጽሑፍ አርታኢ ውስጥ፣ የቋሚ ገጾች መቆጣጠሪያን ማየት እንጀምር፤ ይህም በዝርዝር 3.9 ውስጥ ያለውን ይዞታ መምሰል ይኖርበታል። ከምዕራፍ 2 የመልመጃ አፕልኬሽን፣ የተጠቃሚወች እና የአጪርጽሑፎች መቆጣጠሪያወች በተለየ መልኩ፣ ይህ የቋሚ ገጾች መቆጣጠሪያ መደበኛ የው.ሁ.ማ ተግባሮችን እንደማይጠቀም አስተውላችሁ ይሆናል። ይህ ለቛሚ ገጾች አንድ የተለመደ ስብስብ ነው፤ ይህ ማለትም የው.ሁ.ማ መዋቅር ለማንኛውም ችግር ብቁ መፍትሔ አይደለም ማለት ነው።

class QuamiGetssController < ApplicationController
  def menesha
  end

  def erdata
  end
end

በዝርዝር 3.9 ውስጥ የ‘/ቋሚ_ገጾች_መቆጣጠሪያ.አርቢ (quami_getss_controller.rb) ፋይል ክፍል (class) በተባለ ቁልፍቃል፣ አንድ ክፍልን እንደበየነ እንመለከታለን፤ ክፍሉም ቋሚ_ገጾችመቆጣጠሪያ (QuamiGetssController) ይባላል። ክፍሎች የ‘መነሻ (menesha) እና የ‘እርዳታ (erdata) የመሳሰሉ ሥልቶችን (Functions) በቀላሉ ለማደራጀት አመቺ መንገዶች ናቸው (ሥልቶች (Functions) ዘዴወች (Methods) በመባልም ይታወቃሉ)። እነዚህ የሚበየኑትም በይን (def) የተባለ ቁልፍቃልን በመጠቀም ነው። በክፍል 2.3.4 ላይ እንደተገለጸው ይህ < የግራ ማዕዘን ቅንፍ ቋሚ_ገጾችመቆጣጠሪያ (QuamiGetssController) ከሬይልስ የ‘አፕልኬሽንመቆጣጠሪያ (ApplicationController) ክፍል እንደሚወርስ ያመለክታል፤ ይህ ማለት በቅርብ ጊዜ እንደምናየው፣ ገጾቻችን ብዛት ያላቸው ሬይልስ ተኮር ተግባራትን የሰነቁ ናቸው ማለት ነው። (በክፍል 4.4 ውስጥ ስለ ክፍሎች እና ውርሻ በደንብ እንማራለን።)

በቋሚ ገጾች መቆጣጠሪያ ጉዳይ ላይ፣ ሁለቱም ዘዴወች በመጀመሪያ ላይ ባዶ ናቸው:-

def menesha
end

def erdata
end

በጥሬው ሩቢ ውስጥ እነዚህ ዘዴወች ምንም ነገር አይሰሩም። በሬይልስ አሰራር ግን ሁኔታው የተለየ ነው፤ ቋሚገጾችመቆጣጠሪያ (QuamiGetssController) አንድ የሩቢ ክፍል ነው፤ ነገር ግን ከ‘አፕልኬሽንመቆጣጠሪያ (ApplicationController) ስለሚወርስ የዘዴወቹ ባህሪ ለሬይልስ የተለዩ ናቸው፤ የ‘/ቋሚ_ገጾች/መነሻ (/quami_getss/menesha) አድራሻን በምንጎበኝበት ጊዜ፣ ሬይልስ ቋሚ ገጾች መቆጣጠሪያ ላይ ይመለከት እና በ‘መነሻ (menesha) ተግባር ውስጥ ያለውን ኮድ ይፈጽማል፤ ከዚያም ከተግባሩ ጋር የሚጎዳኘውን ትይታ ያቀርባል፤ (በክፍል 1.2.3 ውስጥ እንደተመለከተው፣ “ት (V)” በ‘ቅ.ተ.መ (MVC) ውስጥ ያለውን የ “ት (V)” ተግባርን ያመለክታል)። በአሁኑ ጊዜ የ‘መነሻ (menesha) ተግባር ባዶ ነው፤ ስለዚህም /ቋሚ_ገጾች/መነሻ‘ን (/quami_getss/menesha) መጎብኘት የሚሰራው ነገር ቢኖር፣ ትይታውን ማሳየት ብቻ ነው። ታድያ ትይታው ምን ይመስላል? እንዴትስ እናገኘዋለን?

በዝርዝር 3.7 ላይ ያለውን ውጤት እንደገና ብትመለከቱ፣ በተግባሮች እና በማሳያወች መካከል ያለውን ጉድኝት ልትገምቱ ችላላችሁ። ለምሳሌ መነሻ‘ን (menesha) የመሰለ ተግባር አንድ መነሻ.ሃጽመቋ.ክሩ (menesha.html.erb) የተባለ ተጓዳኝ ትይታ አለው። .ኢአርቢ (.erb) የሚለው ክፍል ምን ማለት እንደሆነ፣ በክፍል 3.4 ውስጥ እንማረዋለን፤ .ሃጽመቋ (.html) የሚለው ክፍል ግን በመሰረቱ ሃ.ጽ.መ.ቋ ስለሚመስል ምናልባት አያስደንቃቹሁ ይሆናል (ዝርዝር 3.10)።

<h1>QuamiGetss#menesha</h1>
<p>Find me in app/views/quami_getss/menesha.html.erb</p>

የ‘እርዳታ (erdata) ተግባሩ ትይታም ተመሳሳይ ነው (ዝርዝር 3.11)።

<h1>QuamiGetss#erdata</h1>
<p>Find me in app/views/quami_getss/erdata.html.erb</p>

እነዚህ ሁለቱም ትይታወች የቦታ-መያዣዎች ናችው፡- አንድ በ‘ራስጌ1 (h1) መለያ ውስጥ የገባ የአብይ-ደረጃ አርእስት እና አንድ በ‘ፓ (p) መለያ ውስጥ የገባ፣ ወደ ተጓዳኙ ፋይል የሚወስድ ሙሉ መንገድን አካተዋል።

3.2.2 ብጁ ቛሚ ገጾች

ከክፍል 3.4 ጀምሮ አንዳንድ (በጣም በጥቂቱ) የሚለዋወጡ ይዞታዎችን የምንጨምርባቸው ቢሆንም፣ በዝርዝር 3.10 እና በዝርዝር 3.11 ውስጥ ያሉ ፋይሎች አሁን ባሉበት ሁኔታ ግን አንድ አስፈላጊ ነጥብን አጉልተው ያሳያሉ፤ እሱም የሬይልስ ትይታወች ንጹህ ቛሚ ሃ.ጽ.መ.ቋን እንደሚይዙ ነው። ይህ ማለትም የሬይልስ ዕውቀት ሳይኖረን እንኳ የመነሻ እና የእርዳታ ገጾችን ልክ በዝርዝር 3.12 እና በዝርዝር 3.13 ላይ እንዳሉት አድርገን ገጾቹን ማበጀት መጀመር እንችላለን ማለት ነው።

<h1>ማሳያ አፕልኬሽን</h1>
<p>
  ይህ <a href="https://www.railstutorial.org/">
  የሩቢ ኦን ሬይልስ ስልጠና </a>
  ማሳያ ለተባለው አፕልኬሽን የመነሻ ገጽ ነው፡፡
</p>

<h1>እርዳታ</h1>
<p>
  በሩቢ ኦንሬይልስ ስልጠና ላይ እርዳታን ለማግኘት
  <a href="https://www.railstutorial.org/help">የሩቢ ኦንሬይልስ ስልጠና እርዳታ ገጽን</a>
  ቃኙ። በዚህ የማሳያ አፕልኬሽን ላይ እርዳታን ለማግኘት
  <a href="https://www.railstutorial.org/book"><em>
  የሩቢ ኦንሬይልስ ስልጠና</em> መጽሐፍን</a> ተመልከቱ።
</p>

የዝርዝር 3.12 እና የዝርዝር 3.13 ውጤቶች በምስል 3.6 እና በምስል 3.7 ላይ ይታያሉ፡፡

ምስል 3.6: አንድ የተበጀ የመነሻ ገጽ።

ምስል 3.7: አንድ የተበጀ የእርዳታ ገጽ።

3.3.1 የመጀመሪያ ፈተናችን

አሁን አንድ ስለኛ የተባለ ገጽን ወደ አፕልኬሽናችን የምናክልበት ጊዜ ነው። ከዚህ በኋላ እንደምናየው፣ ፈተናው አጪር እና ቀላል ነው፤ ስለዚህም በሳጥን 3.3 ውስጥ ያሉ አመራሮችን በመከተል ፈተናውን በመጀመሪያ እንጽፋለን። ከዚያም የአፕልኬሽኑን ኮድ ለመጻፍ የሚወድቁትን ፈተናወች እንጠቀማን።

የመፈተን ስራን ለመጀመር ከባድ እና የሬይልስንም የሩቢንም ሰፊ ዕውቀት የሚጠየቅ ሊሆን ይችላል። በዚህ ገና በሆነ ጊዜም ፈተናወችን መጻፉ ተስፋ አስቆራጪ እና አስፈሪ ሊመስል ይችላል። እንደ አጋጣሚ ግን ሬይልስ ከባዱን ስራ ሰርቶልናል፤ ምክንያቱም ፈተናውን በቀጥታ እንድንጀምር የ‘ሬይልስ መቆጣጠርያ አመንጪ (rails generate controller) ትእዛዝን (ዝርዝር 3.7) ባካሄድንበት ወቅት አንድ የፈተና ፋይልን በራስሰር አመንጪቶልናል፡-

$ ls test/controllers/
quami_getss_controller_test.rb

እስቲ እንመልከተው፤ (በዝርዝር 3.14 ውስጥ ያለው ፈተና የአማርኛ ጽሑፍ እንደተጨመረበት ልትገነዘቡ ይገባል)።

require 'test_helper'

class QuamiGetssControllerTest < ActionDispatch::IntegrationTest

  test "should get menesha" do
    get quami_getss_menesha_url
    assert_response :success
  end

  test "should get erdata" do
    get quami_getss_erdata_url
    assert_response :success
  end
end

በዚህ ወቅት በዝርዝር 3.14 ውስጥ ያለውን አገባብ በዝርዝር መረዳቱ አስፈላጊ አይደለም፤ ነገር ግን በዝርዝር 3.7 ውስጥ በማዘዥያ መስመሩ ላይ፣ ላካተትናቸው ለእያንዳንዱ የመቆጣጠሪያ ተግባር፣ ሁለት ፈተናወዎች እንዳሉ ማየት ግን እንችላለን፡፡ እያንዳንዱ ፈተና በቀላሉ አንድ ዓ.አ.ሃ.አን ያገኛል፤ እናም ውጤቱ የተሳካ መሆኑን (በአንድ ማረጋገጫ (Assertion) በኩል) ያረጋግጣል። እዚህ ጋር የ‘አግኝ (get) ጥቅም ፈተናወቻችን የመነሻ እና የእርዳታ ገጾች የተለመዱ የድር ገጾች መሆናቸውን እንደሚጠብቅ ያመለክታል፤ ይህም የተደረሰው በአንድ የ‘ዓግኝ (GET) መጠይቅ ነው (ሳጥን 3.2)። የ‘አሳካ (:success) ምላሽ፣ የሃ.ጽ.ማ.ስ የስር ኮድ ሁኔታ አንድ የረቀቀ ውክልና ሲሆን፤ አሁን ባለበት ሁኔታ ደግሞ ትክክል (200 OK) ነው ማለት ነው፡፡ በሌላ አማርኛ ይህንን የመሰለ ፈተና:-

test "should get menesha" do
  get quami_getss_menesha_url
  assert_response :success
end

“አንድ የ‘ዓግኝ (GET) መጠይቅን በቋሚ ገጾች መነሻ (menesha) ዓ.አ.ሃ.አ ላይ በመስጠት፣ የመነሻ ገጽን እንፈትን እና ከዚያም ምላሹ ‘ተሳክቷል success’ የሚል የኮድ ሁኔታን እንደተቀበልን እናረጋግጥ” ይላል።

የፈተና ዑደታችንን ለመጀመር፣ ፈተናወቹ በአሁኑ ጊዜ ማለፋቸውን ለማረጋገጥ፣ የፈተና ስብስቡን ማካሄድ አለብን። ይህንንም የ‘ሬይልስ ፈትን (rails test) ትእዛዝን እንደሚከተለው አድርገን በመጠቀም ማከናወን እንችላለን:-

$ rails db:migrate     # በአንዳድ ስርዓቶች ላይ አስፈላጊ ሊሆን የሚችል
$ rails test
2 tests, 2 assertions, 0 failures, 0 errors, 0 skips

የማስጀመሪያ የፈተና ስብስባችን እንደተፈለገው አልፏል (አረንጓዴ)። (ግዴታዊ ያልሆነውን የሚኒቴስት (MiniTest) ዘጋቢዎችን ክፍል 3.6.1 ውስጥ ካልጨመራችሁ በስተቀር፣ ላለፉት ፈተናወች በአረንጓዴ የተጻፉ ፈተናወችን በሰሌዳችሁ ውስጥ ማየት አትችሉም። እነዚህ ቀለሞች ቀጥታዊ ትርጉም ባይሰጣቸውም፣ አንድ አፕልኬሽን በሚገነባበት ጊዜ አረንጓዴ እና ቀይ የሚባለው አጠራር፣ የራሱ የሆነ ትርጉም አለው። ስለሆነም በዚህ ዓውድ ውስጥ ቀይ ማለት የፈተናውን መውደቅ ሲገልጽ፤ አረንጓዴ ማለት ደግሞ የፈተናውን ማለፍ ይገልጻል ማለት ነው፡፡ ስለሆነም ካሁን በኋላ በቀሪው ክፍለ ጊዜ ይህንን አባባል እንጠቀማለን።) እዚህ ላይና በቀሪው የስልጠና ክፍለ ጊዜ ሁሉ፣ በጣም የሚጠቅሙትን ክፍሎች ብቻ አጉልቶ ለማሳየት ስል፣ በአጠቃላይ ከፈተና ውጽዓቱ ላይ የተወሰኑትን መስመሮች እንደምተዋቸው ልብ ልትሉ ይገባል።

በነገራችን ላይ፣ በአንዳንድ ስርዓቶች ላይ በ‘ውጎ (db) ማውጫ ውስጥ የሚመጡ እነዚህን የመሰሉ:-

/db/test.sqlite3-0

የመነጩ ፋይሎችን ልታዩ ትችላላችሁ። እነዚህ የመነጩ ፋይሎች ማከማቻው ላይ እንዳይታከሉ ለመከላከል፣ በዝርዝር 3.16 ላይ እንደሚታየው፣ እነሱን ችላ እንዲላቸው በ‘.ጊትችላበለው (.gitignore) ፋይል (ክፍል 1.3.1.2) ውስጥ አንድ ደንብን እንድታክሉ እመክራችኋለሁ፡፡

.
.
.
# Ignore db test files.
db/test.*

3.3.2 ቀይ

በሳጥን 3.3 ውስጥ እንደተገለጸው፣ ፈተና-መሬ ብልጸጋ የሚወድቀውን ፈተና በመጀመሪያ መጻፍ፣ ፈተናውን ለማሳለፍ የሚፈለገውን የአፕልኬሽን ኮድ መጻፍ እና ከዚያም አስፈላጊ ከሆነ ኮዱን ማጣራትን ያሳትፋል። አብዛኞቹ የመፈተኛ መሳሪያዎች የሚወድቁትን ፈተናወች በቀይ የሚያልፉትን ደግሞ በአረንጓዴ ቀለም ስለሚያመለክቱ ይህ ዑደት አንዳንድ ጊዜ “ቀይ፣ አረንጓዴ፣ ማጣራት” በመባል ይታወቃል። በዚህ ክፍል ውስጥ የመጀመሪያውን ዑደት እንጨርሳለን፤ ይህም አንድ የሚወድቅ ፈተናን በመጻፍ ቀይን ማግኘት ይሆናል። ከዚያም በክፍል 3.3.3 ውስጥ አረንጓዴ ቀለምን እናገኛለን፣ ከዚያም በክፍል 3.4.3 ውስጥ ኮዱን እናጣራለን። ⁹

የመጀመሪያው ሂደታችን ለ‘ስለኛ (Silegna) ገጽ አንድ የሚወድቅ ፈተናን መጻፍ ነው። የዝርዝር 3.14 ቅድን በመከተል ፈተናው ምን ዓይነት ፈተና መሆን እንዳለበት መገመት ትችላላችሁን? መልሱ በዝርዝር 3.17 ውስጥ ይታያል፡፡

require 'test_helper'

class QuamiGetssControllerTest < ActionDispatch::IntegrationTest

  test "መነሻ ገጽን ማግኘት አለበት" do
    get quami_getss_menesha_url
    assert_response :success
  end

  test "እርዳታ ገጽን ማግኘት አለበት" do
    get quami_getss_erdata_url
    assert_response :success
  end

  test "ስለኛ ገጽን ማግኘት አለበት" do
    get quami_getss_silegna_url
    assert_response :success
  end
end

በዝርዝር 3.17 ውስጥ በቢጫ ቀለም የተቀቡት መስመሮች ላይ የስለኛ ገጽ፣ “silegna” የሚለው ቃል በ “menesha” ወይም “erdata” ቦታ ከመተካቱ በስተቀር ከሁለቱም ፈተናወች ጋር አንድ ዓይነት እንደሆነ እንመለከታለን። (ዝርዝር 3.17 የፈተናውን ገለጣ ከእንግሊዝኛ ይልቅ ወደ አማርኛ እንደቀየረው ልብበሉ።)

እንደተፈለገው፣ ፈተናው መጀመሪያ ላይ ይወድቃል፡-

$ rails test
3 tests, 2 assertions, 0 failures, 1 errors, 0 skips

3.3.3 አረንጓዴ

አሁን አንድ የወደቀ ፈተና ስላለን (ቀይ) ወደሚያልፈው ፈተና (አረንጓዴ) እንዲመራን፣ የወደቁት ፈተናወች የሰጡንን የስህተት መልእክቶች እንጠቀማለን፣ በነሱ በመመራትም አንድ የሚሰራ የስለኛ ገጽን እንተገብራለን።

የወደቀው ፈተና የስህተት መልእክት ውጤት ውጽዓትን፣ በመመርመር መጀመር እንችላለን፡-

$ rails test
NameError: undefined local variable or method `quami_getss_silegna_url'

እዚህ ያለው የስህተት መልእክት እንደሚለው፣ የስለኛ ገጽ ዓ.አ.ሃ.አ በሬይልስ ኮድ ውስጥ አልተሰየመም ይላል፣ ይህም ራውትስ በተባለው ፋይል ውስጥ አንድ መስመር ኮድ መጨመር እንዳለብን አንድ ፍንጪ እየሰጠን ነው። በዝርዝር 3.20 ላይ እንደሚታየው፣ በዝርዝር 3.8 ውስጥ ያለውን ጥለት በመከተል ይህንን ማከናወን እንችላለን፡፡

Rails.application.routes.draw do
  get  'quami_getss/menesha'
  get  'quami_getss/erdata'
  get  'quami_getss/silegna'
  root 'application#selamta'
end

በዝርዝር 3.20 ውስጥ በቢጫ ቀለም የተቀባው መስመር ሬይልስን፣ በቋሚ ገጾች መቆጣጠሪያ ውስጥ ላለው የ‘ስለኛ (silegna) ተግባር፣ ለ‘/ቋሚ_ገጾች/ስለኛ (/quami_getss/silegna) ዓ.አ.ሃ.አ አንድ የ‘ዓግኝ (GET) መጠይቅን እንዲያዘዋውር ይነግረዋል።

ይህ:-

quami_getss_silegna_url

ተብሎ የሚጠራ አንድ ረጅን በራስሰር ይፈጥራል።

የፈተና ስብስቡን በድጋሜ በማስኬድ አሁንም ፈተናው ቀይእንደሆነ እናያለን፤ ነገር ግን አሁን የስህተት መልእክቱ ተለውጧል፡-

$ rails test
AbstractController::ActionNotFound:
The action 'silegna' could not be found for QuamiGetssController

የስህተት መልእክቱ አሁን በቋሚ ገጾች መቆጣጠሪያ ውስጥ የሌለውን አንድ የ‘ስለኛ (silegna) ተግባርን ያመለክታል፣ ይህንንም በዝርዝር 3.22 ውስጥ እንደታየው፣ በዝርዝር 3.9 ውስጥ ያሉትን ማለት የ‘መነሻ (menesha) እና የ‘እርዳታ (erdata) ቅድን በመከተል ተግባሩን ማከል እንችላለን።

class QuamiGetssController < ApplicationController

  def menesha
  end

  def erdata
  end

  def silegna
  end
end

እንደበፊቱ የፈተና ስብስባችን አሁንም ቀይነው፤ ነገር ግን የስህተት መልእክቱ አሁንም በድጋሜ ተለውጧል፡-

$ rails test
ActionController::UnknownFormat: QuamiGetssController#silegna is missing
a template for this request format and variant.

ይህ የጎደለውን አንድ ዝግጁገጽታ ያመለክታል፣ ይህም በሬይልስ አውድ ውስጥ በመሰረቱ ከአንድ ትይታ ጋር አንድ ዓይነት ነገር ነው። በክፍል 3.2.1 ውስጥ እንደተገለጸው፣ የ‘መነሻ (menesha) ተግባር በ‘አፕ/ትይታወች/ቋሚ_ገጾች (app/views/quami_getss) ውስጥ ከሚገኘው ከ‘መነሻ.ሃጽመቋ.ክሩ (menesha.html.erb) ትይታ ጋር የተዛመደ ነው። ይህ ማለትም እዛው ውስጥ አንድ ስለኛ.ሃጽመቋ.ክሩ (silegna.html.erb) የተባለ አዲስ ፋይል መፍጠር ይኖርብናል ማለት ነው።

አንድ ፋይልን የመፍጠር ዘዴው እንደየ ስርዓቱ አወቃቀር ይለያያል፤ ነገር ግን አብዛኞቹ የጽሑፍ አርታኢዎች ማውጫው ላይ መቆጣጠሪያ ቁልፍን ተጪኖ ጠቅ በማድረግ “New File” የሚለውን ምናሌ በመምረጥ አዲስ ፋይልን እንድትፈጥሩ ይፈቅዱላችኋል። በተመሳሳይ መልኩ አንድ አዲስ ፋይልን ለመፍጠርም የፋይል ምናሌውን መጠቀም ትችላላችሁ፤ ከዚያም ፋይሉን በምታስቀምቱበት ጊዜ አስፈላጊውን ማውጫ ምረጡ። በመጨረሻም፣ እኔ የምወደውን የዩኒክስ ንካ ትእዛዝን እንደሚከተለው አድርጋችሁ መጠቀምም ትችላላችሁ፡-

$ touch app/views/quami_getss/silegna.html.erb

በማዘዥያ መስመር ላይ መሰረታዊ እውቀትን ለማግኘት የሚያስፈልገውን ትምህርት ተማር ላይ እንደተገለጸው የ‘ንካ (touch) ትእዛዝ የአንድ ፋይል ወይም የማውጫ ማህተመጊዜን ለማዘመን የተነደፈ ቢሆንም፣ ትእዛዙ ፋይሉ ላይም ሆነ ማውጫው ላይ ምንም ነገር አይጨምርም፤ ይህ ማለት ፋይሉ ቀድሞ የተፈጠረ ከሆነ ነው፤ ፋይሉ ካልተፈጠረ ግን ትእዛዙ አንድ አዲስ ባዶ ፋይልን ይፈጥራል። (የደመና ቅ.ማ.አን እየተጠቀማችሁ ከሆነ፣ በክፍል 1.2.1 ላይ እንደተገለጸው የፋይሉን ዛፍ ማደስ ሊኖርባችሁ ይችላል፡፡ ይህም አንድ የቴክኒካዊ ብልሃት ምሳሌ ነው (ሳጥን 1.2)።)

አንዴ በትክክለኛው ማውጫ ውስጥ የ‘ስለኛ.ሃጽመቋ.ክሩ (silegna.html.erb) ፋይልን ከፈጠራችሁ በኋላ፣ ፋይሉን በዝርዝር 3.23 ውስጥ ባሉት ይዞታዎች መሙላት ይኖርባቹኋል።

<h1>ስለኛ</h1>
<p>
  <a href="https://www.railstutorial.org/"><em>የሩቢ ኦን ሬይልስ ስልጠና</em></a>
   በ <a href="https://www.learnenough.com/">በበቂ ተማር</a>
  ስልጠናወች ውስጥ የሚገኝ አካል እና
   <a href="https://rubyonrails.org/">በሩቢ ኦንሬይልስ</a>
   ድር ማበልጸግን የሚያስተምር
   <a href="https://www.railstutorial.org/book">የመጽሐፍ</a>
   እና <a href="https://screencasts.railstutorial.org/">ተከታታይ የቪዲዮ</a>
   ስልጠና ነው፡፡ ይህ የስልጠናው የማሳያ አፕልኬሽን ነው።
</p>

በዚህ ጊዜ፣ የ‘ሬይልስ ፈትን (rails test) ትእዛዝን ማስኬዱ መልሶ ወደ አረንጓዴሊያመጣን ይገባዋል:-

$ rails test
3 tests, 3 assertions, 0 failures, 0 errors, 0 skips

በእርግጥ፣ ፈተናወቻችን ወደ ስህተት እየመሩን አለመሆናቸውን ለማረጋገጥ፣ ገጹን በአንድ የድር አሳሽ ውስጥ ማየቱ መጥፎ ሃሳብ አይደለም (ምስል 3.8)።

ምስል 3.8: አዲሱ ስለኛ ገጽ (/quami_getss/silegna)።

3.3.4 ማጣራት

አሁን አረንጓዴን ስላገኘን፣ የእኛን ኮድ በልበ ሙሉነት ለማጣራት ነጻ ነን። አንድ አፕልኬሽን በሚበለጽግበት ጊዜ፣ ኮዱ ብዙውን ጊዜ “መሽተት” ይጀምራል፤ ይህ ማለትም አስቀያሚ፣ የተንዛዛ፣ ወይም በኮድ ድግግሞሽ የተሞላ ነው ማለት ነው። ኮምፒውተሩ ኮዱ የፈለገውን ቢመስል ግድ የለውም፣ በርግጥ ሰው ግድ ይለዋል፤ ስሆነም የኮዱን መሰረት ንጹህ ለማድረግ ሁሌ ኮዱን ማጣራት አስፈላጊ ነው። ምንም እንኳን የአፕልኬሽናችን ኮድ ለማጣራት በጣም ትንሽ ቢሆንም፣ የኮድ መሽተትን ግን በሁሉም ስንጥቆች ውስጥ ያስገባል፣ እናም በክፍል 3.4.3 ውስጥ ኮዱን ማጣራት እንጀምራለን።

3.4.1 አርዕስቶችን መፈተን (ቀይ)

በዝርዝር 3.25 ውስጥ የሚታየውን አይነት ቅጽ የሚወስድ የገጽ አርዕስቶችን ለማከል፣ አንድ የተለመደ የድር ገጽ አወቃቀርን መማር (ወይም መገምገም) ይኖርብናል። (ይህ በ በሃ.ጽ.መ.ቋ ላይ መሰረታዊ እውቀትን ለማግኘት የሚያስፈልገውን ተማር ላይ በሰፊው ተሸፍኗል።)

<!DOCTYPE html>
<html>
  <head>
    <title>ሰላምታ</title>
  </head>
  <body>
    <p>ዓለም እንዴት ነሽ!</p>
  </body>
</html>

በዝርዝር 3.25 ውስጥ ያለው መዋቅር፣ የትኛው ዓይነት የሃ.ጽ.መ.ቋ ስሪትን እየተጠቀምን እንደሆነ ለአሳሾቹ ለመንገር በራስጌው ላይ አንድ የሰነድ ዓይነቱን (Document Type) የሚበይን ደንብን ይይዛል (በዚህ ጊዜ የሚበየነው ደንብም ሃ.ጽ.መ.ቋ5 (HTML5)¹⁰ የተባለውን ደንብ ነው)። በዚህ ጊዜ በራስ (head) ክፍል ውስጥ፡ ርዕስ (title) በተባለው መለዮ ላይ “ሰላምታ” እና አካል (body) በተባለው ክፍል ውስጥ ፓ (p) በተባለው መለዮ ላይ “ዓለም እንዴት ነሽ!” የሚል ይዞታን ይዟል። (ለግምስምስ ሌጣቦታ (Whitespace) የመተው ጉዳይ እንደየሰው ፍላጎት ይወሰናል (ሃ.ጽ.መ.ቋ ለሌጣቦታ ግድ የለውም እናም ሁሉንም ክፍትቦታዎች እና ታሮች ችላ ይላቸዋል።) እኛ ይህንን በማድረጋችን ግን የመዋቅሩን ስነዳ ለማየት ሁኔታወችን ያቃልልናል።¹¹)

በዝርዝር 3.17 ውስጥ ያሉትን ፈተናወች ከ‘መለያ_አረጋግጥ (assert_select) ዘዴ ጋር በማጣመር ሰንጠረዥ 3.2 ውስጥ ላሉ ለእያንዳንዱ አርዕስት ቀላል የሆኑ ፈተናወችን እንጽፋለን፣ ይህም አንድ የተወሰነ የሃ.ጽ.መ.ቋ መለዮ የተጠበቀው ቦታ ላይ መኖሩን እንድናረጋግጥ ያስችለናል (የሃ.ጽ.መ.ቋ መለዮ ልክ እንደስሙ አንዳንድ ጊዜ “መራጪ (selector)” በመባል ይታወቃል፣ በዚህ ስልጠና ላይ ግን መለዮ በማለት እንጠራወለን):- ¹²

assert_select "title", "መነሻ | የሩቢ ኦን ሬይልስ ስልጠና ማሳያ አፕልኬሽን"

በተለይም፣ ከላይ ያለው ኮድ “መነሻ | የሩቢ ኦን ሬይልስ ስልጠና ማሳያ አፕልኬሽን” የሚል ሃረግ የያዘ አንድ የ‘ርዕስ (<title>) መለዮ መኖሩን ይፈትሻል። ይህንን ሃሳብ በሶስቱም ቛሚ ገጾች ላይ ተግባራዊ ማድረጉ በዝርዝር 3.26 ውስጥ የተመለከቱትን ፈተናወች ይሰጣል።

require 'test_helper'

class QuamiGetssControllerTest < ActionDispatch::IntegrationTest

  test "መነሻ ገጽን ማግኘት አለበት" do
    get quami_getss_menesha_url
    assert_response :success
    assert_select "title", "መነሻ | የሩቢ ኦን ሬይልስ ስልጠና ማሳያ አፕልኬሽን"
  end

  test "እርዳታ ገጽን ማግኘት አለበት" do
    get quami_getss_erdata_url
    assert_response :success
    assert_select "title", "እርዳታ | የሩቢ ኦን ሬይልስ ስልጠና ማሳያ አፕልኬሽን"
  end

  test "ስለኛ ገጽን ማግኘት አለበት" do
    get quami_getss_silegna_url
    assert_response :success
    assert_select "title", "ስለኛ | የሩቢ ኦን ሬይልስ ስልጠና ማሳያ አፕልኬሽን"
  end
end

የዝርዝር 3.26 ፈተናወች ባሉበት ሁኔታ እንዳሉ፣ የፈተና ስብስቡ አሁን ቀይመሆኑን ማረጋገጥ ይኖርባቹኋል፡-

$ rails test
3 tests, 6 assertions, 3 failures, 0 errors, 0 skips

3.4.2 የገጽ አርዕስትን ማከል (አረንጓዴ)

ፈተናወቹ በክፍል 3.4.1 ላይ ባሉ የፈተና ሂደቶች ውስጥ እንዲያልፉ፣ አሁን በእያንዳንዱ ገጽ ላይ አንድ አርዕስትን እናክላለን፡፡ መሰረታዊውን የሃ.ጽ.መ.ቋ መዋቅር ከዝርዝር 3.25 ወደ ተበጀው መነሻ ገጽ ማለት ወደ ዝርዝር 3.12 ማከሉ፣ ዝርዝር 3.28 ‘ን ያስገኛል።

<!DOCTYPE html>
<html>
  <head>
    <title>መነሻ | የሩቢ ኦን ሬይልስ ስልጠና ማሳያ አፕልኬሽን</title>
  </head>
  <body>
    <h1>ማሳያ አፕልኬሽን</h1>
    <p>
      ይህ <a href="https://www.railstutorial.org/">
      የሩቢ ኦን ሬይልስ ስልጠና</a>
      ማሳያ ለተባለው አፕልኬሽን፡ የመነሻ ገጽ ነው፡፡
    </p>
  </body>
</html>

ተዛማጁ የድር ገጽ በምስል 3.9 ውስጥ ይታያል። ከማያ-ገጹ ላይ የተወሰደው ስእል እንደሚያሳየው፣ የገጹን አርዕስት በአሳሻችሁ ላይ ማየት ከፈለጋችሁ፣ አንድ አዲስ ተጨማሪ ትርን መክፈት ይጠበቅባችኋል፡፡ ምስል 3.9 ‘ም የሚታየውን ማለት የሁለተኛውን ትር ያብራራል፡፡

ምስል 3.9: የመነሻ ገጹ ከአንድ አርዕስት ጋር፡፡

ለእርዳታ ገጽ (ዝርዝር 3.13) እና ለስለኛ ገጽ (ዝርዝር 3.23) ይህንን ቅድ መከተል በዝርዝር 3.29 እና በዝርዝር 3.30 ውስጥ ያለውን ኮድ ያስገኛል።

<!DOCTYPE html>
<html>
  <head>
    <title>እርዳታ | የሩቢ ኦን ሬይልስ ስልጠና ማሳያ አፕልኬሽን</title>
  </head>
  <body>
    <h1>እርዳታ</h1>
    <p>
      በሩቢ ኦንሬይልስ ስልጠና ላይ እርዳታን፡ ለማግኘት
      <a href="https://www.railstutorial.org/help">የሩቢ ኦንሬይልስ ስልጠና እርዳታ ገጽን</a>
      ቃኙ። በዚህ የማሳያ አፕልኬሽን ላይ እርዳታን፡ ለማግኘት
      <a href="https://www.railstutorial.org/book"><em>
      የሩቢ ኦንሬይልስ ስልጠና</em> መጽሐፍን</a> ተመልከቱ።
    </p>
  </body>
</html>

<!DOCTYPE html>
<html>
  <head>
    <title>ስለኛ | የሩቢ ኦን ሬይልስ ስልጠና ማሳያ አፕልኬሽን</title>
  </head>
  <body>
    <h1>ስለኛ</h1>
    <p>
      <a href="https://www.railstutorial.org/"><em>የሩቢ ኦን ሬይልስ ስልጠና፡</em></a>
       በ <a href="https://www.learnenough.com/">በበቂ ተማር</a>
       ስልጠናወች ውስጥ የሚገኝ አካል እና፣
       <a href="https://rubyonrails.org/">በሩቢ ኦንሬይልስ</a>
       ድር ማበልጸግን የሚያስተምር
       <a href="https://www.railstutorial.org/book">የመጽሐፍ</a>
       እና <a href="https://screencasts.railstutorial.org/">ተከታታይ የቪዲዮ</a>
       ስልጠና ነው፡፡ ይህ የስልጠናው ማሳያ አፕልኬሽን ነው።
    </p>
  </body>
</html>

በዚህ ጊዜ፣ የፈተና ስብስቡ ወደ አረንጓዴመመለስ አለበት፡-

$ rails test
3 tests, 6 assertions, 0 failures, 0 errors, 0 skips

require 'test_helper'

class QuamiGetssControllerTest < ActionDispatch::IntegrationTest

  def setup
    @meserete_ries = "የሩቢ ኦን ሬይልስ ስልጠና ማሳያ አፕልኬሽን"
  end

  test "መነሻ ገጽን ማግኘት አለበት" do
    get quami_getss_menesha_url
    assert_response :success
    assert_select "title", "መነሻ | #{@meserete_ries}"
  end

  test "እርዳታ ገጽን ማግኘት አለበት" do
    get quami_getss_erdata_url
    assert_response :success
    assert_select "title", "እርዳታ | #{@meserete_ries}"
  end

  test "ስለኛ ገጽን ማግኘት አለበት" do
    get quami_getss_silegna_url
    assert_response :success
    assert_select "title", "ስለኛ | #{@meserete_ries}"
  end
end

3.4.3 ገጽታወች እና ክት ሩቢ (ማጣራት)

ቀደም ሲል በዚህ ክፍል ውስጥ ብዙ ነገር አሳክተናል፤ የሬይልስ መቆጣጠሪያወችን እና ተግባሮችን በመጠቀም ሶስት ብቁ ገጾችን አመንጪተናል፤ ነገር ግን ገጾቹ ንጹህ ቛሚ ሃ.ጽ.መ.ቋ ናቸው፣ እና በዚህ ምክንያትም የሬይልስን ችሎታ አያሳዩም። በተጨማሪም በመጥፎ የኮድ ድግግሞሽ ተጠቅተዋል፡-

• የገጹ አርዕስቶች በአብዛኛው (ግን ብዙ ባይሆንም) በጣም ተመሳሳዮች ናቸው።
• “የሩቢ ኦን ሬይልስ ስልጠና ማሳያ አፕልኬሽን” የሚለው አርዕስት ለሶስቱም አርዕስቶች የጋራ ነው።
• ሁሉም የሃ.ጽ.መ.ቋ መሰረታዊ መዋቅር በእያንዳንዱ ገጽ ላይ ይደጋገማል።

ይህ የተደጋጋመ ኮድ “ነገር አትደጋግም Don’t Repeat Yourself” የተባለውን የሬይልስ መርህን የሚጥስ ስራ ነው፤ በዚህ ክፍል ውስጥ ድግግሞሹን በማስወገድ ኮዳችንን ከመደጋገም ነጻ እናወጣለን። በመጨመሻም አርዕስቶቹ አሁንም ትክክል መሆናቸውን ለማረጋገጥ፣ በክፍል 3.4.2 ውስጥ የሚገኙትን ፈተናወችን ደግመን እናስኬዳቸዋለን።

ድግግሞሹን ለማስወገድ አንድ እርምጃ ወደፊት እንጓዝ ዘንድ፣ በተቃራኒ መልኩ አንድዳንድ ተጨማሪ ድግግሞሽን በማከል የመጀመሪያውን ሂደት እንጀምራለን፣ አሁን በጣም የሚመሳሰሉትን አርዕስቶች ጪራሽ አንድ ዓይነት በማድረግ እንጀምራለን፡፡ ይህ ሂደት በኋላ ሁሉንም የኮድ ድግግሞሽ ለማስወገድ በጣም ቀላል እንዲሆን ያደርጋል።

ስልቱ በትይታችን ውስጥ ክት ሩቢን (Embedded Ruby) መጠቀምን ያሳትፋል። የመነሻ፣ የእርዳታ እና የስለኛ ገጽ አርዕስቶች አንድ ተለዋዋጪ አካል ስላላቸው፣ በእያንዳንዱ ገጽ ላይ የተለያዩ አርዕስቶችን ለማዘጋጀት አንድ አቅርብ (provide) የተባለ የሬይልስ ልዩ ሥልትን እንጠቀማለን። በዝርዝር 3.33 ውስጥ ካለው ኮድ ጋር ቃልበቃል “መነሻ” የሚለውን አርዕስት በ‘መነሻ.ሃጽመቋ.ክሩ (menesha.html.erb) ትይታ ውስጥ በመተካት ይህ አርዕስት እንዴት እንደሚሰራ ማየት እንችላለን፡፡

<% provide(:title, "መነሻ") %>
<!DOCTYPE html>
<html>
  <head>
    <title><%= yield(:title)%> | የሩቢ ኦን ሬይልስ ስልጠና ማሳያ አፕልኬሽን</title>
  </head>
  <body>
    <h1>ማሳያ አፕልኬሽን</h1>
    <p>
      ይህ <a href="https://www.railstutorial.org/">
      የሩቢ ኦን ሬይልስ ስልጠና</a>
      ማሳያ ለተባለው አፕልኬሽን፡ የመነሻ ገጽ ነው፡፡
    </p>
  </body>
</html>

በዝርዝር 3.33 ውስጥ የሚገኘው ክት ሩቢ የመጀመሪያ ምሳሌያችን ነው፣ ይህም ክ.ሩ ERb (ወይም ERB) በመባልም ይታወቃል። (የሃ.ጽ.መ.ቋ ትይታወች ለምን .ሃጽመቋ.ክሩ (.html.erb) የሚል የፋይል ቅጥያ እንደያዙ አሁን እውቃችኋል።) ኢአርቢ በድር ገጾች ውስጥ ተለዋዋጪ ይዘትን ለማካተት የሚጠቅም ዋነኛው የዝግጁገጽታ ስርዓት ነው፡፡¹³ ይህ ኮድ:-

<% provide(:title, "መነሻ") %>

ይህን <% ... %> በመጠቀም፣ ሬይልስ፣ የ‘:ርዕስ (:title) መለያ ጋር የአቅርብ (provide) ሥልትን በመጥራት፣ የ “መነሻ” ሃረግን ከአርዕስት መለያው ጋር እንደሚያዛምድ ያመለክታል። ¹⁴ ከዚያም በአርዕስቱ ውስጥ የሩቢን አፍራ (yield) ሥልትን በመጠቀም አርዕስቱን በገጽታው ውስጥ ለማስገባት በጣም የተዛመደውን ማለት ይህን <%= ... %> ስርዓተ-ምልክት ተጠቅመናል፡- ¹⁵

<title><%= yield(:title) %> | የሩቢ ኦን ሬይልስ ስልጠና ማሳያ አፕልኬሽን</title>

(በሁለቱ ክት ሩቢ መካከል ያለው ልዮነት፣ ይህ <% ... %> በውስጡ የገባውን ኮድ ይፈጽማል፤ ይህ <%= ... %> ደግሞ በውስጡ የገባውን ኮድ ይፈጽም እና ውጤቱን ወደ ገጽታው ያስገባል።) አሁን ገጹ ላይ ያለው ውጤት ከበፊቱ ጋር አንድ ዓይነት ነው፤ አሁን ግን የአርዕስቱ ተለዋዋጪ ክፍል በትእንግርት በክት ሩቢ ይመነጫል።

በክፍል 3.4.2 ውስጥ የሚገኙትን ፈተናወች በማስኬድ፣ እስካሁን ያደረግነው ስራ ሁሉም እንደሚሰራ እና ሁሉም እስካሁን ድረስ አረንጓዴመሆናቸውን ማረጋገጥ እንችላለን፡-

$ rails test
3 tests, 6 assertions, 0 failures, 0 errors, 0 skips

ከዚያ ለእገዛ እና ለስለ ገጾች ተዛማጅ ተተኪ አርዕስቶችን ማድረግ እንችላለን (ዝርዝር 3.35 እና ዝርዝር 3.36)።

<% provide(:title, "እርዳታ") %>
<!DOCTYPE html>
<html>
  <head>
    <title><%= yield(:title)%> | የሩቢ ኦን ሬይልስ ስልጠና ማሳያ አፕልኬሽን</title>
  </head>
  <body>
    <h1>እርዳታ</h1>
    <p>
      በሩቢ ኦንሬይልስ ስልጠና ላይ እርዳታን፡ ለማግኘት
      <a href="https://www.railstutorial.org/help">የሩቢ ኦንሬይልስ ስልጠና እርዳታ ገጽን</a>
      ቃኙ። በዚህ የማሳያ አፕልኬሽን ላይ እርዳታን፡ ለማግኘት
      <a href="https://www.railstutorial.org/book"><em>
      የሩቢ ኦንሬይልስ ስልጠና</em> መጽሐፍን</a> ተመልከቱ።
    </p>
  </body>
</html>

<% provide(:title, "ስለኛ") %>
<!DOCTYPE html>
<html>
  <head>
    <title><%= yield(:title)%> | የሩቢ ኦን ሬይልስ ስልጠና ማሳያ አፕልኬሽን</title>
  </head>
  <body>
    <h1>ስለኛ</h1>
    <p>
      <a href="https://www.railstutorial.org/"><em>የሩቢ ኦን ሬይልስ ስልጠና፡</em></a>
       በ <a href="https://www.learnenough.com/">በበቂ ተማር</a>
       ስልጠናወች ውስጥ የሚገኝ አካል እና፣
       <a href="https://rubyonrails.org/">በሩቢ ኦንሬይልስ</a>
       ድር ማበልጸግን የሚያስተምር
       <a href="https://www.railstutorial.org/book">የመጽሐፍ</a>
       እና <a href="https://screencasts.railstutorial.org/">ተከታታይ የቪዲዮ</a>
       ስልጠና ነው፡፡ ይህ የስልጠናው ማሳያ አፕልኬሽን ነው።
    </p>
  </body>
</html>

አሁን የገጹ አርዕስቶች ተለዋዋጪ ክፍልን በክት ሩቢ ስለተካን፣ እያንዳንዱ ገጻችን ይህንን ይመስላል:-

<% provide(:title, "የገጽ አርዕስት") %>
<!DOCTYPE html>
<html>
  <head>
    <title><%= yield(:title)%> | የሩቢ ኦን ሬይልስ ስልጠና ማሳያ አፕልኬሽን</title>
  </head>
  <body>
    Contents
  </body>
</html>

በሌላ አማርኛ በ‘አካል (body) መለዮ ውስጥ ካሉት ይዞታወች በስተቀር፣ በርዕስ (title) መለዮ ውስጥ ያሉትን ይዘቶች ጨምሮ ሁሉም ገጾች በመዋቅር ረገድ ፍጹም አንድ ናቸው ማለት ነው።

ይህንን የጋራ መዋቅር ከሌላ ለመለየት፣ ሬይልስ አፕልኬሽን.ሃጽመቋ.ክሩ (application.html.erb) ከተባለ አንድ ልዩ የገጽታ ፋይል ጋር ይመጣል፣ እሱም በዚህ ክፍል መጀመሪያ (በክፍል 3.4) ላይ ዳግም-የሰየምነው እና አሁን እነበረበት ቦታ የምንመልሰው ፋይል ነው:-

$ mv layout_file app/views/layouts/application.html.erb

ገጽታው እንዲሰራ ለማድረግ ነባሪውን አርዕስት ከላይ ካሉት ክት ሩቢ ምሳሌዎች ባንዱ እንተካዋለን:-

<title><%= yield(:title) %> | የሩቢ ኦን ሬይልስ ስልጠና ማሳያ አፕልኬሽን</title>

ያንን በማድረግ የተገኘው የገጽታው ውጤት በዝርዝር 3.37 ውስጥ ይታያል፡፡

<!DOCTYPE html>
<html>
  <head>
    <title><%= yield(:title)%> | የሩቢ ኦን ሬይልስ ስልጠና ማሳያ አፕልኬሽን</title>
    <meta charset="utf-8">
    <%= csrf_meta_tags %>
    <%= csp_meta_tag %>

    <%= stylesheet_link_tag 'application', media: 'all',
                                           'data-turbolinks-track': 'reload' %>
    <%= javascript_pack_tag 'application', 'data-turbolinks-track': 'reload' %>
  </head>

  <body>
    <%= yield %>
  </body>
</html>

ይህን ልዩ መስመር ልብ በሉ:-

<%= yield %>

ይህ ኮድ የእያንዳንዱን ገጽ ይዞታ፣ ገጽታው ውስጥ የማስገባት ሃላፊነት አለበት። ይህ እንዴት በትክክል እንደሚሰራ ማወቅ አስፈላጊ አይደለም፣ የሚያስፈልግ ነገር ቢኖር ለምሳሌ:- /ቋሚ_ገጾችመቆጣጠሪያ/መነሻ‘ን (/quami_getss/menesha) መጎብኘቱ የ‘መነሻ.ሃጽመቋ.ክሩ (menesha.html.erb) ይዞታዎችን ወደ ሃ.ጽ.መ.ቋ እንደሚቀይር እና ከዚያ <%= yield %> ቦታ ላይ በርግጠኛነት እንደሚያስገባው ማወቅ ብቻ ነው።

ዝርዝር 3.37 አንድ “የሆሄ ቋንቋ (Character Set)” ያካተተ ሲሆን፣ በዚህ ሁኔታ ላይ ዩኒኮድን (Unicode) ለማሳየት utf-8 የተባለውን የቋንቋ ሆሄን ተጠቅሟል።

መጨረሻም፣ ነባሪው የሬይልስ ገጽታ፣ የተለያዩ ተጨማሪ ኮዶችን የያዙ መስመሮችን እንደሚያካትት ማስተዋሉ አስፈላጊ ነው፡-

<%= csrf_meta_tags %>
<%= csp_meta_tag %>
<%= stylesheet_link_tag ... %>
<%= javascript_pack_tag "application", ... %>

ከላይ የተዘረዘሩትን ኮዶች ስንመለከት:- የአፕልኬሽኑን ቅጠሉህ (Stylesheet)¹⁶ ወደ አፕልኬሽኑ ለማካተት የ‘ቅጠሉህ_አገናኝ_መለያ (stylesheet_link_tag) ዘዴን ሲጠቀም፤ ጃቫስክሪፕቱን ለማካተት ደግሞ የ‘ጃቫስክሪፕት_አገናኝ_መለያ (javascript_link_tag) ዘዴን ይጠቀማል፡፡ እነዚህ እና ከላይ የተዘረዘሩትን ጨምሮ ሁሉም የንብረት ቧንቧመስመር ክፍል ናቸው (ክፍል 5.2.1)። የይዘት ጥበቃ ፖሊሲን (Content Security Policy) (ይ.ጥ.ፖ (CSP)) ተግባራዊ አድርጎ ወደ አፕልኬሽኑ የሚመጡ ጣቢያ ሰበር ስክሪፕትን (cross-site scripting) (ጣ.ሰ.ስ (XSS)) ለመቀነስ የ‘ጣሰስ_የውሂብውሂብ_መለያ (csp_meta_tag) ዘዴን ሲተገብር ወደ አፕልኬሽኑ የሚመጡ ጣቢያ ሰበር የማጪበርበር መጠይቆችን (cross-site request forgery) (ጣ.ሰ.ማ.መ (CSRF)) ለመከላከል ደግሞ የ‘ጣሰማመ_የውሂብውሂብ_መለዮዎች (csrf_meta_tags) ዘዴን ይተገብራል፡፡ (እንደ ሬይልስ ያለ የበሰለ መዋቅርን የመጠቀም አንዱ ትልቅ ጥቅም እንደዚህ ያሉ ነገሮች ላይ ከመጨነቅ ማዳኑ ነው፡፡)

ምንም እንኳን ፈተናወቹ በሙሉ የሚያልፉ ቢሆንም፤ አንድ መደረግ የሚገባው ነገር ግን አለ፤ በዝርዝር 3.33 ፣ በዝርዝር 3.35 እና በዝርዝር 3.36 ያሉት ትይታወች፣ ገጽታውን ጨምሮ ሁሉም በሃ.ጽ.መ.ቋ መዋቅር ተሞልተዋል። እሱም ከመጠን በላይ የተደጋገመ ስለሆነ (እና በእርግጥም ብቃት ወደለለው የሃ.ጽ.መ.ቋ ንቅሳት ስለሚያመራ) የውስጥ ይዘታዎቹን ብቻ በመተው እሱን ማስወገድ አለብን፡፡ ይህንን በማድረጋችን ምክንያት የጸዱት ትይታወች፣ በዝርዝር 3.38 ፣ በዝርዝር 3.39 እና በዝርዝር 3.40 ውስጥ ይታያሉ፡፡

<% provide(:title, "መነሻ") %>
<h1>ማሳያ አፕልኬሽን</h1>
<p>
  ይህ <a href="https://www.railstutorial.org/">
  የሩቢ ኦን ሬይልስ ስልጠና </a>
  ማሳያ ለተባለው አፕልኬሽን፡ የመነሻ ገጽ ነው፡፡
</p>

<% provide(:title, "እርዳታ") %>
<h1>እርዳታ</h1>
<p>
  በሩቢ ኦንሬይልስ ስልጠና ላይ እርዳታን፡ ለማግኘት
  <a href="https://www.railstutorial.org/help">የሩቢ ኦንሬይልስ ስልጠና እርዳታ ገጽን</a>
  ቃኙ። በዚህ የማሳያ አፕልኬሽን ላይ እርዳታን፡ ለማግኘት
  <a href="https://www.railstutorial.org/book"><em>
  የሩቢ ኦንሬይልስ ስልጠና</em> መጽሐፍን</a> ተመልከቱ።
</p>

<% provide(:title, "ስለኛ") %>
<h1>ስለኛ</h1>
<p>
  <a href="https://www.railstutorial.org/"><em>የሩቢ ኦን ሬይልስ ስልጠና፡</em></a>
   በ <a href="https://www.learnenough.com/">በበቂ ተማር</a>
    ስልጠናወች ውስጥ የሚገኝ አካል እና፣
   <a href="https://rubyonrails.org/">በሩቢ ኦንሬይልስ</a>
   ድር ማበልጸግን የሚያስተምር
   <a href="https://www.railstutorial.org/book">የመጽሐፍ</a>
   እና <a href="https://screencasts.railstutorial.org/">ተከታታይ የቪዲዮ</a>
   ስልጠና ነው፡፡ ይህ የስልጠናው ማሳያ አፕልኬሽን ነው።
</p>

እነዚህ ትይታወች ከተበየኑ በኋላ የመነሻ፣ የእርዳታ እና ስለኛ ገጾቹ ከዚህ በፊት ከነበረው ይዞታቸው ጋር ሲነጻጸሩ በይዞታቸው ፍጹም አንድ ዓይነት ሲሆኑ፤ ያላቸው ድግግሞሽ ግን በጣም ትንሽ ነው።

ተሞክሮ እንደሚያሳየው፣ በጣም ትንሽ ማጣራት እንኳን ለስህተት የሚጋለጥ እና በቀላሉ ከቁጥጥር ውጪ ለሆነ ችግር እንደሚያጋልጥ ነው። አንድ ጥሩ የፈተና ስብስብ መኖሩ በጣም አስፈላጊ የሆነበት አንዱ ምክንያትም ለዚህ ነው። እያንዳንዱ ገጽ ትክክል መሆኑን አንድ ባንድ ከማረጋገጥ ይልቅ፣ (በአሁኑ ጊዜ እያንዳንዱ ገጽ ትክክል መሆኑን አንድ በአንድ ማረጋገጡ አስቸጋሪ ባይሆንም አፕልኬሽኑ አያደገ ሲመጣ ግን ሂደቱ የማያዛልቅ ይሆናል) የፈተና ስብስቡ አሁንም አረንጓዴመሆኑን በቀላሉ ማረጋገጥ እንችላለን:-

$ rails test
3 tests, 6 assertions, 0 failures, 0 errors, 0 skips

ይህ የእኛ ኮድ አሁንም ትክክል ለመሆኑ ማረጋገጫ አይደለም፣ ነገር ግን ትክክል የመሆን ዕድሉን በእጅጉ ከፍ ያደርገዋል፣ በዚህም ወደፊት ከሚመጡ ስንኮች የሚጠብቀን አንድ የደህንነት ጋሻን ይሰጠናል።

<% provide(:title, "አግኙን") %>
<h1>አግኙን</h1>
<p>
  ማሳያ አፕልኬሽኑን በተመለከተ፡ በሩቢ ኦን ሬይልስ ስልጠና፡
  <a href="https://www.railstutorial.org/contact">አግኙን ገጽ</a>
  በኩል ልትገናኙን ትችላላችሁ፡፡
</p>

3.4.4 ስረ ማዘዋወርያውን ማቀናበር

አሁን የጣቢያችንን ገጾች ስላበጀን እና በፈተና ስብስቡ ላይ አንድ ጥሩ ጅማሬን ስላገኘን፣ ከመቀጠላችን በፊት እስኪ የአፕኬሽኑን ስረ ማዘዋወርያ እናዘጋጅ። ልክ እንደ ክፍል 1.2.4 እና ልክ እንደ ክፍል 2.2.2 ከመረጥነው ገጽ ጋር ይህንን ምልክት:- / ለማገናኘት የማዘዋወሪያዎች (routes.rb) ፋይልን ማረምን ያሳትፋል፤ በዚህ ሁኔታ ላይ ምርጫችን የመነሻ ገጹ ይሆናል። (በዚህ ጊዜ በክፍል 3.1 ላይ በአፕልኬሽን መቆጣጠሪያው ውስጥ የጨመራችሁትን የ‘ሰላምታ (selamta) ተግባር እንድታስወግዱ አሳስባለሁ።) በዝርዝር 3.43 ውስጥ እንደታየው ማለት የ‘ስር (root) ማዘዋወርያውን ከ፡-

root 'application#selamta'

ወደ

root 'quami_getss#menesha'

መለወጥ ነው። ይህ የዚህ ምልክት:- / መጠይቆችን ለ‘መነሻ (menesha) እንዲተላለፍ ያዘጋጃል። የተገኘው የማዘዋወሪያ ፋይል በምስል 3.10 ውስጥ ይታያል።

Rails.application.routes.draw do
  root 'quami_getss#menesha'
  get  'quami_getss/menesha'
  get  'quami_getss/erdata'
  get  'quami_getss/silegna'
end

ምስል 3.10: የመነሻ ገጹ በስረ ማዘዋወርያው ላይ።

require 'test_helper'

class QuamiGetssControllerTest < ActionDispatch::IntegrationTest

  test "ስረ ማዘዋወርያን ማግኘት አለበት" do
    get ይህን_ሙሉ
    assert_response ይህን_ሙሉ
  end

  test "መነሻ ገጽን ማግኘት አለበት" do
    get quami_getss_menesha_url
    assert_response :success
  end

  test "እርዳታ ገጽን ማግኘት አለበት" do
    get quami_getss_erdata_url
    assert_response :success
  end

  test "ስለኛ ገጽን ማግኘት አለበት" do
    get quami_getss_about_url
    assert_response :success
  end
end

Rails.application.routes.draw do
#   root 'quami_getss#menesha'
  get  'quami_getss/menesha'
  get  'quami_getss/erdata'
  get  'quami_getss/silegna'
end

3.5.1 በዚህ ምዕራፍ ውስጥ የተማርናቸው ነገሮች:-

• አዲስ ማዘዋወርያወች በአዋቅር/ማዘዋወርያወች/አርቢ (config/routes.rb) ፋይል ውስጥ እንደሚበየኑ፣
• የ‘ሬይልስ (rails) ትእዛዝ rails generate controller የመቆጣጠሪያስም (ControllerName) <አማራጪ የተግባር ስሞች > አንድ አዲስ መቆጣጠሪያን እንደሚያመነጪ፣
• የሬይልስ ትይታወች ቋሚ ሃ.ጽ.መ.ቋን ወይም ክት ሩቢን (ክ.ሩ ERb) ሊይዙ እንደሚችሉ፣
• ፈተና-መሬ ብልጸጋ አንድ የ “ቀይ፣ አረንጓዴ፣ ማጣራት” ዑደትን እንደሚጠቀም፣
• ራስሰሬ ፈተና አዳዲስ ገጸባህሪያትን ለማበልጸግ የሚረዱ የፈተና ስብስቦችን ለመጻፍ እንደሚያስችለን፣ (ኮዱን) ለማጣራት በራስ የመተማመን ችሎታን እንደሚሰጡ፣ እና ምልሰቶችን እንደሚይዙ፣
• የሬይልስ ገጽታወች በአፕልኬሽናችን ውስጥ፣ ገጾች አንድ የጋራ ዝግጁገጽታ እንዲጠቀሙ እንደሚፈቅዱ፣ በዚህ ምክንያትም የኮድ ድግግሞሽን እንደሚያስወግዱ እና
• ለሶስተኛ ጊዜ ከዜሮ ተነስተን አንድ አዲስ የሬይልስ አፕልኬሽንን ለመፍጠር ሙሉ ቅደመ ተከተሎችን ማድረግን፣ አስፈላጊ እንቁወችን መጫንን፣ ወደ አንድ ሩቅ ማከማቻ መግፋትን፣ ከዚያም አፕልኬሽኑን በምርት ላይ ማሰማራትን ተምረናል።

3.6.1 ሚኒቴስት ሪፖርተር

ምንም እንኳን የደመና ቅ.ማ.አን ጨምሮ ብዙ ስርዓቶች ለቀይ እና ለአረንጓዴ የፈተና ስብስቦች ተገቢዎቹን ቀለሞች ቢያሳዩም የሚኒቴስት ሪፖርተርስ እንቁን በፈተና ስርዓት ውስጥ ማከሉ ግን በፈተናው ውጽዓቶች ላይ በተወሰነ መልኩ ደስ የሚያሰኝ መልክን ይሰጣል፤ ስለዚህ በዝርዝር 3.46 ውስጥ ያለውን ኮድ በቴስት ሃልፐር ፋይላችሁ ¹⁹ ውስጥ እንድታክሉት እመክራለሁ፤ በዚህ ምክንያትም አፕልኬሽናችሁ በዝርዝር 3.2 ውስጥ የተካተተውን ማለት የ minitestreporters እንቁን ይጠቀማል ማለት ነው።

ENV['RAILS_ENV'] ||= 'test'
require_relative '../config/environment'
require 'rails/test_help'
require "minitest/reporters"
Minitest::Reporters.use!

class ActiveSupport::TestCase
  # Run tests in parallel with specified workers
  parallelize(workers: :number_of_processors)

  # Setup all fixtures in test/fixtures/*.yml for all tests in alphabetical order.
  fixtures :all

  # Add more helper methods to be used by all tests here...
end

በደመና ቅ.ማ.አ ውስጥ ከ ቀይ ወደ አረንጓዴ የተደረገው የሽግግር ውጤት በምስል 3.11 ላይ ይታያል፡፡

ምስል 3.11: በደመና ቅ.ማ.አው ላይ ከ ቀይ ወደ አረንጓዴ መሄድ።

3.6.2 ራስሰሬ ፈተናዎች ከጋርድ ጋር

የ‘ሬይልስ ፈትን (rails test) ትእዛዝን ከመጠቀም ጋር የተቆራኘ አንድ ደባሪ ነገር ቢኖር፣ ወደ ማዘዥያ መስመሩ መሄድ እና ፈተናወችን በእጅ ማስኬድ ነው፡፡ ይህንን ችግር ለማስወገድ፣ የፈተናወቹን አካሄድ ራስሰሬ ለማድረግ ጋርድን (Guard) መጠቀም እንችላለን፡፡ ጋርድ በፋይል ስርዓቱ ውስጥ ለውጦችን ይከታተላል፤ ለምሳሌ በ‘/ቋሚ_ገጾች_መቆጣጠሪያ_ፈተና.አርቢ (quami_getss_controller_test.rb) ፋይል ላይ የሆነ ለውጥ ብናደርግ፣ እነዚያ ፈተናወች ብቻ ይሄዳሉ። ከዚያ በበለጠ ደግሞ ለምሳሌ፣ የ‘መነሻ.ሃጽመቋ.ክሩ (menesha.html.erb) ፋይል ሲሻሻል፣ /ቋሚ_ገጾች_መቆጣጠሪያ_ፈተና.አርቢ (quami_getss_controller_test.rb) በራስሰር እንዲሄድ ለማድረግ፣ ጋርድን ማዋቀር እንችላለን፡፡

በዝርዝር 3.2 ውስጥ ያለው የ‘እንቁፋይል (Gemfile) ቀድሞውኑ የ‘ጋርድ (guard) እንቁን በአፕልኬሽናችን ውስጥ አካቷል፤ ስለዚህ ስራውን ለማስጀመር እሱን ማስጀመር ይኖርብናል፡-

$ bundle _2.2.17_ exec guard init
Writing new Guardfile to /home/ec2-user/አካባቢ/masaya/Guardfile
00:51:32 - INFO - minitest guard added to Guardfile, feel free to edit it

በመቀጠል የውህደት ፈተናወች እና ትይታወች በሚዘመኑበት ጊዜ ጋርድ ትክክለኛ ፈተናወችን እንዲያስኬድ፣ የ‘ጋርድፋይል (Guardfile) ውጤትን እናርማለን፣ የተዘመነው ፋይልም በዝርዝር 3.47 ውስጥ ያለውን ይመስላል፡፡ የሚፈለገውን ውጤት ለማግኘት፣ በአፕልኬሽኑ ማጣቀሻ ውስጥ የተዘረዘውን የ‘ጋርድፋይል (Guardfile) ስሪትን እንድትጠቀሙ እመክራለሁ፤ ይህንን በመስመር ላይ እያነበባችሁ ከሆነ፣ በዝርዝር 3.47 ወስጥ ካለው ጋር ፍጹም አንድ ዓይነት መሆን አለበት:-

• የ‘ጋርድፋይል (Guardfile) ማጣቀሻ በ railstutorial.org/guardfile ላይ ይገኛል።

ማሳሰቢያ:- የ‘ጋርድፋይሉ (Guardfile) የአማርኛ ትርጉም ያካተተውን ፈተና ያስኬድልን ዘንድ፣ የአማርኛ ትርጉሙ የተጠቀመበትን የፈተና ኮዶች በጋርድ ፋይል ውስጥ እንዳከልናቸው ልትገነዘቡ ይገባል።

require 'active_support/core_ext/string'
# ለጋርድ ተዛማጅ ደንቦችን ይበይናል።
guard :minitest, spring: "bin/rails test", all_on_start: false do
  watch(%r{^test/(.*)/?(.*)_test\.rb$})
  watch('test/test_helper.rb') { 'test' }
  watch('config/routes.rb') { interface_tests }
  watch(%r{app/views/layouts/*}) { interface_tests }
  watch(%r{^app/models/(.*?)\.rb$}) do |matches|
    "test/models/#{matches[1]}_test.rb"
  end
  watch(%r{^app/controllers/(.*?)_controller\.rb$}) do |matches|
    resource_tests(matches[1])
  end
  watch(%r{^app/views/([^/]*?)/.*\.html\.erb$}) do |matches|
    ["test/controllers/#{matches[1]}_controller_test.rb"] +
    integration_tests(matches[1])
  end
  watch(%r{^app/helpers/(.*?)_helper\.rb$}) do |matches|
    integration_tests(matches[1])
  end
  watch('app/views/layouts/application.html.erb') do
    'test/integration/site_layout_test.rb'
  end
  # ለአማርኛው ስሪት ተዛማጅ ደንቦችን ይበይናል።
  watch('app/views/layouts/application.html.erb') do
    'test/integration/tabya_getsta_test.rb'
  end
  watch('app/helpers/sessions_helper.rb') do
    integration_tests << 'test/helpers/sessions_helper_test.rb'
  end
  watch('app/controllers/sessions_controller.rb') do
    ['test/controllers/sessions_controller_test.rb',
     'test/integration/users_login_test.rb',
     # ለአማርኛው ስሪት ተዛማጅ ደንቦችን ይበይናል።
     'test/integration/teteqamis_gba_test.rb']
  end
  watch('app/controllers/account_activations_controller.rb') do
    'test/integration/users_signup_test.rb'
  end
  # ለአማርኛው ስሪት ተዛማጅ ደንቦችን ይበይናል።
  watch('app/controllers/meleya_magberyas_controller.rb') do
    'test/integration/teteqamis_temezgeb_test.rb'
  end
  watch(%r{app/views/users/*}) do
    resource_tests('users') +
    ['test/integration/microposts_interface_test.rb']
  end
  # ለአማርኛው ስሪት ተዛማጅ ደንቦችን ይበይናል።
  watch(%r{app/views/teteqamis/*}) do
    resource_tests('teteqamis') +
    ['test/integration/achrtshufs_beynegets_test.rb']
  end
end

# ከተሰጠው ሃብት ጋር የሚዛመዱ የውህደት ፈተናዎችን ይመልሳል።
def integration_tests(resource = :all)
  if resource == :all
    Dir["test/integration/*"]
  else
    Dir["test/integration/#{resource}_*.rb"]
  end
end

# በይነገጹን የመቱትን ፈተናዎችን ሁሉ ይመልሳል።
def interface_tests
  integration_tests << "test/controllers/"
end

# ከተሰጠው ሃብት ጋር የሚዛመዱ የመቆጣጠሪያ ፈተናዎችን ይመልሳል።
def controller_test(resource)
  "test/controllers/#{resource}_controller_test.rb"
end

# ለተሰጠው ሃብት ሁሉንም ፈተናዎች ይመልሳል።
def resource_tests(resource)
  integration_tests(resource) << controller_test(resource)
end

በደመና ቅ.ማ.አ ላይ፣ አንድ መወሰድ የሚገባው ተጨማሪ ሂደት አለ፤ እሱም ጋርድ በፕሮጀክቱ ውስጥ ያሉትን ሁሉንም ፋይሎች ለመቆጣጠር የሚያስችለውን፣ የሚከተሉትን ግልጽ ያልሆኑ ትእዛዞችን ማስኬድ ነው:-

$ echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf
$ sudo sysctl -p

አንድ ጊዜ ጋርድ ከተዋቀረ፣ አንድ አዲስ መናኸሪያ ላይ የሚከተለውን ትእዛዝ አስኪዱ (ምስል 3.12) (በክፍል 1.2.2 ውስጥ ልክ የሬይልስ ድር አገልጋይን ለማስኬድ ተጠቅመንበት እንደነበረው ዓይነት ማለት ነው):-

$ bundle _2.2.17_ exec guard

በዝርዝር 3.47 ውስጥ ያሉት ደንቦች ለዚህ ስልጠና የተመቻቹ ደንቦች ናቸው፣ ማለት በአንድ መቆጣጠሪያ ላይ አንድ ለውጥ በሚደረግበት ጊዜ፣ የውህደት ፈተናወችን በራስሰር ያስኬዳል። ሁሉንም ፈተናወች ለማስኬድ፣ የተመለስ ቁልፍን የ‘ guard> መቀበያ ላይ ብቻ ምቱ፡፡

ምስል 3.12: በደመና ቅ.ማ.አ ላይ ጋርድን መጠቀም።

ከጋርድ ለመውጣት፣ “ተቆር-ዲን (Ctrl-D)” ተጫኑ። በጋርድ ላይ ተጨማሪ ተዛማጆችን ለማከል፣ በዝርዝር 3.47 ውስጥ፣ በጋርድ አንብቡኝ እና በጋርድ ዊኪ ላይ ያሉት ምሳሌዎች ላይ ተጣቀሱ፡፡

የፈተና ስብስቡ ያለ ምንም ምክንያት ሳይጀምር ከቀረ፣ ከጋርድ ውጡ፣ ስፕሪንግን አቁሙ እና እንደገና አስጀምሩት (ስፕሪንግ:- ሬይልስ ፈተናወችን ለማፋጠን የሚያግዝ መረጃዎችን ቀድሞ ለመጫን የሚጠቀምበት እንቁ ነው):-

$ bin/spring stop  # ፈተናወቹ ባልታወቀ ምክንያት መጀመር ካልቻሉ ይህንን ትእዛዝ ሞክሩ፡፡
$ bundle _2.2.17_ exec guard

ከመቀጠላችሁ በፊት ለውጦቻችሁን ማከል እና መቀላቀል አለባችሁ:-

$ git add -A
$ git commit -m "የላቀ ፈተና መዋቅሩን ማጠናቀቅ"