student_list 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c73afb232da5b5b584617cc799aff8d41f4143ccd97cd61fca69bb2617c8d7cb
+  data.tar.gz: ff75edc9d6bb9ea223d1b45eccbae397d110792ace37961140a9daa1bba3ffd7
+SHA512:
+  metadata.gz: 93ed939b37348e7ff691ad7e589e29aca82a303eed09031556b90e274e807e58aa30123ac062d4cb1bc024415e92f3b988691f9cacd74d259adc4555fd67b4f6
+  data.tar.gz: 03b7cc945f1e3c87b8940b5070c360dfd29a42187aff9554cdb0e165883e9cc2428a025f5b50b21c7196a6e0d7b58a624a940c1359bcebad7d031d9644d1fd7e

data/lib/data_list.rb

@@ -0,0 +1,58 @@
+require_relative "data_table"
+
+class DataList
+
+  def object_list=(new_object_list)
+    @object_list = new_object_list
+    clear_selected
+  end
+
+  attr_reader :object_list, :selected
+
+  def initialize(object_list: )
+    @object_list = object_list
+    @selected = []
+    @atribute_names = get_atribute_names unless object_list.empty?
+  end
+
+  def select(number)
+    if number >= 0 && number < @object_list.size
+      @selected << number unless @selected.include?(number)
+    end
+  end
+
+  def get_selected(numbers)
+    @selected.map { |index| @object_list[index].id }
+  end
+
+  def get_names()
+      ["№"] + @atribute_names
+  end
+
+  def get_data()
+    result_data = []
+    name_columns = get_atribute_names()
+    @object_list.each do |elem|
+      hash = Hash.new
+      atribute_data = get_atribute_data(elem)
+      (0..name_columns.size).each do |index|
+        hash[name_columns[index]] = atribute_data[index]  
+      end
+      result_data.append(hash)
+    end
+    return DataTable.new(result_data)
+  end
+
+  def clear_selected()
+    @selected.clear
+  end
+
+  private
+  def get_atribute_data(elem)
+    raise NotImplementedError, "Метод должен быть реализован в наследнике"
+  end
+
+  def get_atribute_names()
+    raise NotImplementedError, "Метод должен быть реализован в наследнике"
+  end
+end

data/lib/data_list_student_short.rb

@@ -0,0 +1,20 @@
+require_relative "data_list"
+require_relative "student_short"
+
+class DataListStudentShort < DataList
+  def initialize(student_list)
+    super(object_list: student_list)
+  end
+
+  private
+
+  def get_atribute_names
+    ["last_name_initials", "contact", "git"]
+  end
+
+  def get_atribute_data(elem)
+    [elem.last_name_initials, elem.contact, elem.git]
+  end
+end
+
+

data/lib/data_table.rb

@@ -0,0 +1,96 @@
+class DataTable
+
+
+  attr_reader :columns
+
+  def initialize(objects)
+    @table = []
+    index = 0
+    @columns = []
+    return if objects.empty?
+    objects.each do |obj|
+      if @columns.empty?
+        @columns = obj.keys
+        @columns.unshift("№")
+      end
+      if obj.is_a?(Hash)
+        record = []
+        obj.each do |k, v|
+          record.append(v)
+        end
+        record.unshift(index)
+        @table.append(record)
+        index += 1
+      end
+    end
+  end
+
+  def [](row,col)
+    @table[row.to_i][1..][[col.to_i]]
+  end
+
+  def count_row
+    @table.size
+  end
+
+  def count_column
+    return 0 if @table.empty?
+    @columns.size
+  end
+
+  def to_s
+    return puts "Таблица пуста" if @table.empty?
+    column_widths = calculate_column_widths
+    print_border(column_widths)
+    print_row(@columns, column_widths)
+    print_separator(column_widths)
+    @table.each do |row|
+      print_row(row, column_widths)
+    end
+    print_border(column_widths)
+  end
+
+  private
+
+  def calculate_column_widths
+    widths = []
+    (0...count_column).each do |col|
+      max_width = @columns[col].to_s.length
+      
+      @table.each do |row|
+        cell_length = row[col].to_s.length
+        max_width = cell_length if cell_length > max_width
+      end
+      
+      widths << max_width
+    end
+    
+    widths
+  end
+
+  def print_border(widths)
+    border = "+"
+    widths.each do |width|
+      border += "#{'-' * (width + 2)}+"
+    end
+    puts border
+  end
+
+  def print_separator(widths)
+    separator = "+"
+    widths.each do |width|
+      separator += "#{'=' * (width + 2)}+"
+    end
+    puts separator
+  end
+
+  def print_row(row, widths)
+    line = "|"
+    row.each_with_index do |cell, index|
+      line += " #{cell.to_s.ljust(widths[index])} |"
+    end
+    puts line
+  end
+
+
+end

data/lib/student.rb

@@ -0,0 +1,137 @@
+require_relative 'student_template'
+
+class Student < TemplateStudent
+  include Comparable 
+
+  attr_reader :patronymic, :last_name, :first_name
+  def initialize(id: nil,
+                  first_name: , 
+                  last_name: , 
+                  patronymic: nil, 
+                  phone: nil,
+                  telegram: nil,
+                  email: nil,
+                  git: nil)
+    self.patronymic = patronymic
+    self.last_name = last_name
+    self.first_name = first_name
+    self.git = git
+    self.contact = {telegram: telegram, phone: phone, email: email}
+    super(id: id, git: git, contact: contact)
+  end
+
+  def <=>(other)
+    return nil unless other.is_a?(Student)
+    
+    self_name = "#{@first_name} #{@last_name} #{@patronymic}".downcase
+    other_name = "#{other.first_name} #{other.last_name} #{other.patronymic}".downcase
+    
+    self_name <=> other_name
+  end
+
+  def last_name_initials()
+    initials = "#{@first_name[0].upcase}."
+    initials += " #{@patronymic[0].upcase}." if @patronymic && !@patronymic.empty?
+    return "#{@last_name} #{initials}"
+  end
+
+  def contact()
+    if not @telegram.nil?
+      return "telegram - #{@telegram}"
+    elsif not @email.nil?
+      return "email - #{@email}"
+    elsif not @phone.nil?
+      return "phone - #{@phone}"
+    else return nil
+    end
+  end
+
+  def contact=(contact)
+      contact.each do |contact_type, contact_value|
+        case contact_type
+          when :telegram
+            validator_contact(telegram: contact_value)
+            @telegram = contact_value
+          when :phone
+            validator_contact(phone: contact_value)
+            @phone = contact_value
+          when :email
+            validator_contact(email: contact_value)
+            @email = contact_value
+          else
+            raise ArgumentError, "Указан верный тип контакта, допустимы контакты с типом tg, email, phone. Вы ввели тип #{contact_type}"
+        end
+    end
+  end
+
+  def to_s
+      info = ["ID: #{@id}", "Фамилия: #{@last_name}", "Имя: #{@first_name}"]
+      info << "Отчество: #{@patronymic}" if @patronymic
+      info << "Телефон: #{@phone}" if @phone
+      info << "Телеграм: #{@telegram}" if @telegram
+      info << "Почта: #{@email}" if @email
+      info << "Гит: #{self.git}" if self.git
+      info.join("\n")
+
+  end
+
+
+  def self.valid_email?(email)
+    return (email.nil? or email =~ /\A[\p{L}0-9+\-.]+@[a-z\d\-]+(\.[a-z]+)*\.[a-z]+\z/ui)
+  end
+
+  def self.valid_phone?(phone)
+    return (phone.nil? or phone =~ /^(\+7|8)?[\s-]?\(?(\d{3})\)?[\s-]?(\d{3})[\s-]?(\d{2})[\s-]?(\d{2})$/)
+  end
+
+  def self.valid_telegram?(telegram)
+    return telegram.nil? || telegram.empty? || telegram.match?(/^@[a-zA-Z0-9_]{5,32}$/)
+  end
+
+  def self.valid_git?(git)
+      return (git.nil? or git =~ /^https:\/\/(github|gitlab)\.com\/[a-zA-Z0-9_-]+\/?$/)
+  end
+
+  def self.valid_name?(student_names)
+    return (not student_names.nil? and student_names =~ /^[A-ZА-Я][a-zа-я]*$/)
+  end
+
+
+  private
+    def self.attr_writer_with_validation(*attributes) 
+      attributes.each do |attr|
+        define_method("#{attr}=") do |val|
+          valid_method = "valid_#{attr}?"
+          if [:patronymic, :last_name, :first_name].include?(attr)
+            valid_method = "valid_name?"
+            if val.nil? and [:patronymic].include?(attr)
+              return
+            end
+          end
+          if self.class.respond_to?(valid_method) && self.class.send(valid_method, val)
+            instance_variable_set("@#{attr}", val)
+          else
+            raise ArgumentError, "Невалидное значение #{attr}"  
+          end
+        end  
+      end 
+    end
+
+  def validator_contact(**kwargs)
+    kwargs.each do |arg, val|
+      next if val.nil?
+      case arg
+        when :phone
+          raise ArgumentError, "Ошибка валидации #{arg}" if not Student.valid_phone?(val)
+        when :email
+          raise ArgumentError, "Ошибка валидации #{arg}" if not Student.valid_email?(val)
+        when :telegram
+          raise ArgumentError, "Ошибка валидации #{arg}" if not Student.valid_telegram?(val)
+        else
+          raise ArgumentError, "Ошибка данный аргумент не предусмотрен как поле класса - #{arg}"
+      end
+    end
+  end
+attr_writer_with_validation :first_name, :last_name, :patronymic, :git
+end
+

data/lib/student_list.rb

@@ -0,0 +1,93 @@
+require 'data_list_student_short'
+require 'student'
+require 'student_short'
+
+
+class StudentList
+  def initialize()
+    @students_list = []
+  end
+
+  def excecute_data
+        raise NoMethodError, "Обязателен к переопределению"
+
+  end
+
+  def commit_data
+        raise NoMethodError, "Обязателен к переопределению"
+
+  end
+
+  def get_sudent_for_id(id)
+    @students_list.find{|student| student.id == id}
+  end
+
+  def get_k_n_student_short_list(k, n, exists_data_list=false)
+    start_index = (k - 1) * n
+    end_index = start_index + n - 1
+    students_slice = @students_list[start_index..end_index] || []
+    students_slice.map{|student| StudentShort.from_student(student)}
+    if exists_data_list
+      exists_data_list.object_list = students_slice
+      return exists_data_list
+    else
+      DataListStudentShort.new(students_slice)
+    end
+  end
+
+  def sort_by_initials
+    @students_list.sort_by! { |student| student.last_name_initials }
+  end
+
+  def add_student(last_name:, first_name:, patronymic: nil, phone: nil, telegram: nil, email: nil, git: nil)
+    new_id = generate_new_id    
+    student = Student.new(
+      id: new_id,
+      first_name: first_name,
+      last_name: last_name,
+      patronymic: patronymic,
+      phone: phone,
+      telegram: telegram,
+      email: email,
+      git: git
+    )
+    
+    @students_list << student
+    commit_data # Сохраняем изменения
+    student
+  end
+  
+  def update_student(id, last_name:, first_name:, patronymic: nil, phone: nil, telegram: nil, email: nil, git: nil)
+    student = get_sudent_for_id(id)
+    return false unless student
+    student.last_name = last_name
+    student.first_name = first_name
+    student.patronymic = patronymic if patronymic
+    student.git = git if git
+    contact = {}
+    contact[:phone] = phone if phone
+    contact[:telegram] = telegram if telegram
+    contact[:email] = email if email
+    student.contact = contact unless contact.empty?
+    commit_data
+    true
+  end
+  
+
+  def delete_student(id)
+    deleted = @students_list.reject! { |student| student.id == id }
+    commit_data if deleted
+    !deleted.nil?
+  end
+  
+  def get_student_short_count
+    @students_list.count
+  end
+
+  private
+  def generate_new_id
+    max_id = @students_list.map { |s| s.id.to_i }.max || 0
+    (max_id + 1).to_s
+  end
+
+end

data/lib/student_list_file.rb

@@ -0,0 +1,66 @@
+require_relative "student_list"
+
+
+class StudentListFile < StudentList
+  def file_path=(val)
+    if File.exist?(val)
+      @file_path = val
+      return
+    end
+    raise ArgumentError, "Такого файла не существует"
+  end
+
+  attr_reader :file_path, :students_list
+
+  def initialize(file_path: )
+    self.file_path = file_path
+    super()
+    file_read
+  end
+
+  def load_file()
+    raise NoMethodError, "Обязателен к переопределению"
+  end
+
+  def get_data_write(data)
+    raise NoMethodError, "Обязателен к переопределению"
+  end
+
+  def file_read()
+    data = load_file
+    data.each do |student_data|
+      begin
+        self.students_list << Student.new(**student_data)
+      rescue StandardError => e
+        puts "Ошибка создания студента #{student_data}: #{e.message}"
+      end
+    end
+  end
+
+  def file_write()
+    data = self.students_list.map { |student| student_to_hash(student) }
+    File.write(@file_path, get_data_write(data))
+  end
+
+  def commit_data
+    file_write
+  end
+
+  def read_data
+    file_read
+  end
+
+  def student_to_hash(student)
+    {
+      id: student.id,
+      first_name: student.first_name,
+      last_name: student.last_name,
+      patronymic: student.patronymic,
+      phone: student.instance_variable_get(:@phone),
+      telegram: student.instance_variable_get(:@telegram),
+      email: student.instance_variable_get(:@email),
+      git: student.git
+    }.compact
+  end
+
+end

data/lib/student_list_json.rb

@@ -0,0 +1,83 @@
+require 'json'
+require_relative 'student_list_file'
+
+class StudentListJSON < StudentListFile
+  def initialize(file_path: )
+    super(file_path: file_path)
+  end
+
+  def load_file()
+    JSON.parse(File.read(@file_path), symbolize_names: true)
+  end
+
+  def get_data_write(data)
+    JSON.pretty_generate(data)
+  end
+end
+
+# Основная программа
+if __FILE__ == $0
+  filename = '/home/danil/design-patterns-template/src/lab_4/students.json'
+    
+  # Создаем экземпляр класса
+  student_list = StudentListJSON.new(file_path: filename)
+  
+  puts "Загружено студентов: #{student_list.get_student_short_count}"
+  
+  # Выводим исходный порядок
+  puts "\nИсходный список студентов:"
+  student_list.students_list.each do |student|
+    puts "#{student.last_name_initials} (ID: #{student.id})"
+  end
+  
+  # Сортируем по инициалам
+  puts "\nПосле сортировки по инициалам:"
+  student_list.sort_by_initials
+  student_list.students_list.each do |student|
+    puts student.last_name_initials
+  end
+  
+  # Получаем список (первые 2 элемента)
+  puts "\nПолучаем первые 2 студента:"
+  short_list = student_list.get_k_n_student_short_list(1, 2)
+  puts short_list.get_data()
+  # Добавляем нового студента
+  puts "\nДобавляем нового студента:"
+  new_student = student_list.add_student(
+    last_name: "Павлов",
+    first_name: "Артем", 
+    patronymic: "Викторович",
+    phone: "+79165554433",
+  )
+  puts "Добавлен: #{new_student.last_name_initials}"
+  
+  # Получаем студента по ID
+  puts "\nПоиск студента по ID 2:"
+  found_student = student_list.get_sudent_for_id("2")
+  if found_student
+    puts "Найден: #{found_student.last_name_initials}"
+  end
+  
+  # Обновляем студента
+  puts "\nОбновляем студента с ID 3:"
+  if student_list.update_student("3", 
+    last_name: "Волкова", 
+    first_name: "Мария",
+    patronymic: "Александровна",
+    )
+    puts "Студент обновлен"
+  end
+  
+  # Выводим финальный список
+  puts "\nФинальный список студентов (#{student_list.get_student_short_count} чел.):"
+  student_list.students_list.each do |student|
+    puts "#{student.last_name_initials} (ID: #{student.id})"
+  end
+  
+  # Демонстрация пагинации
+  puts "\nДемонстрация пагинации (по 2 студента на странице):"
+  (1..3).each do |page|
+    short_list = student_list.get_k_n_student_short_list(page, 2, short_list)
+    puts "Страница #{page}: #{short_list.get_data}"
+  end
+end

data/lib/student_list_yaml.rb

@@ -0,0 +1,83 @@
+require_relative 'student_list_file'
+require 'yaml'
+
+class StudentListYAML < StudentListFile
+  def initialize(file_path: )
+    super(file_path: file_path)
+  end
+
+  def load_file()
+    YAML.load_file(@file_path, symbolize_names: true)
+  end
+
+  def get_data_write(data)
+    data.to_yaml
+  end
+end
+
+# Основная программа
+if __FILE__ == $0
+  filename = '/home/danil/design-patterns-template/src/lab_4/students.yaml'
+    
+  # Создаем экземпляр класса
+  student_list = StudentListYAML.new(file_path: filename)
+  
+  puts "Загружено студентов: #{student_list.get_student_short_count}"
+  
+  # Выводим исходный порядок
+  puts "\nИсходный список студентов:"
+  student_list.students_list.each do |student|
+    puts "#{student.last_name_initials} (ID: #{student.id})"
+  end
+  
+  # Сортируем по инициалам
+  puts "\nПосле сортировки по инициалам:"
+  student_list.sort_by_initials
+  student_list.students_list.each do |student|
+    puts student.last_name_initials
+  end
+  
+  # Получаем список (первые 2 элемента)
+  puts "\nПолучаем первые 2 студента:"
+  short_list = student_list.get_k_n_student_short_list(1, 2)
+  puts short_list.get_data()
+  # Добавляем нового студента
+  puts "\nДобавляем нового студента:"
+  new_student = student_list.add_student(
+    last_name: "Павлов",
+    first_name: "Артем", 
+    patronymic: "Викторович",
+    phone: "+79165554433",
+  )
+  puts "Добавлен: #{new_student.last_name_initials}"
+  
+  # Получаем студента по ID
+  puts "\nПоиск студента по ID 2:"
+  found_student = student_list.get_sudent_for_id("2")
+  if found_student
+    puts "Найден: #{found_student.last_name_initials}"
+  end
+  
+  # Обновляем студента
+  puts "\nОбновляем студента с ID 3:"
+  if student_list.update_student("3", 
+    last_name: "Волкова", 
+    first_name: "Мария",
+    patronymic: "Александровна",
+    )
+    puts "Студент обновлен"
+  end
+  
+  # Выводим финальный список
+  puts "\nФинальный список студентов (#{student_list.get_student_short_count} чел.):"
+  student_list.students_list.each do |student|
+    puts "#{student.last_name_initials} (ID: #{student.id})"
+  end
+  
+  # Демонстрация пагинации
+  puts "\nДемонстрация пагинации (по 2 студента на странице):"
+  (1..3).each do |page|
+    short_list = student_list.get_k_n_student_short_list(page, 2, short_list)
+    puts "Страница #{page}: #{short_list.get_data}"
+  end
+end

data/lib/student_short.rb

@@ -0,0 +1,30 @@
+require_relative 'student'
+require_relative 'student_template'
+
+class StudentShort < TemplateStudent
+    def initialize(id:, last_name_initials:, contact: nil, git: nil)
+        @last_name_initials = last_name_initials
+        @contact = contact
+        super(id: id, contact: contact, git: git)
+    end
+
+    def contact()
+      @contact
+    end
+
+    def last_name_initials()
+      @last_name_initials
+    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
+        self.short_info
+    end
+end

data/lib/student_template.rb

@@ -0,0 +1,34 @@
+class TemplateStudent
+    
+  def contact()
+    raise NoMethodError, "Обязателен к переопределению"
+  end
+  
+  def last_name_initials()
+    raise NoMethodError, "Обязателен к переопределению"
+  end
+
+  attr_reader :id, :git
+  
+  def initialize(id: , contact: nil, git: nil)
+    @id = id
+    @contact = contact
+    @git = git
+  end
+
+  def short_info()
+      info = ["ID: #{@id}", "ФИО: #{last_name_initials()}"]
+      info << (@contact || "нет контакта")
+      info << "Гит: #{@git || 'нет'}"
+      info.join(", ")
+  end
+
+  def has_git?
+      !git.nil? && !git.empty?
+  end
+
+  def has_contact?
+      !contact.nil? && !contact.empty?
+  end
+
+end

data/lib/students_list.rb

@@ -0,0 +1,14 @@
+# Главный файл gem - загружает все зависимости
+require_relative 'data_list'
+require_relative 'data_table'
+require_relative 'data_list_student_short'
+require_relative 'student'
+require_relative 'student_short'
+require_relative 'students_list'
+require_relative 'student_template'
+require_relative 'student_list'
+require_relative 'student_list_file'
+require_relative 'student_list_json'
+require_relative 'student_list_yaml'
+
+puts "✅ StudentList gem loaded successfully!"

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification
+name: student_list
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- KotDev
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2025-10-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: psych
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Manage student lists with YAML and JSON storage
+email:
+- kotikov.lil@bk.ru
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/data_list.rb
+- lib/data_list_student_short.rb
+- lib/data_table.rb
+- lib/student.rb
+- lib/student_list.rb
+- lib/student_list_file.rb
+- lib/student_list_json.rb
+- lib/student_list_yaml.rb
+- lib/student_short.rb
+- lib/student_template.rb
+- lib/students_list.rb
+homepage: 
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.11
+signing_key: 
+specification_version: 4
+summary: Student list management
+test_files: []