pin-project

• Fix warnings when #[pin_project] attribute used within macro_rules! macros.

• Remove deprecated #[project], #[project_ref], and #[project_replace] attributes.

  Name the projected type by passing an argument with the same name as the method to the #[pin_project] attribute instead:

  - #[pin_project]
  + #[pin_project(project = EnumProj)]
    enum Enum<T> {
        Variant(#[pin] T),
    }
  
  - #[project]
    fn func<T>(x: Pin<&mut Enum<T>>) {
  -     #[project]
        match x.project() {
  -         Enum::Variant(_) => { /* ... */ }
  +         EnumProj::Variant(_) => { /* ... */ }
        }
    }
  

• Remove deprecated Replace argument from #[pin_project] attribute. Use project_replace argument instead.

• Optimize code generation when used on enums.

• Raise the minimum supported Rust version of this crate from Rust 1.34 to Rust 1.37.

• Suppress explicit_outlives_requirements, box_pointers, clippy::large_enum_variant, clippy::pattern_type_mismatch, clippy::implicit_return, and clippy::redundant_pub_crate lints in generated code. (#276, #277, #284)

• Diagnostic improvements.

Changes since the 1.0.0-alpha.1 release:

• Fix drop order of pinned fields in project_replace

• Update minimal version of syn to 1.0.44

• Update minimal version of syn to 1.0.44

• Fix drop order of pinned fields in project_replace

• Suppress drop_bounds lint, which will be added to rustc in the future. See #272 for more details.

  (Note: 1.0.0-alpha.1 already contains this change.)

• Fix compatibility of generated code with forbid(future_incompatible)

  Note: This does not guarantee compatibility with forbid(future_incompatible) in the future.
  If rustc adds a new lint, we may not be able to keep this.

• Remove deprecated #[project], #[project_ref], and #[project_replace] attributes.

  Name the projected type by passing an argument with the same name as the method to the #[pin_project] attribute instead:

  - #[pin_project]
  + #[pin_project(project = EnumProj)]
    enum Enum<T> {
        Variant(#[pin] T),
    }
  
  - #[project]
    fn func<T>(x: Pin<&mut Enum<T>>) {
  -     #[project]
        match x.project() {
  -         Enum::Variant(_) => { /* ... */ }
  +         EnumProj::Variant(_) => { /* ... */ }
        }
    }
  

• Remove deprecated Replace argument from #[pin_project] attribute. Use project_replace argument instead.

• Optimize code generation when used on enums.

• Suppress explicit_outlives_requirements, box_pointers, clippy::large_enum_variant, clippy::pattern_type_mismatch, and clippy::implicit_return lints in generated code. (#276, #277)

• Diagnostic improvements.

See also tracking issue for 1.0 release.

• Fix compile error with ?Sized type parameters.

• Documentation improvements.

• Deprecated #[project], #[project_ref], and #[project_replace] attributes due to some unfixable limitations.

  Consider naming the projected type by passing an argument with the same name as the method to the #[pin_project] attribute instead.

  use pin_project::pin_project;
  use std::pin::Pin;
  
  #[pin_project(project = EnumProj)]
  enum Enum<T> {
      Variant(#[pin] T),
  }
  
  fn func<T>(x: Pin<&mut Enum<T>>) {
      match x.project() {
          EnumProj::Variant(y) => {
              let _: Pin<&mut T> = y;
          }
      }
  }
  

  See #225 for more details.

• Support Self in fields and generics in type definitions.

• Fix errors involving "self value is a keyword only available in methods with self parameter" in apparently correct code.

• Diagnostic improvements.

• You can now use project_replace argument without Replace argument.
  This used to require you to specify both.

  - #[pin_project(Replace, project_replace = EnumProjOwn)]
  + #[pin_project(project_replace = EnumProjOwn)]
    enum Enum<T> {
        Variant(#[pin] T)
    }
  

• Makes project_replace argument an alias for Replace argument so that it can be used without a value.

  #[pin_project(project_replace)]
  enum Enum<T> {
      Variant(#[pin] T)
  }
  

  The Replace argument will be deprecated in the future.

• Suppress unreachable_pub lint in generated code.

• Fix unused_results lint in generated code.

• Support Self in more syntax positions inside #[pinned_drop] impl.

• Suppress clippy::type_repetition_in_bounds and clippy::used_underscore_binding lints in generated code.

• Documentation improvements.

• Diagnostic improvements.

• Support naming the projection types.

  By passing an argument with the same name as the method to the attribute, you can name the projection type returned from the method:

  use pin_project::pin_project;
  use std::pin::Pin;
  
  #[pin_project(project = EnumProj)]
  enum Enum<T> {
      Variant(#[pin] T),
  }
  
  fn func<T>(x: Pin<&mut Enum<T>>) {
      match x.project() {
          EnumProj::Variant(y) => {
              let _: Pin<&mut T> = y;
          }
      }
  }
  

• Fixed an issue that users can call internal function generated by #[pinned_drop].

• #[project] attribute can now handle all project* attributes in that scope with one wrapper attribute.

• Added !Unpin option to #[pin_project] attribute for guarantee the type is !Unpin.

  use pin_project::pin_project;
  #[pin_project(!Unpin)]
  struct Struct<T, U> {
      field: T,
  }
  

  This is equivalent to use #[pin] attribute for PhantomPinned field.

  use pin_project::pin_project;
  use std::marker::PhantomPinned;
  #[pin_project]
  struct Struct<T, U> {
      field: T,
      #[pin] // Note that using `PhantomPinned` without `#[pin]` attribute has no effect.
      _pin: PhantomPinned,
  }
  

  Note: This raises the minimum supported Rust version of this crate from rustc 1.33 to rustc 1.34.

• Fixed an issue where duplicate #[project] attributes were ignored.

• Fixed compile error and warnings with HRTB.

• Hide generated items from --document-private-items. See #211 for more details.

• Improve documentation

• Fixed a regression in 0.4.11.

  Changes from 0.4.10 and 0.4.12:

  • Fixed an issue that #[project] on non-statement expression does not work without unstable features.

  • Support overwriting the name of core crate.

  • Improve documentation

• A release to avoid a regression in 0.4.11. No code changes from 0.4.10.

• Fixed an issue that #[project] on non-statement expression does not work without unstable features.

• Support overwriting the name of core crate.

• Improve documentation