// Copyright 2019-2020 Parity Technologies (UK) Ltd. // This file is part of Substrate. // Substrate is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // Substrate is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // You should have received a copy of the GNU General Public License // along with Substrate. If not, see . //! Contains the same API as the `http` module, except that everything returns an error. use sp_core::offchain::{HttpRequestId, Timestamp, HttpRequestStatus, HttpError}; use std::{future::Future, pin::Pin, task::Context, task::Poll}; /// Creates a pair of [`HttpApi`] and [`HttpWorker`]. pub fn http() -> (HttpApi, HttpWorker) { (HttpApi, HttpWorker) } /// Dummy implementation of HTTP capabilities. #[derive(Debug)] pub struct HttpApi; /// Dummy implementation of HTTP capabilities. #[derive(Debug)] pub struct HttpWorker; impl HttpApi { /// Mimics the corresponding method in the offchain API. pub fn request_start( &mut self, _: &str, _: &str ) -> Result { /// Because this always returns an error, none of the other methods should ever be called. Err(()) } /// Mimics the corresponding method in the offchain API. pub fn request_add_header( &mut self, _: HttpRequestId, _: &str, _: &str ) -> Result<(), ()> { unreachable!("Creating a request always fails, thus this function will \ never be called; qed") } /// Mimics the corresponding method in the offchain API. pub fn request_write_body( &mut self, _: HttpRequestId, _: &[u8], _: Option ) -> Result<(), HttpError> { unreachable!("Creating a request always fails, thus this function will \ never be called; qed") } /// Mimics the corresponding method in the offchain API. pub fn response_wait( &mut self, requests: &[HttpRequestId], _: Option ) -> Vec { if requests.is_empty() { Vec::new() } else { unreachable!("Creating a request always fails, thus the list of requests should \ always be empty; qed") } } /// Mimics the corresponding method in the offchain API. pub fn response_headers( &mut self, _: HttpRequestId ) -> Vec<(Vec, Vec)> { unreachable!("Creating a request always fails, thus this function will \ never be called; qed") } /// Mimics the corresponding method in the offchain API. pub fn response_read_body( &mut self, _: HttpRequestId, _: &mut [u8], _: Option ) -> Result { unreachable!("Creating a request always fails, thus this function will \ never be called; qed") } } impl Future for HttpWorker { type Output = (); fn poll(self: Pin<&mut Self>, _: &mut Context) -> Poll { Poll::Ready(()) } }