concurso_hub 0.1.0

data/src/infrastructure/repositories/pci_concurso_repository.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require 'uri'
+require_relative '../../application/ports/concurso_repository'
+require_relative '../http/http_client'
+require_relative '../parsers/pci_html_parser'
+
+module Infrastructure
+  module Repositories
+    class PciConcursoRepository < Application::Ports::ConcursoRepository
+      ABERTOS_URL    = 'https://www.pciconcursos.com.br/concursos/'
+      ENCERRADOS_URL = 'https://www.pciconcursos.com.br/pesquisa/'
+
+      def initialize(
+        http_client: Http::HttpClient.new,
+        parser:      Parsers::PciHtmlParser.new
+      )
+        @http_client = http_client
+        @parser      = parser
+      end
+
+      def fetch_abertos
+        html = @http_client.get(ABERTOS_URL)
+        @parser.parse_abertos(html)
+      end
+
+      def fetch_encerrados(busca)
+        url  = "#{ENCERRADOS_URL}?p=#{URI.encode_www_form_component(busca)}&tipopesquisa=1"
+        html = @http_client.get(url)
+        @parser.parse_encerrados(html)
+      end
+
+      def fetch_edital(url)
+        html = @http_client.get(url)
+        @parser.parse_edital(html, url)
+      end
+
+      def fetch_provas_listing(provas_url)
+        html = @http_client.get(provas_url)
+        @parser.parse_provas_listing(html)
+      end
+
+      def fetch_prova_pdfs(download_url)
+        html = @http_client.get(download_url)
+        @parser.parse_prova_download_page(html)
+      end
+    end
+  end
+end

data/src/presentation/cli/cli_controller.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require_relative 'cli_options_parser'
+require_relative '../../application/ver_edital_request'
+require_relative '../../application/baixar_edital_request'
+require_relative '../../application/baixar_provas_request'
+
+module Presentation
+  module Cli
+    class CliController
+      def initialize(use_case:, ver_edital:, baixar_edital:, baixar_provas:, options_parser: CliOptionsParser.new)
+        @use_case       = use_case
+        @ver_edital     = ver_edital
+        @baixar_edital  = baixar_edital
+        @baixar_provas  = baixar_provas
+        @options_parser = options_parser
+      end
+
+      def run(args)
+        request = @options_parser.parse(args)
+
+        case request
+        when Application::BaixarProvasRequest
+          @baixar_provas.execute(request)
+        when Application::BaixarEditalRequest
+          @baixar_edital.execute(request)
+        when Application::VerEditalRequest
+          @ver_edital.execute(request)
+        else
+          @use_case.execute(request)
+        end
+      end
+    end
+  end
+end

data/src/presentation/cli/cli_options_parser.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+require 'optparse'
+require_relative '../../application/filtros_concurso'
+require_relative '../../application/ver_edital_request'
+require_relative '../../application/baixar_edital_request'
+require_relative '../../application/baixar_provas_request'
+
+module Presentation
+  module Cli
+    class CliOptionsParser
+      ESTADOS_VALIDOS = %w[
+        NACIONAL AC AL AM AP BA CE DF ES GO MA MG MS MT PA PB PE PI PR
+        RJ RN RO RR RS SC SE SP TO
+      ].freeze
+
+      def parse(args)
+        options    = {}
+        ver_url    = nil
+        baixar_url = nil
+        baixar_provas_url = nil
+        dest_dir   = nil
+
+        parser = OptionParser.new do |opts|
+          opts.banner = build_banner
+          opts.separator 'Opções:'
+
+          opts.on('--ver URL',
+                  'Exibir o edital completo de um concurso pela URL') do |v|
+            ver_url = v
+          end
+
+          opts.on('--baixar URL',
+                  'Baixar os PDFs do edital de um concurso pela URL') do |v|
+            baixar_url = v
+          end
+
+          opts.on('--baixar-provas URL',
+                  'Baixar provas/gabaritos de uma página de provas do pciconcursos') do |v|
+            baixar_provas_url = v
+          end
+
+          opts.on('--dir PASTA',
+                  'Pasta de destino para --baixar (padrão: ./editais/)') do |v|
+            dest_dir = v
+          end
+
+          opts.on('--estado ESTADO',
+                  "Filtrar por estado/UF (#{ESTADOS_VALIDOS.join(', ')})") do |v|
+            options[:estado] = v.upcase
+          end
+
+          opts.on('--nivel NIVEL',
+                  'Filtrar por escolaridade (ex: Superior, Médio, Técnico)') do |v|
+            options[:nivel] = v
+          end
+
+          opts.on('--busca TEXTO',
+                  'Buscar texto no nome da instituição ou cargo') do |v|
+            options[:busca] = v
+          end
+
+          opts.on('--limite N', Integer,
+                  'Limitar o número de resultados exibidos') do |v|
+            options[:limite] = v
+          end
+
+          opts.on('--ano ANO', Integer,
+                  'Filtrar pelo ano no prazo de inscrição (ex: 2025, 2026)') do |v|
+            options[:ano] = v
+          end
+
+          opts.on('--abertos',
+                  'Mostrar concursos com inscrições abertas (padrão)') do
+            options[:modo] = :abertos
+          end
+
+          opts.on('--encerrados',
+                  'Mostrar concursos encerrados (requer --busca)') do
+            options[:modo] = :encerrados
+          end
+
+          opts.on('-h', '--help', 'Exibir esta ajuda') do
+            puts opts
+            exit
+          end
+        end
+
+        parser.parse!(args)
+        return Application::BaixarProvasRequest.new(url: baixar_provas_url, dest_dir: dest_dir) if baixar_provas_url
+        return Application::BaixarEditalRequest.new(url: baixar_url, dest_dir: dest_dir) if baixar_url
+        return Application::VerEditalRequest.new(url: ver_url) if ver_url
+
+        Application::FiltrosConcurso.new(**options)
+      end
+
+      private
+
+      def build_banner
+        <<~BANNER
+
+          Uso:
+            ruby main.rb [opções]
+
+          Exemplos:
+            ruby main.rb                               # todos os abertos
+            ruby main.rb --estado SP                   # apenas SP
+            ruby main.rb --nivel Superior              # nível superior
+            ruby main.rb --busca analista              # busca por texto
+            ruby main.rb --estado MG --limite 10       # 10 primeiros de MG
+            ruby main.rb --encerrados --busca policia  # encerrados sobre polícia
+            ruby main.rb --ver URL                     # edital completo de um concurso
+            ruby main.rb --baixar URL                  # baixar PDFs do edital
+            ruby main.rb --baixar URL --dir ~/Downloads
+            ruby main.rb --baixar-provas URL            # baixar provas/gabaritos anteriores
+
+        BANNER
+      end
+    end
+  end
+end

data/src/presentation/formatters/terminal_presenter.rb

@@ -0,0 +1,203 @@
+# frozen_string_literal: true
+
+require_relative '../../application/ports/presenter'
+
+module Presentation
+  module Formatters
+    class TerminalPresenter < Application::Ports::Presenter
+      RESET  = "\e[0m"
+      BOLD   = "\e[1m"
+      DIM    = "\e[2m"
+      RED    = "\e[31m"
+      GREEN  = "\e[32m"
+      YELLOW = "\e[33m"
+      BLUE   = "\e[34m"
+      CYAN   = "\e[36m"
+      WHITE  = "\e[97m"
+
+      def show_loading
+        puts "#{CYAN}Conectando ao pciconcursos.com.br…#{RESET}"
+      end
+
+      def show(concursos, metadata: {})
+        if concursos.empty?
+          puts "\n#{RED}Nenhum concurso encontrado com os filtros informados.#{RESET}\n"
+          return
+        end
+
+        render_header(metadata)
+        render_concursos(concursos)
+        render_footer(concursos.size)
+      end
+
+      def error(message)
+        warn "#{RED}#{message}#{RESET}"
+      end
+
+      def show_edital(edital)
+        puts
+        puts "#{BOLD}#{CYAN}╔══════════════════════════════════════════════════════════╗#{RESET}"
+        puts "#{BOLD}#{CYAN}║  EDITAL COMPLETO                                         ║#{RESET}"
+        puts "#{BOLD}#{CYAN}╚══════════════════════════════════════════════════════════╝#{RESET}"
+        puts
+        puts "#{BOLD}#{WHITE}#{edital.titulo}#{RESET}"
+        puts
+        puts "#{DIM}#{edital.descricao}#{RESET}"                                    unless edital.descricao.empty?
+        puts "#{DIM}Publicado em: #{edital.data_publicacao}#{RESET}"                unless edital.data_publicacao.empty?
+        puts "#{DIM}Fonte: #{edital.url}#{RESET}"
+        puts
+        puts "#{DIM}#{'─' * 70}#{RESET}"
+        puts
+
+        edital.blocos.each do |bloco|
+          case bloco[:tipo]
+          when :secao
+            puts "\n#{BOLD}#{YELLOW}#{bloco[:texto]}#{RESET}\n"
+          when :paragrafo
+            puts wrap_text(bloco[:texto])
+            puts
+          when :item
+            puts "  #{CYAN}•#{RESET} #{wrap_text(bloco[:texto], indent: 4)}"
+          end
+        end
+
+        unless edital.pdfs.empty?
+          puts
+          puts "#{BOLD}#{YELLOW}PDFs disponíveis:#{RESET}"
+          edital.pdfs.each_with_index do |pdf, i|
+            puts "  #{CYAN}[#{i + 1}]#{RESET} #{pdf[:titulo]}"
+            puts "      #{DIM}#{pdf[:url]}#{RESET}"
+          end
+          puts
+          puts "#{DIM}Use --baixar URL para fazer download dos PDFs.#{RESET}"
+        end
+
+        if edital.provas_url
+          puts
+          puts "#{BOLD}#{YELLOW}Provas anteriores disponíveis:#{RESET}"
+          puts "  #{DIM}#{edital.provas_url}#{RESET}"
+          puts "#{DIM}Use --baixar-provas #{edital.provas_url} para baixar todas as provas.#{RESET}"
+        end
+      end
+
+      def show_provas(provas)
+        if provas.empty?
+          puts "\n#{RED}Nenhuma prova encontrada.#{RESET}\n"
+          return
+        end
+
+        puts
+        puts "#{BOLD}#{CYAN}Provas e gabaritos disponíveis:#{RESET}"
+        puts
+        provas.each do |prova|
+          puts "#{BOLD}#{YELLOW}#{prova[:cargo]}#{RESET}"
+          prova[:pdfs].each_with_index do |pdf, i|
+            puts "  #{CYAN}[#{i + 1}]#{RESET} #{pdf[:titulo]}"
+            puts "      #{DIM}#{pdf[:url]}#{RESET}"
+          end
+          puts
+        end
+
+        puts
+        puts "#{DIM}#{'═' * 70}#{RESET}"
+        puts
+      end
+
+      def show_download_start(titulo, index, total)
+        puts "  #{CYAN}[#{index}/#{total}]#{RESET} #{titulo}…"
+      end
+
+      def show_download_done(paths)
+        puts
+        puts "#{GREEN}#{BOLD}#{paths.size} arquivo(s) baixado(s) com sucesso:#{RESET}"
+        paths.each { |p| puts "  #{DIM}#{p}#{RESET}" }
+        puts
+      end
+
+      private
+
+      def render_header(metadata)
+        total_vagas   = metadata[:total_vagas]   || ''
+        total_scraped = metadata[:total_scraped]
+        encerrados    = metadata[:modo] == :encerrados
+        busca         = metadata[:busca]
+
+        titulo = encerrados ? 'CONCURSOS ENCERRADOS' : 'CONCURSOS PÚBLICOS ABERTOS'
+
+        puts
+        puts "#{BOLD}#{CYAN}╔══════════════════════════════════════════════════════════╗#{RESET}"
+        puts "#{BOLD}#{CYAN}║  #{titulo.ljust(54)} ║#{RESET}"
+        puts "#{BOLD}#{CYAN}║  #{Time.now.strftime('%d/%m/%Y').ljust(54)} ║#{RESET}"
+        puts "#{BOLD}#{CYAN}╚══════════════════════════════════════════════════════════╝#{RESET}"
+        puts
+        puts "#{DIM}Busca: \"#{busca}\"#{RESET}"                        if busca
+        puts "#{DIM}Fonte: pciconcursos.com.br  |  #{total_vagas}#{RESET}" unless total_vagas.empty?
+        puts "#{DIM}#{total_scraped} resultado(s) encontrado(s).#{RESET}" if total_scraped
+        puts
+      end
+
+      def render_concursos(concursos)
+        puts "#{GREEN}#{BOLD}Exibindo #{concursos.size} concurso(s)#{RESET}"
+        puts
+
+        current_state = nil
+        concursos.each do |c|
+          if c.estado != current_state
+            current_state = c.estado
+            puts "\n#{BOLD}#{BLUE}▶  #{current_state}#{RESET}"
+            puts "#{DIM}#{'-' * 62}#{RESET}"
+          end
+          render_entry(c)
+        end
+      end
+
+      def render_entry(concurso)
+        puts
+        puts "  #{BOLD}#{WHITE}#{concurso.instituicao}#{RESET}"
+
+        vagas_line = if concurso.salario.empty?
+                       concurso.vagas
+                     else
+                       "#{concurso.vagas}  #{YELLOW}#{concurso.salario}#{RESET}"
+                     end
+
+        puts "  #{YELLOW}Vagas :#{RESET} #{vagas_line}"
+        puts "  #{YELLOW}Cargo :#{RESET} #{concurso.cargos}"        unless concurso.cargos.empty?
+        puts "  #{YELLOW}Nível :#{RESET} #{concurso.nivel}"          unless concurso.nivel.empty?
+        puts "  #{YELLOW}Prazo :#{RESET} #{RED}#{concurso.prazo}#{RESET}" unless concurso.prazo.empty?
+        puts "  #{DIM}#{concurso.url}#{RESET}"                        if concurso.url
+      end
+
+      def render_footer(count)
+        puts
+        puts "#{DIM}#{'═' * 62}#{RESET}"
+        puts "#{GREEN}#{BOLD}Total exibido: #{count} concurso(s)#{RESET}"
+        puts
+      end
+
+      def wrap_text(text, width: 72, indent: 0)
+        words  = text.split(' ')
+        prefix = ' ' * indent
+        lines  = []
+        line   = ''
+
+        words.each do |word|
+          if line.empty?
+            line = word
+          elsif (line.length + 1 + word.length) <= (width - indent)
+            line += " #{word}"
+          else
+            lines << line
+            line = word
+          end
+        end
+        lines << line unless line.empty?
+
+        first = lines.shift || ''
+        return first if lines.empty?
+
+        ([first] + lines.map { |l| prefix + l }).join("\n")
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification
+name: concurso_hub
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Felipe
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-05-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+description: Gem Ruby para buscar concursos públicos brasileiros a partir do PCI Concursos.
+  Retorna listagens, editais e provas em estruturas de dados prontas para APIs backend.
+email: ''
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/concurso_hub.rb
+- lib/concurso_hub/version.rb
+- src/application/baixar_edital_request.rb
+- src/application/baixar_provas_request.rb
+- src/application/filtros_concurso.rb
+- src/application/ports/concurso_repository.rb
+- src/application/ports/file_downloader.rb
+- src/application/ports/presenter.rb
+- src/application/use_cases/baixar_edital.rb
+- src/application/use_cases/baixar_provas.rb
+- src/application/use_cases/listar_concursos.rb
+- src/application/use_cases/listar_provas.rb
+- src/application/use_cases/ver_edital.rb
+- src/application/ver_edital_request.rb
+- src/domain/entities/concurso.rb
+- src/domain/entities/edital.rb
+- src/infrastructure/http/http_client.rb
+- src/infrastructure/http/http_file_downloader.rb
+- src/infrastructure/parsers/pci_html_parser.rb
+- src/infrastructure/repositories/pci_concurso_repository.rb
+- src/presentation/cli/cli_controller.rb
+- src/presentation/cli/cli_options_parser.rb
+- src/presentation/formatters/terminal_presenter.rb
+homepage: https://github.com/seu-usuario/concurso_hub
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+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: Busca e extração de dados de concursos públicos brasileiros
+test_files: []