students_list_yaml_Quartz 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 95c6092475db21fe4c65f122426f93af80bad40716d3c43a612ffd7a9b6700ae
+  data.tar.gz: 33fcb5592ee4b4c9922537ce5c9e9c43d1850714764cbbe23200c156a77789ad
+SHA512:
+  metadata.gz: 8cc4a7aae5c8d4013323fd639e12246ff77e3342742ca44070c576283d46fe842cfbaad8cc5a5ca2682b652daa67e3387b32ac99d9d36ddbecc38e4c9015d90a
+  data.tar.gz: 378290c9c17c7685a217cac342d3a18ec74c53890644836ccc1c58a60d8767cfaf21165047f2dab2f09c73848ac63a65427c83df49e857c00cafe22b8bdadf23

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Quartz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,43 @@
+# StudentsListYaml
+
+TODO: Delete this and the text below, and describe your gem
+
+Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/students_list_yaml`. To experiment with that code, run `bin/console` for an interactive prompt.
+
+## Installation
+
+TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
+
+Install the gem and add to the application's Gemfile by executing:
+
+```bash
+bundle add UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+```
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+```bash
+gem install UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+```
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/students_list_yaml. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/students_list_yaml/blob/master/CODE_OF_CONDUCT.md).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the StudentsListYaml project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/students_list_yaml/blob/master/CODE_OF_CONDUCT.md).

data/lib/Base.rb

@@ -0,0 +1,35 @@
+class Base
+	
+	def git
+		@git
+	end
+	
+	def id
+		@id
+	end
+	
+	def contact
+		raise NotImplementedError
+	end
+	
+	def to_s
+		raise NotImplementedError
+	end
+	
+	def short_info
+		string = "id: #{id.to_s}, ФИО: #{last_name_initials}, гит: #{git}, контакт: #{contact}"
+	end
+	
+	def has_git?
+		@git!=nil
+	end
+	
+	def has_contact?
+		contact!=nil
+	end
+	
+	def last_name_initials
+		raise NotImplementedError
+	end
+	
+end

data/lib/README.rdoc

@@ -0,0 +1,164 @@
+= Students_list_JSON — README
+
+== Описание
+Класс Students_list_JSON — лёгкий Ruby-класс для управления коллекцией студентов, сериализуемой в JSON.
+Обеспечивает загрузку/сохранение из/в файла, CRUD-операции, постраничную выдачу сокращённых представлений (StudentShort) и сортировку.
+
+== Требования
+
+Ruby 2.5+ (или совместимая).
+
+Стандартная библиотека json.
+
+В проекте должны присутствовать файлы:
+
+student.rb — класс Student.
+
+student_short.rb — класс StudentShort.
+
+data_list_student_short.rb — класс DataListStudentShort (или общий DataList).
+
+== Установка
+Поместите файл students_list_json.rb в проект и подключите:
+
+require_relative 'students_list_json'
+require_relative 'student'
+require_relative 'student_short'
+require_relative 'data_list_student_short'
+
+
+== Быстрый старт — пример использования
+
+# инициализация (загрузка при наличии файла)
+list = Students_list_JSON.new('students.json')
+
+# добавление студента (предполагается реализация Student.from_hash/to_hash)
+student = Student.from_hash(first_name: 'Ivan', last_name: 'Ivanov')
+added = list.add_student(student)
+puts "Добавлен студент с id=#{added.id}"
+
+# сохранить в файл
+list.save_to_file
+
+# получить первого студента по id
+s = list.get_student_by_id(1)
+puts s.to_hash if s
+
+# постраничная выдача — 10 элементов, страница 1
+page = list.get_k_n_student_short_list(10, 1)
+puts page.data.map(&:to_hash)
+
+
+== API (краткое описание методов)
+
+Students_list_JSON.new(file_path = nil) — конструктор; при наличии существующего file_path автоматически выполняет загрузку.
+
+load_from_file — загрузка списка из @file_path. При некорректном JSON внутренний список очищается.
+
+save_to_file — сохраняет @students в @file_path в виде pretty JSON.
+
+get_student_by_id(id) — возвращает Student или nil.
+
+get_k_n_student_short_list(k, n, existing_data_list = nil) — возвращает постраничный список StudentShort. Если передан existing_data_list типа DataList, его поле data перезаписывается.
+
+sort_by_full_name — сортирует внутренний массив по last_name_initials.downcase.
+
+add_student(student) — добавляет студента, генерирует уникальный id, возвращает добавленный объект.
+
+replace_student_by_id(id, new_student) — заменяет студента с указанным id; возвращает true/false.
+
+delete_student_by_id(id) — удаляет студента(ов) по id; возвращает true/false.
+
+get_student_short_count — возвращает количество студентов (Integer).
+
+== Формат JSON (ожидаемый)
+Класс ожидает JSON-массив объектов, каждый объект — структура, совместимая с Student.from_hash и Student#to_hash.
+Пример:
+
+[
+  {"id":1,"first_name":"Ivan","last_name":"Ivanov","birth_date":"2000-01-01","group":"CS-101"},
+  {"id":2,"first_name":"Anna","last_name":"Petrova","birth_date":"1999-05-12","group":"CS-101"}
+]
+
+
+== Ожидаемый интерфейс зависимых классов
+Чтобы Students_list_JSON работал, зависимые классы должны поддерживать:
+
+Student
+
+.from_hash(hash) — создать объект из хэша.
+
+#to_hash — вернуть хэш для сериализации.
+
+#id — числовой идентификатор.
+
+#last_name_initials — строка для сортировки (например, "Ivanov I.P.").
+
+StudentShort
+
+.from_student(student) — создать сокращённое представление.
+
+#to_hash — (опционально) для сериализации.
+
+DataListStudentShort / DataList
+
+Конструктор DataListStudentShort.new(array_of_short_students) или объект с присваиваемым полем data для записи массива StudentShort.
+
+== Поведение и ошибки
+
+При JSON::ParserError — внутренний список очищается (чтобы избежать неконсистентных данных).
+
+Если file_path не указан — операции загрузки/сохранения игнорируются.
+
+get_k_n_student_short_list безопасно возвращает пустой список, если индекс выходит за пределы.
+
+replace_student_by_id и delete_student_by_id возвращают логические значения, не выбрасывают исключения при отсутствии записи.
+
+== Рекомендации по улучшению
+
+Добавить логирование ошибок при парсинге JSON вместо тихого rescue.
+
+Ввести валидацию входных объектов (проверять наличие to_hash, id и т.п.).
+
+Для многопоточных приложений — использовать Mutex для защиты @students.
+
+Валидация схемы JSON (gem json-schema или аналог).
+
+== Генерация RDoc-документации
+
+Убедитесь, что у вас установлен rdoc (если нет — gem install rdoc).
+
+В каталоге с проектом выполните:
+
+rdoc -o doc students_list_json.rb student.rb student_short.rb data_list_student_short.rb
+
+
+Откройте doc/index.html в браузере.
+
+Для генерации документации по всему проекту (включая README) выполните:
+
+rdoc -o doc .
+
+
+== Тестирование
+Рекомендуется покрыть тестами (RSpec/Minitest) сценарии:
+
+* загрузка корректного JSON;
+
+* поведение при некорректном JSON;
+
+* добавление/замена/удаление студентов;
+
+* постраничная выдача и граничные условия;
+
+* сохранение и повторная загрузка.
+
+== Лицензия
+Добавьте подходящую лицензию (например, MIT). Примерный блок для LICENSE:
+
+MIT License
+Copyright (c) <year> <author>
+...
+
+
+== Контакты / автор

data/lib/Rakefile.rb

@@ -0,0 +1,15 @@
+require 'rdoc/task'
+
+RDoc::Task.new do |rdoc|
+  rdoc.title = "StudentListJSON Documentation"
+  rdoc.rdoc_dir = 'doc'
+  rdoc.main = 'README.rdoc'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('Students_list_JSON.rb')
+  rdoc.rdoc_files.include('examples/*.rb')
+
+  rdoc.options << '--all'
+  rdoc.options << '--fmt=html'
+end
+
+task :default => :rdoc

data/lib/Students_list_JSON.rb

@@ -0,0 +1,86 @@
+require "json"
+require_relative 'student'
+require_relative 'student_short'
+require_relative 'data_list'
+
+class Students_list_JSON
+  attr_reader :file_path
+
+  def initialize(file_path = nil)
+    @file_path = file_path
+    @students = []
+    load_from_file if file_path && File.exist?(file_path)
+  end
+
+  def load_from_file
+    return unless @file_path && File.exist?(@file_path)
+
+    begin
+      content = File.read(@file_path)
+      return if content.strip.empty?
+
+      data = JSON.parse(content, symbolize_names: true)
+      @students = data.map { |hash| Student.from_hash(hash) }
+    rescue JSON::ParserError
+      @students = []
+    end
+  end
+
+  def save_to_file
+    return unless @file_path
+
+    data = @students.map(&:to_hash)
+    File.write(@file_path, JSON.pretty_generate(data))
+  end
+
+  def get_student_by_id(id)
+    @students.find { |student| student.id == id }
+  end
+
+  def get_k_n_student_short_list(k, n, existing_data_list = nil)
+    start_index = (n - 1) * k
+    selected = @students[start_index, k] || []
+
+    short_students = selected.map { |student| StudentShort.from_student(student) }
+
+    if existing_data_list && existing_data_list.is_a?(Data_list)
+	  existing_data_list.data = short_students
+	  existing_data_list
+	else
+	  Data_list_student_short.new(short_students)
+	end
+  end
+
+  def sort_by_full_name
+    @students.sort_by! { |student| student.last_name_initials.downcase }
+  end
+
+  def add_student(student)
+    new_id = @students.empty? ? 1 : @students.map(&:id).max + 1
+    student_with_id = Student.from_hash(student.to_hash.merge(id: new_id))
+    @students << student_with_id
+    student_with_id
+  end
+
+  def replace_student_by_id(id, new_student)
+    index = @students.find_index { |s| s.id == id }
+    return false unless index
+
+    @students[index] = Student.from_hash(new_student.to_hash.merge(id: id))
+    true
+  end
+
+  def delete_student_by_id(id)
+    size_before = @students.size
+    @students.reject! { |s| s.id == id }
+    size_before != @students.size
+  end
+
+  def get_student_short_count
+    @students.size
+  end
+
+  private
+
+  attr_writer :students
+end

data/lib/data_list.rb

@@ -0,0 +1,75 @@
+require_relative 'data_table'
+require_relative 'student_short'
+class Data_list
+	def initialize(data)
+		@data=data
+		@selected=[]
+	end
+	
+	def select(index)
+		@selected<<@data[index]
+	end
+	
+	def get_selected
+		@selected.map {|x| x.id}
+	end
+	
+	def clear_selected
+		@selected.clear
+	end
+
+	def get_names
+		[*get_names_v, "last_name_initials", "contact", "git"]
+	end
+
+	def get_data
+		table_data = @data.each_with_index.map do |student, index|
+			[index + 1] + get_data_v(student)
+		end
+		Data_table.new(table_data)
+	end
+	
+	def data=(data)
+		@data=data
+	end
+	
+	protected
+	
+	def get_data_v(student)
+		raise NotImplementedError
+	end
+	
+	def get_names_v
+		raise NotImplementedError
+	end
+end
+
+class Data_list_student_short < Data_list
+	private
+	def get_names_v
+		["№ по порядку"]
+	end
+
+	def get_data_v(student)
+		  [
+			student.last_name_initials,
+			student.contact,
+			student.git
+		  ]
+	end
+end
+
+
+
+# students = [
+  # StudentShort.new(id: 1, last_name_initials: "K.K.", contact: "kosta2005kes@gmail.com", git: "git2"),
+  # StudentShort.new(id: 2, last_name_initials: "L.T.", contact: "krutfortnite@gmail.com", git: "git2"),
+  # StudentShort.new(id: 3, last_name_initials: "K.V.", contact: "magasiay@gmail.com", git: "git3")
+# ]
+# list = Data_list_student_short.new(students)
+# list.select(0)
+# list.select(2)
+# table = list.get_data
+# puts table.get(0, 0)
+# puts table.get(1, 1)
+# puts list.get_names

data/lib/data_list_Student_short.rb

@@ -0,0 +1,18 @@
+require_relative 'data_list'
+require_relative 'student_short'
+
+class DataListStudentShort < DataList
+ 
+  private
+  def column_names
+    ["Фамилия И.О.", "Git", "Контакт"]
+  end
+  
+  def row_values(student_short)
+    [
+      student_short.last_name_initials || "",
+      student_short.git || "",
+      student_short.contact || ""
+    ]
+  end
+end

data/lib/data_table.rb

@@ -0,0 +1,17 @@
+class Data_table
+	def initialize(data)
+		@data=data
+	end
+	
+	def get(row_index, col_index)
+		@data[row_index][col_index]
+	end
+	
+	def row_count
+		@data.length
+	end
+
+	def column_count
+		@data.first.length
+	end
+end

data/lib/student.rb

@@ -0,0 +1,185 @@
+require_relative 'Base'
+class Student<Base
+	REGULAR_PHONE = /\A(\+7|8)?[\s\-\(]?(\d{3})[\s\-\)]?\s*(\d{3})[\s\-]?(\d{2})[\s\-]?(\d{2})\z/
+	REGULAR_GIT = /\Ahttps:\/\/(github|gitlab)\.com\/[a-zA-Z0-9_-]+\z/
+	REGULAR_NAME = /\A[A-ZА-ЯЁ][a-zа-яё]+\z/
+	REGULAR_EMAIL = /\A[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}\z/
+	REGULAR_TELEGRAM = /\A@[a-zA-Z0-9_]{5,32}\z/
+	include Comparable
+	attr_reader :first_name, :last_name, :patronymic
+    def initialize (last_name:, first_name:, patronymic: nil, id: nil, phone: nil, telegram: nil, email: nil, git: nil)
+        self.first_name= first_name
+		self.patronymic= patronymic
+		self.last_name= last_name
+		@id= id
+		self.contact= {:phone => phone, :email => email, :telegram => telegram}
+		self.git= git
+
+    end
+  def first_name=(value)
+        raise ArgumentError, "Неверное имя" unless self.class.valid_name?(value)
+        @first_name = value
+    end
+
+    def last_name=(value)
+        raise ArgumentError, "Неверная фамилия" unless self.class.valid_name?(value)
+        @last_name = value
+    end
+
+    def patronymic=(value) 
+        raise ArgumentError, "Неверное отчество" unless self.class.valid_name?(value) if !value.nil?
+        @patronymic = value
+    end
+
+    def git=(value)
+        raise ArgumentError, "Неверный Git" unless self.class.valid_git?(value) if !value.nil?
+        @git = value
+    end
+
+    def last_name_initials
+        string = "#{@last_name} #{@first_name[0]}."
+        if @patronymic != nil
+            return string + " #{@patronymic[0]}."
+        end
+        return string
+    end
+
+
+def contact
+        return "telegram - #{@telegram}" if @telegram
+        return "email - #{@email}" if @email
+        return "phone - #{@phone}" if @phone
+        nil
+    end
+ 
+    def contact=(contacts_hash)
+        contacts_hash.each do |type, value|
+            case type.to_sym
+            when :telegram
+                raise ArgumentError, "Неверный Telegram" unless self.class.valid_telegram?(value)
+                @telegram = value            
+            when :email
+                raise ArgumentError, "Неверный email" unless self.class.valid_email?(value)
+                @email = value
+            when :phone
+                raise ArgumentError, "Неверный телефон" unless self.class.valid_phone?(value)
+                @phone = value
+
+            end
+        end
+    end
+
+    def to_s
+        string = "Фамилия: #{@last_name}, Имя: #{@first_name}, Отчество: #{@patronymic.to_s} id: #{@id.to_s}, телефон: #{@phone.to_s}, телеграм: #{@telegram.to_s}, гит: #{@git.to_s}, почта: #{@email.to_s}"
+    end
+
+	def has_contact?
+		@email!=nil || @phone!=nil || @telegram!=nil
+	end
+	def self.valid_git?(git)
+		!!(git =~ REGULAR_GIT) || git==nil
+	end
+
+	def self.valid_telegram?(telegram)
+		!!(telegram =~ REGULAR_TELEGRAM) || telegram==nil
+	end
+
+	def self.valid_phone?(phone)
+		!!(phone =~ REGULAR_PHONE) || phone==nil
+	end
+
+	def self.valid_email?(email)
+		!!(email =~ REGULAR_EMAIL) || email==nil
+	end
+
+	def self.valid_name?(name)
+	  !!(name =~ REGULAR_NAME)
+	end
+	
+	def <=>(other)
+	  last_name_comparison = @last_name <=> other.last_name
+	  return last_name_comparison unless last_name_comparison == 0
+
+	  first_name_comparison = @first_name <=> other.first_name
+	  return first_name_comparison unless first_name_comparison == 0
+
+	  @patronymic.to_s <=> other.patronymic.to_s
+	end
+	
+
+  def ==(other)
+    return false unless other.is_a?(Base)
+    
+    contacts_overlap = false
+    [@phone, @email, @telegram].each do |contact|
+      next if contact.nil? || contact.empty?
+      if [other.instance_variable_get(:@phone), 
+          other.instance_variable_get(:@email), 
+          other.instance_variable_get(:@telegram)].include?(contact)
+        contacts_overlap = true
+        break
+      end
+    end
+    
+    comparison_key == other.comparison_key || contacts_overlap
+  end
+
+  alias eql? ==
+
+  def hash
+    comparison_key.hash
+  end
+
+  def to_hash
+    {
+      id: @id,
+      first_name: @first_name,
+      last_name: @last_name,
+      patronymic: @patronymic,
+      git: @git,
+      phone: @phone,
+      telegram: @telegram,
+      email: @email
+    }
+  end
+
+  def to_db_hash
+    {
+      first_name: @first_name,
+      last_name: @last_name,
+      patronymic: @patronymic,
+      git: @git,
+      phone: @phone,
+      telegram: @telegram,
+      email: @email
+    }
+  end
+
+  private
+
+  def fill_info_parts(info_parts)
+    info_parts << "Фамилия: #{last_name}"
+    info_parts << "Имя: #{first_name}"
+    info_parts << "Отчество: #{patronymic}" if patronymic
+    info_parts << "Телефон: #{@phone}" if @phone
+    info_parts << "Email: #{@email}" if @email
+    info_parts << "Telegram: #{@telegram}" if @telegram
+    info_parts << "Git: #{git}" if git
+  end
+
+  def comparison_key
+    [last_name, first_name, patronymic].map { |n| n || '' }
+  end
+	def self.from_hash(hash)
+	  new(
+		id: hash[:id],
+		last_name: hash[:last_name],
+		first_name: hash[:first_name],
+		patronymic: hash[:patronymic],
+		git: hash[:git],
+		phone: hash[:phone],
+		telegram: hash[:telegram],
+		email: hash[:email]
+	  )
+	end
+end

data/lib/student_short.rb

@@ -0,0 +1,26 @@
+require_relative 'Base'
+class StudentShort<Base
+	attr_reader :last_name_initials, :contact
+	def initialize (id:, last_name_initials:, contact:nil, git:nil)
+		@last_name_initials=last_name_initials
+		@id = id
+		@contact = contact
+		@git = git
+	end
+
+	def self.from_student(student)
+		new(id: student.id, last_name_initials: student.last_name_initials, contact: student.contact, git: student.git)
+	end
+
+	def to_s
+		string = "id: #{@id.to_s}, ФИО: #{@last_name_initials}, гит: #{@git}, контакт: #{@contact}"   
+	end
+
+	def last_name_initials
+		@last_name_initials
+	end
+	def contact
+		@contact
+	end
+
+end

data/lib/students_list_yaml/version.rb

@@ -0,0 +1,3 @@
+module StudentsListYaml
+  VERSION = "0.1.0"
+end

data/lib/students_list_yaml.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+require "yaml"
+require_relative "students_list_yaml/version"
+require_relative "student"
+require_relative "student_short"
+require_relative "data_list"
+require_relative "data_table"
+require_relative "base"
+
+module StudentsListYaml
+  class StudentsList
+    attr_reader :file_path
+
+    def initialize(file_path = nil)
+      @students = []
+      @file_path = file_path
+      load_data if file_path && File.exist?(file_path)
+    end
+
+    def load_data
+      return unless @file_path && File.exist?(@file_path)
+
+      begin
+        file_content = File.read(@file_path)
+        return if file_content.strip.empty?
+
+        data = YAML.safe_load(file_content, symbolize_names: true)
+        @students = data.map { |student_data| Student.from_hash(student_data) }
+      rescue Psych::SyntaxError
+        @students = []
+      end
+    end
+
+    def save_data
+      return unless @file_path
+
+      students_data = @students.map(&:to_hash)
+      File.write(@file_path, students_data.to_yaml)
+    end
+
+    def get_student_by_id(id)
+      @students.find { |student| student.id == id }
+    end
+
+    def get_k_n_student_short_list(k, n, existing_data_list = nil)
+      start_index = (n - 1) * k
+      selected_students = @students[start_index, k] || []
+
+      short_students = selected_students.map { |student| StudentShort.from_student(student) }
+
+      if existing_data_list && existing_data_list.is_a?(Data_list)
+        existing_data_list.data = short_students
+        existing_data_list
+      else
+        Data_list_student_short.new(short_students)
+      end
+    end
+
+    def sort_by_full_name
+      @students.sort_by! { |student| student.last_name_initials.downcase }
+    end
+
+    def add_student(student)
+      new_id = @students.empty? ? 1 : @students.map(&:id).max + 1
+      student_with_id = Student.from_hash(student.to_hash.merge(id: new_id))
+      @students << student_with_id
+      student_with_id
+    end
+
+    def replace_student_by_id(id, new_student)
+      index = @students.find_index { |s| s.id == id }
+      return false unless index
+
+      @students[index] = Student.from_hash(new_student.to_hash.merge(id: id))
+      true
+    end
+
+    def delete_student_by_id(id)
+      initial_size = @students.size
+      @students.reject! { |s| s.id == id }
+      initial_size != @students.size
+    end
+
+    def get_student_short_count
+      @students.size
+    end
+
+    private
+
+    attr_writer :students
+  end
+end

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification
+name: students_list_yaml_Quartz
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Kosta717
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+description: Класс для CRUD-операций со студентами и хранением в YAML-файле
+email:
+- kosta2005kes@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- lib/Base.rb
+- lib/README.rdoc
+- lib/Rakefile.rb
+- lib/Students_list_JSON.rb
+- lib/data_list.rb
+- lib/data_list_Student_short.rb
+- lib/data_table.rb
+- lib/student.rb
+- lib/student_short.rb
+- lib/students_list_yaml.rb
+- lib/students_list_yaml/version.rb
+homepage: https://github.com/Kosta717/students_list_YAML
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/Kosta717/students_list_YAML
+  source_code_uri: https://github.com/Kosta717/students_list_YAML
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.5'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: Управление списком студентов с сохранением в YAML
+test_files: []