students_list_yaml_gems 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 24550a4c94d1481f0231db32635e5f6065ce116bb1db7d2617780e1f2f31f6eb
+  data.tar.gz: 20753b23b4029e82c7f6b1be5a44a31e45c5db36b7e883b6d0ac71a3bbac7ba5
+SHA512:
+  metadata.gz: 75df2aa0f5c7f3cf46b0cdfcdc978c40ad522dbaab586ded7caf2748d02256f064fde1fe1a0c88a98ba562e5d99d1b8570944b0c118b22a5a190f117ef25522c
+  data.tar.gz: 621f9b6c890d1c4ff44d6fb5b997753c84a88107d6733bb3546ed996f5e19a075ac50a9f5f7519b1428cb9861d43ede8b35d3c17e3cd78f8024299beab11e8a9

data/lib/data_list.rb

@@ -0,0 +1,42 @@
+require_relative 'data_table'
+class Data_list
+  def initialize(array)
+    @selected = []
+    @elements = array
+  end
+
+  def select(number)
+    @selected << @elements[number]
+  end
+
+  def get_selected
+    @selected.map{ |x| x.id }
+  end
+
+  def get_names
+    get_names = ["№ по порядку"] + template_get_names()
+  end
+
+  def get_data
+    get_data = []
+    @elements.each_with_index do |item, index|
+      get_data << [index] + template_get_data(item)
+    end
+    Data_table.new(get_data)
+  end
+
+  def clear_selected
+    @selected.clear
+  end
+
+  protected
+
+  def template_get_data(item)
+    raise 'NotImplementedError'
+  end
+
+  def template_get_names
+    raise 'NotImplementedError'
+  end
+
+end

data/lib/data_list_student_short.rb

@@ -0,0 +1,24 @@
+require_relative 'data_list'
+require_relative 'student_short'
+class Data_list_student_short < Data_list
+
+  def array=(array)
+    @array = array
+  end
+
+  def initialize(array)
+    super
+    self.array=array
+  end
+  
+  private
+
+  def template_get_names
+    names = [ "Last name initialize", "Contact", "Git" ]
+  end
+
+  def template_get_data(value)
+    data = [ value.last_name_initials, value.contact || "", value.git || "" ]
+  end
+
+end

data/lib/data_table.rb

@@ -0,0 +1,24 @@
+class Data_table
+  def initialize(array)
+    @elements = []
+    array.each do |item|
+      @elements << item
+    end
+  end
+
+  def to_s
+    @elements
+  end
+
+  def get_element(i, j)
+    @elements[i][j].dup
+  end
+
+  def get_count_rows
+    @elements.length.dup
+  end
+
+  def get_count_column
+    @elements[0].length.dup
+  end
+end

data/lib/logger.rb

@@ -0,0 +1,63 @@
+class Logger
+  LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    fatal: 4
+  }
+
+  def initialize(log_file = 'application.log', level = :info)
+    @log_file = log_file
+    @level = LOG_LEVELS[level] || LOG_LEVELS[:info]
+    @mutex = Mutex.new
+    ensure_log_file
+  end
+
+  def debug(message)
+    log(:debug, message) if @level <= LOG_LEVELS[:debug]
+  end
+
+  def info(message)
+    log(:info, message) if @level <= LOG_LEVELS[:info]
+  end
+
+  def warn(message)
+    log(:warn, message) if @level <= LOG_LEVELS[:warn]
+  end
+
+  def error(message)
+    log(:error, message) if @level <= LOG_LEVELS[:error]
+  end
+
+  def fatal(message)
+    log(:fatal, message) if @level <= LOG_LEVELS[:fatal]
+  end
+
+  def level=(new_level)
+    @level = LOG_LEVELS[new_level] || LOG_LEVELS[:info]
+  end
+
+  private
+
+  def ensure_log_file
+    return if File.exist?(@log_file)
+    File.write(@log_file, '')
+  end
+
+  def log(level, message)
+    @mutex.synchronize do
+      timestamp = Time.now.strftime("%Y-%m-%d %H:%M:%S.%L")
+      log_entry = "[#{timestamp}] #{level.to_s.upcase}: #{message}\n"
+      
+      File.open(@log_file, 'a') do |file|
+        file.write(log_entry)
+      end
+      
+      # Также выводим в консоль для отладки
+      puts log_entry.strip if @level <= LOG_LEVELS[:info]
+    end
+  rescue => e
+    STDERR.puts "Ошибка записи в лог: #{e.message}"
+  end
+end

data/lib/student.rb

@@ -0,0 +1,131 @@
+require_relative 'student_superclass'
+
+class Student < StudentSuper
+  include Comparable
+  attr_reader :last_name, :first_name, :patronymic, :phone, :telegram, :email
+
+  # Основной конструктор
+  def initialize(last_name:, first_name:, patronymic: nil, id: nil, phone: nil, telegram: nil, email: nil, git: nil)
+    raise ArgumentError, "Неверный git: #{git}" unless self.class.valid_git?(git)
+
+    super(id: id, git: git)
+
+    self.last_name = last_name
+    self.first_name = first_name
+    self.patronymic = patronymic
+    set_contact(phone: phone, telegram: telegram, email: email)
+  end
+
+  # Конструктор из хеша (Задание 2.5)
+  def self.from_hash(hash)
+    new(
+      id: hash['id'] || hash[:id],
+      last_name: hash['last_name'] || hash[:last_name],
+      first_name: hash['first_name'] || hash[:first_name],
+      patronymic: hash['patronymic'] || hash[:patronymic] || hash['middle_name'] || hash[:middle_name],
+      phone: hash['phone'] || hash[:phone],
+      telegram: hash['telegram'] || hash[:telegram],
+      email: hash['email'] || hash[:email],
+      git: hash['git'] || hash[:git]
+    )
+  end
+
+  def self.validated_attr_writer(attribute, validation_method)
+    define_method("#{attribute}=") do |value|
+      raise ArgumentError unless self.class.send(validation_method, value)
+      instance_variable_set("@#{attribute}", value)
+    end
+  end
+
+  validated_attr_writer :first_name, :valid_name?
+  validated_attr_writer :last_name, :valid_name?
+  validated_attr_writer :patronymic, :valid_name?
+  validated_attr_writer :git, :valid_git?
+
+  def <=>(other)
+    [last_name, first_name, patronymic || nil] <=> [other.last_name, other.first_name, other.patronymic || nil]
+  end
+
+  def contact
+    return "telegram - #{@telegram}" if @telegram and !@telegram.empty?
+    return "email - #{@email}" if @email and !@email.empty?
+    return "phone - #{@phone}" if @phone and !@phone.empty?
+    nil
+  end
+
+  def set_contact(phone: nil, telegram: nil, email: nil)
+    @phone = phone if phone && self.class.valid_phone?(phone)
+    @telegram = telegram if telegram && self.class.valid_telegram?(telegram)
+    @email = email if email && self.class.valid_email?(email)
+  end
+
+  def contact=(contacts)
+    contacts.each do |type, value|
+      validator = "valid_#{type}?".to_sym
+      raise ArgumentError, "Неверный формат #{type}" unless self.class.send(validator, value)
+      instance_variable_set("@#{type}", value)
+    end
+  end
+
+  def last_name_initials
+    initials = ""
+    if first_name and patronymic
+      initials = "#{first_name[0]}. #{patronymic[0]}." if first_name and patronymic
+    elsif first_name
+      initials = "#{first_name[0]}."
+    else
+      initials = ""
+    end
+    "#{last_name} #{initials}".strip
+  end
+
+  def to_s
+    info = []
+    info << "ID: #{id}" if id
+    info << "Фамилия: #{last_name}"
+    info << "Имя: #{first_name}"
+    info << "Отчество: #{patronymic}" if patronymic
+    info << "Телефон: #{@phone}" if @phone
+    info << "Telegram: #{@telegram}" if @telegram
+    info << "Email: #{@email}" if @email
+    info << "Git: #{git}" if git
+    info.join(", ")
+  end
+
+  def to_hash
+    {
+      id: @id,
+      last_name: @last_name,
+      first_name: @first_name,
+      patronymic: @patronymic,
+      phone: @phone,
+      telegram: @telegram,
+      email: @email,
+      git: @git
+    }
+  end
+
+  def self.valid_name?(name)
+    name.nil? || name.is_a?(String) && name.match?(/\A[A-ZА-ЯЁ][a-zа-яё]+\z/)
+  end
+
+  def self.valid_phone?(phone)
+    return true if phone.nil? or phone.empty?
+    phone.match?(/^(\+7|8)?[\s\-\(]?(\d{3})[\s\-\)]?(\d{3})[\s\-]?(\d{2})[\s\-]?(\d{2})$/)
+  end
+
+  def self.valid_telegram?(telegram)
+    return true if telegram.nil? or telegram.empty?
+    telegram.match?(/^@[a-zA-Z0-9_]{5,32}$/)
+  end
+
+  def self.valid_email?(email)
+    return true if email.nil? or email.empty?
+    email.match?(/^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/)
+  end
+
+  def self.valid_git?(git)
+    return true if git.nil? or git.empty?
+    git.match?(/^https:\/\/(github|gitlab)\.com\/[a-zA-Z0-9_-]+\/?$/)
+  end
+end

data/lib/student_short.rb

@@ -0,0 +1,23 @@
+require_relative 'student'
+require_relative 'student_superclass'
+class StudentShort < StudentSuper
+  attr_reader :last_name_initials, :contact
+  def initialize(id:, last_name_initials:, contact: nil, git: nil)
+    super(id: id, git: git)
+    @last_name_initials = last_name_initials
+    @contact = contact
+  end
+
+  def self.from_student(student)
+    raise ArgumentError, "Student must not be nil" unless student
+
+    raise ArgumentError, "ID not found" unless student.id
+
+    new(
+      id: student.id,
+      last_name_initials: student.last_name_initials,
+      contact: student.contact,
+      git: student.git
+    )
+  end
+end

data/lib/student_superclass.rb

@@ -0,0 +1,40 @@
+class StudentSuper
+  attr_reader :id, :git
+
+  def initialize(id: nil, git: nil)
+    @id = id
+    @git = git
+  end
+
+  def to_s
+    short_info
+  end
+
+  def short_info
+    info = []
+    info << "ID: #{id}" if id
+    info << "ФИО: #{last_name_initials}"
+    info << contact if contact
+    info << "Git: #{git}" if git
+    info
+  end
+
+  def has_git?
+    !@git.nil? and !@git.empty?
+  end
+
+  def has_contact?
+    !@contact.nil? and !@contact.empty?
+  end
+
+  protected
+
+  def contact
+    raise 'NotImplementedError'
+  end
+
+  def last_name_initials
+    raise 'NotImplementedError'
+  end
+  
+end

data/lib/students_list_base.rb

@@ -0,0 +1,149 @@
+require_relative 'student'
+require_relative 'student_short'
+require_relative 'data_list_student_short'
+
+class Students_list_base
+  def initialize
+    @students = []
+    @filename = nil
+    @logger = Logger.new
+  end
+
+  # Абстрактные методы
+  def read_from_file(filename)
+    raise NotImplementedError, "Метод read_from_file должен быть реализован в подклассе"
+  end
+
+  def write_to_file(filename)
+    raise NotImplementedError, "Метод write_to_file должен быть реализован в подклассе"
+  end
+
+  # Получить объект класса Student по ID
+  def get_student_by_id(id)
+    @logger.debug("Поиск студента с ID: #{id}")
+    student = @students.find { |s| s.id == id }
+    if student
+      @logger.debug("Найден студент: #{student.last_name_initials}")
+    else
+      @logger.debug("Студент с ID #{id} не найден")
+    end
+    student
+  end
+
+  # Получить список k по счету n объектов класса Student_short
+  def get_k_n_student_short_list(k, n, existing_list = nil)
+    @logger.debug("Получение списка: страница #{k}, элементов #{n}")
+    
+    # Сортируем по ФамилияИнициалы
+    sorted_students = @students.sort_by(&:last_name_initials)
+    
+    # Преобразуем в Student_short
+    short_students = sorted_students.map { |s| StudentShort.from_student(s) }
+    
+    # Вычисляем диапазон
+    start_index = (k - 1) * n
+    end_index = start_index + n - 1
+    
+    # Получаем срез
+    result_data = short_students[start_index..end_index] || []
+    
+    # Возвращаем или изменяем существующий список
+    if existing_list
+      existing_list.instance_variable_set(:@elements, result_data)
+      @logger.debug("Обновлен существующий список, элементов: #{result_data.size}")
+      existing_list
+    else
+      @logger.debug("Создан новый список, элементов: #{result_data.size}")
+      Data_list_student_short.new(result_data)
+    end
+  end
+
+  # Сортировать элементы по набору ФамилияИнициалы
+  def sort_by_name
+    @logger.info("Сортировка списка студентов по ФамилияИнициалы")
+    @students.sort_by!(&:last_name_initials)
+  end
+
+  # Добавить объект класса Student в список (при добавлении сформировать новый ID)
+  def add_student(student)
+    @logger.info("Добавление нового студента: #{student.last_name}")
+    
+    # Генерация нового ID
+    new_id = @students.empty? ? 1 : @students.map(&:id).compact.max + 1
+    
+    # Создаем нового студента с новым ID
+    new_student = Student.new(
+      id: new_id,
+      last_name: student.last_name,
+      first_name: student.first_name,
+      patronymic: student.patronymic,
+      phone: student.phone,
+      telegram: student.telegram,
+      email: student.email,
+      git: student.git
+    )
+    
+    @students << new_student
+    save_changes
+    @logger.info("Студент добавлен с ID: #{new_id}")
+    new_id
+  end
+
+  # Заменить элемент списка по ID
+  def replace_student(id, student)
+    @logger.info("Замена студента с ID: #{id}")
+    
+    index = @students.find_index { |s| s.id == id }
+    
+    if index
+      updated_student = Student.new(
+        id: id,
+        last_name: student.last_name,
+        first_name: student.first_name,
+        patronymic: student.patronymic,
+        phone: student.phone,
+        telegram: student.telegram,
+        email: student.email,
+        git: student.git
+      )
+      
+      @students[index] = updated_student
+      save_changes
+      @logger.info("Студент с ID #{id} успешно заменен")
+      true
+    else
+      @logger.warn("Студент с ID #{id} не найден")
+      false
+    end
+  end
+
+  # Удалить элемент списка по ID
+  def delete_student(id)
+    @logger.info("Удаление студента с ID: #{id}")
+    
+    initial_size = @students.size
+    @students.reject! { |student| student.id == id }
+    
+    if @students.size < initial_size
+      save_changes
+      @logger.info("Студент с ID #{id} успешно удален")
+      true
+    else
+      @logger.warn("Студент с ID #{id} не найден")
+      false
+    end
+  end
+
+  # Получить количество элементов
+  def get_student_short_count
+    count = @students.size
+    @logger.debug("Текущее количество студентов: #{count}")
+    count
+  end
+
+  private
+
+  def save_changes
+    write_to_file(@filename) if @filename
+  end
+end

data/lib/students_list_yaml.rb

@@ -0,0 +1,60 @@
+require 'yaml'
+require_relative 'students_list_base'
+require_relative 'logger'
+
+class Students_list_YAML < Students_list_base
+  def initialize
+    super
+    @logger = Logger.new('students_yaml.log', :debug)
+  end
+
+  # a. Чтение всех значений из файла
+  def read_from_file(filename)
+    @logger.info("Чтение из YAML файла: #{filename}")
+    @filename = filename
+    
+    begin
+      if File.exist?(filename)
+        data_array = YAML.load_file(filename)
+        
+        @students = data_array.map do |hash|
+          Student.from_hash(hash)
+        end
+        
+        @logger.info("Успешно загружено #{@students.size} студентов")
+      else
+        @students = []
+        @logger.warn("Файл #{filename} не существует. Создан пустой список.")
+      end
+    rescue Psych::SyntaxError => e
+      @logger.error("Ошибка парсинга YAML: #{e.message}")
+      @students = []
+    rescue => e
+      @logger.error("Ошибка чтения файла: #{e.message}")
+      @students = []
+    end
+  end
+
+  # b. Запись всех значений в файл
+  def write_to_file(filename)
+    @logger.info("Запись в YAML файл: #{filename}")
+    
+    begin
+      data_array = @students.map(&:to_hash)
+      yaml_data = YAML.dump(data_array)
+      File.write(filename, yaml_data)
+      @logger.info("Успешно записано #{@students.size} студентов")
+    rescue => e
+      @logger.error("Ошибка записи в файл: #{e.message}")
+      raise
+    end
+  end
+
+  private
+
+  def save_changes
+    return unless @filename
+    @logger.debug("Автосохранение изменений")
+    write_to_file(@filename)
+  end
+end

metadata

@@ -0,0 +1,51 @@
+--- !ruby/object:Gem::Specification
+name: students_list_yaml_gems
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Мари
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-01-10 00:00:00.000000000 Z
+dependencies: []
+description:
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/data_list.rb
+- lib/data_list_student_short.rb
+- lib/data_table.rb
+- lib/logger.rb
+- lib/student.rb
+- lib/student_short.rb
+- lib/student_superclass.rb
+- lib/students_list_base.rb
+- lib/students_list_yaml.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.4.20
+signing_key:
+specification_version: 4
+summary: Управление списками студентов в YAML
+test_files: []