student_list_yaml_gem 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 10576fb140bc58bc6b580ab3e74a37538d0bf6bf16b8f6eff774b1e2b5946767
+  data.tar.gz: '0779fdbb0450c06b19ec726740c233f39bca5962c5be946585edd2c6f4e13077'
+SHA512:
+  metadata.gz: dc656e8a694d8e60a06e701cc90410188855d6eb2d2072e4d87ad0cf1b80edfd5b81f068524e68ff3f4f6f65af399227656fa71cadf4ad267ce9342ef377eec5
+  data.tar.gz: ec2395929753ec1fbf131a339e291e4760181dcd45f61fa7d15b8b7941124d8b8cdd1a2383b9f8482693d3554b4085f289d26bd61ea4f0f2d9d4ced576f9a046

data/lib/data_list.rb

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

data/lib/data_list_student_short.rb

@@ -0,0 +1,13 @@
+require_relative 'data_list.rb'
+require_relative 'student_short.rb'
+
+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/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/student.rb

@@ -0,0 +1,135 @@
+require_relative 'super_student.rb'
+
+class Student < SuperStudent
+    include Comparable
+
+    attr_reader :last_name, :first_name, :patronymic
+
+    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)
+        [first_name, last_name, patronymic || nil] <=> [other.first_name, other.last_name, other.patronymic || nil]
+    end
+
+    def initialize(last_name:, first_name:, id: nil, patronymic: nil, phone: nil, telegram: nil, email: nil, git: nil)
+
+        raise ArgumentError, "Неверный формат гита" 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 = {telegram: telegram, email: email, phone: phone}
+
+    end
+
+    def ==(other)
+        self_data = self.to_hash
+        other_data = other.to_hash
+
+        [:telegram, :email, :phone, :git].each do |field|
+            self_value = self_data[field]
+            other_value = other_data[field]
+            
+            return true if self_value && other_value && self_value == other_value
+        end
+
+        false
+    end
+
+    def to_hash
+        {   
+            id: @id,
+            first_name: @first_name,
+            last_name: @last_name,
+            patronymic: @patronymic,
+            telegram: @telegram, 
+            email: @email, 
+            phone: @phone,
+            git: @git
+        }
+    end
+
+    def self.initialize_hash(id: nil, student_hash:)
+        new(
+            id: id,
+            last_name: student_hash[:last_name],
+            first_name: student_hash[:first_name],
+            patronymic: student_hash[:patronymic],
+            telegram: student_hash[:telegram], 
+            email: student_hash[:email], 
+            phone: student_hash[:phone],
+            git: student_hash[:git]
+        )
+    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 last_name_initials
+        initials = "#{last_name} #{first_name[0]}."
+        initials += " #{patronymic[0]}." if patronymic
+        initials
+    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}" if @telegram
+        info << "Почта: #{@email}" if @email
+        info << "Гит: #{@git}" if @git
+        info.join("\n")
+    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
+end

data/lib/student_list_yaml.rb

@@ -0,0 +1,116 @@
+require 'yaml'
+require_relative 'student.rb'
+require_relative 'data_list_student_short.rb'
+require_relative 'unique_student_error.rb'
+
+# Класс для работы со списком студентов, хранящимся в YAML-файле
+class StudentListYAML
+
+    # Инициализация списка студентов
+    # @param file_path [String]
+    def initialize(file_path:, log_path: nil)
+        @file_path = file_path
+        @logger = log_path ? AppLogger.build(log_path) : nil
+        @students = read
+    end
+
+    # Чтение студентов из файла
+    # @return [Array<Student>] массив студентов
+    def read
+        @logger.debug('read yaml')
+
+        return [] unless File.exist?(@file_path)
+
+        data = YAML.load_file(@file_path)
+        return [] unless data.is_a?(Array)
+
+        data.map do |student_hash|
+            Student.initialize_hash(id: student_hash[:id], student_hash: student_hash)
+        end
+
+        rescue => e
+            @logger.error(e.message)
+        []
+    end
+
+    # Записывает данные студентов в YAML-файл
+    def write
+        students_hash = @students.map { |student| student.to_hash }
+        File.write(@file_path, students_hash.to_yaml)
+    end
+
+    # Получить студента по ID
+    # @param id [Integer]
+    # @return [Student, nil]
+    def get_student_by_id(id)
+        @logger.debug("get_student_by_id #{id}")
+        @students.find { |student| student.id = id }
+        rescue => e
+            @logger.error(e.message)
+    end
+
+    # Получить список студентов
+    # @param k [Integer] номер первого элемента
+    # @param n [Integer] количество элементов
+    # @return [DataList]
+    def get_k_n_student_short_list(k, n)
+        students = @students.slice(k - 1, n)
+        list = DataListStudentShort.new(students)
+        list.get_data
+    end
+
+    # Сортировка студентов по ФамилияИнициалы
+    def sort_by_name
+        @students.sort_by! { |student| student.last_name_initials }
+    end
+
+    # Добавление студента в список
+    # @param student [Student]
+    def add_student(student)
+        @logger.info("add_student #{student.short_info}")
+        new_id = @students.map(&:id).max.to_i + 1
+
+        new_student = Student.initialize_hash(id: new_id, student_hash: student.to_hash)
+        unique(new_student)
+
+        @students << new_student
+        rescue => e
+            @logger.error(e.message)
+    end
+
+    # Изменение студента по id
+    # @param id [Integer]
+    # @param new_student [Student]
+    def update_student(id:, new_student:)
+        @logger.info("update_student_id: #{id}")
+
+        index = @students.index { |student| student.id == id }
+        return unless index
+        unique(new_student)
+        @students[index] = new_student
+
+        rescue => e
+            @logger.error(e.message)
+    end
+
+    # Удаление студента по id
+    # param id [Integer]
+    def delete_student(id)
+        @logger.info("delete_student_id: #{id}")
+
+        @students.reject! { |s| s.id == id }
+
+        rescue => e
+            @logger.error(e.message)
+    end
+    
+    private
+
+    # Проверка студентов на уникальность
+    def unique(new_student)
+        @students.each do |student|
+            raise UniqueStudentError, "Ошибка уникальности студента" if student == new_student
+        end
+    end
+
+end

data/lib/student_short.rb

@@ -0,0 +1,25 @@
+require_relative 'student.rb'
+require_relative 'super_student.rb'
+
+
+class StudentShort < SuperStudent
+
+    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" unless student.id
+        new(
+            id: student.id,
+            last_name_initials: student.last_name_initials,
+            contact: student.contact,
+            git: student.git
+        )
+    end
+
+end

data/lib/super_student.rb

@@ -0,0 +1,41 @@
+class SuperStudent
+    
+    attr_reader :id, :git
+
+    def initialize(id: nil, git: nil)
+        @id = id
+        @git = git
+    end
+
+    def short_info
+        info = []
+        info << "ID: #{id}" if id
+        info << "ФИО: #{last_name_initials}"
+        info << "Контакт: #{contact}" if contact
+        info << "Гит: #{git}" if git
+        info.join("\n")
+    end
+
+    def to_s
+        short_info
+    end
+
+    def has_git?
+        !@git.nil? && !@git.empty?
+    end
+
+    def has_contact?
+        !contact.nil? && !contact.empty?
+    end
+
+    protected
+
+    def last_name_initials
+        raise NotImplementedError
+    end
+
+    def contact
+        raise NotImplementedError
+    end
+
+end

data/lib/unique_student_error.rb

@@ -0,0 +1,2 @@
+class UniqueStudentError < ArgumentError
+end

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification
+name: student_list_yaml_gem
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- TelariL
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-01-04 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/student.rb
+- lib/student_list_yaml.rb
+- lib/student_short.rb
+- lib/super_student.rb
+- lib/unique_student_error.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: Students list stored in YAML
+test_files: []