{"id":15288012,"url":"https://github.com/alex88/grpc_client_pool","last_synced_at":"2026-02-04T06:04:04.016Z","repository":{"id":57503679,"uuid":"260356937","full_name":"alex88/grpc_client_pool","owner":"alex88","description":"Elixir GRPC client pooling library","archived":false,"fork":false,"pushed_at":"2020-06-09T06:25:39.000Z","size":13,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-11-14T23:16:53.684Z","etag":null,"topics":["elixir","grpc"],"latest_commit_sha":null,"homepage":null,"language":"Elixir","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alex88.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-05-01T01:41:14.000Z","updated_at":"2023-12-19T22:44:32.000Z","dependencies_parsed_at":"2022-08-30T01:30:53.697Z","dependency_job_id":null,"html_url":"https://github.com/alex88/grpc_client_pool","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/alex88/grpc_client_pool","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alex88%2Fgrpc_client_pool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alex88%2Fgrpc_client_pool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alex88%2Fgrpc_client_pool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alex88%2Fgrpc_client_pool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alex88","download_url":"https://codeload.github.com/alex88/grpc_client_pool/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alex88%2Fgrpc_client_pool/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29072475,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-04T03:31:03.593Z","status":"ssl_error","status_checked_at":"2026-02-04T03:29:50.742Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["elixir","grpc"],"created_at":"2024-09-30T15:43:46.638Z","updated_at":"2026-02-04T06:04:03.995Z","avatar_url":"https://github.com/alex88.png","language":"Elixir","readme":"# GRPCClientPool Elixir\n\n[![Hex.pm](https://img.shields.io/hexpm/v/grpc_client_pool.svg)](https://hex.pm/packages/grpc_client_pool)\n\nA connection pooling library to be used along with [grpc](https://github.com/elixir-grpc/grpc) to create a connection pool of gRPC clients\n\n## Installation\n\nThe package can be installed with:\n\n```elixir\ndef deps do\n  [\n    {:grpc_client_pool, \"~\u003e 0.0.2-beta\"}\n  ]\nend\n```\n\n## Usage\n\n1. Follow [grpc](https://github.com/elixir-grpc/grpc) instructions on how to generate the elixir code\n2. Create a module in your app that will act as a client and make it use the connection pool:\n\n```elixir\ndefmodule MyApp.GRPCClient do\n  use GRPCClientPool,\n    otp_app: :my_app\nend\n```\n\n3. Configure the client:\n```elixir\nconfig :my_app, MyApp.GRPCClient,\n  size: 2,                                  \n  max_overflow: 10,\n  url: \"localhost:50051\",\n  connect_opts: []\n```\n\n4. Add client requests within your new module:\n\n```elixir\ndefmodule MyApp.GRPCClient do\n  use GRPCClientPool,\n    otp_app: :my_app\n\n  alias GeneratedProto.ApiInput\n  alias GeneratedProto.ApiService.Stub\n\n  def remote_function(%ApiInput{} = params) do\n    with_channel(fn channel -\u003e\n      Stub.remote_function(channel, params)\n    end)\n  end\nend\n```\n\n## Options\n\nThe available configuration parameters are:\n\n|    Name             |  Default  |  Required  |  Description                                                                                                                                                                      |\n|---------------------|-----------|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| size                |  2        |  false     |  Poolboy size parameter                                                                                                                                                           |\n| max_overflow        |  10       |  false     |  Poolboy max_overflow parameter                                                                                                                                                   |\n| url                 |  nil      |  true      |  The url to be used as first argument of `GRPC.Stub.connect/2`. Can be either a string or {:system, \"ENV\"} or {:system, \"ENV\", \"default\"} to load the value from an env variable  |\n| connect_opts        |  []       |  false     |  The second argument passed to `GRPC.Stub.connect/2`                                                                                                                              |\n| reconnect_interval  |  5000     |  false     |  If the initial connection doesn't succeed, retry after `reconnect_interval` ms                                                                                                   |\n\n## TODO\n\n- [ ] Better naming logic for poolboy's pool\n- [ ] Tests\n- [ ] Configurable checkout timeout\n- [ ] Better way of getting channel\n- [x] Handle connection errors\n- [ ] Module docs\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falex88%2Fgrpc_client_pool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falex88%2Fgrpc_client_pool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falex88%2Fgrpc_client_pool/lists"}