concurso_hub 0.1.1 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3d3c35af1cd394db7f3addc01c36daf6213ef41cad01f7698012fa133fd138ea
-  data.tar.gz: b3560b5c754af23223c6057cb09b101d3a9b111aeda8c9e4182e66bff317c3cc
+  metadata.gz: f99628e279ee08c6946acef5af57235d817ad60f21c34ea0c479f8d613ea72ca
+  data.tar.gz: fe45e6e0222417e0668f5919bb7cd489b1948a19a5ddae842636cc45c2e1e4b5
 SHA512:
-  metadata.gz: e36c6535eda410ed7ad844df0a12c6b62115ca399a1fbf3fb6fb0c0460b8616708a37bacd974571c507d80bdfc0f60aa7bc2341cc380d18934408bf251f4ffdc
-  data.tar.gz: 820b978859be06ee266300016d1324b36bb4b5ab9576a054e2d679d177db5d2a5d5147484bae866f117011479591d1c17481e1c1fa4851d5f15523840b962059
+  metadata.gz: c4ab516996fcb6e9db83f9c7cad653fcfe9bf1debf5afcc9da77631a512a779f90404749238a0392b6370ea0710478131be21f2881c5218f329b3d1d5bc12de7
+  data.tar.gz: 35f768dd828eb2d0adb259fb3e91896855c50f3fc82f4125a372224e607ff0cd2522f4e8a9be8070d8e9619b1da717bf829d9ade7424eaa3c7e9a06bcf824ebe

data/README.md

@@ -14,6 +14,7 @@ Projetada com **arquitetura hexagonal (Ports & Adapters)**, a biblioteca mantém
   - [ConcursoHub.search](#concursoscrapersearch)
   - [ConcursoHub.edital](#concursoscraperedital)
   - [ConcursoHub.provas](#concursoscraperprovas)
+  - [ConcursoHub.download](#concursoscraperdownload)
   - [Exemplo completo em Rails](#exemplo-completo-em-rails)
 - [Uso avançado (injeção de dependências)](#uso-avançado-injeção-de-dependências)
   - [Listar concursos](#listar-concursos)
@@ -217,6 +218,36 @@ provas
 
 ---
 
+### ConcursoHub.download
+
+Busca um PDF do PCI Concursos e retorna os **bytes brutos** (`String` binária) — sem salvar nada em disco. A gem é apenas a ponte; o backend decide o que fazer com os bytes.
+
+```ruby
+# url vem de edital[:pdfs].first[:url] ou provas[0][:pdfs].first[:url]
+bytes = ConcursoHub.download(pdf_url)
+```
+
+**Casos de uso típicos em backends multi-usuário:**
+
+```ruby
+# 1. Stream direto para o cliente (Rails) — sem tocar no disco
+bytes = ConcursoHub.download(params[:pdf_url])
+send_data bytes, type: 'application/pdf', filename: 'documento.pdf', disposition: 'inline'
+
+# 2. Salvar no S3 / object storage
+bytes = ConcursoHub.download(pdf_url)
+S3.put_object(bucket: 'meu-bucket', key: "provas/#{cargo}.pdf", body: bytes)
+
+# 3. Encodar em Base64 para resposta JSON
+require 'base64'
+bytes = ConcursoHub.download(pdf_url)
+render json: { filename: 'prova.pdf', content: Base64.strict_encode64(bytes) }
+```
+
+> **Nota:** Não utilize este método para salvar arquivos em disco em ambientes multi-usuário — prefira object storage (S3, GCS) ou stream direto ao cliente. O método `download` faz sentido em disco apenas na CLI (uso local).
+
+---
+
 ### Exemplo completo em Rails
 
 **`Gemfile`**
@@ -258,14 +289,24 @@ class ConcursosController < ApplicationController
   rescue => e
     render json: { error: e.message }, status: :bad_gateway
   end
+
+  # GET /concursos/download?url=https://pciconcursos.com.br/.../edital.pdf
+  # Faz o stream do PDF direto ao cliente — sem salvar em disco
+  def download
+    bytes = ConcursoHub.download(params[:url])
+    send_data bytes, type: 'application/pdf', disposition: 'inline'
+  rescue => e
+    render json: { error: e.message }, status: :bad_gateway
+  end
 end
 ```
 
 **`config/routes.rb`**
 ```ruby
-get '/concursos',        to: 'concursos#index'
-get '/concursos/edital', to: 'concursos#edital'
-get '/concursos/provas', to: 'concursos#provas'  # ?url= é a URL do concurso
+get '/concursos',          to: 'concursos#index'
+get '/concursos/edital',   to: 'concursos#edital'
+get '/concursos/provas',   to: 'concursos#provas'    # ?url= é a URL do concurso
+get '/concursos/download', to: 'concursos#download'  # ?url= é a URL do PDF
 ```
 
 ---

data/lib/concurso_hub/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ConcursoHub
-  VERSION = '0.1.1'
+  VERSION = '0.2.1'
 end

data/lib/concurso_hub.rb

@@ -11,6 +11,7 @@ require 'application/use_cases/listar_concursos'
 require 'application/use_cases/ver_edital'
 require 'application/use_cases/listar_provas'
 require 'infrastructure/repositories/pci_concurso_repository'
+require 'infrastructure/http/http_file_downloader'
 
 module ConcursoHub
   def self.search(
@@ -60,6 +61,10 @@ module ConcursoHub
     fetch_edital_hash(url, build_repository)
   end
 
+  def self.download(url)
+    Infrastructure::Http::HttpFileDownloader.new.fetch_bytes(url)
+  end
+
   def self.provas(url)
     repository = build_repository
     edital     = fetch_edital_hash(url, repository)

data/src/infrastructure/http/http_file_downloader.rb

@@ -10,6 +10,36 @@ module Infrastructure
       USER_AGENT = 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 ' \
                    '(KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36'
 
+      def fetch_bytes(url, redirect_limit: 5)
+        raise 'Muitos redirecionamentos' if redirect_limit.zero?
+
+        uri  = URI.parse(url)
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl      = (uri.scheme == 'https')
+        http.open_timeout = 15
+        http.read_timeout = 120
+
+        request = Net::HTTP::Get.new(uri.request_uri)
+        request['User-Agent'] = USER_AGENT
+
+        http.start do |h|
+          h.request(request) do |response|
+            case response
+            when Net::HTTPSuccess
+              buffer = +''
+              response.read_body { |chunk| buffer << chunk }
+              buffer
+            when Net::HTTPRedirection
+              new_url = response['location']
+              new_url = URI.join(url, new_url).to_s unless new_url.start_with?('http')
+              fetch_bytes(new_url, redirect_limit: redirect_limit - 1)
+            else
+              raise "Erro HTTP: #{response.code} #{response.message}"
+            end
+          end
+        end
+      end
+
       def download(url, dest_path, redirect_limit: 5)
         raise 'Muitos redirecionamentos' if redirect_limit.zero?
 

data/src/infrastructure/parsers/pci_html_parser.rb

@@ -87,7 +87,7 @@ module Infrastructure
       end
 
       def build_concurso_encerrado(el)
-        link = el.css('div.ca > a').first
+        link = el.css('div.ca > a[href^="/concurso/"]').first
         return nil unless link
 
         state = el.css('div.cc').first&.text&.strip || ''
@@ -106,7 +106,7 @@ module Infrastructure
         )
       end
       def build_concurso(el, state)
-        link = el.css('div.ca > a').first
+        link = el.css('div.ca > a[href^="/concurso/"]').first
         return nil unless link
 
         vagas, salario = parse_vagas_salario(el)

data/src/presentation/cli/cli_controller.rb

@@ -8,11 +8,13 @@ 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)
+      def initialize(use_case:, ver_edital:, baixar_edital:, baixar_provas:, presenter:, repository:, options_parser: CliOptionsParser.new)
         @use_case       = use_case
         @ver_edital     = ver_edital
         @baixar_edital  = baixar_edital
         @baixar_provas  = baixar_provas
+        @presenter      = presenter
+        @repository     = repository
         @options_parser = options_parser
       end
 
@@ -28,8 +30,47 @@ module Presentation
           @ver_edital.execute(request)
         else
           @use_case.execute(request)
+          interactive_menu
+        end
+      end
+
+      private
+
+      def interactive_menu
+        concursos = @presenter.last_concursos
+        return if concursos.nil? || concursos.empty?
+
+        print "\nSelecione um concurso (1-#{concursos.size}) ou Enter para sair: "
+        input = $stdin.gets&.chomp
+        return if input.nil? || input.empty?
+
+        index = input.to_i - 1
+        return unless index.between?(0, concursos.size - 1)
+
+        concurso = concursos[index]
+
+        puts "\n  \e[1m\e[97m#{concurso.instituicao}\e[0m  —  #{concurso.estado}"
+        puts
+        puts "  [1] Ver edital completo"
+        puts "  [2] Baixar PDFs do edital"
+        puts "  [3] Baixar provas e gabaritos"
+        print "\n  Opção (Enter para cancelar): "
+
+        case $stdin.gets&.chomp
+        when '1'
+          @ver_edital.execute(Application::VerEditalRequest.new(url: concurso.url))
+        when '2'
+          @baixar_edital.execute(Application::BaixarEditalRequest.new(url: concurso.url, dest_dir: nil))
+        when '3'
+          edital = @repository.fetch_edital(concurso.url)
+          unless edital.provas_url
+            puts "\n  \e[31mNenhuma prova disponível para este concurso.\e[0m"
+            return
+          end
+          @baixar_provas.execute(Application::BaixarProvasRequest.new(url: edital.provas_url, dest_dir: nil))
         end
       end
     end
   end
 end
+

data/src/presentation/formatters/terminal_presenter.rb

@@ -15,11 +15,14 @@ module Presentation
       CYAN   = "\e[36m"
       WHITE  = "\e[97m"
 
+      attr_reader :last_concursos
+
       def show_loading
         puts "#{CYAN}Conectando ao pciconcursos.com.br…#{RESET}"
       end
 
       def show(concursos, metadata: {})
+        @last_concursos = concursos
         if concursos.empty?
           puts "\n#{RED}Nenhum concurso encontrado com os filtros informados.#{RESET}\n"
           return
@@ -141,19 +144,20 @@ module Presentation
         puts
 
         current_state = nil
-        concursos.each do |c|
+        concursos.each_with_index do |c, i|
           if c.estado != current_state
             current_state = c.estado
-            puts "\n#{BOLD}#{BLUE}▶  #{current_state}#{RESET}"
+            puts "\n#{BOLD}#{BLUE}\u25b6  #{current_state}#{RESET}"
             puts "#{DIM}#{'-' * 62}#{RESET}"
           end
-          render_entry(c)
+          render_entry(c, i + 1)
         end
       end
 
-      def render_entry(concurso)
+      def render_entry(concurso, numero = nil)
         puts
-        puts "  #{BOLD}#{WHITE}#{concurso.instituicao}#{RESET}"
+        num_prefix = numero ? "#{BOLD}#{CYAN}[#{numero}]#{RESET} " : '  '
+        puts "  #{num_prefix}#{BOLD}#{WHITE}#{concurso.instituicao}#{RESET}"
 
         vagas_line = if concurso.salario.empty?
                        concurso.vagas

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: concurso_hub
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.1
 platform: ruby
 authors:
 - Felipe Longo
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-22 00:00:00.000000000 Z
+date: 2026-05-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri