Auto | arch-x1: 2026-06-03 21:34:10

This commit is contained in:
Dmitry
2026-06-03 21:34:10 +03:00
parent b0e229d980
commit 68ce894541
141 changed files with 1 additions and 10750 deletions
@@ -1,172 +0,0 @@
---
status: processing
type: knowledge
tags:
- programming
- ruby
created: 2026-05-17
updated: 2026-05-26
title: Ruby - массивы
source:
- "[[Ruby - массивы]]"
- "[[Итераторы для обработки массивов Ruby]]"
---
# Ruby — массивы
Массив в Ruby — экземпляр класса `Array`. Поскольку массивы являются объектами со своими методами, работа со списками данных упрощается.
Связанные темы: [[Ruby - основы языка]]
## Создание массива
```ruby
a1 = [1, 2, 3] # литерал
a2 = %w{word1 word2} # массив строк без кавычек
a3 = ['start', nil, 5, [1, 2]] # разнотипные элементы, вложенный массив
a4 = Array.new # пустой массив
a5 = Array.new(3) # [nil, nil, nil]
a6 = Array.new(5, "Test") # ["Test", "Test", ...]
a7 = Array.new(5) { |i| i * i } # [0, 1, 4, 9, 16]
a8 = Array.[](1, 'a', /^A/) # через метод класса
```
Ruby поддерживает многомерные массивы с элементами разной размерности.
## Индексация
```ruby
a[0] # первый элемент
a[-1] # последний элемент
a[-2] # предпоследний
```
### Размер
```ruby
a.size # количество элементов
a.length # синоним size
```
## Поиск элементов
```ruby
a.include?(obj) # => true / false
a.index(obj) # индекс первого вхождения или nil
```
## Добавление элементов
```ruby
a << 4 # в конец
a += [5] # объединение
a.push(6) # в конец (синоним: append)
a.unshift(0) # в начало (сдвигает остальные вправо)
a.insert(2, x) # вставить перед элементом с индексом 2
```
## Удаление элементов
```ruby
a.delete(obj) # удалить все вхождения obj
a.delete_at(index) # удалить по индексу
a.delete_if { |x| block } # удалить все, подходящие под условие
a.shift # удалить и вернуть первый элемент
a.pop # удалить и вернуть последний элемент
```
## Срезы
```ruby
a[1..3] # диапазон индексов
a[1, 3] # начиная с индекса 1, длиной 3
a.values_at(0, 2, 4) # элементы по перечисленным индексам или диапазонам
a.first(n) # первые n элементов
a.last(n) # последние n элементов
```
## Полезные методы
```ruby
a.flatten # развернуть многомерный массив в одномерный
a.flatten! # то же, но изменяет сам массив
a.sample # случайный элемент
a.sample(n) # n случайных элементов
a.select { |x| block } # массив элементов, для которых block == true
```
## Итераторы
`each` перебирает элементы массива:
```ruby
ary.each { |item| block }
```
Пример:
```ruby
arr.each do |x|
if x > 0 && x % 5 == 0
arr_out << x
end
end
```
`each_index` перебирает индексы:
```ruby
ary.each_index { |index| block }
```
Похожий проход по индексам:
```ruby
(0...arr.size).each do |i|
if arr[i] > 0 && arr[i] % 5 == 0
arr_out << arr[i]
end
end
```
### Поиск минимума, максимума и индексов
Императивный вариант:
```ruby
a = gets.chomp.split.map { |i| i.to_i }
p a
max = min = a[0]
maxi = mini = 0
for i in 1...a.size
if a[i] > max
max = a[i]
maxi = i
end
if a[i] < min
min = a[i]
mini = i
end
end
puts "Максимальное число: #{max}, индекс: #{maxi}"
puts "Минимальное число: #{min}, индекс: #{mini}"
```
Через методы массива:
```ruby
a = gets.chomp.split.map { |i| i.to_i }
p a
max = a.max
min = a.min
maxi = a.index(max)
mini = a.index(min)
```
@@ -1,293 +0,0 @@
---
status: processing
type: knowledge
tags:
- programming
- ruby
created: 2026-05-17
updated: 2026-05-26
title: Ruby - основы языка
source:
- "[[Ruby - основы языка]]"
- "[[Знания Ruby]]"
---
# Ruby — основы языка
Ruby — объектно-ориентированный язык, но допускает процедурный стиль написания кода. Всё является объектом, включая числа и булевы значения.
Связанные темы: [[Ruby On Rails]]
## Синтаксис
- Знак препинания в конце строки не нужен
- Отступы не несут синтаксического смысла (в отличие от Python)
- Несколько команд в одной строке разделяются через `;`
```ruby
puts "Hello World!"
puts 42; puts "next line"
```
## Комментарии
```ruby
# однострочный комментарий
=begin
многострочный
комментарий
=end
```
## Типы данных
```ruby
"Hello".class # => String
true.class # => TrueClass
5.class # => Integer
6.4.class # => Float
nil.class # => NilClass
```
### Именование
- Переменные — с маленькой буквы: `my_var`
- Классы — с большой буквы: `MyClass`
- Ключевые слова языка использовать нельзя
### Преобразование типов
**Явное:**
| Метод | Что делает |
|--------|-----------------------------------------|
| `to_i` | к целому числу (дробная часть отсекается) |
| `to_f` | к вещественному числу |
| `to_s` | к строке |
**Неявное:** при математических операциях `Integer + Float``Float`.
## Значения по умолчанию
Для присваивания значения по умолчанию часто используют `||=`:
```ruby
a ||= 'что-то'
# то же самое, что:
a = a || 'что-то'
```
Это работает из-за того, что в Ruby только `nil` и `false` считаются falsey. Все остальные значения, включая `0`, пустую строку и пустой массив, в условиях считаются truthy.
Ограничение: `||=` не подходит, если `false` — допустимое сохранённое значение.
## Предикаты
В Ruby проверки часто оформляют методами-предикатами с `?` на конце:
```ruby
0.zero? # => true
1.zero? # => false
2.positive? # => true
8.even? # => true
8.odd? # => false
''.empty? # => true
'wow'.empty? # => false
something.nil?
items.any?
items.empty?
```
## Управляющие конструкции
```ruby
# if без ветвления
if a > 0
action
end
# if-elsif-else
if a > 0
...
elsif a == 0
...
else
...
end
# unless — выполнится, если условие ложно
unless a > 0
action
end
# case
case a
when 1 then puts "один"
when 2 then puts "два"
else puts "другое"
end
```
### Альтернативные условия
Тернарный оператор — короткая форма `if/else`, когда нужно выбрать одно из двух значений:
```ruby
condition ? value_if_true : value_if_false
```
Пример:
```ruby
age = 20
status = age >= 18 ? 'adult' : 'minor'
# => "adult"
```
Обычный `if/else` для того же случая:
```ruby
status =
if age >= 18
'adult'
else
'minor'
end
```
Тернарный оператор удобен, когда обе ветки короткие и возвращают простые значения:
```ruby
message = user.nil? ? 'Гость' : user.name
price = discount ? base_price * 0.9 : base_price
```
Если логика занимает несколько строк, лучше использовать обычный `if/else`. Вложенные тернарные операторы тоже лучше не писать: они быстро становятся нечитаемыми.
Плохой вариант:
```ruby
result = a > 0 ? 'positive' : a < 0 ? 'negative' : 'zero'
```
Постфиксный `if` используют для коротких выражений:
```ruby
do_something if num.zero?
```
`unless` выполняет блок, если условие ложно:
```ruby
unless something.zero?
do_something
end
```
Сложные условия внутри `unless` лучше не писать: `unless a && b` читается хуже явного `if`.
## Логические операторы
```ruby
true && false # => false
false || true # => true
!true # => false
```
Сравнение с логическими значениями строгое:
```ruby
true == 1 # => false
false == nil # => false
```
Логические операторы возвращают не обязательно `true` или `false`, а последнее вычисленное значение:
```ruby
0 && 'one' # => "one"
nil && false # => nil
```
## Оператор `<=>`
`<=>` называют spaceship-оператором. Он возвращает `-1`, `0` или `1` и часто используется при сортировке:
```ruby
1 <=> 1 # => 0
2 <=> 1 # => 1
1 <=> 2 # => -1
```
## Строки
Конкатенация:
```ruby
name = 'H' + 'e' + 'x' + 'l' + 'e' + 't'
name = 'H' 'e' 'x' 'l' 'e' 't'
```
Интерполяция работает только в двойных кавычках:
```ruby
greeting = "hello #{name}"
line_feed = "one line\nanother one"
```
Полезные методы:
```ruby
name = 'ruby'
name.upcase # => "RUBY"
name.include?('ru')
name.capitalize # => "Ruby"
name.length # => 4
```
Срезы:
```ruby
name = 'ruby'
name[1] # => "u"
name[-1] # => "y"
name[0, 2] # => "ru"
name[0..-2] # => "rub"
name[-4..] # => "ruby"
name[/ru/] # => "ru"
```
Пример маскирования номера карты:
```ruby
def prepare_card_for_display(num)
"**#{num[-4..]}"
end
```
## Циклы
| Оператор | Назначение |
|----------|-----------|
| `loop` | бесконечный цикл; выход через `break` |
| `while` | цикл с условием выполнения |
| `until` | цикл, пока условие ложно |
| `for` | итератор по перечислимому объекту |
| `next` | пропустить текущий шаг |
| `redo` | повторить текущий шаг заново |
**Диапазоны в `for`:**
```ruby
for i in 1..5 # от 1 до 5 включительно
for i in 1...5 # от 1 до 4 (5 не входит)
```
**Деление с остатком:**
```ruby
x, r = x.divmod(n)
```
@@ -1,74 +0,0 @@
---
status: seed
type: guide
tags:
- programming
- ruby-on-rails
- api
created: 2026-05-25
updated: 2026-05-25
title: API импорт в Rails через runner
source: "[[Работа с API для проекта Attendance Mephi]]"
---
# API импорт в Rails через runner
Памятка по ручному запуску импортов в [[Ruby On Rails]]-проекте Attendance Mephi для [[НИР]].
## Контекст
Импорт запускается через `bin/rails runner`:
```sh
/home/ada/.local/bin/mise exec ruby -- bin/rails runner '...'
```
Актуальный семестр берется из `Term.actual`. Для старта `2026-02-07` код семестра: `20252`.
## Credentials
```yaml
api:
home_mephi:
host:
code:
token:
students_mephi:
host:
username:
password:
```
См. также: [[Rails credentials edit не открывает редактор]].
## Endpoints
```text
GET {home_mephi.host}/study_groups.json?term_code=20252&code=...&token=...
GET {home_mephi.host}/tutors.json?term_code=20252&code=...&token=...
GET {students_mephi.host}/get_list_by_group_name?group=...&term=20252
GET {home_mephi.host}/tutors/{staff_id}/schedules.json?term_code=20252&date=YYYY-MM-DD&code=...&token=...
```
`students_mephi` использует Basic Auth: `username/password`.
## Ручная загрузка
```sh
/home/ada/.local/bin/mise exec ruby -- bin/rails runner 'ImportGroupsService.execute'
/home/ada/.local/bin/mise exec ruby -- bin/rails runner 'ImportTutorsService.execute'
/home/ada/.local/bin/mise exec ruby -- bin/rails runner 'ImportStudentsService.execute'
/home/ada/.local/bin/mise exec ruby -- bin/rails runner 'term = Term.actual; ImportDisciplineService.execute(nil, term)'
```
Расписание на сегодня:
```sh
/home/ada/.local/bin/mise exec ruby -- bin/rails runner 'term = Term.actual; ImportScheduleService.execute(Date.today, term)'
```
Расписание за весь семестр до сегодня:
```sh
/home/ada/.local/bin/mise exec ruby -- bin/rails runner 'term = Term.actual; finish = [term.get_finish_date, Date.today].min; (term.start_date..finish).each { |date| ImportScheduleService.execute(date, term) unless date.wday == 0 }'
```
@@ -1,42 +0,0 @@
---
status: seed
type: guide
tags:
- programming
- ruby-on-rails
- deploy
created: 2026-05-29
updated: 2026-05-29
title: Capistrano deploy через systemd
source: "[[Команды для деплоя с помощью Capistrano]]"
---
# Capistrano deploy через systemd
Заметка про выдачу минимальных `sudo`-прав для деплоя Rails-приложения через Capistrano, когда сервисы управляются через `systemd`.
## Sudoers
В `/etc/sudoers` задаётся alias для команд, которые Capistrano может выполнять без пароля:
```sudoers
Cmnd_Alias PUMA_CONTROL = /usr/bin/mv /tmp/navigation_backend_puma_production.service /etc/systemd/system/, /usr/bin/mv /tmp/navigation_backend_puma_production.socket /etc/systemd/system/, /bin/systemctl daemon-reload, /bin/systemctl enable navigation_backend_puma_production, /bin/systemctl start navigation_backend_puma_production, /bin/systemctl stop navigation_backend_puma_production, /bin/systemctl restart navigation_backend_puma_production, /bin/systemctl enable navigation_backend_puma_production.socket, /bin/systemctl restart navigation_backend_sidekiq_production.service, /bin/systemctl restart navigation_backend_solid_queue_production.service, /bin/systemctl restart solid_queue
deploy ALL = NOPASSWD: PUMA_CONTROL
```
Где:
- `deploy` — пользователь, от имени которого выполняется деплой;
- `navigation_backend` — имя приложения в service/socket unit-файлах.
## Команды деплоя
```bash
cap production puma:install
cap production deploy
```
`puma:install` кладёт `systemd` unit-файлы, после чего `deploy` перезапускает Puma и фоновые сервисы без интерактивного ввода пароля.
## Связанные заметки
- [[Ruby On Rails]]
- [[Sidekiq - основа работы]]
@@ -1,70 +0,0 @@
---
status: seed
type: guide
tags:
- programming
- ruby-on-rails
- debug
created: 2026-05-20
updated: 2026-05-20
title: Rails credentials edit не открывает редактор
source: "[[99 System/Archive/Rails credentials edit не открывает редактор|Rails credentials edit не открывает редактор]]"
---
# Rails credentials edit не открывает редактор
Заметка фиксирует кейс, когда `bin/rails credentials:edit` в [[Ruby On Rails]] завершается без открытия редактора и без явной ошибки.
## Симптом
Команда:
```bash
bin/rails credentials:edit
```
сразу печатает:
```text
File encrypted and saved.
```
При этом редактор не открывается, а credentials фактически не меняются.
## Причина
Rails 7.x выбирает редактор через helper `rails/command/helpers/editor.rb` и берёт `$VISUAL` приоритетнее `$EDITOR`.
Если переменная окружения `$VISUAL` установлена, например в `zed` или `code`, значение `$EDITOR` игнорируется. Если указанный в `$VISUAL` редактор не найден или не может быть запущен, системный вызов завершается с ошибкой, но Rails может молча продолжить выполнение и сохранить файл без изменений.
Связанный контекст: [[Environment Variables]] и [[Command Path]].
## Решение
На один запуск явно сбросить `$VISUAL` и задать рабочий редактор:
```bash
VISUAL="" EDITOR="nano" bin/rails credentials:edit
```
Можно заменить `nano` на любой редактор, который доступен в текущем окружении.
## Диагностика
Проверить, не установлен ли `$VISUAL`:
```bash
echo "VISUAL='$VISUAL'"
```
Проверить, находится ли редактор в `PATH`:
```bash
which nano
```
Если используется GUI-редактор вроде `code` или `zed`, отдельно проверить, что его CLI-команда доступна из той же shell-сессии, где запускается Rails.
## Практический вывод
Для `credentials:edit` важен не только `$EDITOR`, но и `$VISUAL`. Если Rails ведёт себя так, будто файл был сохранён без редактирования, сначала проверить переменные окружения редактора и доступность команды редактора через `PATH`.
@@ -1,21 +0,0 @@
---
status: processing
type: moc
tags:
- programming
- ruby-on-rails
created: 2025-12-17
updated: 2026-05-29
title: Ruby On Rails
---
# Ruby On Rails
%% Begin Waypoint %%
- [[Active Storage]]
- [[API импорт в Rails через runner]]
- [[Capistrano deploy через systemd]]
- [[Rails credentials edit не открывает редактор]]
- [[Sidekiq - основа работы]]
%% End Waypoint %%