عرض مصدر Rails/command line

<noinclude>{{DISPLAYTITLE:سطر أوامر ريلز}}</noinclude>
[[تصنيف:Rails]]
[[تصنيف:Rails Digging Deeper]]
بعد قراءة هذا الدّليل، ستتمكّن من:
* إنشاء تطبيق ريلز.
* توليد النماذج، ووحدات التحكّم، وتهجيرات قاعدة البيانات (database migrations)، ووحدات الاختبار.
* بدء الخادم الإنتاجي.
* كيفية تجربة الكائنات من خلال صدفة تفاعليّة (interactive shell)
يفترض هذا الدليل أن لديك معرفة أساسية بإطار العمل ريلز من قراءة دليل [[Rails/getting started|البدء مع ريلز]].

== أساسيات سطر الأوامر ==
هناك بضعة أوامر تُعتبر حاسمة للغاية لاستخدامك اليومي لإطار العمل ريلز. هذا الأوامر مرتّبة حسب كثرة استخدامها تقريبًا بالشكل التالي:
* <code>rails console</code>
* <code>rails server</code>
* <code>bin/rails</code>
* <code>rails generate</code>
* <code>rails dbconsole</code>
* <code>rails new app_name</code>
يمكن تشغيل كافة الأوامر مع <code>h-</code> أو <code>help--</code> لعرض مزيد من المعلومات عنها.

دعنا نُنشئ تطبيق ريلز بسيط لتجريب كل من هذه الأوامر في سياقها المناسب.

=== <code>rails new</code> ===
أول شيء نريد فعله هو إنشاء تطبيق ريلز جديد عن طريق تنفيذ الأمر <code>rails new</code> بعد تثبيت ريلز.

يمكنك تثبيت الجوهرة rails بكتابة الأمر <code>gem install rails</code> إن لم تمتلكها بالفعل.<syntaxhighlight lang="shell">
$ rails new commandsapp
     create
     create  README.md
     create  Rakefile
     create  config.ru
     create  .gitignore
     create  Gemfile
     create  app
     ...
     create  tmp/cache
     ...
        run  bundle install
</syntaxhighlight>ستُزوّدك ريلز بما يبدو بمقدار كبير من المعلومات حتى بالنسبة لأمر بهذا الصغر! لديك بنية المجلّد Rails كاملة الآن مع كامل التعليمات البرمجيّة التي تحتاجها لتشغيل تطبيقنا البسيط لدينا مباشرة.

=== <code>rails server</code> ===
يشغِّل الأمر <code>rails server</code> خادم ويب يسمّى Puma والذي يأتي مع ريلز. ستستخدمه وقتما تريد الوصول إلى تطبيقك عبر مُتصفّح ويب.

سيُشغّل الأمر <code>rails server</code> تطبيق ريلز الجديد بدون أي عمل إضافي:<syntaxhighlight lang="shell">
$ cd commandsapp
$ bin/rails server
=> Booting Puma
=> Rails 5.1.0 application starting in development on http://0.0.0.0:3000
=> Run `rails server -h` for more startup options
Puma starting in single mode...
* Version 3.0.2 (ruby 2.3.0-p0), codename: Plethora of Penguin Pinatas
* Min threads: 5, max threads: 5
* Environment: development
* Listening on tcp://localhost:3000
Use Ctrl-C to stop
</syntaxhighlight>بثلاثة أوامر فقط، صنعنا خادم ريلز يستمع على المنفذ 3000. انتقل إلى متصفّحك وافتح <nowiki>http://localhost:3000</nowiki> سترى تطبيق Rails بسيط قيد التشغيل.

يمكنك أيضًا استخدام الاسم البديل "s" لبدء تشغيل الخادم بالشكل: <code>rails s</code>.

يمكن تشغيل الخادم على منفذ مُختلف باستخدام الخيار <code>p-</code>. يمكن تغيير بيئة التطوير الافتراضية باستخدام <code>e-</code>.<syntaxhighlight lang="shell">
$ bin/rails server -e production -p 4000
</syntaxhighlight>يربط الخيار <code>b-</code> إطار العمل ريلز بالعنوان IP المحدّد الذي يكون افتراضيًا localhost. يمكنك تشغيل الخادم كعفريت (daemon) بتمرير الخيار <code>d-</code>.

=== <code>rails generate</code> ===
يستخدم الأمر <code>rails generate</code> قوالب لإنشاء أشياء كثيرة. تشغيل <code>rails generate</code> نفسه يعطي قائمة من المُوّلدات المتاحة:

'''ملاحظة''': يمكنك أيضًا استخدام الاسم البديل "g" لاستدعاء الأمر المُولّد بالشكل: <code>rails g</code>.<syntaxhighlight lang="shell">
$ bin/rails generate
Usage: rails generate GENERATOR [args] [options]
 
...
...
 
Please choose a generator below.
 
Rails:
  assets
  channel
  controller
  generator
  ...
  ...
</syntaxhighlight>'''ملاحظة''': يمكنك تثبيت المزيد من المولّدات عبر الجواهر المُولّدة، وأجزاء من الإضافات (plugins) التي ستُثبّتها دون شك ويمكنك حتى إنشاء مولّداتك شخصيَّا!

سيوفّر استخدام المولدات عليك كثيرًا الوقت عبر كتابة الشيفرة المُتداولة (boilerplate code)، وهي شيفرة ضروريّة كي يعمل التطبيق.

فلنصنع وحدة تحكّم خاصة بنا بمولّد وحدات تحكّم. لكن ما الأمر الذي يجب أن نستخدمه؟ فلنسأل المُولّد:

'''ملاحظة''': تحتوي كافّة أدوات الطرفيّة المساعدة (console utilities) في ريلز على نص مساعدة. يمكنك محاولة إضافة <code>help--</code> أو <code>h-</code> إلى نهاية الأمر كما هو الحال مع معظم الأدوات المساعدة <code>nix*</code>، على سبيل المثال <code>rails server --help</code>.<syntaxhighlight lang="shell">
$ bin/rails generate controller
Usage: rails generate controller NAME [action action] [options]
 
...
...
 
Description:
    ...
 
    To create a controller within a module, specify the controller name as a path like 'parent_module/controller_name'.
 
    ...
 
Example:
    `rails generate controller CreditCards open debit credit close`
 
    Credit card controller with URLs like /credit_cards/debit.
        Controller: app/controllers/credit_cards_controller.rb
        Test:       test/controllers/credit_cards_controller_test.rb
        Views:      app/views/credit_cards/debit.html.erb [...]
        Helper:     app/helpers/credit_cards_helper.rb

</syntaxhighlight>يتوقع مُولّد وحدة التحكّم المعاملات في شكل <code>generate controller ControllerName action1 action2</code>. فلننشئ وحدة تحكّم Greetings مع إجراء (action) سنسمّيه hello، والذي سيقول لنا أشياءً لطيفة.<syntaxhighlight lang="shell">
$ bin/rails generate controller Greetings hello
     create  app/controllers/greetings_controller.rb
      route  get "greetings/hello"
     invoke  erb
     create    app/views/greetings
     create    app/views/greetings/hello.html.erb
     invoke  test_unit
     create    test/controllers/greetings_controller_test.rb
     invoke  helper
     create    app/helpers/greetings_helper.rb
     invoke  assets
     invoke    coffee
     create      app/assets/javascripts/greetings.coffee
     invoke    scss
     create      app/assets/stylesheets/greetings.scss
</syntaxhighlight>ما الذي ولّده كل هذا؟ تأكد من وجود مجموعة من المجلّدات في تطبيقنا، وإنشاء ملف وحدة تحكّم، وملف واجهة، وملف اختبار وظيفي، ومساعد للواجهة، وملف JavaScript وملف ورقة أنماط (stylesheet).

تحقّق من وحدة التحكّم وعدّلها قليلًا (في app/controllers/greetings_controller.rb):<syntaxhighlight lang="shell">
class GreetingsController < ApplicationController
  def hello
    @message = "Hello, how are you today?"
  end
end
</syntaxhighlight>ثم الواجهة لعرض رسالتنا (في app/views/greetings/hello.html.erb):<syntaxhighlight lang="html">
<h1>A Greeting for You!</h1>
<p><%= @message %></p>
</syntaxhighlight>أطلق خادمك باستخدام <code>rails server</code>:<syntaxhighlight lang="shell">
$ bin/rails server
=> Booting Puma...
</syntaxhighlight>سيكون العنوان هو <nowiki>http://localhost:3000/greetings/hello</nowiki>.

باستخدام تطبيق ريلز عادي قديم، ستتبع عناوينك URL بشكل عام النمط <nowiki>http://(host)/(controller)/(action)‎،</nowiki> وسيُشغّل عنوان URL مثل <nowiki>http://(host)/(controller)‎</nowiki> الإجراء <code>index</code> من وحدة التحكّم تلك.

تأتي ريلز مع مُولّد لنماذج البيانات أيضا.<syntaxhighlight lang="shell">
$ bin/rails generate model
Usage:
  rails generate model NAME [field[:type][:index] field[:type][:index]] [options]
 
...
 
Active Record options:
      [--migration]            # Indicates when to generate migration
                               # Default: true
 
...
 
Description:
    Create rails files for model generator.
</syntaxhighlight>ارجع إلى توثيق [http://api.rubyonrails.org/v5.2.2/classes/ActiveRecord/ConnectionAdapters/SchemaStatements.html#method-i-add_column الواجهة البرمجيّة] للتابع <code>add_column</code> للوحدة <code>SchemaStatements</code> للحصول على قائمة بأنواع الحقول المتاحة لمعامل <code>type</code>. ينشئ المعامل <code>index</code> فهرسًا (index) مقابلًا للعمود.

ولكن بدلًا من توليد نموذج مباشرة (وهو ما سنفعله لاحقًا)، فلننشئ سقالة (scaffold). السقالة في ريلز هي مجموعة كاملة من النماذج، وتهجير قاعدة البيانات لهذا النموذج، ووحدة تحكّم للتلاعب بها، توابع واجهة لعرض البيانات ومعالجتها، ومجموعة اختبار لكل ما سبق.

سننشئ موردًا بسيطًا يسمى "HighScore" والذي سيتابع أعلى درجاتنا في ألعاب الفيديو التي نلعبها:<syntaxhighlight lang="shell">
$ bin/rails generate scaffold HighScore game:string score:integer
    invoke  active_record
    create    db/migrate/20130717151933_create_high_scores.rb
    create    app/models/high_score.rb
    invoke    test_unit
    create      test/models/high_score_test.rb
    create      test/fixtures/high_scores.yml
    invoke  resource_route
     route    resources :high_scores
    invoke  scaffold_controller
    create    app/controllers/high_scores_controller.rb
    invoke    erb
    create      app/views/high_scores
    create      app/views/high_scores/index.html.erb
    create      app/views/high_scores/edit.html.erb
    create      app/views/high_scores/show.html.erb
    create      app/views/high_scores/new.html.erb
    create      app/views/high_scores/_form.html.erb
    invoke    test_unit
    create      test/controllers/high_scores_controller_test.rb
    invoke    helper
    create      app/helpers/high_scores_helper.rb
    invoke    jbuilder
    create      app/views/high_scores/index.json.jbuilder
    create      app/views/high_scores/show.json.jbuilder
    invoke  test_unit
    create    test/system/high_scores_test.rb
    invoke  assets
    invoke    coffee
    create      app/assets/javascripts/high_scores.coffee
    invoke    scss
    create      app/assets/stylesheets/high_scores.scss
    invoke  scss
   identical    app/assets/stylesheets/scaffolds.scss
</syntaxhighlight>يتطلّب التهجير  (migration) تشغيل بعض التعليمات البرمجية في [[Ruby|روبي]] (الموجودة في 20130717151933_create_high_scores.rb) لتعديل مخطّط قاعدة بياناتنا. أية قاعدة بيانات؟ قاعدة البيانات SQLite3 التي ستنشئها ريلز لك عند تنفيذ الأمر <code>bin/rails db:migrate</code>. سنتحدث أكثر عن <code>bin/rails</code> بتعّمق بعد حين.<syntaxhighlight lang="shell">
$ bin/rails db:migrate
==  CreateHighScores: migrating ===============================================
-- create_table(:high_scores)
   -> 0.0017s
==  CreateHighScores: migrated (0.0019s) ======================================
</syntaxhighlight>فلنتحدّث عن اختبارات الوحدة (unit tests). اختبارات الوحدة هي شيفرة تختبر وتضع تأكيدات حول الشيفرة. في اختبار الوحدات، نأخذ جزءًا صغيرًا من الشيفرات، مثلًا تابع نموذج ونختبر مدخلاته ومخرجاته. اختبارات الوحدات هم أصدقائك الصديقون. كلما تقبّلت حقيقة أن جودة حياتك ستزداد بشكل كبير عندما تختبر الوحدة شيفراتك بشكل أسرع، كان ذلك أفضل. يرجى الاطلاع على [[Rails/testing|دليل الاختبار]] للحصول على نظرة تفصيلية على اختبار الوحدة.

فلنلقي نظرة على واجهة ريلز التي أُنشئت لنا.<syntaxhighlight lang="shell">
$ bin/rails server
</syntaxhighlight>انتقل إلى المتصفّح وافتح الصفحة ذات الرابط <nowiki>http://localhost:3000/high_scores،</nowiki> والآن يمكننا إنشاء درجات عالية جديدة (55،160 على Space Invaders!)

=== <code>rails console</code> ===
يتيح لك الأمر <code>console</code> التفاعل مع تطبيقك من سطر الأوامر. الجانب السلبي هو أنّ <code>rails console</code> يستخدم IRB، لذلك إن استخدمته من قبل، فستجد نفسك مرتاحًا. هذا مفيد لاختبار الأفكار السريعة مع الشيفرات وتغيير البيانات من جانب خادم دون لمس موقع الويب.

يمكنك أيضًا استخدام الاسم البديل "c" لاستدعاء الطرفيّة بالشكل: <code>rails c</code>.

يمكنك تحديد البيئة التي يجب أن يعمل فيها الأمر <code>console</code>.<syntaxhighlight lang="shell">
$ bin/rails console -e staging
</syntaxhighlight>تستطيع إن أردت اختبار بعض الشفرات دون تغيير أي بيانات عبر استدعاء <code>rails console --sandbox</code>.<syntaxhighlight lang="shell">
$ bin/rails console --sandbox
Loading development environment in sandbox (Rails 5.1.0)
Any modifications you make will be rolled back on exit
irb(main):001:0>
</syntaxhighlight>

==== التطبيق والكائنات المساعدة ====
داخل <code>rails console</code>، لديك حق الوصول إلى النُسخ <code>app</code>  و <code>helper</code>.

باستخدام التابع <code>app</code> يمكنك الوصول إلى مساعدي url والمسار إضافةً إلى الطلبات.<syntaxhighlight lang="shell">
>> app.root_path
=> "/"
 
>> app.get _
Started GET "/" for 127.0.0.1 at 2014-06-19 10:41:57 -0300
...
</syntaxhighlight>مع التابع <code>helper</code>، من الممكن الوصول إلى Rails ومساعدي تطبيقك.<syntaxhighlight lang="shell">
>> helper.time_ago_in_words 30.days.ago
=> "about 1 month"
 
>> helper.my_custom_helper
=> "my custom helper"
</syntaxhighlight>

=== <code>rails dbconsole</code> ===
يكتشف الأمر <code>rails dbconsole</code> أي قاعدة البيانات تستخدمها ويضعك بواجهة سطر الأوامر التي ستستخدمها معها (ويكتشف معاملات سطر الأوامر التي يجب إعطائها أيضًا!). ويدعم MySQL (بما في ذلك MariaDB)، و PostgreSQL و SQLite3.

يمكنك أيضًا استخدام الاسم البديل "db" لاستدعاء الأمر <code>dbconsole</code> بالشكل: <code>rails db</code>.

=== <code>rails runner</code> ===
يُشغّل الأمر <code>runner</code> شيفرات [[Ruby|روبي]] في سياق ريلز بشكل غير تفاعلي (non-interactively). على سبيل المثال:<syntaxhighlight lang="shell">
$ bin/rails runner "Model.long_running_method"

</syntaxhighlight>يمكنك أيضًا استخدام الاسم البديل "r" لاستدعاء الأمر <code>runner</code> بالشكل: <code>rails r</code>.

يمكنك تحديد البيئة التي يجب أن يعمل الأمر <code>runner</code> ضمنها باستخدام المُبدّل <code>e-</code>.<syntaxhighlight lang="shell">
$ bin/rails runner -e staging "Model.long_running_method"
</syntaxhighlight>يمكنك حتى تنفيذ شفرات [[Ruby|روبي]] مكتوبة في ملف مع الأمر <code>runner</code>.<syntaxhighlight lang="shell">
$ bin/rails runner lib/code_to_be_run.rb
</syntaxhighlight>

=== <code>rails destroy</code> ===
فكّر في الأمر <code>destroy</code> كنقيض للأمر <code>generate</code>. سيكتشف ما فعله الأمر <code>generate</code> ثم سيلغيه.

يمكنك أيضًا استخدام الاسم البديل "d" لاستدعاء أمر التدمير بالشكل: <code>rails d</code>.<syntaxhighlight lang="shell">
$ bin/rails generate model Oops
      invoke  active_record
      create    db/migrate/20120528062523_create_oops.rb
      create    app/models/oops.rb
      invoke    test_unit
      create      test/models/oops_test.rb
      create      test/fixtures/oops.yml
</syntaxhighlight><syntaxhighlight lang="shell">
$ bin/rails destroy model Oops
      invoke  active_record
      remove    db/migrate/20120528062523_create_oops.rb
      remove    app/models/oops.rb
      invoke    test_unit
      remove      test/models/oops_test.rb
      remove      test/fixtures/oops.yml
</syntaxhighlight>

== <code>bin/rails</code> ==
<code>bin/rails</code> هو الإعداد الافتراضي الجديد لتشغيل الأوامر نظرًا لأنَّ الإصدار 5.0 وما بعده من ريلز يحتوي على أوامر <code>rake</code> مضمّنة في ملف ريلز التنفيذي.

يمكنك الحصول على قائمة بمهام <code>bin/rails</code> المتاحة لك، والتي غالبًا ما تعتمد على مجلّدك الحالي، عبر كتابة الأمر <code>bin/rails --help</code> . تحتوي كل مهمّة على وصف ويجب أن تساعدك في إيجاد ما تحتاجه.<syntaxhighlight lang="shell">
$ bin/rails --help
Usage: rails COMMAND [ARGS]
 
The most common rails commands are:
generate    Generate new code (short-cut alias: "g")
console     Start the Rails console (short-cut alias: "c")
server      Start the Rails server (short-cut alias: "s")
...
 
All commands can be run with -h (or --help) for more information.
 
In addition to those commands, there are:
about                               List versions of all Rails ...
assets:clean[keep]                  Remove old compiled assets
assets:clobber                      Remove compiled assets
assets:environment                  Load asset compile environment
assets:precompile                   Compile all the assets ...
...
db:fixtures:load                    Loads fixtures into the ...
db:migrate                          Migrate the database ...
db:migrate:status                   Display status of migrations
db:rollback                         Rolls the schema back to ...
db:schema:cache:clear               Clears a db/schema_cache.yml file
db:schema:cache:dump                Creates a db/schema_cache.yml file
db:schema:dump                      Creates a db/schema.rb file ...
db:schema:load                      Loads a schema.rb file ...
db:seed                             Loads the seed data ...
db:structure:dump                   Dumps the database structure ...
db:structure:load                   Recreates the databases ...
db:version                          Retrieves the current schema ...
...
restart                             Restart app by touching ...
tmp:create                          Creates tmp directories ...

</syntaxhighlight>يمكنك أيضًا استخدام <code>bin/rails -T</code> للحصول على قائمة المهام.

=== <code>about</code> ===
يعطي <code>bin/rails about</code> معلومات حول أرقام إصدارات [[Ruby|روبي]]، و RubyGems، وريلز، ومكوّنات ريلز الفرعية، ومجلد تطبيقك، واسم بيئة ريلز الحاليّة، ومحوّل قاعدة بيانات تطبيقك، وإصدار المخطّط (schema version). يفيد ذلك عندما تحتاج لطلب المساعدة أو التحقّق من إحتمال تأثير رقعة أمان (security patch) عليك، أو عندما تحتاج إلى بعض الإحصائيات لتثبيت قائم بالفعل.<syntaxhighlight lang="shell">
$ bin/rails about
About your application's environment
Rails version             5.1.0
Ruby version              2.2.2 (x86_64-linux)
RubyGems version          2.4.6
Rack version              2.0.1
JavaScript Runtime        Node.js (V8)
Middleware:               Rack::Sendfile, ActionDispatch::Static, ActionDispatch::Executor, ActiveSupport::Cache::Strategy::LocalCache::Middleware, Rack::Runtime, Rack::MethodOverride, ActionDispatch::RequestId, ActionDispatch::RemoteIp, Sprockets::Rails::QuietAssets, Rails::Rack::Logger, ActionDispatch::ShowExceptions, WebConsole::Middleware, ActionDispatch::DebugExceptions, ActionDispatch::Reloader, ActionDispatch::Callbacks, ActiveRecord::Migration::CheckPending, ActionDispatch::Cookies, ActionDispatch::Session::CookieStore, ActionDispatch::Flash, Rack::Head, Rack::ConditionalGet, Rack::ETag
Application root          /home/foobar/commandsapp
Environment               development
Database adapter          sqlite3
Database schema version   20110805173523
</syntaxhighlight>

=== <code>assets</code> ===
يمكنك إجراء تحويل مسبق (precompile) للأصول في app/assets باستخدام <code>bin/rails assets:precompile</code>، وإزالة الأصول المُحوّلة (compiled) القديمة باستخدام أصول <code>bin/rails assets:clean</code>. تسمح المهمّة <code>assets:clean</code> بعكس عملية النشر (deploys) التي قد تزال مرتبطة بأصل قديم بينما تُبنى الأصول الجديدة.

تستطيع استخدام <code>bin/rails assets:clobber</code> إن أردت مسح public/assets تمامًا.

=== <code>db</code> ===
المهمّتان الأكثر شيوعًا من مجال الاسم <code>db: bin/rails</code> هما <code>migrate</code> و <code>create</code>، وستؤتي تجربة كل مهام التهجير <code>bin/rails</code> ثمارها (up, down, redo, reset) . يفيدنا <code>bin/rails db:version</code> عند استكشاف الأخطاء وإصلاحها ويُعلمك بالإصدار الحالي لقاعدة البيانات.

لمزيد من المعلومات حول عمليات التهجير أنظر دليل [[Rails/active record migrations|التهجير]].

=== <code>notes</code> ===
ستبحث <code>bin/rails notes</code> داخل شيفرتك عن التعليقات التي تبدأ بـ <code>FIXME</code> أو <code>OPTIMIZE</code> أو <code>TODO</code>. يُبحَثُ في الملفات ذات الامتداد builder. و rb. و rake. و yml. و yaml. و ruby. و css. و js. و erb. لكل من التعليقات التوضيحيّة الافتراضيّة والمخصصّة.<syntaxhighlight lang="shell">
$ bin/rails notes
(in /home/foobar/commandsapp)
app/controllers/admin/users_controller.rb:
  * [ 20] [TODO] any other way to do this?
  * [132] [FIXME] high priority for next deploy
 
app/models/school.rb:
  * [ 13] [OPTIMIZE] refactor this code to make it faster
  * [ 17] [FIXME]
</syntaxhighlight>يمكنك إضافة دعم لإمتدادات ملفات جديدة باستخدام الخيار <code>config.annotations.register_extensions</code> الذي يتلقى قائمة بالامتدادات مع التعبير النمطي (regex) المناسب لها لمطابقتهما.<syntaxhighlight lang="shell">
config.annotations.register_extensions("scss", "sass", "less") { |annotation| /\/\/\s*(#{annotation}):?\s*(.*)$/ }
</syntaxhighlight>تستطيع إن كنت تبحث عن تعليق توضيحي محدّد مثل <code>FIXME</code>، استخدام <code>bin/rails notes:fixme</code>. لاحظ أنَّ عليك تصغير أحرف اسم التعليق التوضيحي.<syntaxhighlight lang="shell">
$ bin/rails notes:fixme
(in /home/foobar/commandsapp)
app/controllers/admin/users_controller.rb:
  * [132] high priority for next deploy
 
app/models/school.rb:
  * [ 17]
</syntaxhighlight>يمكنك أيضًا استخدام تعليقات توضيحيّة مخصصّة في شفرتك وإدراجها باستخدام <code>bin/rails notes:custom</code> عبر تحديد التعليق التوضيحي باستخدام متغير البيئة <code>ANNOTATION</code>.<syntaxhighlight lang="shell">
$ bin/rails notes:custom ANNOTATION=BUG
(in /home/foobar/commandsapp)
app/models/article.rb:
  * [ 23] Have to fix this one before pushing!
</syntaxhighlight>لا يُعرَض اسم التعليق التوضيحي (<code>FIXME</code> و <code>BUG</code> وما إلى ذلك) في خطوط الإخراج (output lines) عند استخدام التعليقات التوضيحية والتعليقات التوضيحية المخصصّة.

سينظر <code>rails notes</code> افتراضيًّا في مجلّدات <code>app config</code> و <code>db</code> و <code>lib test</code>. إن أردت البحث في مجلّدات أخرى، تستطيع إعدادها باستخدام الخيار <code>config.annotations.register_directories</code>.<syntaxhighlight lang="shell">
config.annotations.register_directories("spec", "vendor")
</syntaxhighlight>يمكنك أيضًا تقديمها كقائمة مفصولة بفواصل في متغيّر البيئة <code>SOURCE_ANNOTATION_DIRECTORIES</code>.<syntaxhighlight lang="shell">
$ export SOURCE_ANNOTATION_DIRECTORIES='spec,vendor'
$ bin/rails notes
(in /home/foobar/commandsapp)
app/models/user.rb:
  * [ 35] [FIXME] User should have a subscription at this point
spec/models/user_spec.rb:
  * [122] [TODO] Verify the user that has a subscription works
</syntaxhighlight>

=== <code>routes</code> ===
سيسرد الأمر <code>rails routes</code> قائمة بجميع مساراتك المحدّدة والتي تفيد في تتبع مشكلات التوجيه في تطبيقك أو تقدّم لك نظرة عامة جيّدة على عناوين URL في تطبيق تحاول التعرّف عليه.

=== <code>test</code> ===
يرد وصف جيّد لاختبار الوحدة في ريلز في دليل [[Rails/testing|اختبار تطبيقات ريلز]].

تأتي ريلز مع جناح اختبار يسمى Minitest. ريلز تدين باستقرارها لاستخدام الاختبارات. تُساعد المهام المتوفّرة في مجال الاسم <code>:test</code>  في تشغيل الاختبارات المختلفة التي نأمل أن تكتبها.

=== <code>tmp</code> ===
المُجلّد Rails.root/tmp - الذي يشابه المُجلّد nix /tmp* - هو مكان الاحتجاز للملفات المؤقتة مثل ملفات هوية العمليّة والإجراءات المخزنة مؤقتًا.

تساعدك مهام مجال الاسم <code>:tmp</code> في مسح وإنشاء المجلّد Rails.root/tmp:
* rails tmp:cache:clear clears tmp/cache.
* rails tmp:sockets:clear clears tmp/sockets.
* rails tmp:screenshots:clear clears tmp/screenshots.
* rails tmp:clear clears all cache, sockets and screenshot files.
* rails tmp:create creates tmp directories for cache, sockets and pids.

=== منوّعات ===
* <code>rails stats</code> ممتازة للنظر في الإحصاءات بشفرتك، عرض أشياء مثل KLOCs (آلاف الأسطر من الشيفرات البرمجية) ونسبة شيفراتك مقابل الإختبارات.
* سيمنحك <code>rails secret</code> مفتاحًا عشوائيًا لاستخدامه في جلستك السريّة.
* يعطي <code>rails time:zones:all</code> قائمة بجميع المناطق الزمنيّة التي تعرفها ريلز.

=== مهمّات rake المخصّصة ===
تملك مهام rake المخصّصة الامتداد rake. وتوجد في Rails.root/lib/tasks. يمكنك إنشاء هذه المهام rake المخصّصة باستخدام الأمر <code>bin/rails generate task</code>.<syntaxhighlight lang="shell">
desc "I am short, but comprehensive description for my cool task"
task task_name: [:prerequisite_task, :another_task_we_depend_on] do
  # All your magic here
  # Any valid Ruby code is allowed
end
</syntaxhighlight>لتمرير الوسائط (arguments) لمهمتك rake المخصّصة:<syntaxhighlight lang="shell">
task :task_name, [:arg_1] => [:prerequisite_1, :prerequisite_2] do |task, args|
  argument_1 = args.arg_1
end
</syntaxhighlight>يمكنك تجميع المهام عن طريق وضعها في مجالات أسماء:<syntaxhighlight lang="shell">
namespace :db do
  desc "This task does nothing"
  task :nothing do
    # Seriously, nothing
  end
end
</syntaxhighlight>سيبدو استدعاء المهام كما يلي:<syntaxhighlight lang="shell">
$ bin/rails task_name
$ bin/rails "task_name[value 1]" # entire argument string should be quoted
$ bin/rails db:nothing
</syntaxhighlight>على مُهمّتك الاعتماد على المهمة <code>environment</code> التي تُحمّل رمز تطبيقك إن احتجت للتفاعل مع نماذج تطبيقاتك وإجراء استعلامات لقاعدة البيانات وما إلى ذلك.

== سطر الأوامر المتقّدم في ريلز ==
يركّز الاستخدام الأكثر تقدمًا لسطر الأوامر على إيجاد خيارات مفيدة (أو حتى مفاجئة في بعض الأحيان) في أدوات المُساعدة، وتخصيصها لاحتياجاتك وتدفق عملك. أدرجنا هنا بعض حيل ريلز.

=== ريلز مع قواعد البيانات و SCM ===
عند إنشاء تطبيق ريلز جديد، لديك خيار تحديد نوع قاعدة البيانات ونوع نظام إدارة الشيفرة المصدريّة التي سيستخدمها تطبيقك. سيوفر لك هذا بضع دقائق والكثير من ضغطات المفاتيح.

فلنلق نظرة على ما يوفّره الخيار <code>git--</code> والخيار <code>database=postgresql--</code> لنا:<syntaxhighlight lang="shell">
$ mkdir gitapp
$ cd gitapp
$ git init
Initialized empty Git repository in .git/
$ rails new . --git --database=postgresql
      exists
      create  app/controllers
      create  app/helpers
...
...
      create  tmp/cache
      create  tmp/pids
      create  Rakefile
add 'Rakefile'
      create  README.md
add 'README.md'
      create  app/controllers/application_controller.rb
add 'app/controllers/application_controller.rb'
      create  app/helpers/application_helper.rb
...
      create  log/test.log
add 'log/test.log'

</syntaxhighlight>كان علينا إنشاء المجلّد gitapp وتهيئة مستودع git فارغ قبل أن تضيف ريلز الملفات التي أنشأها لمستودعنا. فلنرى ما وضعه في إعداد قاعدة بياناتنا:<syntaxhighlight lang="shell">
$ cat config/database.yml
# PostgreSQL. Versions 9.1 and up are supported.
#
# Install the pg driver:
#   gem install pg
# On OS X with Homebrew:
#   gem install pg -- --with-pg-config=/usr/local/bin/pg_config
# On OS X with MacPorts:
#   gem install pg -- --with-pg-config=/opt/local/lib/postgresql84/bin/pg_config
# On Windows:
#   gem install pg
#       Choose the win32 build.
#       Install PostgreSQL and put its /bin directory on your path.
#
# Configure Using Gemfile
# gem 'pg'
#
default: &default
  adapter: postgresql
  encoding: unicode
  # For details on connection pooling, see Rails configuration guide
  # http://guides.rubyonrails.org/configuring.html#database-pooling
  pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
 
development:
  <<: *default
  database: gitapp_development
...
...
</syntaxhighlight>كما أنه ولّد بعض الأسطر في إعدادنا database.yml المقابل لاختيار PostgreSQL لقاعدة البيانات.

المشكلة الوحيدة في استخدام خيارات SCM هو أن عليك أن إنشاء مجلّد تطبيقك أولاً ثم تهيئة SCM لاحقًا، ثم يمكنك تشغيل الأمر <code>rails new</code> لإنشاء أساس تطبيقك.

== مصادر ==
* [https://guides.rubyonrails.org/command_line.html صفحة The Rails command line في ثوثيق Ruby On Rails الرّسمي.]