datajud 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5f39081aadf1eae3fd48ec2b4c41290747c9c1d7af57e1c2277a030633ed9e64
-  data.tar.gz: aab5ae80ec67d1465641b0af7b4674b1ee2dceddcc20c5ef36fbf9263dd2a23a
+  metadata.gz: 5df3f8cadbf3eb0e40ba6891207bc56a076e5624e171cd99e1fef1ee66cf1696
+  data.tar.gz: bfc125d69fb6a639afbc0891db64d301209cf7901e14a8fee82477623e521153
 SHA512:
-  metadata.gz: 8c0c96e126baf36e5a1e9fe6960a60f6bf332290931515f8386245c4e808905a89c2bae3a89dd38fb900a6de953739e9175edc2880047520d62ae054bab7c674
-  data.tar.gz: f518b69601b88db2d9a7eb452673019449504772ce4d818e2c64d65e663b8b72a1f8ec1910ce37a5839cd135b1d65386f43ba9fe67dd72b731484212cf267d53
+  metadata.gz: 6ad607e3b195cc8055bcad7b5e77854694a91297f86af88391ccd4c13cdeac5a49394315a9a0120dde19f49507526c41849ffe7ad3fc6ed2019ad921d74ad8dd
+  data.tar.gz: f9b89ba96631fa69025ae5d6b52a5cc142c4026aaccb5f1397b3459a502a5189eb9e9cc48bcdd1046b7f78cdc461697b8f6e915728e73105d51907f995afcdae

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 ## [Unreleased]
 
+## [0.1.4] - 2026-03-12
+
+- Todos os atributos e subatributos do processo agora podem ser acessados por ponto (OpenStruct), sem classes manuais.
+
+## [0.1.3] - 2026-03-12
+
+- Exposed object-oriented accessors for nested attributes (ex.: `processo.vara.nome`).
+- Standardized on `andamentos` and removed the `movimentacoes` alias.
+
 ## [0.1.2] - 2026-03-12
 
 - Added `Datajud.find` to return process data via an object-oriented API.

data/README.md

@@ -19,19 +19,35 @@ If bundler is not being used to manage dependencies, install the gem by executin
 ```ruby
 require 'datajud'
 
+# Busca processo (tribunal pode ser explícito ou inferido)
 processo = Datajud.find("00008323520184013202")
-
-# Com tribunal explícito
 processo = Datajud.find("00008323520184013202", tribunal: "trf1")
 
-processo.numero
-processo.classe
-processo.partes
-processo.movimentacoes
-
-# Tribunal como objeto
-processo.tribunal
-# => { nome: "TRF1", sigla: "TRF1", esfera: "Federal" }
+# Acessa atributos principais
+puts processo.tribunal # Tribunal como objeto ou string
+puts processo.numero
+puts processo.vara
+puts processo.situacao
+puts processo.andamentos
+puts processo.documentos
+puts processo.audiencias
+puts processo.sistema
+puts processo.formato
+puts processo.data_ultima_atualizacao
+puts processo.data_ajuizamento
+puts processo.nivel_sigilo
+puts processo.id
+puts processo.timestamp
+
+# Tribunal como objeto (se disponível)
+puts processo.tribunal.nome if processo.tribunal.respond_to?(:nome)
+puts processo.tribunal.sigla if processo.tribunal.respond_to?(:sigla)
+puts processo.tribunal.esfera if processo.tribunal.respond_to?(:esfera)
+
+# Exemplos de acesso orientado a objeto
+puts processo.vara.nome if processo.vara.respond_to?(:nome)
+puts processo.vara.comarca.nome if processo.vara&.comarca&.respond_to?(:nome)
+puts processo.assunto.map(&:nome) if processo.assunto
 
 # Tabela HTML de endpoints (todos os tribunais conhecidos)
 Datajud.endpoints_table(Datajud::TRIBUNAIS_SIGLAS)
@@ -42,6 +58,8 @@ Datajud.endpoints_table(Datajud::TRIBUNAIS_SIGLAS)
 ```ruby
 # API orientada a objeto
 processo = Datajud.find("00008323520184013202", tribunal: "trf1")
+# ou
+processo = Datajud.find("00008323520184013202", "trf1")
 
 # Retorno bruto (hash)
 resultado = Datajud.processo("00008323520184013202", tribunal: "trf1")
@@ -73,7 +91,7 @@ para evitar varrer todas as bases.
 
 ```ruby
 processo = Datajud.find("0000832-35.2018.8.26.0202")
-puts processo.tribunal
+puts processo.tribunal.nome
 ```
 
 > A UF da comarca é derivada localmente pelo código IBGE do município quando disponível.

data/examples/find.rb

@@ -11,11 +11,11 @@ begin
   processo = Datajud.find("0000832-35.2018.8.26.0202")
 
   if processo
-    puts "Tribunal: #{processo.tribunal}"
+    puts "Tribunal: #{processo.tribunal.nome}"
     puts "Número: #{processo.numero}"
-    puts "Classe: #{processo.classe}"
+    puts "Classe: #{processo.classe.nome}"
     puts "Partes: #{processo.partes.map(&:nome).join(', ')}"
-    puts "Movimentações: #{processo.movimentacoes.size}"
+    puts "Andamentos: #{processo.andamentos.size}"
   else
     puts "Processo não encontrado."
   end

data/lib/datajud/process.rb

@@ -6,99 +6,63 @@ module Datajud
   # Representa um processo retornado pela API DataJud.
   # Fornece acesso simples a campos comuns via métodos.
   class Processo
-    attr_reader :tribunal, :data
+                def self.deep_struct(obj)
+                  case obj
+                  when Hash
+                    OpenStruct.new(obj.transform_values { |v| deep_struct(v) })
+                  when Array
+                    obj.map { |v| deep_struct(v) }
+                  else
+                    obj
+                  end
+                end
+            def municipio_ibge
+              orgao = instance_variable_get(:@orgao_julgador) || instance_variable_get(:@orgao_julgador) || self.respond_to?(:orgao_julgador) ? self.orgao_julgador : nil
+              return nil unless orgao && orgao.is_a?(Hash)
+              orgao['codigoMunicipioIBGE'] || orgao[:codigoMunicipioIBGE]
+            end
+        def comarca_ibge_codigo
+          v = instance_variable_get(:@vara)
+          return nil unless v && v.is_a?(Hash)
+          comarca = v['comarca'] || v[:comarca]
+          return nil unless comarca && comarca.is_a?(Hash)
+          comarca['codigoIbge'] || comarca[:codigoIbge] || comarca['ibge'] || comarca[:ibge]
+        end
+    attr_reader :tribunal
 
     def initialize(raw)
-      # raw expected: { tribunal: 'TJSP', processo: { ... } } or string-keyed
-      @tribunal = raw[:tribunal] || raw['tribunal']
-      @data = raw[:processo] || raw['processo'] || {}
-    end
-
-    def numero
-      @data['numero'] || @data[:numero]
-    end
-
-    def classe
-      @data['classe'] || @data[:classe]
-    end
-
-    def vara
-      v = @data['vara'] || @data[:vara]
-      return nil unless v
-
-      OpenStruct.new(
-        nome: v['nome'] || v[:nome],
-        codigo: v['codigo'] || v[:codigo],
-        comarca: v['comarca'] || v[:comarca]
-      )
-    end
-
-    def situacao
-      @data['situacao'] || @data[:situacao]
-    end
-
-    def origem
-      @data['origem'] || @data[:origem]
-    end
-
-    def instancia
-      @data['instancia'] || @data[:instancia]
-    end
-
-    def assunto
-      @data['assunto'] || @data[:assunto]
-    end
-
-    def partes
-      partes = @data['partes'] || @data[:partes] || []
-      partes.map do |p|
-        OpenStruct.new(
-          nome: p['nome'] || p[:nome],
-          tipo: p['tipo'] || p['tipoParte'] || p[:tipo],
-          documento: p['documento'] || p[:documento]
-        )
+      processo_hash = raw[:processo] || raw['processo'] || raw
+      @tribunal = self.class.deep_struct(raw[:tribunal] || raw['tribunal'])
+      processo_hash.each do |k, v|
+        ivar = "@#{k.to_s.gsub(/([A-Z])/, '_\\1').downcase}"
+        instance_variable_set(ivar, self.class.deep_struct(v))
+        self.class.send(:attr_reader, k.to_s.gsub(/([A-Z])/, '_\\1').downcase)
       end
-    end
-
-    def andamentos
-      mov = @data['andamentos'] || @data[:andamentos] || @data['movimentacoes'] || @data[:movimentacoes]
-      (mov || []).map do |m|
-        OpenStruct.new(
-          descricao: m['descricao'] || m[:descricao],
-          data: m['data'] || m['dataHora'] || m[:data],
-          tipo: m['tipo'] || m['codigoTipoMovimento'] || m[:tipo]
-        )
+      if processo_hash['orgaoJulgador'] || processo_hash[:orgaoJulgador]
+        orgao = processo_hash['orgaoJulgador'] || processo_hash[:orgaoJulgador]
+        instance_variable_set(:@orgao_julgador, self.class.deep_struct(orgao))
+        self.class.send(:attr_reader, :orgao_julgador)
+        if orgao['codigoMunicipioIBGE'] || orgao[:codigoMunicipioIBGE]
+          vara = instance_variable_get(:@vara)
+          if vara && vara.respond_to?(:comarca)
+            comarca = vara.comarca
+            if comarca && comarca.is_a?(OpenStruct)
+              ibge = orgao['codigoMunicipioIBGE'] || orgao[:codigoMunicipioIBGE]
+              comarca.codigoIbge = ibge if comarca.respond_to?(:codigoIbge=)
+            end
+          end
+        end
       end
-    end
 
-    def documentos
-      docs = @data['documentos'] || @data[:documentos] || []
-      docs.map do |d|
-        OpenStruct.new(
-          titulo: d['titulo'] || d['nomeDocumento'] || d[:titulo],
-          tipo: d['tipo'] || d['tipoDocumento'] || d[:tipo],
-          data: d['data'] || d['dataJuntada'] || d[:data],
-          assinatura_digital: d['assinatura_digital'] || d['assinaturaDigital'] || d[:assinatura_digital]
-        )
-      end
     end
 
-    def audiencias
-      auds = @data['audiencias'] || @data[:audiencias] || []
-      auds.map do |a|
-        OpenStruct.new(
-          data_hora: a['data_hora'] || a['dataHora'] || a[:data_hora],
-          tipo: a['tipo'] || a[:tipo],
-          status: a['status'] || a['statusAudiencia'] || a[:status],
-          observacao: a['observacao'] || a[:observacao]
-        )
+    def codigo_municipio_ibge
+      if respond_to?(:orgao_julgador) && orgao_julgador.is_a?(Hash)
+        orgao_julgador['codigoMunicipioIBGE'] || orgao_julgador[:codigoMunicipioIBGE]
+      else
+        nil
       end
     end
-
-    alias movimentacoes andamentos
-
-    def to_h
-      { tribunal: tribunal, processo: data }
-    end
+    # Only tribunal is explicit; all other fields are dynamic.
   end
 end

data/lib/datajud/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Datajud
-  VERSION = "0.1.3"
+  VERSION = "0.1.4"
 end

data/lib/datajud.rb

@@ -357,11 +357,11 @@ module Datajud
         tribunal: tribunal_from(sigla, proc),
         processo: {
           numero: proc['numeroProcesso'],
-      vara: proc['orgaoJulgador'] ? {
-        nome: proc['orgaoJulgador']['nome'],
-        codigo: proc['orgaoJulgador']['codigo'],
-        comarca: comarca_from(proc['orgaoJulgador'], sigla)
-      } : nil,
+          vara: proc['orgaoJulgador'] ? {
+            nome: proc['orgaoJulgador']['nome'],
+            codigo: proc['orgaoJulgador']['codigo'],
+            comarca: comarca_from(proc['orgaoJulgador'], sigla)
+          } : nil,
           situacao: proc['situacao'],
           origem: proc['origem'],
           instancia: proc['grau'],
@@ -390,7 +390,14 @@ module Datajud
               status: aud['statusAudiencia'],
               observacao: aud['observacao']
             }
-          end
+          end,
+          sistema: proc['sistema'],
+          formato: proc['formato'],
+          dataHoraUltimaAtualizacao: proc['dataHoraUltimaAtualizacao'],
+          dataAjuizamento: proc['dataAjuizamento'],
+          nivelSigilo: proc['nivelSigilo'],
+          id: proc['id'],
+          timestamp: proc['@timestamp']
         }
       }
       break
@@ -471,7 +478,8 @@ module Datajud
     if comarca.is_a?(Hash)
       nome = comarca['nome'] || comarca['descricao'] || comarca['nomeComarca']
       uf = comarca['uf'] || comarca['siglaUf'] || comarca['estado']
-      return { nome: nome, uf: uf, tribunal: sigla.upcase }
+      hash = { nome: nome, uf: uf, tribunal: sigla.upcase }
+      return hash
     end
 
     nome = comarca || orgao_julgador['nome']
@@ -485,7 +493,11 @@ module Datajud
 
     return nil unless nome
 
-    { nome: nome, uf: uf, tribunal: sigla.upcase }
+    hash = { nome: nome, uf: uf, tribunal: sigla.upcase }
+    if orgao_julgador['codigoMunicipioIBGE']
+      hash[:codigoIbge] = orgao_julgador['codigoMunicipioIBGE']
+    end
+    hash
   end
 
   def self.ibge_uf_from(codigo_municipio)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: datajud
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - PablUoo