brasilapi 0.7.0 → 0.9.0

data/lib/brasil_api/tuss.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+# Cliente Ruby da {https://brasilapi.com.br BrasilAPI}.
+#
+# @example Bancos participantes do STR
+#   BrasilAPI::Bank.all
+# @see https://brasilapi.com.br/docs
+module BrasilAPI
+  # Terminologia Unificada da Saúde Suplementar.
+  #
+  # @see https://brasilapi.com.br/docs#tag/TUSS
+  class TUSS < Base
+    # Filtros de listagem, busca e autocompletar, e o nome enviado na query.
+    #
+    # @return [Hash{Symbol=>Symbol}]
+    PARAMS = {
+      query: :q,
+      name: :name,
+      code: :tuss,
+      match: :match,
+      sort: :sort,
+      order: :order,
+      fields: :fields,
+      limit: :limit,
+      offset: :offset
+    }.freeze
+
+    class << self
+      # Lista procedimentos da TUSS.
+      #
+      # @param filters [Hash] filtros opcionais
+      # @option filters [String] :query texto livre (+q+)
+      # @option filters [String] :name nome do procedimento
+      # @option filters [String] :code código TUSS (+tuss+)
+      # @option filters [String] :match modo de correspondência
+      # @option filters [String] :sort campo de ordenação
+      # @option filters [String] :order direção da ordenação
+      # @option filters [String] :fields campos devolvidos
+      # @option filters [Integer] :limit quantidade máxima de itens
+      # @option filters [Integer] :offset deslocamento da página
+      # @return [Hash] total e lista de procedimentos
+      # @raise [BrasilAPI::BadRequest] quando a BrasilAPI responde 400
+      # @raise [BrasilAPI::NotFound] quando a BrasilAPI responde 404
+      # @raise [BrasilAPI::ServerError] quando a BrasilAPI responde 5xx
+      # @raise [BrasilAPI::Timeout] quando a requisição estoura o tempo limite
+      # @raise [BrasilAPI::Error] em outras respostas de erro
+      # @example Primeiro procedimento
+      #   BrasilAPI::TUSS.all(limit: 1)
+      # @see https://brasilapi.com.br/docs#tag/TUSS
+      def all(**filters)
+        get("/tuss/v1", translate(filters, PARAMS))
+      end
+
+      # Busca um procedimento pelo código TUSS.
+      #
+      # @param code [String, Integer] código do procedimento
+      # @return [Hash] descrição do procedimento
+      # @raise [BrasilAPI::BadRequest] quando a BrasilAPI responde 400
+      # @raise [BrasilAPI::NotFound] quando o código não existe
+      # @raise [BrasilAPI::ServerError] quando a BrasilAPI responde 5xx
+      # @raise [BrasilAPI::Timeout] quando a requisição estoura o tempo limite
+      # @raise [BrasilAPI::Error] em outras respostas de erro
+      # @example Consulta em consultório
+      #   BrasilAPI::TUSS.find_by_code("10101012")
+      # @see https://brasilapi.com.br/docs#tag/TUSS
+      def find_by_code(code)
+        get("/tuss/v1/#{code}")
+      end
+
+      # Procura procedimentos por texto e filtros.
+      #
+      # @param filters [Hash] filtros opcionais; as chaves são as de {PARAMS}
+      # @option filters [String] :query texto livre (+q+)
+      # @option filters [String] :name nome do procedimento
+      # @option filters [String] :code código TUSS (+tuss+)
+      # @option filters [String] :match modo de correspondência
+      # @option filters [String] :sort campo de ordenação
+      # @option filters [String] :order direção da ordenação
+      # @option filters [String] :fields campos devolvidos
+      # @option filters [Integer] :limit quantidade máxima de itens
+      # @option filters [Integer] :offset deslocamento da página
+      # @return [Hash] total e procedimentos encontrados
+      # @raise [BrasilAPI::BadRequest] quando a BrasilAPI responde 400
+      # @raise [BrasilAPI::NotFound] quando a BrasilAPI responde 404
+      # @raise [BrasilAPI::ServerError] quando a BrasilAPI responde 5xx
+      # @raise [BrasilAPI::Timeout] quando a requisição estoura o tempo limite
+      # @raise [BrasilAPI::Error] em outras respostas de erro
+      # @example
+      #   BrasilAPI::TUSS.search(query: "consulta", limit: 1)
+      # @see https://brasilapi.com.br/docs#tag/TUSS
+      def search(**filters)
+        get("/tuss/v1/search", translate(filters, PARAMS))
+      end
+
+      # Sugere procedimentos a partir de um prefixo.
+      #
+      # @param filters [Hash] filtros opcionais; as chaves são as de {PARAMS}
+      # @option filters [String] :query texto livre (+q+)
+      # @option filters [String] :name nome do procedimento
+      # @option filters [String] :code código TUSS (+tuss+)
+      # @option filters [String] :match modo de correspondência
+      # @option filters [String] :sort campo de ordenação
+      # @option filters [String] :order direção da ordenação
+      # @option filters [String] :fields campos devolvidos
+      # @option filters [Integer] :limit quantidade máxima de itens
+      # @option filters [Integer] :offset deslocamento da página
+      # @return [Hash] sugestões de procedimentos
+      # @raise [BrasilAPI::BadRequest] quando a BrasilAPI responde 400
+      # @raise [BrasilAPI::NotFound] quando a BrasilAPI responde 404
+      # @raise [BrasilAPI::ServerError] quando a BrasilAPI responde 5xx
+      # @raise [BrasilAPI::Timeout] quando a requisição estoura o tempo limite
+      # @raise [BrasilAPI::Error] em outras respostas de erro
+      # @example
+      #   BrasilAPI::TUSS.autocomplete(query: "cons", limit: 5)
+      # @see https://brasilapi.com.br/docs#tag/TUSS
+      def autocomplete(**filters)
+        get("/tuss/v1/autocomplete", translate(filters, PARAMS))
+      end
+    end
+  end
+end

data/lib/brasil_api/version.rb

@@ -1,5 +1,11 @@
 # frozen_string_literal: true
 
+# Cliente Ruby da {https://brasilapi.com.br BrasilAPI}.
+#
+# @example Bancos participantes do STR
+#   BrasilAPI::Bank.all
+# @see https://brasilapi.com.br/docs
 module BrasilAPI
-  VERSION = "0.7.0"
+  # Versão publicada da gem, no formato +MAJOR.MINOR.PATCH+.
+  VERSION = "0.9.0"
 end

data/lib/brasil_api.rb

@@ -1,6 +1,18 @@
 # frozen_string_literal: true
 
+# Cliente Ruby da {https://brasilapi.com.br BrasilAPI}.
+#
+# Cada família de endpoint é uma classe com métodos de classe.
+#
+# @example Bancos participantes do STR
+#   BrasilAPI::Bank.all
+# @see https://brasilapi.com.br/docs
+module BrasilAPI
+end
+
 require_relative "brasil_api/version"
+require_relative "brasil_api/configuration"
+require_relative "brasil_api/error"
 require_relative "brasil_api/base"
 require_relative "brasil_api/address"
 require_relative "brasil_api/bank"
@@ -15,8 +27,16 @@ require_relative "brasil_api/ncm"
 require_relative "brasil_api/pix"
 require_relative "brasil_api/registrobr"
 require_relative "brasil_api/taxas"
-
-module BrasilAPI
-  class Error < StandardError; end
-  class NotFound < StandardError; end
-end
+require_relative "brasil_api/b3"
+require_relative "brasil_api/business_days"
+require_relative "brasil_api/cambio"
+require_relative "brasil_api/cid10"
+require_relative "brasil_api/cpf"
+require_relative "brasil_api/ddd"
+require_relative "brasil_api/geolocation"
+require_relative "brasil_api/hospital"
+require_relative "brasil_api/ibpt"
+require_relative "brasil_api/igpm"
+require_relative "brasil_api/solar"
+require_relative "brasil_api/status"
+require_relative "brasil_api/tuss"

metadata

@@ -1,19 +1,19 @@
 --- !ruby/object:Gem::Specification
 name: brasilapi
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Dayvid Emerson
 bindir: exe
 cert_chain: []
-date: 2025-04-21 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 description: Acesso programático de informações é algo fundamental na comunicação
   entre sistemas, mas, para nossa surpresa, uma informação tão útil e pública quanto
   um CEP não consegue ser acessada diretamente por um navegador por conta da API dos
-  Correios não possuir CORS habilitado. Dado aisso, este projeto experimental tem
-  como objetivo centralizar e disponibilizar endpoints modernos com baixíssima latência
+  Correios não possuir CORS habilitado. Dado isso, este projeto experimental tem como
+  objetivo centralizar e disponibilizar endpoints modernos com baixíssima latência
   utilizando tecnologias como Vercel Smart CDN responsável por fazer o cache das informações
   em atualmente 23 regiões distribuídas ao longo do mundo (incluindo Brasil). Então
   não importa o quão devagar for a fonte dos dados, nós queremos disponibilizá-la
@@ -26,6 +26,7 @@ extra_rdoc_files: []
 files:
 - ".rspec"
 - ".rubocop.yml"
+- ".yardopts"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - Gemfile
@@ -33,22 +34,36 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
-- brasilapi.gemspec
 - lib/brasil_api.rb
 - lib/brasil_api/address.rb
+- lib/brasil_api/b3.rb
 - lib/brasil_api/bank.rb
 - lib/brasil_api/base.rb
+- lib/brasil_api/business_days.rb
+- lib/brasil_api/cambio.rb
+- lib/brasil_api/cid10.rb
 - lib/brasil_api/company.rb
+- lib/brasil_api/configuration.rb
+- lib/brasil_api/cpf.rb
 - lib/brasil_api/cptec.rb
 - lib/brasil_api/cvm.rb
+- lib/brasil_api/ddd.rb
+- lib/brasil_api/error.rb
 - lib/brasil_api/fipe.rb
+- lib/brasil_api/geolocation.rb
 - lib/brasil_api/holiday.rb
+- lib/brasil_api/hospital.rb
 - lib/brasil_api/ibge.rb
+- lib/brasil_api/ibpt.rb
+- lib/brasil_api/igpm.rb
 - lib/brasil_api/isbn.rb
 - lib/brasil_api/ncm.rb
 - lib/brasil_api/pix.rb
 - lib/brasil_api/registrobr.rb
+- lib/brasil_api/solar.rb
+- lib/brasil_api/status.rb
 - lib/brasil_api/taxas.rb
+- lib/brasil_api/tuss.rb
 - lib/brasil_api/version.rb
 - lib/brasilapi.rb
 homepage: https://brasilapi.com.br
@@ -58,7 +73,9 @@ metadata:
   homepage_uri: https://brasilapi.com.br
   source_code_uri: https://github.com/dayvidemerson/brasilapi-rb
   changelog_uri: https://github.com/dayvidemerson/brasilapi-rb/blob/main/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/brasilapi
   rubygems_mfa_required: 'true'
+  github_repo: ssh://github.com/dayvidemerson/brasilapi-rb
 rdoc_options: []
 require_paths:
 - lib
@@ -66,14 +83,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.6.0
+      version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Cliente desenvolvido em Ruby para o consumo da Brasil API que permite buscar
   informações públicas referentes ao Brasil de modo eficiente e simplificado.

data/brasilapi.gemspec

@@ -1,42 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "lib/brasil_api/version"
-
-Gem::Specification.new do |spec|
-  spec.name = "brasilapi"
-  spec.version = BrasilAPI::VERSION
-  spec.authors = ["Dayvid Emerson"]
-  spec.email = ["dayvidemerson96@gmail.com"]
-
-  spec.summary = "Cliente desenvolvido em Ruby para o consumo da Brasil API que permite buscar informações públicas " \
-                 "referentes ao Brasil de modo eficiente e simplificado."
-
-  spec.description = "Acesso programático de informações é algo fundamental na comunicação entre sistemas, mas, para " \
-                     "nossa surpresa, uma informação tão útil e pública quanto um CEP não consegue ser acessada " \
-                     "diretamente por um navegador por conta da API dos Correios não possuir CORS habilitado. Dado a" \
-                     "isso, este projeto experimental tem como objetivo centralizar e disponibilizar endpoints " \
-                     "modernos com baixíssima latência utilizando tecnologias como Vercel Smart CDN responsável por " \
-                     "fazer o cache das informações em atualmente 23 regiões distribuídas ao longo do mundo " \
-                     "(incluindo Brasil). Então não importa o quão devagar for a fonte dos dados, nós queremos " \
-                     "disponibilizá-la da forma mais rápida e moderna possível."
-
-  spec.homepage = "https://brasilapi.com.br"
-  spec.license = "MIT"
-  spec.required_ruby_version = ">= 2.6.0"
-
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/dayvidemerson/brasilapi-rb"
-  spec.metadata["changelog_uri"] = "https://github.com/dayvidemerson/brasilapi-rb/blob/main/CHANGELOG.md"
-  spec.metadata["rubygems_mfa_required"] = "true"
-
-  # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files = Dir.chdir(__dir__) do
-    `git ls-files -z`.split("\x0").reject do |f|
-      (File.expand_path(f) == __FILE__) || f.start_with?(*%w[bin/ test/ spec/ features/ .git .circleci appveyor])
-    end
-  end
-  spec.bindir = "exe"
-  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-end