bindan 0.1.0

data/lib/bindan/providers/storage.rb

@@ -0,0 +1,96 @@
+require_relative "../error"
+require "uri"
+begin
+  require "google/cloud/storage"
+rescue LoadError => e
+  warn e
+  module Google
+    module Cloud
+      class Storage
+        def initialize(**kwargs)
+        end
+
+        def bucket(*args)
+          Class.new do
+            def file(*args)
+              Class.new do
+                def download(*args)
+                end
+              end.new
+            end
+          end.new
+        end
+      end
+    end
+  end
+end
+
+module Bindan
+  module Provider
+    class Storage
+      class FileNotExist < Error; end
+
+      #
+      # @param [String] bucket
+      # @param [String] project_id
+      # @param [String] separator
+      # @param [String] credentials
+      # @param [Google::Cloud::Storage] sdk
+      #
+      def initialize(bucket, raise_error: nil, separator: "-", sdk: ::Google::Cloud::Storage, **kwargs)
+        @_options = {}
+        @bucket = bucket
+
+        @_options[:raise_error] = raise_error
+        @separator = separator
+        @project_id = kwargs[:project_id]
+
+        options = prepare_options(kwargs)
+
+        @_storage = sdk.new(**options)
+      end
+      attr_reader :project_id, :separator
+
+      #
+      # @param [Hash] options
+      # @return [Hash]
+      #
+      def prepare_options(options)
+        if ENV["STORAGE_EMULATOR_HOST"]
+          u = URI(ENV["STORAGE_EMULATOR_HOST"].to_s)
+          u.path = "/" if u.path.to_s.size == 0
+          options[:endpoint] = u.to_s
+        end
+
+        options
+      end
+
+      #
+      # decorated bucket name
+      #
+      # @return [String]
+      #
+      def bucket
+        [@project_id, @bucket].join(@separator)
+      end
+
+      #
+      # @raise FileNotExist
+      # @param [String] file
+      # @return [String]
+      #
+      def [](file)
+        remote = @_storage.bucket(bucket).file(file)
+
+        if remote
+          Tempfile.open { |t|
+            remote.download(t.path)
+            t.read.chomp
+          }
+        elsif @_options[:raise_error]
+          raise FileNotExist.new file
+        end
+      end
+    end
+  end
+end

data/lib/bindan/providers.rb

@@ -0,0 +1 @@
+Dir.glob(File.join(__dir__.to_s, "providers/*.rb")).each { |f| require_relative f }

data/lib/bindan/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Bindan
+  VERSION = "0.1.0"
+end

data/lib/bindan.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require "ostruct"
+require_relative "bindan/version"
+require_relative "bindan/error"
+require_relative "bindan/providers"
+
+module Bindan
+  #
+  # @param [Hash[Symbol, Provider]] providers
+  # @param [Proc] block
+  # @return [OpenStruct]
+  #
+  def configure(providers: {env: Bindan::Provider::Envvar.new}, &block)
+    if block.is_a? Proc
+      container = OpenStruct.new
+      block.call(container, Struct.new(*providers.keys).new(*providers.values)) # steep:ignore
+      container
+    else
+      warn "no block given for `configure'"
+    end
+  end
+  module_function :configure
+end

data/rbs_collection.lock.yaml

@@ -0,0 +1,328 @@
+---
+path: ".gem_rbs_collection"
+gems:
+- name: activesupport
+  version: '7.0'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: addressable
+  version: '2.8'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: ast
+  version: '2.4'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: base64
+  version: 0.3.0
+  source:
+    type: rubygems
+- name: benchmark
+  version: '0'
+  source:
+    type: stdlib
+- name: bigdecimal
+  version: '3.1'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: concurrent-ruby
+  version: '1.1'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: connection_pool
+  version: '2.4'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: csv
+  version: '3.3'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: date
+  version: '0'
+  source:
+    type: stdlib
+- name: digest
+  version: '0'
+  source:
+    type: stdlib
+- name: erb
+  version: '0'
+  source:
+    type: stdlib
+- name: faraday
+  version: '2.7'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: ffi
+  version: 1.17.2
+  source:
+    type: rubygems
+- name: fileutils
+  version: '0'
+  source:
+    type: stdlib
+- name: forwardable
+  version: '0'
+  source:
+    type: stdlib
+- name: google-apis-core
+  version: '0.15'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: google-cloud-errors
+  version: '1.5'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: googleauth
+  version: '1.11'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: httpclient
+  version: '2.8'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: i18n
+  version: '1.10'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: json
+  version: '0'
+  source:
+    type: stdlib
+- name: jwt
+  version: '2.5'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: listen
+  version: '3.9'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: logger
+  version: '0'
+  source:
+    type: stdlib
+- name: mini_mime
+  version: '0.1'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: minitest
+  version: '5.25'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: monitor
+  version: '0'
+  source:
+    type: stdlib
+- name: mutex_m
+  version: 0.3.0
+  source:
+    type: rubygems
+- name: net-http
+  version: '0'
+  source:
+    type: stdlib
+- name: net-protocol
+  version: '0'
+  source:
+    type: stdlib
+- name: openssl
+  version: '0'
+  source:
+    type: stdlib
+- name: optparse
+  version: '0'
+  source:
+    type: stdlib
+- name: parallel
+  version: '1.20'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: parser
+  version: '3.2'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: pathname
+  version: '0'
+  source:
+    type: stdlib
+- name: prism
+  version: 1.4.0
+  source:
+    type: rubygems
+- name: rainbow
+  version: '3.0'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: rake
+  version: '13.0'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: rbs
+  version: 3.9.4
+  source:
+    type: rubygems
+- name: rdoc
+  version: '0'
+  source:
+    type: stdlib
+- name: regexp_parser
+  version: '2.8'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: rubocop
+  version: '1.57'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: rubocop-ast
+  version: '1.30'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: securerandom
+  version: '0'
+  source:
+    type: stdlib
+- name: signet
+  version: '0.19'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: singleton
+  version: '0'
+  source:
+    type: stdlib
+- name: socket
+  version: '0'
+  source:
+    type: stdlib
+- name: stringio
+  version: '0'
+  source:
+    type: stdlib
+- name: strscan
+  version: '0'
+  source:
+    type: stdlib
+- name: time
+  version: '0'
+  source:
+    type: stdlib
+- name: timeout
+  version: '0'
+  source:
+    type: stdlib
+- name: tsort
+  version: '0'
+  source:
+    type: stdlib
+- name: tzinfo
+  version: '2.0'
+  source:
+    type: git
+    name: ruby/gem_rbs_collection
+    revision: 4873ad046b4ea8931591626cd547becae6d1e84e
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    repo_dir: gems
+- name: uri
+  version: '0'
+  source:
+    type: stdlib
+gemfile_lock_path: Gemfile.lock

data/rbs_collection.yaml

@@ -0,0 +1,19 @@
+# Download sources
+sources:
+  - type: git
+    name: ruby/gem_rbs_collection
+    remote: https://github.com/ruby/gem_rbs_collection.git
+    revision: main
+    repo_dir: gems
+
+# You can specify local directories as sources also.
+# - type: local
+#   path: path/to/your/local/repository
+
+# A directory to install the downloaded RBSs
+path: .gem_rbs_collection
+
+gems:
+  # If you want to avoid installing rbs files for gems, you can specify them here.
+  - name: google-cloud-firestore
+    ignore: true

data/sig/bindan/emulators/firestore_controller.rbs

@@ -0,0 +1,76 @@
+module Bindan
+  module Emulator
+    #
+    # Represents and controls a single instance of the Google Cloud Firestore emulator process.
+    # This class encapsulates the logic for starting, stopping, and waiting for the emulator,
+    # separating process management from the test execution flow.
+    #
+    class FirestoreController
+      @pid: untyped
+
+      @host: untyped
+
+      @port: untyped
+
+      WAIT_TIMEOUT: 15
+
+      INITIAL_BACKOFF_KEY_SEC: ::Float
+
+      BACKOFF_MULTIPLIER: ::Float
+
+      #
+      # @return [Array<String, Integer>]
+      #
+      def self.host_and_port: (?untyped? host, ?untyped? port) -> ::Array[untyped]
+
+      #
+      # Initiates the emulator process and returns a new instance.
+      #
+      # @param [String] import
+      # @param [String] export
+      # @param [String] host
+      # @param [Integer] port
+      # @param [bool] close_io
+      # @raise [Errno]
+      # @return [FirestoreEmulatorController] An instance to manage the emulator lifecycle.
+      #
+      def self.start: (?import: untyped?, ?export: untyped?, ?host: untyped?, ?port: untyped?, ?close_io: bool) -> untyped
+
+      #
+      # kill process group
+      #
+      # @param [Integer] pid
+      # @param [bool] with_message
+      # @return [void]
+      #
+      def self.stop: (untyped pid, ?with_message: bool) -> untyped
+
+      #
+      # @param [Integer] host
+      # @param [Integer] port
+      #
+      def self.kill_process_if_already_exists: (host: untyped, port: untyped, ?with_message: bool) -> untyped
+
+      #
+      # @param [Integer] pid - process group id
+      #
+      def initialize: (untyped pid, untyped host, untyped port) -> void
+
+      #
+      # waits to accessable
+      #
+      # @raise [Timeout::Error] if the emulator does not become available within the configured timeout.
+      # @param [number] timeout
+      # @param [number] backoff
+      # @param [number] multiplier
+      # @return [void]
+      #
+      def wait_available: (?timeout: untyped, ?backoff: untyped, ?multiplier: untyped, ?with_message: bool) -> untyped
+
+      #
+      # @return [void]
+      #
+      def stop: (?with_message: bool) -> untyped
+    end
+  end
+end

data/sig/bindan/emulators/gcs_server_controller.rbs

@@ -0,0 +1,71 @@
+module Bindan
+  module Emulator
+    class GcsServerController
+      @container_name: untyped
+
+      @folder: untyped
+
+      class ContainerCannotOpenError < Error
+      end
+
+      CONTAINER_NAME: "gcs-server"
+
+      WAIT_TIMEOUT: 15
+
+      INITIAL_BACKOFF_KEY_SEC: ::Float
+
+      BACKOFF_MULTIPLIER: ::Float
+
+      #
+      # @raise [Errno]
+      # @param [String] folder
+      # @param [Integer] [port]
+      # @param [String] [name]
+      # @return [GcsServerController]
+      #
+      def self.start: (folder: untyped, ?port: ::Integer, ?name: untyped, ?close_io: bool) -> untyped
+
+      #
+      # @raise [IOError]
+      # @param [String] name
+      # @return [bool]
+      #
+      def self.running?: (name: untyped) -> untyped
+
+      #
+      # @param [String] name
+      # @raise [Errno]
+      # @return [void]
+      #
+      def self.stop: (name: untyped) -> untyped
+
+      #
+      # @param [String] name
+      # @param [String] folder
+      #
+      def initialize: (name: untyped, folder: untyped) -> void
+
+      #
+      # @return
+      #
+      def stop: () -> untyped
+
+      #
+      # @param [String] name
+      # @return [bool]
+      #
+      def running?: () -> untyped
+
+      #
+      # waits container to be running
+      #
+      # @raise [Timeout::Error] if the container does not become available within the configured timeout.
+      # @param [number] timeout
+      # @param [number] backoff
+      # @param [number] multiplier
+      # @return [void]
+      #
+      def wait_available: (?timeout: untyped, ?backoff: untyped, ?multiplier: untyped) -> untyped
+    end
+  end
+end

data/sig/bindan/error.rbs

@@ -0,0 +1,4 @@
+module Bindan
+  class Error < StandardError
+  end
+end

data/sig/bindan/providers/envvar.rbs

@@ -0,0 +1,22 @@
+module Bindan
+  module Provider
+    class Envvar
+      @_env: Hash[String, String]
+
+      @_options: Hash[untyped, untyped]
+
+      #
+      # @param [Hash] env
+      # @param [Hash] options
+      #
+      def initialize: (?::Hash[String, String] env, ?::Hash[untyped, untyped] options) -> void
+
+      #
+      # @raise KeyError
+      # @param [String] key
+      # @return [String]
+      #
+      def []: (String key) -> untyped
+    end
+  end
+end

data/sig/bindan/providers/firestore.rbs

@@ -0,0 +1,47 @@
+module Google
+  module Cloud
+    class Firestore
+      def initialize: (**untyped kwargs) -> void
+
+      def doc: (*untyped args) -> untyped
+    end
+  end
+end
+
+module Bindan
+  module Provider
+    class Firestore
+      @_options: Hash[Symbol, untyped]
+
+      @collection: String
+
+      @project_id: String
+
+      @_firestore: Google::Cloud::Firestore
+
+      class ColOrDocNotExist < Error
+      end
+
+      #
+      # @param [String] collection
+      # @param [bool] raise_error
+      # @param [Google::Cloud::Firestore] sdk
+      #
+      def initialize: (?String? collection, ?project_id: String?, ?raise_error: bool, ?sdk: untyped, **untyped kwargs) -> void
+
+      attr_reader project_id: String
+
+      #
+      # @param [Hash] pair
+      #
+      def _prepare: (Hash[String, untyped] pair) -> untyped
+
+      #
+      # @raise ColOrDocNotExist
+      # @param [String] key
+      # @return [Hash]
+      #
+      def []: (String key) -> untyped
+    end
+  end
+end