Skip to content

Commit 9561433

Browse files
author
Justin C Presley
committed
reset versioning - origin of releases
1 parent fae935c commit 9561433

File tree

4 files changed

+27
-7
lines changed

4 files changed

+27
-7
lines changed

README.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,10 @@ The full API documentation is available on [pkg.go.dev](https://pkg.go.dev/githu
2626

2727
Additionally, [usage](https://github.com/justincpresley/go-cobs/blob/master/docs/USAGE.md) outlines everything you need to know about types, config, and anything that may be unclear outside of the API.
2828

29+
## Notes
30+
31+
***go-cobs*** stands out from other COBS libraries due to [many differences](https://github.com/justincpresley/go-cobs/blob/master/docs/DIFFERENCES.md). This library has discovered advances in the COBS that are not stated anywhere else.
32+
2933
## License
3034

3135
***go-cobs*** is an open source project licensed under ISC. See LICENSE.md for more information.
@@ -35,5 +39,5 @@ Additionally, [usage](https://github.com/justincpresley/go-cobs/blob/master/docs
3539
[3]: https://www.codefactor.io/repository/github/justincpresley/go-cobs
3640
[4]: https://go.dev/
3741
[5]: https://github.com/justincpresley/go-cobs/releases
38-
[6]: https://github.com/justincpresley/go-cobs/compare/v1.5.0-alpha.1...HEAD
42+
[6]: https://github.com/justincpresley/go-cobs/compare/v1.6.0...HEAD
3943
[7]: https://en.wikipedia.org/wiki/ISC_license

docs/CHANGELOG.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,17 +4,18 @@ All notable changes to **go-cobs** will be documented in this file.
44

55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Go's Versioning](https://go.dev/doc/modules/release-workflow).
66

7-
This Changelog starts at ***v1.5.0-alpha.1*** due to the late integration of this log.
7+
This Changelog starts at ***v1.6.0*** due to the late integration of this log.
88

99
## [Unreleased]
1010

11-
## [v1.5.0-alpha.1] - 2024-02-18
11+
## [v1.6.0] - 2024-02-18
1212
## Added
1313
- An easy-to-run example which can be run instantly after cloning this repository.
14+
- A Changelog!
1415

1516
## Changed
16-
- Completely refactor the structure of this library.
17+
- Completely refactor the structure and documentation of this library.
1718
- Moved to go 1.22, updated all dependencies.
1819

19-
[Unreleased]: https://github.com/justincpresley/go-cobs/compare/v1.5.0-alpha.1...HEAD
20-
[v1.5.0-alpha.1]: https://github.com/justincpresley/go-cobs/releases/tag/v1.5.0-alpha.1
20+
[Unreleased]: https://github.com/justincpresley/go-cobs/compare/v1.6.0...HEAD
21+
[v1.6.0]: https://github.com/justincpresley/go-cobs/releases/tag/v1.6.0

docs/DIFFERENCES.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# Differences
2+
3+
Comparatively, this library offers combined functionality not found within most if not all other COBS libraries on the market as of writing this. To name a few:
4+
5+
- **Choose whether the Delimiter (Special byte) is added.** Libraries tend to choose this for you.
6+
- **Choose what the Special Byte is.** Libraries tend to provide the NULL (0x00) byte only.
7+
- **Use COBS as a Layer of Integrity.** By ensuring that the special byte does not occur (expect with a delimiter) and by ensuring that the flags lead to the end of the data, COBS can provide a small layer of integrity.
8+
- **Use a TONS of different extensions (types).** Found in [usage](https://github.com/justincpresley/go-cobs/blob/master/docs/USAGE.md), rare types are included and even ones only included in this library.
9+
- **Additional API Commands.** Not only is there functions to calculate the min/max overhead for COBS but also flag-related functions.
10+
11+
## Research
12+
13+
There is a lot of research potential out of this library. For example, It would be an interesting to find what the optimal amount of flags is to provide the best integrity checking for some given data.
14+
15+
The license on **go-cobs** was chosen to help facilitate research. If you do conduct research, you are welcomed to open an [Issue](https://github.com/justincpresley/go-cobs/issues) to document your findings/papers/etc. This way, **go-cobs** can take in your research (given the approach attributions) and grow as a library.

flags.go

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ package cobs
22

33
const (
44
Branch = "master"
5-
Version = "v1.5.0-alpha.1"
5+
Version = "v1.6.0"
66
License = "ISC License"
77
Source = "github.com/justincpresley/go-cobs"
88
Created = "2022-07-24"

0 commit comments

Comments
 (0)