Revision control
Copy as Markdown
Other Tools
// SPDX-License-Identifier: Apache-2.0 OR MIT
#![allow(dead_code, unreachable_pub, clippy::no_effect_underscore_binding)]
#[macro_use]
mod auxiliary;
use core::{
marker::{PhantomData, PhantomPinned},
pin::Pin,
};
use pin_project_lite::pin_project;
#[test]
fn projection() {
pin_project! {
#[project = StructProj]
#[project_ref = StructProjRef]
#[project_replace = StructProjReplace]
#[derive(Default)]
struct Struct<T, U> {
#[pin]
f1: T,
f2: U,
}
}
let mut s = Struct { f1: 1, f2: 2 };
let mut s_orig = Pin::new(&mut s);
let s = s_orig.as_mut().project();
let _: Pin<&mut i32> = s.f1;
assert_eq!(*s.f1, 1);
let _: &mut i32 = s.f2;
assert_eq!(*s.f2, 2);
assert_eq!(s_orig.as_ref().f1, 1);
assert_eq!(s_orig.as_ref().f2, 2);
let mut s = Struct { f1: 1, f2: 2 };
let mut s = Pin::new(&mut s);
{
let StructProj { f1, f2 } = s.as_mut().project();
let _: Pin<&mut i32> = f1;
let _: &mut i32 = f2;
}
{
let StructProjRef { f1, f2 } = s.as_ref().project_ref();
let _: Pin<&i32> = f1;
let _: &i32 = f2;
}
{
let StructProjReplace { f1: PhantomData, f2 } =
s.as_mut().project_replace(Struct::default());
assert_eq!(f2, 2);
let StructProj { f1, f2 } = s.project();
assert_eq!(*f1, 0);
assert_eq!(*f2, 0);
}
pin_project! {
#[project = EnumProj]
#[project_ref = EnumProjRef]
#[project_replace = EnumProjReplace]
#[derive(Eq, PartialEq, Debug)]
enum Enum<C, D> {
Struct {
#[pin]
f1: C,
f2: D,
},
Unit,
}
}
let mut e = Enum::Struct { f1: 1, f2: 2 };
let mut e = Pin::new(&mut e);
match e.as_mut().project() {
EnumProj::Struct { f1, f2 } => {
let _: Pin<&mut i32> = f1;
assert_eq!(*f1, 1);
let _: &mut i32 = f2;
assert_eq!(*f2, 2);
}
EnumProj::Unit => unreachable!(),
}
assert_eq!(&*e, &Enum::Struct { f1: 1, f2: 2 });
if let EnumProj::Struct { f1, f2 } = e.as_mut().project() {
let _: Pin<&mut i32> = f1;
assert_eq!(*f1, 1);
let _: &mut i32 = f2;
assert_eq!(*f2, 2);
}
if let EnumProjReplace::Struct { f1: PhantomData, f2 } = e.as_mut().project_replace(Enum::Unit)
{
assert_eq!(f2, 2);
}
}
#[test]
fn enum_project_set() {
pin_project! {
#[project = EnumProj]
#[project_ref = EnumProjRef]
#[derive(Eq, PartialEq, Debug)]
enum Enum {
V1 { #[pin] f: u8 },
V2 { f: bool },
}
}
let mut e = Enum::V1 { f: 25 };
let mut e_orig = Pin::new(&mut e);
let e_proj = e_orig.as_mut().project();
match e_proj {
EnumProj::V1 { f } => {
let new_e = Enum::V2 { f: f.as_ref().get_ref() == &25 };
e_orig.set(new_e);
}
EnumProj::V2 { .. } => unreachable!(),
}
assert_eq!(e, Enum::V2 { f: true });
}
#[test]
fn where_clause() {
pin_project! {
struct Struct<T>
where
T: Copy,
{
f: T,
}
}
pin_project! {
#[project = EnumProj]
#[project_ref = EnumProjRef]
enum Enum<T>
where
T: Copy,
{
V { f: T },
}
}
}
#[test]
fn where_clause_and_associated_type_field() {
pin_project! {
struct Struct1<I>
where
I: Iterator,
{
#[pin]
f1: I,
f2: I::Item,
}
}
pin_project! {
struct Struct2<I, J>
where
I: Iterator<Item = J>,
{
#[pin]
f1: I,
f2: J,
}
}
pin_project! {
pub struct Struct3<T>
where
T: 'static,
{
f: T,
}
}
trait Static: 'static {}
impl<T> Static for Struct3<T> {}
pin_project! {
#[project = EnumProj]
#[project_ref = EnumProjRef]
enum Enum<I>
where
I: Iterator,
{
V1 { #[pin] f: I },
V2 { f: I::Item },
}
}
}
#[test]
fn derive_copy() {
pin_project! {
#[derive(Clone, Copy)]
struct Struct<T> {
f: T,
}
}
fn is_copy<T: Copy>() {}
is_copy::<Struct<u8>>();
}
#[test]
fn move_out() {
struct NotCopy;
pin_project! {
struct Struct {
f: NotCopy,
}
}
let x = Struct { f: NotCopy };
let _val: NotCopy = x.f;
pin_project! {
#[project = EnumProj]
#[project_ref = EnumProjRef]
enum Enum {
V { f: NotCopy },
}
}
let x = Enum::V { f: NotCopy };
#[allow(clippy::infallible_destructuring_match)]
let _val: NotCopy = match x {
Enum::V { f } => f,
};
}
#[test]
fn trait_bounds_on_type_generics() {
pin_project! {
pub struct Struct1<'a, T: ?Sized> {
f: &'a mut T,
}
}
pin_project! {
pub struct Struct2<'a, T: ::core::fmt::Debug> {
f: &'a mut T,
}
}
pin_project! {
pub struct Struct3<'a, T: core::fmt::Debug> {
f: &'a mut T,
}
}
// pin_project! {
// pub struct Struct4<'a, T: core::fmt::Debug + core::fmt::Display> {
// f: &'a mut T,
// }
// }
// pin_project! {
// pub struct Struct5<'a, T: core::fmt::Debug + ?Sized> {
// f: &'a mut T,
// }
// }
pin_project! {
pub struct Struct6<'a, T: core::fmt::Debug = [u8; 16]> {
f: &'a mut T,
}
}
let _: Struct6<'_> = Struct6 { f: &mut [0_u8; 16] };
pin_project! {
pub struct Struct7<T: 'static> {
f: T,
}
}
trait Static: 'static {}
impl<T> Static for Struct7<T> {}
pin_project! {
pub struct Struct8<'a, 'b: 'a> {
f1: &'a u8,
f2: &'b u8,
}
}
pin_project! {
#[project = EnumProj]
#[project_ref = EnumProjRef]
enum Enum<'a, T: ?Sized> {
V { f: &'a mut T },
}
}
}
#[test]
fn private_type_in_public_type() {
pin_project! {
pub struct PublicStruct<T> {
#[pin]
inner: PrivateStruct<T>,
}
}
struct PrivateStruct<T>(T);
}
#[allow(clippy::needless_lifetimes)]
#[test]
fn lifetime_project() {
pin_project! {
struct Struct1<T, U> {
#[pin]
pinned: T,
unpinned: U,
}
}
pin_project! {
struct Struct2<'a, T, U> {
#[pin]
pinned: &'a T,
unpinned: U,
}
}
pin_project! {
#[project = EnumProj]
#[project_ref = EnumProjRef]
enum Enum<T, U> {
V {
#[pin]
pinned: T,
unpinned: U,
},
}
}
impl<T, U> Struct1<T, U> {
fn get_pin_ref<'a>(self: Pin<&'a Self>) -> Pin<&'a T> {
self.project_ref().pinned
}
fn get_pin_mut<'a>(self: Pin<&'a mut Self>) -> Pin<&'a mut T> {
self.project().pinned
}
fn get_pin_ref_elided(self: Pin<&Self>) -> Pin<&T> {
self.project_ref().pinned
}
fn get_pin_mut_elided(self: Pin<&mut Self>) -> Pin<&mut T> {
self.project().pinned
}
}
impl<'b, T, U> Struct2<'b, T, U> {
fn get_pin_ref<'a>(self: Pin<&'a Self>) -> Pin<&'a &'b T> {
self.project_ref().pinned
}
fn get_pin_mut<'a>(self: Pin<&'a mut Self>) -> Pin<&'a mut &'b T> {
self.project().pinned
}
fn get_pin_ref_elided(self: Pin<&Self>) -> Pin<&&'b T> {
self.project_ref().pinned
}
fn get_pin_mut_elided(self: Pin<&mut Self>) -> Pin<&mut &'b T> {
self.project().pinned
}
}
impl<T, U> Enum<T, U> {
fn get_pin_ref<'a>(self: Pin<&'a Self>) -> Pin<&'a T> {
match self.project_ref() {
EnumProjRef::V { pinned, .. } => pinned,
}
}
fn get_pin_mut<'a>(self: Pin<&'a mut Self>) -> Pin<&'a mut T> {
match self.project() {
EnumProj::V { pinned, .. } => pinned,
}
}
fn get_pin_ref_elided(self: Pin<&Self>) -> Pin<&T> {
match self.project_ref() {
EnumProjRef::V { pinned, .. } => pinned,
}
}
fn get_pin_mut_elided(self: Pin<&mut Self>) -> Pin<&mut T> {
match self.project() {
EnumProj::V { pinned, .. } => pinned,
}
}
}
}
mod visibility {
use pin_project_lite::pin_project;
pin_project! {
pub(crate) struct S {
pub f: u8,
}
}
}
#[test]
fn visibility() {
let mut x = visibility::S { f: 0 };
let x = Pin::new(&mut x);
let y = x.as_ref().project_ref();
let _: &u8 = y.f;
let y = x.project();
let _: &mut u8 = y.f;
}
#[test]
fn trivial_bounds() {
pin_project! {
pub struct NoGenerics {
#[pin]
f: PhantomPinned,
}
}
assert_not_unpin!(NoGenerics);
}
#[test]
fn dst() {
pin_project! {
pub struct Struct1<T: ?Sized> {
f: T,
}
}
let mut x = Struct1 { f: 0_u8 };
let x: Pin<&mut Struct1<dyn core::fmt::Debug>> = Pin::new(&mut x as _);
let _: &mut (dyn core::fmt::Debug) = x.project().f;
pin_project! {
pub struct Struct2<T: ?Sized> {
#[pin]
f: T,
}
}
let mut x = Struct2 { f: 0_u8 };
let x: Pin<&mut Struct2<dyn core::fmt::Debug + Unpin>> = Pin::new(&mut x as _);
let _: Pin<&mut (dyn core::fmt::Debug + Unpin)> = x.project().f;
pin_project! {
struct Struct3<T>
where
T: ?Sized,
{
f: T,
}
}
pin_project! {
struct Struct4<T>
where
T: ?Sized,
{
#[pin]
f: T,
}
}
pin_project! {
struct Struct11<'a, T: ?Sized, U: ?Sized> {
f1: &'a mut T,
f2: U,
}
}
}
#[test]
fn dyn_type() {
pin_project! {
struct Struct1 {
f: dyn core::fmt::Debug,
}
}
pin_project! {
struct Struct2 {
#[pin]
f: dyn core::fmt::Debug,
}
}
pin_project! {
struct Struct3 {
f: dyn core::fmt::Debug + Send,
}
}
pin_project! {
struct Struct4 {
#[pin]
f: dyn core::fmt::Debug + Send,
}
}
}
#[test]
fn no_infer_outlives() {
trait Trait<X> {
type Y;
}
struct Struct1<A>(A);
impl<X, T> Trait<X> for Struct1<T> {
type Y = Option<T>;
}
pin_project! {
struct Struct2<A, B> {
_f: <Struct1<A> as Trait<B>>::Y,
}
}
}
#[test]
fn trailing_comma() {
pub trait T {}
pin_project! {
pub struct S1<
A: T,
B: T,
> {
f: (A, B),
}
}
pin_project! {
pub struct S2<
A,
B,
>
where
A: T,
B: T,
{
f: (A, B),
}
}
pin_project! {
#[allow(explicit_outlives_requirements)]
pub struct S3<
'a,
A: 'a,
B: 'a,
> {
f: &'a (A, B),
}
}
// pin_project! {
// pub struct S4<
// 'a,
// 'b: 'a, // <-----
// > {
// f: &'a &'b (),
// }
// }
}
#[test]
fn attrs() {
pin_project! {
/// dox1
#[derive(Clone)]
#[project = StructProj]
#[project_ref = StructProjRef]
/// dox2
#[derive(Debug)]
/// dox3
struct Struct {
// TODO
// /// dox4
f: ()
}
}
pin_project! {
#[project = Enum1Proj]
#[project_ref = Enum1ProjRef]
enum Enum1 {
#[cfg(not(any()))]
V {
f: ()
},
}
}
pin_project! {
/// dox1
#[derive(Clone)]
#[project(!Unpin)]
#[project = Enum2Proj]
#[project_ref = Enum2ProjRef]
/// dox2
#[derive(Debug)]
/// dox3
enum Enum2 {
/// dox4
V1 {
// TODO
// /// dox5
f: ()
},
/// dox6
V2,
}
}
}
#[test]
fn pinned_drop() {
pin_project! {
pub struct Struct1<'a> {
was_dropped: &'a mut bool,
#[pin]
field: u8,
}
impl PinnedDrop for Struct1<'_> {
fn drop(this: Pin<&mut Self>) {
**this.project().was_dropped = true;
}
}
}
let mut was_dropped = false;
drop(Struct1 { was_dropped: &mut was_dropped, field: 42 });
assert!(was_dropped);
pin_project! {
pub struct Struct2<'a> {
was_dropped: &'a mut bool,
#[pin]
field: u8,
}
impl PinnedDrop for Struct2<'_> {
fn drop(mut this: Pin<&mut Self>) {
**this.as_mut().project().was_dropped = true;
}
}
}
trait Service<Request> {
type Error;
}
pin_project! {
struct Struct3<'a, T, Request>
where
T: Service<Request>,
T::Error: std::error::Error,
{
was_dropped: &'a mut bool,
#[pin]
field: T,
req: Request,
}
/// dox1
impl<T, Request> PinnedDrop for Struct3<'_, T, Request>
where
T: Service<Request>,
T::Error: std::error::Error,
{
/// dox2
fn drop(mut this: Pin<&mut Self>) {
**this.as_mut().project().was_dropped = true;
}
}
}
}