av 0.1.0

A Rust procedural macro for tracking API version history and deprecation warnings.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

# AV - API Versioning Macro

A Rust procedural macro for tracking API version history and deprecation warnings.

## Features

- Track multiple version entries per function/struct
- Auto-generate documentation from version history
- Auto-generate warnings based on version status

## Version Types

- **`unstable`** - Generates warning when `deprecated_for_unstable` feature is enabled (controlled by API developer)
- **`stable`** - No warnings
- **`update`** - No warnings
- **`deprecated`** - Always generates `#[deprecated]` warning

## Usage

```rust
use av::ver;

// Unstable API
#[ver(unstable, since = "0.1.0")]
pub fn unstable_example() { }

// Stable API
#[ver(stable, since = "1.0.0")]
pub fn stable_example() { }

// Deprecated API - always generates warning
#[ver(deprecated, since = "2.0.0", note = "Use new_function instead")]
pub fn old_function() { }

// Full - multiple versions with history
#[ver(
    update, since = "1.2.0", note = "Added parameter", date = "2024-03-01", author = "Akari";
    stable, since = "1.1.0", note = "First stable release", date = "2024-02-01", author = "Akari";
    unstable, since = "0.1.0", note = "Initial implementation", date = "2024-01-01", author = "Akari"
)]
pub fn full_example(value: i32, new_param: bool) { }
```

## Screenshots

**Deprecated Warning:**
![Deprecated Warning](static/deprecated.png)

**Generated Documentation:**
![Documentation](static/doc_gen.png)