proc 0.9.1 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cbe8ec8f147808e160d44b09da719dafb03e329b3b1fb78f345300af4c9ab798
-  data.tar.gz: f7d81cecd2d9c6cf88e3b4f59bae7681e962bd2dd7d95fd6a1c1593f8245639c
+  metadata.gz: cc5ea46072b5407ec2b71822b8406163aeecd2aa6a57d10773e440bb08721ac5
+  data.tar.gz: 4640295398b9266d57361f62aadf461b9d23e69f9fa0d21d60c5d1cd8b00715f
 SHA512:
-  metadata.gz: e31c9f0c03adc5b2b82f0a2205cfb990f7be7bf529cf287580f2253b70425b63be00f19583838b93e15642f5ea2d3a1289d88065d6658f247f25b875d5bd8e3f
-  data.tar.gz: 9f44c4c22a636faa3f3032420a48e8aa8e7b92b18d2023115736612ef1b03736d967b770a43cf28e3ef426057b2ffa31a0398e627b51e271b6612cfadd2d0fea
+  metadata.gz: 45bb39ab2f194fe673f22a09d7d681c8514e639c71829a5673ac437991652212260fa6031c46fbdf92c48397865e1552ca7fdda72064a0ce6011c29dbee5e018
+  data.tar.gz: 8d1ae22aa4ec5f39cd4c10e2fdf1fa24ad38355e511d5d12cd8935563cb7f6a835a166683922e56bf7db9cc30a5dda7dc649c4c39f3c47b060c5f528f4077331

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/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

@@ -16,7 +16,28 @@ class Proc
       @arguments = arguments.dup
     end
 
-    def call(input = input_omitted = true, **arguments, &block)
+    # [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 block_given?
+        arguments[:proc] = yield
+      end
+
+      callable = self.class.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 = self.class.new(
         @proc,
         client: @client,
@@ -27,7 +48,13 @@ 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)
+      if block_given?
+        arguments[:proc] = yield
+      end
+
       self.class.new(
         @proc,
         client: @client,
@@ -36,6 +63,17 @@ class Proc
       )
     end
 
+    # [public] Returns a composition built from this callable context and one or more other callables.
+    #
+    def compose(*others)
+      composed = 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 << self
@@ -69,21 +107,37 @@ class Proc
       }
     end
 
+    # [public] Returns a callable context for `proc`, nested within this callable context.
+    #
     def [](proc)
+      arguments = if block_given?
+        duped = @arguments.dup
+        duped[:proc] = yield
+        duped
+      else
+        @arguments
+      end
+
       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
+        if block_given?
+          arguments[:proc] = yield
+        end
+
         Callable.new(
           [@proc, name].join("."),
           client: @client,
@@ -102,7 +156,9 @@ class Proc
     end
 
     private def serialize_value(value)
-      if value.respond_to?(:serialize)
+      if value.is_a?(Symbol)
+        ["@@", value.to_s, {}]
+      elsif value.respond_to?(:serialize)
         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,59 +13,111 @@ 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
 
+  # [public] Connection to proc, configured with an authorization.
+  #
   class Client
-    attr_reader :authorization, :scheme, :host
+    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
+
+    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
+      @request_count = 0
+
+      @__base_url = "#{@scheme}://#{host}"
+      @__headers = {
+        "authorization" => "bearer #{@authorization}"
+      }.merge(DEFAULT_HEADERS)
     end
 
+    # [public] Returns a callable context for `proc`.
+    #
     def [](proc)
-      Callable.new(proc, client: self)
+      if block_given?
+        Callable.new(proc, client: self, arguments: {proc: yield})
+      else
+        Callable.new(proc, client: self)
+      end
     end
 
+    # [public] Returns the current rate limit.
+    #
     def rate_limit
       refresh_rate_limit
       @rate_limit
     end
 
+    # [public] Returns the current rate limit window.
+    #
     def rate_limit_window
       refresh_rate_limit
       @rate_limit_window
     end
 
+    # [public] Returns the time at which the current rate limit will reset.
+    #
     def rate_limit_reset
       refresh_rate_limit
       @rate_limit_reset
@@ -76,11 +129,10 @@ class Proc
       end
     end
 
-    DEFAULT_HEADERS = {
-      "accept" => "application/vnd.proc+msgpack",
-      "content-type" => "application/vnd.proc+msgpack"
-    }.freeze
-
+    # [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 = []
 
@@ -92,11 +144,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
@@ -143,6 +191,8 @@ class Proc
       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)
@@ -155,52 +205,58 @@ class Proc
       true
     end
 
+    # [public] Builds a named argument with options.
+    #
     def argument(name, **options)
       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)
+      if value.is_a?(Symbol)
+        ["@@", value.to_s, {}]
+      elsif value.respond_to?(:serialize)
         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|
-        split_limit = response.headers["x-rate-limit"].to_s.split(";window=")
+    private def get_payload(proc:, body:)
+      await {
+        @request_count += 1
 
-        @rate_limit = split_limit[0].to_i
+        response = HTTP.headers(@__headers).post(build_uri(proc), body: MessagePack.pack(body))
 
-        @rate_limit_window = case split_limit[1]
-        when "60"
-          :minute
-        when "1"
-          :second
-        end
+        update_rate_limit(response)
 
-        @rate_limit_reset = if (reset = response.headers["x-rate-limit-reset"])
-          Time.at(reset.to_s.to_i)
-        end
-
-        [response.status, response.headers, MessagePack.unpack(response.read)]
-      end
+        [response.status, response.headers, MessagePack.unpack(response.to_s)]
+      }
     rescue
       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)
       payload.each do |tuple|
         case tuple[0]

data/lib/proc/composition.rb

@@ -15,7 +15,26 @@ 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,
+        callables: @callables.dup,
+        arguments: @arguments.merge(arguments)
+      )
+
+      @client.call("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,
@@ -26,7 +45,13 @@ class Proc
       @client.call("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,9 @@ class Proc
     end
 
     private def serialize_value(value)
-      if value.respond_to?(:serialize)
+      if value.is_a?(Symbol)
+        ["@@", value.to_s, {}]
+      elsif value.respond_to?(:serialize)
         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/version.rb

@@ -1,8 +1,10 @@
 # frozen_string_literal: true
 
 class Proc
-  VERSION = "0.9.1"
+  VERSION = "0.10.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.1
+  version: 0.10.0
 platform: ruby
 authors:
 - Bryan Powell
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-03-17 00:00:00.000000000 Z
+date: 2021-04-01 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.2.1
+        version: '4.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.1
+        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/
 licenses:
-- MIT
+- MPL-2.0
 metadata: {}
 post_install_message:
 rdoc_options: []

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