standard-version 0.3.0

Semantic and calendar version bump calculation
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

# standard-version

[![crates.io](https://img.shields.io/crates/v/standard-version.svg)](https://crates.io/crates/standard-version)
[![docs.rs](https://docs.rs/standard-version/badge.svg)](https://docs.rs/standard-version)

Version bump calculation from conventional commits — supports
semver and calendar versioning (calver).

Also provides the `VersionFile` trait for ecosystem-specific
version file detection and updating (Cargo.toml, package.json,
pyproject.toml, pubspec.yaml, gradle.properties, VERSION).

## Entry points

- `determine_bump` — analyse commits and return the bump level
- `apply_bump` — apply a bump level to a semver version
- `apply_prerelease` — bump with a pre-release tag (e.g. `rc.0`)
- `replace_version_in_toml` — update the version in a TOML string
- `update_version_files` — detect and update version files
- `calver::next_version` — compute next calver version from date

## Example

```rust
use standard_version::{determine_bump, apply_bump, BumpLevel};

let commits = vec![
    standard_commit::parse("feat: add login").unwrap(),
    standard_commit::parse("fix: handle timeout").unwrap(),
];

let level = determine_bump(&commits).unwrap();
assert_eq!(level, BumpLevel::Minor);

let current = semver::Version::new(1, 2, 3);
let next = apply_bump(&current, level);
assert_eq!(next, semver::Version::new(1, 3, 0));
```

## Part of git-std

This crate is one of four libraries powering [git-std][git-std],
a single binary for conventional commits, versioning, changelog,
and git hooks.

## License

MIT

[git-std]: https://github.com/driftsys/git-std