feat: Add deprecated argument to derive macro

[Techassi]

Motivation

Currently it is not possible to set the deprecated and deprecationWarning of a particular CRD version using the derive macro.

See the official Kubernetes docs.

Solution

This PR adds one new argument to the derive macro to set one or both properties.

#[derive(CustomResource)]
#[kube(
    group = "example.org",
    version = "v1",
    kind = "Foo",
    deprecated
)]
struct MyCrdSpec {}

// Also set the deprecationWarning

#[derive(CustomResource)]
#[kube(
    group = "example.org",
    version = "v1",
    kind = "Foo",
    deprecated = "my warning"
)]
struct MyCrdSpec {}

[codecov]

Codecov Report

Attention: Patch coverage is 83.33333% with 1 line in your changes missing coverage. Please review.

Project coverage is 75.9%. Comparing base (c191439) to head (c323b67).
Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
kube-derive/src/custom_resource.rs	83.4%	1 Missing ⚠️

Additional details and impacted files

@@           Coverage Diff           @@
##            main   #1697     +/-   ##
=======================================
+ Coverage   75.9%   75.9%   +0.1%     
=======================================
  Files         84      84             
  Lines       7679    7685      +6     
=======================================
+ Hits        5822    5827      +5     
- Misses      1857    1858      +1     

Files with missing lines	Coverage Δ
kube-derive/src/lib.rs	0.0% <ø> (ø)
kube-derive/tests/crd_schema_test.rs	96.9% <ø> (ø)
kube-derive/src/custom_resource.rs	84.1% <83.4%> (-<0.1%)	⬇️

[Techassi]

The single missing line is a bummer. I thought this is covered by the doc test. Seems like codecov isn't considering doc tests when calculating coverage.

Let me know if there is a way to test the single missing line.

[clux]

very nice! quick nit on docs

[clux]

Looks great. Will merge at green. Thank you!

[Techassi]

Lovely, thank you for the quick review :)