Skip to content

Add compile-time version macros #2118

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
seladb wants to merge 2 commits into
base: dev
Choose a base branch
from
+89 −1
Draft

Add compile-time version macros #2118

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
22694c7
Add version macros
seladb Apr 30, 2026
3313dc7
Merge branch 'dev' into compile-time-version
seladb May 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
90 changes: 89 additions & 1 deletion Common++/header/PcapPlusPlusVersion.h
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,97 @@
/// @brief The main namespace for the PcapPlusPlus lib
namespace pcpp
{
/// @def PCAPPLUSPLUS_VERSION_YEAR
/// @brief The year component of the PcapPlusPlus version (e.g., 25 for 2025)
#define PCAPPLUSPLUS_VERSION_YEAR 25

/// @def PCAPPLUSPLUS_VERSION_MONTH
/// @brief The month component of the PcapPlusPlus version (e.g., 5 for May)
#define PCAPPLUSPLUS_VERSION_MONTH 5

/// @def PCAPPLUSPLUS_VERSION_PATCH
/// @brief The patch number component of the PcapPlusPlus version
#define PCAPPLUSPLUS_VERSION_PATCH 0

/// @def PCAPPLUSPLUS_VERSION_DEV
/// @brief Development flag: non-zero for development/nightly builds, zero for official releases
#define PCAPPLUSPLUS_VERSION_DEV 1

/// @def PCAPPLUSPLUS_VERSION
/// @brief Short version string (e.g., "25.05" for official release or "25.05+" for development)
#define PCAPPLUSPLUS_VERSION "25.05+"
Copy link
Copy Markdown
Owner Author

@seladb seladb May 4, 2026 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's possible to create this string using macros, but it'll be very complex, so maybe it's easier to keep it as is...

Copy link
Copy Markdown
Collaborator

@Dimi1010 Dimi1010 May 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I suppose we can manually set it.

A potential alternative is to have the cmake build system generate the version file, like it does with the package config files. I think that is generally more flexible and we would only need to change the version in the CMakeLists.

Also, do you think we should include the patch number in all versions? (eg. 25.05.0), so people always expect it if they decide to do magic with the version string?

Copy link
Copy Markdown
Collaborator

@Dimi1010 Dimi1010 May 5, 2026 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A potential alternative is to have the cmake build system generate the version file, like it does with the package config files. I think that is generally more flexible and we would only need to change the version in the CMakeLists.

@seladb Additional discussion may be needed separately, but I managed to get CMake to compile a version from the git tags. The versioning is based on the signature major.minor.patch.tweak.

It fetches the MAJOR, MINOR, PATCH from the most recent tag. (eg. last release)
It then calculates the Tweak version as the number of commits past the most recent tag the build is.

If we are precisely on the release commit, the tweak version will be 0 and the full version maj.min.patch.0, if we are 1 commit past it it will be maj.min.patch.1. This can then be used to determine official releases (tweak 0) vs nightly / dev builds (tweak != 0).

The solution will allow us to have rolling versions unique for each development build commit, so we don't have just a nebulous "DEV" version flag. For example the current master would be 25.05.0.201.

A extended version string can also be added with a commit hash, if we need to differentiate between commits on different branches, but I think most will be used from the master / dev line.

#define PCAPPLUSPLUS_VERSION_OFFICIAL "non-official release"

/// @def PCAPPLUSPLUS_VERSION_OFFICIAL
/// @brief String indicating whether this is an official or non-official release
#if PCAPPLUSPLUS_VERSION_DEV
# define PCAPPLUSPLUS_VERSION_OFFICIAL "non-official release"
#else
# define PCAPPLUSPLUS_VERSION_OFFICIAL "official release"
#endif

/// @def PCAPPLUSPLUS_MAKE_VERSION_FULL(year, month, patch, dev)
/// @brief Create a comparable numeric version from year, month, patch, and dev components
/// @param year The year component (e.g., 25 for 2025)
/// @param month The month component (1-12)
/// @param patch The patch number
/// @param dev The development flag (0 for official, 1 for dev)
#define PCAPPLUSPLUS_MAKE_VERSION_FULL(year, month, patch, dev) ((year) * 100000 + (month) * 1000 + (patch) * 10 + dev)

/// @def PCAPPLUSPLUS_MAKE_VERSION(year, month, patch)
/// @brief Create a comparable numeric version for official releases (dev=0)
/// @param year The year component
/// @param month The month component
/// @param patch The patch number
#define PCAPPLUSPLUS_MAKE_VERSION(year, month, patch) PCAPPLUSPLUS_MAKE_VERSION_FULL(year, month, patch, 0)

/// @def PCAPPLUSPLUS_VERSION_NUM
/// @brief The current PcapPlusPlus version as a comparable numeric value
#define PCAPPLUSPLUS_VERSION_NUM \
PCAPPLUSPLUS_MAKE_VERSION_FULL(PCAPPLUSPLUS_VERSION_YEAR, PCAPPLUSPLUS_VERSION_MONTH, PCAPPLUSPLUS_VERSION_PATCH, \
PCAPPLUSPLUS_VERSION_DEV)

/// @def PCAPPLUSPLUS_VERSION_EQUALS(major, minor, patch)
/// @brief Check if the current version equals the specified version
/// @param major The major (year) component to compare
/// @param minor The minor (month) component to compare
/// @param patch The patch number to compare
#define PCAPPLUSPLUS_VERSION_EQUALS(major, minor, patch) \
PCAPPLUSPLUS_VERSION_NUM == PCAPPLUSPLUS_MAKE_VERSION(major, minor, patch)

/// @def PCAPPLUSPLUS_VERSION_LOWER_THAN(year, month, patch)
/// @brief Check if the current version is lower than the specified version
/// @param year The year component to compare
/// @param month The month component to compare
/// @param patch The patch number to compare
#define PCAPPLUSPLUS_VERSION_LOWER_THAN(year, month, patch) \
PCAPPLUSPLUS_VERSION_NUM < PCAPPLUSPLUS_MAKE_VERSION(year, month, patch)

/// @def PCAPPLUSPLUS_VERSION_LOWER_OR_EQUAL_THAN(year, month, patch)
/// @brief Check if the current version is lower than or equal to the specified version
/// @param year The year component to compare
/// @param month The month component to compare
/// @param patch The patch number to compare
#define PCAPPLUSPLUS_VERSION_LOWER_OR_EQUAL_THAN(year, month, patch) \
PCAPPLUSPLUS_VERSION_NUM <= PCAPPLUSPLUS_MAKE_VERSION(year, month, patch)

/// @def PCAPPLUSPLUS_VERSION_HIGHER_THAN(year, month, patch)
/// @brief Check if the current version is higher than the specified version
/// @param year The year component to compare
/// @param month The month component to compare
/// @param patch The patch number to compare
#define PCAPPLUSPLUS_VERSION_HIGHER_THAN(year, month, patch) \
PCAPPLUSPLUS_VERSION_NUM > PCAPPLUSPLUS_MAKE_VERSION(year, month, patch)

/// @def PCAPPLUSPLUS_VERSION_HIGHER_OR_EQUAL_THAN(year, month, patch)
/// @brief Check if the current version is higher than or equal to the specified version
/// @param year The year component to compare
/// @param month The month component to compare
/// @param patch The patch number to compare
#define PCAPPLUSPLUS_VERSION_HIGHER_OR_EQUAL_THAN(year, month, patch) \
PCAPPLUSPLUS_VERSION_NUM >= PCAPPLUSPLUS_MAKE_VERSION(year, month, patch)

/// @def PCAPPLUSPLUS_VERSION_FULL
/// @brief Full version string including version and release type (e.g., "v25.05+ (non-official release)")
#define PCAPPLUSPLUS_VERSION_FULL "v" PCAPPLUSPLUS_VERSION " (" PCAPPLUSPLUS_VERSION_OFFICIAL ")"

/// @return PcapPlusPlus current version, e.g: 23.09. Notice that for non-official releases (which were pulled from
Expand Down
Loading