proc 0.9.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 46f47f39b1b2b4f495b59575a14f1d8df1d837eada9048562ed5455a3d0fbc06
-  data.tar.gz: e93f11f26736d3504fc4e025be2fece6e9dafad9e66d6fac4c2d362470d3b207
+  metadata.gz: b102aa8b4a6c4f99758cab2f6aefff1800948b60197d920f6279cb76f26decbb
+  data.tar.gz: 37b8a0aa99c4089a584b2b7197ab7e9e9ec7bc555a59bdaf1bbce76f4ab466ac
 SHA512:
-  metadata.gz: c82d1cb2697caf43077d2e1a909602401cb7bf8a8518be6f21d5160a38889d49aceb93d1d578c124ca8077dec21aa7e6b5fdec31ebb5e4137e64ab278e58e124
-  data.tar.gz: ca6f582486efebd0817b30228e997da049c482e7c5b42f08b52128e76534d3da19080aa995e0124d15e011677f5af066c0310a7a67671788cf44cffc040e62d5
+  metadata.gz: 33e2381e9f9d5ff7a6ff10c7ad4a75cc2d0687a4e6890916d4443563ddcaf883d7205b971e7dee63637f81731cea2c5caf80df1a980718db65c78b94db19c0ca
+  data.tar.gz: fc7497fce516a9b003ed4dbf617d26c9c7ca5e6b2696f324cba275f765f85f6f878baaea2e7006d3e2e023a61de73b506aff743d1d3ae1451fa9226c2c9040d4

data/LICENSE

@@ -1,22 +1,353 @@
-This software is licensed under the MIT License.
-
-Copyright 2020 Metabahn.
-
-Permission is hereby granted, free of charge, to any person obtaining a
-copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to permit
-persons to whom the Software is furnished to do so, subject to the
-following conditions:
-
-The above copyright notice and this permission notice shall be included
-in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
-OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
-NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
-DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
-OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
-USE OR OTHER DEALINGS IN THE SOFTWARE.
+Mozilla Public License, version 2.0
+
+1. Definitions
+
+1.1. “Contributor”
+
+     means each individual or legal entity that creates, contributes to the
+     creation of, or owns Covered Software.
+
+1.2. “Contributor Version”
+
+     means the combination of the Contributions of others (if any) used by a
+     Contributor and that particular Contributor’s Contribution.
+
+1.3. “Contribution”
+
+     means Covered Software of a particular Contributor.
+
+1.4. “Covered Software”
+
+     means Source Code Form to which the initial Contributor has attached the
+     notice in Exhibit A, the Executable Form of such Source Code Form, and
+     Modifications of such Source Code Form, in each case including portions
+     thereof.
+
+1.5. “Incompatible With Secondary Licenses”
+     means
+
+     a. that the initial Contributor has attached the notice described in
+        Exhibit B to the Covered Software; or
+
+     b. that the Covered Software was made available under the terms of version
+        1.1 or earlier of the License, but not also under the terms of a
+        Secondary License.
+
+1.6. “Executable Form”
+
+     means any form of the work other than Source Code Form.
+
+1.7. “Larger Work”
+
+     means a work that combines Covered Software with other material, in a separate
+     file or files, that is not Covered Software.
+
+1.8. “License”
+
+     means this document.
+
+1.9. “Licensable”
+
+     means having the right to grant, to the maximum extent possible, whether at the
+     time of the initial grant or subsequently, any and all of the rights conveyed by
+     this License.
+
+1.10. “Modifications”
+
+     means any of the following:
+
+     a. any file in Source Code Form that results from an addition to, deletion
+        from, or modification of the contents of Covered Software; or
+
+     b. any new file in Source Code Form that contains any Covered Software.
+
+1.11. “Patent Claims” of a Contributor
+
+      means any patent claim(s), including without limitation, method, process,
+      and apparatus claims, in any patent Licensable by such Contributor that
+      would be infringed, but for the grant of the License, by the making,
+      using, selling, offering for sale, having made, import, or transfer of
+      either its Contributions or its Contributor Version.
+
+1.12. “Secondary License”
+
+      means either the GNU General Public License, Version 2.0, the GNU Lesser
+      General Public License, Version 2.1, the GNU Affero General Public
+      License, Version 3.0, or any later versions of those licenses.
+
+1.13. “Source Code Form”
+
+      means the form of the work preferred for making modifications.
+
+1.14. “You” (or “Your”)
+
+      means an individual or a legal entity exercising rights under this
+      License. For legal entities, “You” includes any entity that controls, is
+      controlled by, or is under common control with You. For purposes of this
+      definition, “control” means (a) the power, direct or indirect, to cause
+      the direction or management of such entity, whether by contract or
+      otherwise, or (b) ownership of more than fifty percent (50%) of the
+      outstanding shares or beneficial ownership of such entity.
+
+
+2. License Grants and Conditions
+
+2.1. Grants
+
+     Each Contributor hereby grants You a world-wide, royalty-free,
+     non-exclusive license:
+
+     a. under intellectual property rights (other than patent or trademark)
+        Licensable by such Contributor to use, reproduce, make available,
+        modify, display, perform, distribute, and otherwise exploit its
+        Contributions, either on an unmodified basis, with Modifications, or as
+        part of a Larger Work; and
+
+     b. under Patent Claims of such Contributor to make, use, sell, offer for
+        sale, have made, import, and otherwise transfer either its Contributions
+        or its Contributor Version.
+
+2.2. Effective Date
+
+     The licenses granted in Section 2.1 with respect to any Contribution become
+     effective for each Contribution on the date the Contributor first distributes
+     such Contribution.
+
+2.3. Limitations on Grant Scope
+
+     The licenses granted in this Section 2 are the only rights granted under this
+     License. No additional rights or licenses will be implied from the distribution
+     or licensing of Covered Software under this License. Notwithstanding Section
+     2.1(b) above, no patent license is granted by a Contributor:
+
+     a. for any code that a Contributor has removed from Covered Software; or
+
+     b. for infringements caused by: (i) Your and any other third party’s
+        modifications of Covered Software, or (ii) the combination of its
+        Contributions with other software (except as part of its Contributor
+        Version); or
+
+     c. under Patent Claims infringed by Covered Software in the absence of its
+        Contributions.
+
+     This License does not grant any rights in the trademarks, service marks, or
+     logos of any Contributor (except as may be necessary to comply with the
+     notice requirements in Section 3.4).
+
+2.4. Subsequent Licenses
+
+     No Contributor makes additional grants as a result of Your choice to
+     distribute the Covered Software under a subsequent version of this License
+     (see Section 10.2) or under the terms of a Secondary License (if permitted
+     under the terms of Section 3.3).
+
+2.5. Representation
+
+     Each Contributor represents that the Contributor believes its Contributions
+     are its original creation(s) or it has sufficient rights to grant the
+     rights to its Contributions conveyed by this License.
+
+2.6. Fair Use
+
+     This License is not intended to limit any rights You have under applicable
+     copyright doctrines of fair use, fair dealing, or other equivalents.
+
+2.7. Conditions
+
+     Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted in
+     Section 2.1.
+
+
+3. Responsibilities
+
+3.1. Distribution of Source Form
+
+     All distribution of Covered Software in Source Code Form, including any
+     Modifications that You create or to which You contribute, must be under the
+     terms of this License. You must inform recipients that the Source Code Form
+     of the Covered Software is governed by the terms of this License, and how
+     they can obtain a copy of this License. You may not attempt to alter or
+     restrict the recipients’ rights in the Source Code Form.
+
+3.2. Distribution of Executable Form
+
+     If You distribute Covered Software in Executable Form then:
+
+     a. such Covered Software must also be made available in Source Code Form,
+        as described in Section 3.1, and You must inform recipients of the
+        Executable Form how they can obtain a copy of such Source Code Form by
+        reasonable means in a timely manner, at a charge no more than the cost
+        of distribution to the recipient; and
+
+     b. You may distribute such Executable Form under the terms of this License,
+        or sublicense it under different terms, provided that the license for
+        the Executable Form does not attempt to limit or alter the recipients’
+        rights in the Source Code Form under this License.
+
+3.3. Distribution of a Larger Work
+
+     You may create and distribute a Larger Work under terms of Your choice,
+     provided that You also comply with the requirements of this License for the
+     Covered Software. If the Larger Work is a combination of Covered Software
+     with a work governed by one or more Secondary Licenses, and the Covered
+     Software is not Incompatible With Secondary Licenses, this License permits
+     You to additionally distribute such Covered Software under the terms of
+     such Secondary License(s), so that the recipient of the Larger Work may, at
+     their option, further distribute the Covered Software under the terms of
+     either this License or such Secondary License(s).
+
+3.4. Notices
+
+     You may not remove or alter the substance of any license notices (including
+     copyright notices, patent notices, disclaimers of warranty, or limitations
+     of liability) contained within the Source Code Form of the Covered
+     Software, except that You may alter any license notices to the extent
+     required to remedy known factual inaccuracies.
+
+3.5. Application of Additional Terms
+
+     You may choose to offer, and to charge a fee for, warranty, support,
+     indemnity or liability obligations to one or more recipients of Covered
+     Software. However, You may do so only on Your own behalf, and not on behalf
+     of any Contributor. You must make it absolutely clear that any such
+     warranty, support, indemnity, or liability obligation is offered by You
+     alone, and You hereby agree to indemnify every Contributor for any
+     liability incurred by such Contributor as a result of warranty, support,
+     indemnity or liability terms You offer. You may include additional
+     disclaimers of warranty and limitations of liability specific to any
+     jurisdiction.
+
+4. Inability to Comply Due to Statute or Regulation
+
+   If it is impossible for You to comply with any of the terms of this License
+   with respect to some or all of the Covered Software due to statute, judicial
+   order, or regulation then You must: (a) comply with the terms of this License
+   to the maximum extent possible; and (b) describe the limitations and the code
+   they affect. Such description must be placed in a text file included with all
+   distributions of the Covered Software under this License. Except to the
+   extent prohibited by statute or regulation, such description must be
+   sufficiently detailed for a recipient of ordinary skill to be able to
+   understand it.
+
+5. Termination
+
+5.1. The rights granted under this License will terminate automatically if You
+     fail to comply with any of its terms. However, if You become compliant,
+     then the rights granted under this License from a particular Contributor
+     are reinstated (a) provisionally, unless and until such Contributor
+     explicitly and finally terminates Your grants, and (b) on an ongoing basis,
+     if such Contributor fails to notify You of the non-compliance by some
+     reasonable means prior to 60 days after You have come back into compliance.
+     Moreover, Your grants from a particular Contributor are reinstated on an
+     ongoing basis if such Contributor notifies You of the non-compliance by
+     some reasonable means, this is the first time You have received notice of
+     non-compliance with this License from such Contributor, and You become
+     compliant prior to 30 days after Your receipt of the notice.
+
+5.2. If You initiate litigation against any entity by asserting a patent
+     infringement claim (excluding declaratory judgment actions, counter-claims,
+     and cross-claims) alleging that a Contributor Version directly or
+     indirectly infringes any patent, then the rights granted to You by any and
+     all Contributors for the Covered Software under Section 2.1 of this License
+     shall terminate.
+
+5.3. In the event of termination under Sections 5.1 or 5.2 above, all end user
+     license agreements (excluding distributors and resellers) which have been
+     validly granted by You or Your distributors under this License prior to
+     termination shall survive termination.
+
+6. Disclaimer of Warranty
+
+   Covered Software is provided under this License on an “as is” basis, without
+   warranty of any kind, either expressed, implied, or statutory, including,
+   without limitation, warranties that the Covered Software is free of defects,
+   merchantable, fit for a particular purpose or non-infringing. The entire
+   risk as to the quality and performance of the Covered Software is with You.
+   Should any Covered Software prove defective in any respect, You (not any
+   Contributor) assume the cost of any necessary servicing, repair, or
+   correction. This disclaimer of warranty constitutes an essential part of this
+   License. No use of  any Covered Software is authorized under this License
+   except under this disclaimer.
+
+7. Limitation of Liability
+
+   Under no circumstances and under no legal theory, whether tort (including
+   negligence), contract, or otherwise, shall any Contributor, or anyone who
+   distributes Covered Software as permitted above, be liable to You for any
+   direct, indirect, special, incidental, or consequential damages of any
+   character including, without limitation, damages for lost profits, loss of
+   goodwill, work stoppage, computer failure or malfunction, or any and all
+   other commercial damages or losses, even if such party shall have been
+   informed of the possibility of such damages. This limitation of liability
+   shall not apply to liability for death or personal injury resulting from such
+   party’s negligence to the extent applicable law prohibits such limitation.
+   Some jurisdictions do not allow the exclusion or limitation of incidental or
+   consequential damages, so this exclusion and limitation may not apply to You.
+
+8. Litigation
+
+   Any litigation relating to this License may be brought only in the courts of
+   a jurisdiction where the defendant maintains its principal place of business
+   and such litigation shall be governed by laws of that jurisdiction, without
+   reference to its conflict-of-law provisions. Nothing in this Section shall
+   prevent a party’s ability to bring cross-claims or counter-claims.
+
+9. Miscellaneous
+
+   This License represents the complete agreement concerning the subject matter
+   hereof. If any provision of this License is held to be unenforceable, such
+   provision shall be reformed only to the extent necessary to make it
+   enforceable. Any law or regulation which provides that the language of a
+   contract shall be construed against the drafter shall not be used to construe
+   this License against a Contributor.
+
+
+10. Versions of the License
+
+10.1. New Versions
+
+      Mozilla Foundation is the license steward. Except as provided in Section
+      10.3, no one other than the license steward has the right to modify or
+      publish new versions of this License. Each version will be given a
+      distinguishing version number.
+
+10.2. Effect of New Versions
+
+      You may distribute the Covered Software under the terms of the version of
+      the License under which You originally received the Covered Software, or
+      under the terms of any subsequent version published by the license
+      steward.
+
+10.3. Modified Versions
+
+      If you create software not governed by this License, and you want to
+      create a new license for such software, you may create and use a modified
+      version of this License if you rename the license and remove any
+      references to the name of the license steward (except to note that such
+      modified license differs from this License).
+
+10.4. Distributing Source Code Form that is Incompatible With Secondary Licenses
+      If You choose to distribute Source Code Form that is Incompatible With
+      Secondary Licenses under the terms of this version of the License, the
+      notice described in Exhibit B of this License must be attached.
+
+Exhibit A - Source Code Form License Notice
+
+      This Source Code Form is subject to the
+      terms of the Mozilla Public License, v.
+      2.0. If a copy of the MPL was not
+      distributed with this file, You can
+      obtain one at
+      http://mozilla.org/MPL/2.0/.
+
+If it is not possible or desirable to put the notice in a particular file, then
+You may include the notice in a location (such as a LICENSE file in a relevant
+directory) where a recipient would be likely to look for such a notice.
+
+You may add additional accurate notices of copyright ownership.
+
+Exhibit B - “Incompatible With Secondary Licenses” Notice
+
+      This Source Code Form is “Incompatible
+      With Secondary Licenses”, as defined by
+      the Mozilla Public License, v. 2.0.

data/README.md

@@ -1,80 +1,58 @@
-The `proc` gem lets you call codeless web functions through the proc.dev service.
+**Superpowers to help you ship web endpoints faster.**
 
-## Getting Started
+Proc is an all-in-one toolchain for building, deploying, and calling custom behavior from any website or app.
 
-Install `proc` using the `gem` command from the command line:
+* [Learn more about Proc](https://proc.dev)
+* [Browse packages](https://proc.dev/packages)
+* [Read the docs](https://proc.dev/docs)
+* [Chat with us](https://discord.gg/aRu8qvkCmy)
 
-```
-gem install proc
-```
-
-You will also need a proc.dev account. Create a free account in seconds at [proc.dev](https://proc.dev/).
-
-## Connecting
+## Install
 
-Sign in to your proc.dev account and locate your secret key. Use the secret to create a client connection:
+Install with `gem install proc`:
 
-```ruby
-client = Proc.connect("secret-key")
 ```
-
-## Calling Procs
-
-You can call available procs through a connected client:
-
-```ruby
-client.core.string.reverse.call("hello")
-=> "olleh"
+gem install proc
 ```
 
-Requests are sent to proc.dev anytime the `call` method is invoked.
+## Usage
 
-## Callable Contexts
-
-Proc lookups create contexts that can be called later:
+Connect to proc using an account secret or limited api key:
 
 ```ruby
-string = client.core.string
-
-string.reverse.call("hello")
-=> "olleh"
+require "proc"
 
-string.truncate.call("hello", length: 3)
-=> "hel"
+client = Proc.connect("{your-proc-authorization}")
 ```
 
-Contexts can be configured with default input and arguments using the `with` method:
+Now you can call procs just like local code:
 
 ```ruby
-truncate = client.core.string.truncate.with("default", length: 1)
+client.type.number.add.call(1, {value: 1});
 
-truncate.call
-=> "d"
+=> 2
 ```
 
-Default input and/or arguments can be overidden for a specific call:
+Build more complex behavior by composing procs together:
 
 ```ruby
-truncate.call(length: 3)
-=> "def"
-```
+time = client.time
 
-Procs can also be looked up using the hash key syntax:
+composition = time.now >> time.format(string: "%A")
 
-```ruby
-client["core.string.truncate"].call("hello", length: 3)
-=> "hel"
-```
+composition.call
 
-## Compositions
+=> "Tuesday"
+````
 
-Procs can be composed together to build more complex behavior:
+Instantly deploy your behavior to a private endpoint and call it from anywhere:
 
 ```ruby
-composition = client.core.string.reverse >> client.core.string.truncate(length: 3) >> client.core.string.capitalize
+client.proc.create.call(name: "day_of_week", proc: composition)
+
+client.self.day_of_week.call
 
-composition.call("hello")
-=> "Oll"
+=> "Tuesday"
 ```
 
-Compositions are sent to proc.dev in a single request.
+Learn more at [proc.dev](https://proc.dev). See you around!

data/lib/proc.rb

@@ -4,15 +4,19 @@ require_relative "proc/client"
 require_relative "proc/version"
 
 class Proc
-  def self.connect(authorization, **options)
-    Client.new(authorization, **options)
-  end
+  class << self
+    # [public] Connect a client with an authorization.
+    #
+    def connect(authorization, **options)
+      Client.new(authorization, **options)
+    end
 
-  def self.undefined
-    @_undefined ||= ::Object.new
-  end
+    def undefined
+      @_undefined ||= ::Object.new
+    end
 
-  def self.undefined?(value)
-    value == undefined
+    def undefined?(value)
+      value == undefined
+    end
   end
 end

data/lib/proc/callable.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 class Proc
-  class Callable
+  class Callable < BasicObject
     attr_reader :proc, :input, :arguments
 
-    def initialize(proc, client:, input: Proc.undefined, arguments: {})
+    def initialize(proc, client:, input: ::Proc.undefined, arguments: {})
       @proc = proc.to_s
       @client = client
       @input = input
@@ -16,8 +16,29 @@ class Proc
       @arguments = arguments.dup
     end
 
-    def call(input = input_omitted = true, **arguments, &block)
-      callable = self.class.new(
+    # [public] Dispatches this callable context to proc using the client.
+    #
+    # If a block is passed, it will be called to prior to dispatch and its result passed as a nested context.
+    #
+    def call(input = input_omitted = true, **arguments)
+      if ::Kernel.block_given?
+        arguments[:proc] = yield
+      end
+
+      callable = ::Proc::Callable.new(
+        @proc,
+        client: @client,
+        input: input_omitted ? @input : input,
+        arguments: @arguments.merge(arguments)
+      )
+
+      @client.call(@proc, callable.input, **callable.arguments)
+    end
+
+    # [public] Dispatches this callable context to proc using the client, calling the given block once for each value.
+    #
+    def each(input = input_omitted = true, **arguments, &block)
+      callable = ::Proc::Callable.new(
         @proc,
         client: @client,
         input: input_omitted ? @input : input,
@@ -27,8 +48,14 @@ class Proc
       @client.call(@proc, callable.input, **callable.arguments, &block)
     end
 
+    # [public] Creates a new callable context based on this one, with a new input and/or arguments.
+    #
     def with(input = input_omitted = true, **arguments)
-      self.class.new(
+      if ::Kernel.block_given?
+        arguments[:proc] = yield
+      end
+
+      ::Proc::Callable.new(
         @proc,
         client: @client,
         input: input_omitted ? @input : input,
@@ -36,8 +63,19 @@ class Proc
       )
     end
 
+    # [public] Returns a composition built from this callable context and one or more other callables.
+    #
+    def compose(*others)
+      composed = ::Proc::Composition.new(client: @client, input: @input)
+      composed << self
+      others.each { |other| composed << other }
+      composed
+    end
+
+    # [public] Returns a composition built from this callable context and another callable.
+    #
     def >>(other)
-      composed = Composition.new(client: @client, input: @input)
+      composed = ::Proc::Composition.new(client: @client, input: @input)
       composed << self
       composed << other
       composed
@@ -46,7 +84,7 @@ class Proc
     def serialize(unwrapped: false)
       serialized = ["()", @proc]
 
-      unless Proc.undefined?(@input)
+      unless ::Proc.undefined?(@input)
         serialized << [">>", serialized_input]
       end
 
@@ -69,22 +107,38 @@ class Proc
       }
     end
 
+    # [public] Returns a callable context for `proc`, nested within this callable context.
+    #
     def [](proc)
-      Callable.new(
+      arguments = if ::Kernel.block_given?
+        duped = @arguments.dup
+        duped[:proc] = yield
+        duped
+      else
+        @arguments
+      end
+
+      ::Proc::Callable.new(
         [@proc, proc].join("."),
         client: @client,
         input: @input,
-        arguments: @arguments
+        arguments: arguments
       )
     end
 
     IGNORE_MISSING = %i[to_hash].freeze
 
+    # [public] Allows nested callable contexts to be built through method lookups.
+    #
     def method_missing(name, input = input_omitted = true, **arguments)
       if IGNORE_MISSING.include?(name)
         super
       else
-        Callable.new(
+        if ::Kernel.block_given?
+          arguments[:proc] = yield
+        end
+
+        ::Proc::Callable.new(
           [@proc, name].join("."),
           client: @client,
           input: input_omitted ? @input : input,
@@ -102,7 +156,10 @@ class Proc
     end
 
     private def serialize_value(value)
-      if value.respond_to?(:serialize)
+      case value
+      when ::Symbol
+        ["@@", value.to_s, {}]
+      when ::Proc::Argument, ::Proc::Callable, ::Proc::Composition
         value.serialize
       else
         ["%%", value]

data/lib/proc/client.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
-require "async"
+require "core/async"
+require "http"
 require "msgpack"
 
 require_relative "msgpack/types/decimal"
@@ -12,74 +13,132 @@ require_relative "callable"
 require_relative "composition"
 require_relative "enumerator"
 
-require_relative "http/client"
-
-Console.logger.off!
-
 class Proc
+  # [public]
+  #
   class Error < StandardError
   end
 
+  # [public] Raised when input or arguments are invalid.
+  #
   class Invalid < ::ArgumentError
   end
 
+  # [public] Raised when a proc endpoint does not exist.
+  #
   class Undefined < ::NameError
   end
 
+  # [public] Raised when the client is unauthorized.
+  #
   class Unauthorized < Error
   end
 
+  # [public] Raised when a call is authorized but is blocked.
+  #
   class Forbidden < Error
   end
 
+  # [public] Raised when proc is unavailable due to an unexpected error.
+  #
   class Unavailable < Error
   end
 
+  # [public] Raised when the client is being rate limited.
+  #
   class Limited < Error
   end
 
+  # [public] Raised when a proc call surpasses the defined limit.
+  #
   class Timeout < Error
   end
 
-  class Client
-    attr_reader :authorization, :scheme, :host
+  # [public] Connection to proc, configured with an authorization.
+  #
+  class Client < BasicObject
+    include ::Is::Async
+
+    # [public] The configured authorization.
+    #
+    attr_reader :authorization
+
+    # [public] The configured scheme.
+    #
+    attr_reader :scheme
+
+    # [public] The configured host.
+    #
+    attr_reader :host
+
+    # [public] The number of requests this client has performed.
+    #
+    attr_reader :request_count
+
+    attr_reader :response
+
+    DEFAULT_HEADERS = {
+      "accept" => "application/vnd.proc+msgpack",
+      "content-type" => "application/vnd.proc+msgpack"
+    }.freeze
 
     def initialize(authorization, scheme: "https", host: "proc.dev")
       @authorization = authorization
       @scheme = scheme
       @host = host
-      @internal = Http::Client.new
-    end
+      @request_count = 0
 
-    def [](proc)
-      Callable.new(proc, client: self)
+      @__base_url = "#{@scheme}://#{host}"
+      @__headers = {
+        "authorization" => "bearer #{@authorization}"
+      }.merge(DEFAULT_HEADERS)
     end
 
-    def remaining
-      unless defined?(@remaining)
-        self["ping"].call
+    # [public] Returns a callable context for `proc`.
+    #
+    def [](proc)
+      if ::Kernel.block_given?
+        ::Proc::Callable.new(proc, client: self, arguments: {proc: yield})
+      else
+        ::Proc::Callable.new(proc, client: self)
       end
+    end
 
-      @remaining
+    # [public] Returns the current rate limit.
+    #
+    def rate_limit
+      refresh_rate_limit
+      @rate_limit
     end
 
-    def resets_at
-      unless defined?(@resets_at)
-        self["ping"].call
-      end
+    # [public] Returns the current rate limit window.
+    #
+    def rate_limit_window
+      refresh_rate_limit
+      @rate_limit_window
+    end
 
-      @resets_at
+    # [public] Returns the time at which the current rate limit will reset.
+    #
+    def rate_limit_reset
+      refresh_rate_limit
+      @rate_limit_reset
     end
 
-    DEFAULT_HEADERS = {
-      "accept" => "application/vnd.proc+msgpack",
-      "content-type" => "application/vnd.proc+msgpack"
-    }.freeze
+    private def refresh_rate_limit
+      unless defined?(@rate_limit)
+        self["core.ping"].call
+      end
+    end
 
-    def call(proc = nil, input = Proc.undefined, **arguments, &block)
+    # [public] Calls a proc with the given input and arguments.
+    #
+    # If a block is passed and the proc returns an enumerable, the block will be called with each value.
+    #
+    def call(proc = nil, input = ::Proc.undefined, **arguments, &block)
       body = []
 
-      unless Proc.undefined?(input)
+      unless ::Proc.undefined?(input)
         body << [">>", serialize_value(input)]
       end
 
@@ -87,11 +146,7 @@ class Proc
         body << ["$$", key.to_s, serialize_value(value)]
       end
 
-      headers = {
-        "authorization" => "bearer #{@authorization}"
-      }.merge(DEFAULT_HEADERS)
-
-      status, headers, payload = get_payload(proc: proc, headers: headers, body: body)
+      status, headers, payload = get_payload(proc: proc, body: body)
 
       case status
       when 200
@@ -99,9 +154,9 @@ class Proc
 
         if (cursor = headers["x-cursor"])
           enumerator = if cursor.empty?
-            Enumerator.new(result)
+            ::Proc::Enumerator.new(result)
           else
-            Enumerator.new(result) {
+            ::Proc::Enumerator.new(result) {
               arguments[:cursor] = cursor.to_s
               call(proc, input, **arguments)
             }
@@ -116,33 +171,35 @@ class Proc
           result
         end
       when 400
-        raise Proc::Invalid, extract_error_message(payload)
+        ::Kernel.raise ::Proc::Invalid, extract_error_message(payload)
       when 401
-        raise Proc::Unauthorized, extract_error_message(payload)
+        ::Kernel.raise ::Proc::Unauthorized, extract_error_message(payload)
       when 403
-        raise Proc::Forbidden, extract_error_message(payload)
+        ::Kernel.raise ::Proc::Forbidden, extract_error_message(payload)
       when 404
-        raise Proc::Undefined, extract_error_message(payload)
+        ::Kernel.raise ::Proc::Undefined, extract_error_message(payload)
       when 408
-        raise Proc::Timeout, extract_error_message(payload)
+        ::Kernel.raise ::Proc::Timeout, extract_error_message(payload)
       when 413
-        raise Proc::Invalid, extract_error_message(payload)
+        ::Kernel.raise ::Proc::Invalid, extract_error_message(payload)
       when 429
-        raise Proc::Limited, extract_error_message(payload)
+        ::Kernel.raise ::Proc::Limited, extract_error_message(payload)
       when 500
-        raise Proc::Error, extract_error_message(payload)
+        ::Kernel.raise ::Proc::Error, extract_error_message(payload)
       when 508
-        raise Proc::Error, extract_error_message(payload)
+        ::Kernel.raise ::Proc::Error, extract_error_message(payload)
       else
-        raise Proc::Error, "unhandled"
+        ::Kernel.raise ::Proc::Error, "unhandled"
       end
     end
 
+    # [public] Allows callable contexts to be built through method lookups.
+    #
     def method_missing(name, input = input_omitted = true, *, **arguments)
       if input_omitted
-        Callable.new(name, client: self, arguments: arguments)
+        ::Proc::Callable.new(name, client: self, arguments: arguments)
       else
-        Callable.new(name, client: self, input: input, arguments: arguments)
+        ::Proc::Callable.new(name, client: self, input: input, arguments: arguments)
       end
     end
 
@@ -150,37 +207,58 @@ class Proc
       true
     end
 
+    # [public] Builds a named argument with options.
+    #
     def argument(name, **options)
-      Argument.new(name, **options)
+      ::Proc::Argument.new(name, **options)
     end
     alias_method :arg, :argument
 
-    def close
-      @internal.close
-    end
-
     private def build_uri(proc)
-      host_and_path = File.join(@host, proc.to_s.split(".").join("/"))
-
-      "#{@scheme}://#{host_and_path}"
+      ::File.join(@__base_url, proc.to_s.split(".").join("/"))
     end
 
     private def serialize_value(value)
-      if value.respond_to?(:serialize)
+      case value
+      when ::Symbol
+        ["@@", value.to_s, {}]
+      when ::Proc::Argument, ::Proc::Callable, ::Proc::Composition
         value.serialize
       else
         ["%%", value]
       end
     end
 
-    private def get_payload(proc:, headers:, body:)
-      @internal.call(:post, build_uri(proc), headers: headers, body: MessagePack.pack(body)) do |response|
-        @remaining = response.headers["x-rate-limit-remaining"].to_s.to_i
-        @resets_at = Time.at(response.headers["x-rate-limit-reset"].to_s.to_i)
-        [response.status, response.headers, MessagePack.unpack(response.read)]
-      end
+    private def get_payload(proc:, body:)
+      await {
+        @request_count += 1
+
+        response = ::HTTP.headers(@__headers).post(build_uri(proc), body: ::MessagePack.pack(body))
+
+        update_rate_limit(response)
+        @response = response
+
+        [response.status, response.headers, ::MessagePack.unpack(response.to_s)]
+      }
     rescue
-      raise Proc::Unavailable
+      ::Kernel.raise ::Proc::Unavailable
+    end
+
+    private def update_rate_limit(response)
+      split_limit = response.headers["x-rate-limit"].to_s.split(";window=")
+
+      @rate_limit = split_limit[0].to_i
+
+      @rate_limit_window = case split_limit[1]
+      when "60"
+        :minute
+      when "1"
+        :second
+      end
+
+      @rate_limit_reset = if (reset = response.headers["x-rate-limit-reset"])
+        ::Time.at(reset.to_s.to_i)
+      end
     end
 
     private def extract_output(payload)

data/lib/proc/composition.rb

@@ -15,7 +15,13 @@ class Proc
       @callables = @callables.dup
     end
 
-    def call(input = input_omitted = true, **arguments, &block)
+    # [public] Dispatches this composition to proc using the client.
+    #
+    def call(input = input_omitted = true, **arguments)
+      if block_given?
+        arguments[:proc] = yield
+      end
+
       callable = self.class.new(
         client: @client,
         input: input_omitted ? @input : input,
@@ -23,10 +29,29 @@ class Proc
         arguments: @arguments.merge(arguments)
       )
 
-      @client.call("exec", Proc.undefined, proc: callable, &block)
+      @client.call("core.exec", Proc.undefined, proc: callable)
     end
 
+    # [public] Dispatches this composition to proc using the client, calling the given block once for each value.
+    #
+    def each(input = input_omitted = true, **arguments, &block)
+      callable = self.class.new(
+        client: @client,
+        input: input_omitted ? @input : input,
+        callables: @callables.dup,
+        arguments: @arguments.merge(arguments)
+      )
+
+      @client.call("core.exec", Proc.undefined, proc: callable, &block)
+    end
+
+    # [public] Creates a new composition based on this one, with a new input and/or arguments.
+    #
     def with(input = input_omitted = true, **arguments)
+      if block_given?
+        arguments[:proc] = yield
+      end
+
       self.class.new(
         client: @client,
         input: input_omitted ? @input : input,
@@ -35,6 +60,16 @@ class Proc
       )
     end
 
+    # [public] Returns a composition from this composition and one or more other callables.
+    #
+    def compose(*others)
+      composed = dup
+      others.each { |other| composed << other }
+      composed
+    end
+
+    # [public] Returns a composition built from this composition and another callable.
+    #
     def >>(other)
       composed = dup
       composed << other
@@ -78,7 +113,10 @@ class Proc
     end
 
     private def serialize_value(value)
-      if value.respond_to?(:serialize)
+      case value
+      when Symbol
+        ["@@", value.to_s, {}]
+      when Argument, Callable, Composition
         value.serialize
       else
         ["%%", value]

data/lib/proc/enumerator.rb

@@ -4,18 +4,21 @@ class Proc
   class Enumerator
     include Enumerable
 
+    attr_reader :values, :next_block
+
     def initialize(values, &next_block)
       @values = values
       @next_block = next_block
     end
 
-    def each(&block)
+    # [public] Calls the given block once for each value.
+    #
+    def each(enumerable = self, &block)
       return to_enum(:each) unless block
 
-      @values.each(&block)
-
-      if @next_block
-        @next_block.call.each(&block)
+      while enumerable
+        enumerable.values.each(&block)
+        enumerable = enumerable.next_block&.call
       end
     end
   end

data/lib/proc/msgpack/types/decimal.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "bigdecimal"
+
 class BigDecimal
   def to_msgpack(packer)
     if precision > 16

data/lib/proc/version.rb

@@ -1,8 +1,10 @@
 # frozen_string_literal: true
 
 class Proc
-  VERSION = "0.9.0"
+  VERSION = "0.12.0"
 
+  # [public]
+  #
   def self.version
     VERSION
   end

metadata

@@ -1,43 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: proc
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.12.0
 platform: ruby
 authors:
 - Bryan Powell
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-03-16 00:00:00.000000000 Z
+date: 2021-05-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: async-http
+  name: core-async
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.54.1
+        version: 0.5.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.54.1
+        version: 0.5.0
 - !ruby/object:Gem::Dependency
-  name: core-async
+  name: http
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.0
+        version: '4.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.0
+        version: '4.4'
 - !ruby/object:Gem::Dependency
   name: msgpack
   requirement: !ruby/object:Gem::Requirement
@@ -66,14 +66,11 @@ files:
 - lib/proc/client.rb
 - lib/proc/composition.rb
 - lib/proc/enumerator.rb
-- lib/proc/http/client.rb
-- lib/proc/http/request.rb
-- lib/proc/http/response.rb
 - lib/proc/msgpack/types/decimal.rb
 - lib/proc/version.rb
-homepage: https://proc.dev/
+homepage: https://proc.dev
 licenses:
-- MIT
+- MPL-2.0
 metadata: {}
 post_install_message:
 rdoc_options: []
@@ -83,14 +80,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.5.0
+      version: 3.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.4
+rubygems_version: 3.2.15
 signing_key:
 specification_version: 4
 summary: Proc client library.

data/lib/proc/http/client.rb

@@ -1,42 +0,0 @@
-# frozen_string_literal: true
-
-require "async"
-require "async/http/internet"
-
-require "core/async"
-
-require_relative "request"
-require_relative "response"
-
-class Proc
-  module Http
-    class Client
-      include Is::Async
-
-      def call(method, uri, params: {}, headers: {}, body: nil)
-        internet = Async::HTTP::Internet.new
-        request = Request.new(method: method, uri: uri, params: params, headers: headers, body: body)
-
-        await {
-          begin
-            response = make_request(internet, request)
-
-            yield response
-          ensure
-            response&.close
-            internet&.close
-          end
-        }
-      end
-
-      private def make_request(internet, request)
-        async_response = internet.call(*request.callable)
-        wrap_async_response_for_request(async_response, request)
-      end
-
-      private def wrap_async_response_for_request(async_response, request)
-        Response.new(request, async_response)
-      end
-    end
-  end
-end

data/lib/proc/http/request.rb

@@ -1,37 +0,0 @@
-# frozen_string_literal: true
-
-class Proc
-  module Http
-    class Request
-      attr_reader :method, :uri, :params, :headers, :body
-
-      def initialize(method:, uri:, params:, headers:, body:)
-        @method = method
-        @uri = uri
-        @params = params
-        @headers = headers
-        @body = body
-      end
-
-      def callable
-        [@method.to_s.upcase, finalize_uri(@uri, @params), @headers, @body]
-      end
-
-      private def finalize_uri(uri, params)
-        "#{uri}#{query_string(params)}"
-      end
-
-      private def query_string(params)
-        params = params.compact
-
-        if params.any?
-          "?" + params.compact.map { |key, value|
-            "#{key}=#{value}"
-          }.join("&")
-        else
-          ""
-        end
-      end
-    end
-  end
-end

data/lib/proc/http/response.rb

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-require "forwardable"
-
-class Proc
-  module Http
-    class Response
-      extend Forwardable
-      def_delegators :@response, :status, :version, :headers, :read, :close
-
-      attr_reader :request
-
-      def initialize(request, response)
-        @request = request
-        @response = response
-      end
-    end
-  end
-end