shnaider_code 1.1.5

data/lib/source/models/student_base.rb

@@ -0,0 +1,128 @@
+# frozen_string_literal: true
+
+##
+# Абстрактный класс с базовым описанием студента
+
+class StudentBase
+  private_class_method :new
+
+  ##
+  # Валидация имени (также применимо к фамилии и отчеству)
+
+  def self.valid_name?(name)
+    name.match(/(^[А-Я][а-я]+$)|(^[A-Z][a-z]+$)/)
+  end
+
+  ##
+  # Валидация номера телефона
+
+  def self.valid_phone?(phone)
+    phone.match(/^\+?[78] ?[(-]?\d{3} ?[)-]?[ -]?\d{3}[ -]?\d{2}[ -]?\d{2}$/)
+  end
+
+  ##
+  # Валидация имени профиля пользователя
+
+  def self.valid_profile_name?(profile_name)
+    profile_name.match(/^[a-zA-Z0-9_.]+$/)
+  end
+
+  ##
+  # Валидация email
+
+  def self.valid_email?(email)
+    email.match(/^(?:[a-z0-9!#$%&'*+\/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+\/=?^_`{|}~-]+)*|"(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])*")@(?:(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?|\[(?:(?:(2(5[0-5]|[0-4][0-9])|1[0-9][0-9]|[1-9]?[0-9]))\.){3}(?:(2(5[0-5]|[0-4][0-9])|1[0-9][0-9]|[1-9]?[0-9])|[a-z0-9-]*[a-z0-9]:(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21-\x5a\x53-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])+)\])$/)
+  end
+
+  protected
+
+  attr_writer :id
+  attr_reader :phone, :telegram, :email
+
+  public
+
+  attr_reader :id, :git
+
+  ##
+  # Стандартный конструктор. Принимает именованные параметры:
+  # id - Id студента
+  # phone - Телефон
+  # telegram - Ник в телеграме
+  # email - Электронная почта
+  # git - Ник на гите
+
+  def initialize(id: nil, phone: nil, telegram: nil, email: nil, git: nil)
+    self.id = id
+    self.phone = phone
+    self.telegram = telegram
+    self.email = email
+    self.git = git
+  end
+
+  ##
+  # Возвращает первый доступный контакт пользователя в виде хеша.
+  # Пример: {type: :telegram, value: 'xoxolovelylove'}
+
+  def short_contact
+    contact = {}
+    %i[telegram email phone].each do |attr|
+      attr_val = send(attr)
+      next if attr_val.nil?
+
+      contact[:type] = attr
+      contact[:value] = attr_val
+      return contact
+    end
+
+    nil
+  end
+
+  protected
+
+  def phone=(new_phone)
+    raise ArgumentError, "Invalid argument: phone=#{new_phone}" unless new_phone.nil? || StudentBase.valid_phone?(new_phone)
+
+    @phone = new_phone
+  end
+
+  def telegram=(new_telegram)
+    raise ArgumentError, "Invalid argument: telegram=#{new_telegram}" unless new_telegram.nil? || StudentBase.valid_profile_name?(new_telegram)
+
+    @telegram = new_telegram
+  end
+
+  def git=(new_git)
+    raise ArgumentError, "Invalid argument: git=#{new_git}" unless new_git.nil? || StudentBase.valid_profile_name?(new_git)
+
+    @git = new_git
+  end
+
+  def email=(new_email)
+    raise ArgumentError, "Invalid argument: email=#{new_email}" unless new_email.nil? || StudentBase.valid_email?(new_email)
+
+    @email = new_email
+  end
+
+  public
+
+  ##
+  # Возвращает true, если у студента есть хотя бы один из контактов
+
+  def has_contacts?
+    !phone.nil? || !telegram.nil? || !email.nil?
+  end
+
+  ##
+  # Возвращает true, если у студента есть гит
+
+  def has_git?
+    !git.nil?
+  end
+
+  ##
+  # Возвращает true, если у студента есть хотя бы один из контактов и гит
+
+  def valid?
+    has_contacts? && has_git?
+  end
+end

data/lib/source/models/student_short.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+##
+# Модель с краткой информацией о студенте
+
+class StudentShort < StudentBase
+  public_class_method :new
+
+  private
+
+  attr_writer :last_name_and_initials, :contact
+
+  public
+
+  attr_reader :last_name_and_initials, :contact
+
+  ##
+  # Конструктор из объекта класса Student
+
+  def self.from_student(student)
+    raise ArgumentError, 'Student ID is required' if student.id.nil?
+
+    StudentShort.new(student.id, student.short_info)
+  end
+
+  ##
+  # Стандартный конструктор. Принимает:
+  # id - Числовой id студента
+  # info_str - JSON строка с полями last_name_and_initials (обязательно), contact, git, а также полями базового класса
+
+  def initialize(id, info_str)
+    params = JSON.parse(info_str, { symbolize_names: true })
+    raise ArgumentError, 'Fields required: last_name_and_initials' if !params.key?(:last_name_and_initials) || params[:last_name_and_initials].nil?
+
+    self.id = id
+    self.last_name_and_initials = params[:last_name_and_initials]
+    self.contact = params[:contact]
+    self.git = params[:git]
+
+    options = {}
+    options[:id] = id
+    options[:git] = git
+    options[contact[:type].to_sym] = contact[:value] if contact
+    super(**options)
+  end
+
+  ##
+  # Преобразование объекта в строку
+
+  def to_s
+    result = last_name_and_initials
+    %i[id contact git].each do |attr|
+      attr_val = send(attr)
+      result += ", #{attr}=#{attr_val}" unless attr_val.nil?
+    end
+    result
+  end
+end

data/lib/source/repositories/adapters/db_source_adapter.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require './LabStudents/repositories/data_sources/db_data_source'
+require './LabStudents/models/student'
+require './LabStudents/models/student_short'
+require './LabStudents/repositories/containers/data_list_student_short'
+
+class DBSourceAdapter
+  def initialize
+    @db = DBDataSource.instance
+  end
+
+  def student_by_id(student_id)
+    hash = @db.prepare_exec('SELECT * FROM student WHERE id = ?', student_id).first
+    return nil if hash.nil?
+
+    Student.from_hash(hash)
+  end
+
+  def paginated_short_students(page, count, existing_data_list = nil)
+    offset = (page - 1) * count
+    students = @db.prepare_exec('SELECT * FROM student LIMIT ?, ?', offset, count)
+    slice = students.map { |h| StudentShort.from_student(Student.from_hash(h)) }
+    return DataListStudentShort.new(slice) if existing_data_list.nil?
+
+    existing_data_list.replace_objects(slice)
+    existing_data_list
+  end
+
+  def add_student(student)
+    template = 'INSERT INTO student(last_name, first_name, father_name, phone, telegram, email, git) VALUES (?, ?, ?, ?, ?, ?, ?)'
+    @db.prepare_exec(template, *student_fields(student))
+    @db.query('SELECT LAST_INSERT_ID()').first.first[1]
+  end
+
+  def replace_student(student_id, student)
+    template = 'UPDATE student SET last_name=?, first_name=?, father_name=?, phone=?, telegram=?, email=?, git=? WHERE id=?'
+    @db.prepare_exec(template, *student_fields(student), student_id)
+  end
+
+  def remove_student(student_id)
+    @db.prepare_exec('DELETE FROM student WHERE id = ?', student_id)
+  end
+
+  def student_count
+    @db.query('SELECT COUNT(id) FROM student').first.first[1]
+  end
+
+  private
+
+  def student_fields(student)
+    [student.last_name, student.first_name, student.father_name, student.phone, student.telegram, student.email, student.git]
+  end
+end

data/lib/source/repositories/adapters/file_source_adapter.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+class FileSourceAdapter
+  def initialize(data_transformer, file_path)
+    @file_path = file_path
+    @file_source = FileDataSource.new(data_transformer)
+    @file_source.load_from_file(file_path)
+  end
+
+  def student_by_id(student_id)
+    @file_source.student_by_id(student_id)
+  end
+
+  def paginated_short_students(page, count, existing_data_list = nil)
+    @file_source.paginated_short_students(page, count, existing_data_list)
+  end
+
+  def add_student(student)
+    added_id = @file_source.add_student(student)
+    @file_source.save_to_file(@file_path)
+    added_id
+  end
+
+  def replace_student(student_id, student)
+    @file_source.replace_student(student_id, student)
+    @file_source.save_to_file(@file_path)
+  end
+
+  def remove_student(student_id)
+    @file_source.remove_student(student_id)
+    @file_source.save_to_file(@file_path)
+  end
+
+  def student_count
+    @file_source.student_count
+  end
+end

data/lib/source/repositories/containers/data_list.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+require './LabStudents/repositories/containers/data_table'
+
+class DataList
+  # Это "абстрактный" класс
+  private_class_method :new
+
+  attr_writer :objects
+
+  # Конструктор, принимает массив любых объектов
+  def initialize(objects)
+    self.objects = objects
+    @listeners = []
+  end
+
+  def add_listener(listener)
+    @listeners << listener
+  end
+
+  def remove_listener(listener)
+    @listeners.delete(listener)
+  end
+
+  def notify
+    @listeners.each { |lst| lst.on_datalist_changed(data_table) }
+  end
+
+  # Выбрать элемент по номеру
+  def select_element(number)
+    self.selected_num = number < objects.size ? number : nil
+  end
+
+  def selected_id
+    objects[selected_num].id
+  end
+
+  # Получить DataTable со всеми элементами.
+  def data_table
+    result = []
+    counter = 0
+    objects.each do |obj|
+      row = []
+      row << counter
+      row.push(*table_fields(obj))
+      result << row
+      counter += 1
+    end
+    DataTable.new(result)
+  end
+
+  # Добавить элементы в конец списка
+  def replace_objects(objects)
+    self.objects = objects.dup
+    notify
+  end
+
+  protected
+
+  # Список значений полей для DataTable. Переопределить в наследниках
+  def table_fields(_obj)
+    []
+  end
+
+  # Имена атрибутов объектов по порядку. Переопределить в наследниках
+  def column_names
+    []
+  end
+
+  private
+
+  attr_reader :objects
+  attr_accessor :selected_num
+end

data/lib/source/repositories/containers/data_list_student_short.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require_relative 'data_list'
+
+class DataListStudentShort < DataList
+  # Делаем приватный new предка публичным
+  public_class_method :new
+
+  def column_names
+    ['Фамилия И. О.', 'Гит', 'Контакт']
+  end
+
+  protected
+
+  def table_fields(obj)
+    [obj.last_name_and_initials, obj.git, obj.contact]
+  end
+end

data/lib/source/repositories/containers/data_table.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+class DataTable
+  attr_reader :rows_count, :cols_count
+
+  # Конструктор, принимает 2D Array
+  def initialize(table)
+    self.rows_count = table.size
+    max_cols = 0
+    table.each { |row| max_cols = row.size if row.size > max_cols }
+    self.cols_count = max_cols
+    self.table = table
+  end
+
+  # Получить значение в ячейке [row, col]
+  def get_item(row, col)
+    return nil if row >= rows_count
+    return nil if col >= cols_count
+
+    table[row][col].dup
+  end
+
+  def to_2d_array
+    table.dup
+  end
+
+  def to_s
+    "DataTable (#{rows_count}x#{cols_count})"
+  end
+
+  private
+
+  attr_accessor :table
+  attr_writer :rows_count, :cols_count
+end

data/lib/source/repositories/data_sources/db_data_source.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'mysql2'
+
+##
+# Источник данных из БД
+
+class DBDataSource
+  private_class_method :new
+  @instance_mutex = Mutex.new
+
+  def initialize
+    db_config = YAML.load_file('./LabStudents/db_config/config.example.yaml').transform_keys(&:to_sym)
+    @client = Mysql2::Client.new(db_config)
+    @client.query_options.merge!(symbolize_keys: true)
+  end
+
+  def self.instance
+    return @instance if @instance
+
+    @instance_mutex.synchronize do
+      @instance ||= new
+    end
+
+    @instance
+  end
+
+  def prepare_exec(statement, *params)
+    @client.prepare(statement).execute(*params)
+  end
+
+  def query(statement)
+    @client.query(statement)
+  end
+end

data/lib/source/repositories/data_sources/file_data_source.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+require './LabStudents/models/student'
+require './LabStudents/models/student_short'
+require './LabStudents/repositories/containers/data_list_student_short'
+
+##
+# Источник данных из файла
+
+class FileDataSource
+  attr_writer :data_transformer
+
+  def initialize(data_transformer)
+    self.students = []
+    self.seq_id = 1
+    self.data_transformer = data_transformer
+  end
+
+  def load_from_file(file_path)
+    hash_list = data_transformer.str_to_hash_list(File.read(file_path))
+    self.students = hash_list.map { |h| Student.from_hash(h) }
+    update_seq_id
+  end
+
+  def save_to_file(file_path)
+    hash_list = students.map(&:to_hash)
+    File.write(file_path, data_transformer.hash_list_to_str(hash_list))
+  end
+
+  def student_by_id(student_id)
+    students.detect { |s| s.id == student_id }
+  end
+
+  def paginated_short_students(page, count, existing_data_list = nil)
+    offset = (page - 1) * count
+    slice = students[offset, count].map { |s| StudentShort.from_student(s) }
+
+    return DataListStudentShort.new(slice) if existing_data_list.nil?
+
+    existing_data_list.replace_objects(slice)
+    existing_data_list
+  end
+
+  def sorted
+    students.sort_by(&:last_name_and_initials)
+  end
+
+  def add_student(student)
+    student.id = seq_id
+    students << student
+    self.seq_id += 1
+    student.id
+  end
+
+  def replace_student(student_id, student)
+    idx = students.find_index { |s| s.id == student_id }
+    students[idx] = student
+  end
+
+  def remove_student(student_id)
+    students.reject! { |s| s.id == student_id }
+  end
+
+  def student_count
+    students.count
+  end
+
+  private
+
+  # Метод для актуализации seq_id
+  def update_seq_id
+    self.seq_id = students.max_by(&:id).id + 1
+  end
+
+  attr_reader :data_transformer
+  attr_accessor :students, :seq_id
+end

data/lib/source/repositories/data_sources/transformers/data_transformer_base.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+class DataTransformerBase
+  private_class_method :new
+
+  protected
+
+  def str_to_hash_list(str)
+    raise NotImplementedError('Should be implemented in child')
+  end
+
+  def hash_list_to_str(hash_list)
+    raise NotImplementedError('Should be implemented in child')
+  end
+end

data/lib/source/repositories/data_sources/transformers/data_transformer_json.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require_relative 'data_transformer_base'
+require 'json'
+
+class DataTransformerJSON < DataTransformerBase
+  public_class_method :new
+
+  def str_to_hash_list(str)
+    JSON.parse(str, { symbolize_names: true })
+  end
+
+  def hash_list_to_str(hash_list)
+    JSON.pretty_generate(hash_list)
+  end
+end

data/lib/source/repositories/data_sources/transformers/data_transformer_yaml.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require_relative 'data_transformer_base'
+require 'yaml'
+
+class DataTransformerYAML < DataTransformerBase
+  public_class_method :new
+
+  def str_to_hash_list(str)
+    YAML.safe_load(str).map { |h| h.transform_keys(&:to_sym) }
+  end
+
+  def hash_list_to_str(hash_list)
+    hash_list.map { |h| h.transform_keys(&:to_s) }.to_yaml
+  end
+end

data/lib/source/repositories/student_repository.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+##
+# Репозиторий студентов с CRUD операциями.
+
+class StudentRepository
+  def initialize(data_source_adapter)
+    @data_source_adapter = data_source_adapter
+  end
+
+  def student_by_id(student_id)
+    @data_source_adapter.student_by_id(student_id)
+  end
+
+  ##
+  # Получить page по счету count элементов (страница начинается с 1)
+
+  def paginated_short_students(page, count, existing_data_list = nil)
+    @data_source_adapter.paginated_short_students(page, count, existing_data_list)
+  end
+
+  def add_student(student)
+    @data_source_adapter.add_student(student)
+  end
+
+  def replace_student(student_id, student)
+    @data_source_adapter.replace_student(student_id, student)
+  end
+
+  def remove_student(student_id)
+    @data_source_adapter.remove_student(student_id)
+  end
+
+  def student_count
+    @data_source_adapter.student_count
+  end
+end

data/lib/source/util/logger_holder.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require 'logger'
+
+##
+# Обертка для хранения объекта Logger
+
+class LoggerHolder
+  private_class_method :new
+  @instance_mutex = Mutex.new
+
+  attr_reader :logger
+
+  def initialize
+    @logger = Logger.new('log.txt')
+
+    # @logger = Logger.new(STDOUT)
+  end
+
+  def self.instance
+    return @instance.logger if @instance
+
+    @instance_mutex.synchronize do
+      @instance ||= new
+    end
+
+    @instance.logger
+  end
+end

data/shnaider_code.gemspec

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative "lib/shnaider_code/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "shnaider_code"
+  spec.version = ShnaiderCode::VERSION
+  spec.authors = ["Shnaider"]
+  spec.email = ["nullexp.team@gmail.com"]
+  spec.summary = "Student App"
+  spec.description = "А gem that allows you to get pass for patterns"
+  spec.homepage = "https://github.com/bushmrz/learning_patterns_with_ruby"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.2.0"
+  spec.add_dependency 'win32api'
+  spec.files = Dir.glob("**/*")
+end

data/sig/shnaider_code.rbs

@@ -0,0 +1,4 @@
+module ShnaiderCode
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end