Struct Resource

pub struct Resource { /* private fields */ }

A Resource python class which implements twisted.web.resource.IResource from a Service. It doesn’t have a Python constructor, so it is expected to be either subclassed or returned from a Rust function:

use std::convert::Infallible;

use bytes::Bytes;
use http::{Request, Response};
use pyo3::prelude::*;

use pyo3_twisted_web::Resource;

#[pyclass(extends=Resource)]
struct MyResource;

#[pymethods]
impl MyResource {
    #[new]
    fn new() -> (Self, Resource) {
        let service = tower::service_fn(|_request: Request<_>| async move {
            let response = Response::new(String::from("hello"));
            Ok(response)
        });

        let super_ = Resource::from_service::<_, _, Infallible>(service);
        (Self, super_)
    }
}

#[pyfunction]
fn my_resource(py: Python) -> PyResult<Py<Resource>> {
    let service = tower::service_fn(|_request: Request<_>| async move {
        let response = Response::new(String::from("hello"));
        Ok(response)
    });

    Py::new(py, Resource::from_service::<_, _, Infallible>(service))
}

Implementations

impl Resource

pub fn from_service<S, B, E>(service: S) -> Self

where S: Service<Request<Full<Bytes>>, Response = Response<B>, Error = E> + Clone + Send + 'static, S::Future: Send, B: Body + Send + 'static, B::Data: Buf, B::Error: Into<PyErr>, E: Into<PyErr> + 'static,

Trait Implementations

impl IntoPy<Py<PyAny>> for Resource

fn into_py(self, py: Python<'_>) -> PyObject

Performs the conversion.

impl PyClass for Resource

type Frozen = False

Whether the pyclass is frozen.

impl PyClassImpl for Resource

const DOC: &'static str = "A Resource python class which implements ``twisted.web.resource.IResource`` from a [`Service`].\nIt doesn\'t have a Python constructor, so it is expected to be either subclassed or returned\nfrom a Rust function:\n\n```rust\nuse std::convert::Infallible;\n\nuse bytes::Bytes;\nuse http::{Request, Response};\nuse pyo3::prelude::*;\n\nuse pyo3_twisted_web::Resource;\n\n#[pyclass(extends=Resource)]\nstruct MyResource;\n\n#[pymethods]\nimpl MyResource {\n #[new]\n fn new() -> (Self, Resource) {\n let service = tower::service_fn(|_request: Request<_>| async move {\n let response = Response::new(String::from(\"hello\"));\n Ok(response)\n });\n\n let super_ = Resource::from_service::<_, _, Infallible>(service);\n (Self, super_)\n }\n}\n\n#[pyfunction]\nfn my_resource(py: Python) -> PyResult<Py<Resource>> {\n let service = tower::service_fn(|_request: Request<_>| async move {\n let response = Response::new(String::from(\"hello\"));\n Ok(response)\n });\n\n Py::new(py, Resource::from_service::<_, _, Infallible>(service))\n}\n```\u{0}"

Class doc string

const IS_BASETYPE: bool = true

#[pyclass(subclass)]

const IS_SUBCLASS: bool = false

#[pyclass(extends=…)]

const IS_MAPPING: bool = false

#[pyclass(mapping)]

const IS_SEQUENCE: bool = false

#[pyclass(sequence)]

type Layout = PyCell<Resource>

Layout

type BaseType = PyAny

Base class

type ThreadChecker = ThreadCheckerStub<Resource>

This handles following two situations:

type PyClassMutability = <<PyAny as PyClassBaseType>::PyClassMutability as PyClassMutability>::MutableChild

Immutable or mutable

type Dict = PyClassDummySlot

Specify this class has #[pyclass(dict)] or not.

type WeakRef = PyClassDummySlot

Specify this class has #[pyclass(weakref)] or not.

type BaseNativeType = PyAny

The closest native ancestor. This is PyAny by default, and when you declare #[pyclass(extends=PyDict)], it’s PyDict.

fn items_iter() -> PyClassItemsIter

fn lazy_type_object() -> &'static LazyTypeObject<Self>

fn dict_offset() -> Option<isize>

fn weaklist_offset() -> Option<isize>

impl<'a, 'py> PyFunctionArgument<'a, 'py> for &'a Resource

type Holder = Option<PyRef<'py, Resource>>

fn extract(obj: &'py PyAny, holder: &'a mut Self::Holder) -> PyResult<Self>

impl<'a, 'py> PyFunctionArgument<'a, 'py> for &'a mut Resource

type Holder = Option<PyRefMut<'py, Resource>>

fn extract(obj: &'py PyAny, holder: &'a mut Self::Holder) -> PyResult<Self>

impl PyMethods<Resource> for PyClassImplCollector<Resource>

fn py_methods(self) -> &'static PyClassItems

impl PyTypeInfo for Resource

const NAME: &'static str = "Resource"

Class name.

const MODULE: Option<&'static str> = ::core::option::Option::None

Module name, if any.

type AsRefTarget = PyCell<Resource>

Utility type to make Py::as_ref work.

fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject

Returns the PyTypeObject instance for this type.

fn type_object(py: Python<'_>) -> &PyType

Returns the safe abstraction over the type object.

fn is_type_of(object: &PyAny) -> bool

Checks if object is an instance of this type or a subclass of this type.

fn is_exact_type_of(object: &PyAny) -> bool

Checks if object is an instance of this type.