students_list_yaml_gem_ahverdyan 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: cd6731b2df1327950c3aca7bf6fa8ddd125b3fe0daee02b978be0b23f4e65709
+  data.tar.gz: b6644cf7cb7bdfd23b0533f0d128768bcd67d7ccebd217a7e3a622413de94ee1
+SHA512:
+  metadata.gz: 91bde1ef9bdf4e45de8e40084f9fd368600873394ee7c7ee77beb9e7eb4974eb7edfcf16b35881777f357595dde42f034e6dca8236544703385106cb22b39ab0
+  data.tar.gz: 2a09ff3a222064a2643da847f73c177938b27d85500d6138ff83bd3509636f150f3cd090f9b56c44eafa4a2980c10390f3b3fa24b871d49ae31112e4f60b8ea8

data/lib/students_list_yaml/data_list.rb

@@ -0,0 +1,49 @@
+require_relative 'data_table'
+class DataList
+  def initialize(array)
+      self.data = array
+      @selected = []
+  end
+
+  def data=(array)
+    @array = array.freeze
+  end
+
+  def select(number)
+    @selected << @array[number]
+  end
+
+  def get_selected
+    @selected.map { |i| i.id }
+  end
+  
+  def get_names
+    ["№ по порядку"] + get_custom_names
+  end
+
+  def get_data
+    rows = []
+    @array.each_with_index do |object, index|
+        rows << [index + 1] + get_custom_row(object)
+    end
+    DataTable.new(rows)
+  end
+
+  def clear_selected
+    @selected.clear
+  end
+
+  def to_s
+    get_data.to_s
+  end
+
+  protected
+  def get_custom_names
+      raise NotImplementedError
+  end
+
+  def get_custom_row(object)
+      raise NotImplementedError
+  end
+
+end

data/lib/students_list_yaml/data_list_student_short.rb

@@ -0,0 +1,11 @@
+require_relative 'data_list'
+require_relative 'student_short'
+class DataListStudentShort < DataList
+  def get_custom_names
+    ["ФИО", "Контакт", "Гит"]
+  end
+
+  def get_custom_row(student)
+    [student.last_name_initials, student.contact, student.git]
+  end
+end

data/lib/students_list_yaml/data_table.rb

@@ -0,0 +1,22 @@
+class DataTable
+    def initialize(rows)
+        @rows = rows.map { |x| x.freeze }
+    end
+
+    def get(row, col)
+        @rows[row][col]
+    end
+
+    def rows
+        @rows.length
+    end
+
+    def columns
+        return 0 if @rows.empty?
+        @rows[0].length
+    end
+
+    def to_s
+        @rows.to_s
+    end
+end

data/lib/students_list_yaml/parent_student.rb

@@ -0,0 +1,38 @@
+class ParentStudent
+  attr_reader :id, :git
+
+  def initialize(id: nil, git: nil)
+    @id = id
+    @git = git
+  end
+
+  def to_s
+    short_info
+  end
+
+  def short_info
+    array = []
+    array << "id студента:#{id}" if id
+    array << "Фамилия и инициалы: #{last_name_initials}"
+    array << "Контакт: #{contact}" if has_contact?
+    array << "Гит:#{git}" if has_git?
+    array.join(", ")
+  end
+
+  def has_contact?
+    !contact.nil? && !contact.empty?
+  end
+
+  def has_git?
+    !git.nil? && !git.empty?
+  end
+
+  protected
+  def last_name_initials
+    raise NotImplementedError
+  end
+
+  def contact
+    raise NotImplementedError
+  end
+end

data/lib/students_list_yaml/student.rb

@@ -0,0 +1,127 @@
+require_relative 'parent_student'
+class Student < ParentStudent
+  attr_reader :last_name, :first_name, :patronymic
+  include Comparable
+
+  def initialize(id: nil, last_name:, first_name:, patronymic: nil, phone: nil, telegram: nil, email: nil, git: nil) 
+    raise ArgumentError, "Неверный формат гита #{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
+    self.contact = {phone: phone, telegram: telegram, email: email}
+  end
+
+  def contact
+    if @telegram && !@telegram.empty?
+        "telegram - #{@telegram}"
+    elsif @email && !@email.empty?
+        "email - #{@email}"
+    elsif @phone && !@phone.empty? 
+        "phone - #{@phone}"
+    else
+        nil
+    end
+  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 self.validated_attr_writer(attribute, validation_name)
+    define_method("#{attribute}=") do |value|
+        raise ArgumentError unless self.class.send(validation_name, 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 last_name_initials
+    if patronymic
+      "#{last_name} #{first_name[0]}. #{patronymic[0]}."
+    else
+      "#{last_name} #{first_name[0]}."
+    end
+  end
+
+  def self.valid_name?(name)
+      name.nil? || (name.is_a?(String) && name.match?(/^[А-ЯA-Z][а-яa-z]+$/))
+  end
+
+  def self.valid_phone?(phone)
+      phone.nil? || (phone.is_a?(String) && phone.match?(/^(\+7|8)?[\s\-\(]?(\d{3})[\s\-\)]?(\d{3})[\s\-]?(\d{2})[\s\-]?(\d{2})$/)) 
+  end
+
+  def self.valid_telegram?(telegram)
+      telegram.nil? || (telegram.is_a?(String) && telegram.match?(/^@[a-zA-Z0-9_]{5,32}$/))
+  end
+
+  def self.valid_email?(email)
+      email.nil? || (email.is_a?(String) && email.match?(/^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/))
+  end
+
+  def self.valid_git?(git)
+      git.nil? || (git.is_a?(String) && git.match?(/^https:\/\/(github|gitlab)\.com\/[a-zA-Z0-9_-]+\/?$/))
+  end
+
+  def to_s
+    array = []
+    array << "id студента: #{id}" if id
+    array << "Фамилия: #{last_name}"
+    array << "Имя: #{first_name}"
+    array << "Отчество: #{patronymic}" if patronymic
+    array << "Номер телефона: #{@phone}" if @phone
+    array << "Телеграм: #{@telegram}" if @telegram
+    array << "Почта: #{@email}" if @email
+    array << "Гит: #{git}" if has_git?
+    array.join(", ")
+  end
+
+  def to_h
+    {
+      id: id,
+      last_name: last_name,
+      first_name: first_name,
+      patronymic: patronymic,
+      phone: @phone,
+      telegram: @telegram,
+      email: @email,
+      git: git
+    }.compact
+  end
+
+  def self.from_h(id: nil, hash:)
+    new(
+      id: id,
+      last_name: hash[:last_name],
+      first_name: hash[:first_name],
+      patronymic: hash[:patronymic],
+      phone: hash[:phone],
+      telegram: hash[:telegram],
+      email: hash[:email],
+      git: hash[:git]
+    )
+  end
+  
+  def <=>(value)
+    [last_name, first_name, patronymic || nil] <=> [value.last_name, value.first_name, value.patronymic || nil]
+  end
+
+  def ==(other)
+    return false unless other.is_a?(Student)
+    [:telegram, :email, :phone, :git].any? do |field|
+      self_val = to_h[field]
+      other_val = other.to_h[field]
+      self_val && other_val && self_val == other_val
+    end
+  end
+
+end

data/lib/students_list_yaml/student_short.rb

@@ -0,0 +1,21 @@
+require_relative 'student'
+require_relative 'parent_student'
+class StudentShort < ParentStudent
+  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, "id не существует" if student.id.nil?
+    new(
+      id: student.id,
+      last_name_initials: student.last_name_initials,
+      contact: student.contact,
+      git: student.git
+    )
+  end
+end

data/lib/students_list_yaml/students_list_yaml.rb

@@ -0,0 +1,82 @@
+require 'yaml'
+require_relative "student"
+require_relative "data_list"
+require_relative "student_short"
+require_relative "data_list_student_short"
+
+
+class DuplicateStudentError < StandardError; end
+
+class StudentsListYAML
+  def initialize(file)
+    @file = file
+    @students = []
+    read_file
+  end
+
+  def read_file
+    yaml_ex = File.read(@file)
+    data = YAML.safe_load(yaml_ex, permitted_classes: [Symbol], symbolize_names: true)
+    @students = data.map { |h| Student.from_h(id: h[:id], hash: h) }
+  end
+
+  def write_file
+    data = @students.map { |s| s.to_h }
+    File.write(@file, YAML.dump(data))
+  end
+
+  def get_student_by_id(id)
+    @students.find { |s| s.id == id }
+  end
+
+  def get_k_n_student_short_list(k, n, data_list = nil)
+    start_index = (n - 1) * k
+    slice = @students[start_index, k] || []
+
+    student_shorts = slice.map do |s|
+      StudentShort.new(
+        id: s.id,
+        last_name_initials: s.last_name_initials,
+        contact: s.contact,
+        git: s.git
+      )
+    end
+
+    if data_list
+      data_list.data = student_shorts
+      data_list
+    else
+      DataListStudentShort.new(student_shorts)
+    end
+  end
+
+  def sort_by_surname_initials!
+    @students.sort_by! { |s| s.last_name_initials }
+  end
+
+  def unique(student)
+    raise DuplicateStudentError, "Студент с таким контактом уже существует" unless !@students.any? { |s| s == student }
+  end
+
+  def add_student(student)
+    unique(student)
+    max_id = @students.map { |s| s.id }.max || 0
+    value = student.to_h
+    @students << Student.from_h(id: max_id + 1, hash: value)
+  end
+
+  def replace_student_by_id(id, new_student)
+    unique(new_student)
+    index = @students.index { |s| s.id == id }
+    return unless index
+    @students[index] = Student.from_h(id: id, hash: new_student.to_h)
+  end
+
+  def delete_student_by_id(id)
+    @students.reject! { |s| s.id == id }
+  end
+
+  def get_student_short_count
+    @students.size
+  end
+end

data/lib/students_list_yaml/version.rb

@@ -0,0 +1 @@
+VERSION = "0.1.0"

data/lib/students_list_yaml.rb

@@ -0,0 +1,8 @@
+require_relative "students_list_yaml/version"
+require_relative "students_list_yaml/student"
+require_relative "students_list_yaml/student_short"
+require_relative "students_list_yaml/parent_student"
+require_relative "students_list_yaml/data_list"
+require_relative "students_list_yaml/data_list_student_short"
+require_relative "students_list_yaml/data_table"
+require_relative "students_list_yaml/students_list_yaml"

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification
+name: students_list_yaml_gem_ahverdyan
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- six6hroun
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-01-07 00:00:00.000000000 Z
+dependencies: []
+description: Класс для работы со списком студентов, хранение в YAML, добавление, удаление,
+  обновление и проверка уникальности
+email:
+- gura0516@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/students_list_yaml.rb
+- lib/students_list_yaml/data_list.rb
+- lib/students_list_yaml/data_list_student_short.rb
+- lib/students_list_yaml/data_table.rb
+- lib/students_list_yaml/parent_student.rb
+- lib/students_list_yaml/student.rb
+- lib/students_list_yaml/student_short.rb
+- lib/students_list_yaml/students_list_yaml.rb
+- lib/students_list_yaml/version.rb
+homepage:
+licenses: []
+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: []