protocol-http-executor 0.0.1

data/readme.md

@@ -0,0 +1,74 @@
+# Protocol::HTTP::Executor
+
+Execute `Protocol::HTTP` applications in isolated threads or Ractors while preserving the request/response streaming model.
+
+[![Development Status](https://github.com/socketry/protocol-http-executor/workflows/Test/badge.svg)](https://github.com/socketry/protocol-http-executor/actions?workflow=Test)
+
+## Features
+
+  - Reconstruct requests and responses on either side of the execution boundary.
+  - Stream request and response bodies with scheduler-compatible backpressure.
+  - Preserve metadata, peer addresses, interim responses, errors, protocol upgrades, and trailers.
+  - Use the same semantic transport for thread-per-request and Ractor-per-request execution.
+
+Each request uses two Unix socket pairs: a bidirectional control channel and a full-duplex body channel. The caller writes request data while reading response data, with socket half-closure representing the final EOF in each direction.
+
+## Usage
+
+Please see the [project documentation](https://socketry.github.io/protocol-http-executor/) for more details.
+
+  - [Getting Started](https://socketry.github.io/protocol-http-executor/guides/getting-started/index) - This guide explains how to execute `Protocol::HTTP` applications in isolated threads or Ractors.
+
+  - [Design Overview](https://socketry.github.io/protocol-http-executor/guides/design-overview/index) - This guide explains how `protocol-http-executor` preserves HTTP request, response, streaming, error, and trailer semantics across an execution boundary.
+
+## Semantic Transport
+
+Request and response heads are sent separately from their bodies. Body chunks are forwarded only for non-empty bodies. Trailer fields are sent after the final body chunk and applied before EOF is exposed to the receiving application.
+
+Streamable response bodies select a direct duplex mode. Initial request-body chunks are forwarded first, followed by upgraded-stream input, while response output flows independently in the other direction.
+
+## Releases
+
+Please see the [project releases](https://socketry.github.io/protocol-http-executor/releases/index) for all releases.
+
+### v0.0.1
+
+  - Add thread-per-request and Ruby head/4.1 Ractor-per-request HTTP execution.
+  - Preserve streamed request and response bodies, interim responses, errors, protocols, peer addresses, and trailers across the execution boundary.
+  - Use a full-duplex body socket with independent half-closure for request and response EOF.
+  - Transfer socket descriptors into Ractors without copying socket objects.
+  - Route errors on the control or body channel according to whether the response head has been sent.
+
+## Contributing
+
+We welcome contributions to this project.
+
+1.  Fork the repository.
+2.  Create your feature branch (`git checkout -b my-new-feature`).
+3.  Commit your changes (`git commit -am 'Add some feature.'`).
+4.  Push to the branch (`git push origin my-new-feature`).
+5.  Create a new pull request.
+
+### Running Tests
+
+To run the test suite:
+
+``` bash
+$ bundle exec sus
+```
+
+### Making Releases
+
+To make a new release:
+
+``` bash
+$ bundle exec bake gem:release:patch # or minor or major
+```
+
+### Developer Certificate of Origin
+
+In order to protect users of this project, we require all contributors to comply with the [Developer Certificate of Origin](https://developercertificate.org/). This ensures that all contributions are properly licensed and attributed.
+
+### Community Guidelines
+
+This project is best served by a collaborative and respectful environment. Treat each other professionally, respect differing viewpoints, and engage constructively. Harassment, discrimination, or harmful behavior is not tolerated. Communicate clearly, listen actively, and support one another. If any issues arise, please inform the project maintainers.

data/releases.md

@@ -0,0 +1,9 @@
+# Releases
+
+## v0.0.1
+
+  - Add thread-per-request and Ruby head/4.1 Ractor-per-request HTTP execution.
+  - Preserve streamed request and response bodies, interim responses, errors, protocols, peer addresses, and trailers across the execution boundary.
+  - Use a full-duplex body socket with independent half-closure for request and response EOF.
+  - Transfer socket descriptors into Ractors without copying socket objects.
+  - Route errors on the control or body channel according to whether the response head has been sent.

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification
+name: protocol-http-executor
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Samuel Williams
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: async
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: protocol-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.70'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.70'
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- context/design-overview.md
+- context/getting-started.md
+- context/index.yaml
+- lib/protocol/http/executor.rb
+- lib/protocol/http/executor/body/input.rb
+- lib/protocol/http/executor/body/output.rb
+- lib/protocol/http/executor/channel.rb
+- lib/protocol/http/executor/error.rb
+- lib/protocol/http/executor/execution.rb
+- lib/protocol/http/executor/generic.rb
+- lib/protocol/http/executor/ractored.rb
+- lib/protocol/http/executor/request.rb
+- lib/protocol/http/executor/threaded.rb
+- lib/protocol/http/executor/transport.rb
+- lib/protocol/http/executor/version.rb
+- lib/protocol/http/executor/worker.rb
+- license.md
+- readme.md
+- releases.md
+homepage: https://github.com/socketry/protocol-http-executor
+licenses:
+- MIT
+metadata:
+  bug_tracker_uri: https://github.com/socketry/protocol-http-executor/issues
+  changelog_uri: https://github.com/socketry/protocol-http-executor/blob/main/releases.md
+  documentation_uri: https://socketry.github.io/protocol-http-executor/
+  source_code_uri: https://github.com/socketry/protocol-http-executor.git
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.10
+specification_version: 4
+summary: Execute Protocol::HTTP applications across isolated execution contexts.
+test_files: []