Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://socketry.github.io/async-http/guides/getting-started/index below:

Getting Started

This guide explains how to get started with Async::HTTP.

Add the gem to your project:

$ bundle add async-http

• class Async::HTTP::Client is the main class for making HTTP requests.
• class Async::HTTP::Internet provides a simple interface for making requests to any server "on the internet".
• class Async::HTTP::Server is the main class for handling HTTP requests.
• class Async::HTTP::Endpoint can parse HTTP URLs in order to create a client or server.
• protocol-http provides the abstract HTTP protocol interfaces.

To make a request, use class Async::HTTP::Internet and call the appropriate method:

require 'async/http/internet/instance'

Sync do
	Async::HTTP::Internet.get("https://httpbin.org/get") do |response|
		puts response.read
	end
end

The following methods are supported:

Async::HTTP::Internet.methods(false)
# => [:patch, :options, :connect, :post, :get, :delete, :head, :trace, :put]

Using a block will automatically close the response when the block completes. If you want to keep the response open, you can manage it manually:

require 'async/http/internet/instance'

Sync do
	response = Async::HTTP::Internet.get("https://httpbin.org/get")
	puts response.read
ensure
	response&.close
end

As responses are streamed, you must ensure it is closed when you are finished with it.

By default, class Async::HTTP::Internet will create a class Async::HTTP::Client for each remote host you communicate with, and will keep those connections open for as long as possible. This is useful for reducing the latency of subsequent requests to the same host. When you exit the event loop, the connections will be closed automatically.

require 'async/http/internet/instance'

Sync do
	# Issue a GET request to Google:
	response = Async::HTTP::Internet.get("https://www.google.com/search?q=kittens")
	
	# Save the response body to a local file:
	response.save("/tmp/search.html")
ensure
	response&.close
end

To post data, use the post method:

require 'async/http/internet/instance'

data = {'life' => 42}

Sync do
	# Prepare the request:
	headers = [['accept', 'application/json']]
	body = JSON.dump(data)
	
	# Issues a POST request:
	response = Async::HTTP::Internet.post("https://httpbin.org/anything", headers, body)
	
	# Save the response body to a local file:
	pp JSON.parse(response.read)
ensure
	response&.close
end

For more complex scenarios, including HTTP APIs, consider using async-rest instead.

To set a timeout for a request, use the Task#with_timeout method:

require 'async/http/internet/instance'

Sync do |task|
	# Request will timeout after 2 seconds
	task.with_timeout(2) do
		response = Async::HTTP::Internet.get "https://httpbin.org/delay/10"
	ensure
		response&.close
	end
rescue Async::TimeoutError
	puts "The request timed out"
end

To create a server, use an instance of class Async::HTTP::Server:

require 'async/http'

endpoint = Async::HTTP::Endpoint.parse('http://localhost:9292')

Sync do |task|
	Async(transient: true) do
		server = Async::HTTP::Server.for(endpoint) do |request|
			::Protocol::HTTP::Response[200, {}, ["Hello World"]]
		end
		
		server.run
	end
	
	client = Async::HTTP::Client.new(endpoint)
	response = client.get("/")
	puts response.read
ensure
	response&.close
end

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4