Release 2.4.8

[talregev]

Release 2.4.8

Refactor:

• Add namespace
• Enable sanitize builds
• Refactor platform unittest external cmake
• Add alias

[dg0yt]

I'm happy seeing CMake namespaces being added to exported targets. But it should be clear that this is a breaking change if not complemented by providing an alias with the old name. I wonder if a breaking change is desired in a patch release.

[talregev]

I already submit it to upstream and it accepted. and maybe it will be release.
#4692
#4701

[dg0yt]

This repo is upstream. That's why I raise the point:
Adding the namespace without add polyfill breaks users.

[nibanks]

How do we add the alias? I assume this is only a build time breaking change? Regardless, I would like to prevent those, if possible.

[dg0yt]

The namespace is a useful service for consumers, but it doesn't affect the build: It signals to CMake that the identifier is a CMake target, not plain input to the linker. This improves detecting configuration errors.

Alias could be setup in msquic-config.cmake, after including the generated export files. Sth. like

foreach(_t IN ITEMS msquic msquic_platform ...)
    if(TARGET msquic::${_t} AND NOT TARGET ${_t})
        add_library(${_t} ALIAS msquic::${_t})
    endif()
endforeach()

[dg0yt]

This could be removed in 2.5 or 3, after proper deprecation.

[talregev]

@dg0yt I thought you are comment on vcpkg.
Can you add alias?

[talregev]

@dg0yt How you can add this to msquic-config.cmake? this file generate automatic. I will glad for your help.

[talregev]

@nibanks @dg0yt
I don't have the knowledge how to add alias. I am close this PR.

[dg0yt]

The suggested change was given almost literally. (I didn't fill in all targets.)
The change is to be inserted after this line:

msquic/src/bin/msquic-config.cmake.in

Line 4 in 21e5b41

include(${SELF_DIR}/msquic.cmake)

Are there any other obstacles?

[talregev]

This should be done in separate PR to the main.

[talregev]

@nibanks
I added the alias

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 86.82%. Comparing base (622a725) to head (9be6488).

Additional details and impacted files

@@               Coverage Diff               @@
##           release/2.4    #4701      +/-   ##
===============================================
- Coverage        86.86%   86.82%   -0.05%     
===============================================
  Files               56       56              
  Lines            17338    17338              
===============================================
- Hits             15061    15053       -8     
- Misses            2277     2285       +8     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[talregev]

Better wait to @dg0yt changes in vcpkg:
microsoft/vcpkg#42788

[talregev]

@nibanks At the moment, vcpkg port was merge without apply the patch inside.
Do you want to move forward with these changes that will match more closer msquic head to release?

Let me know what do you think.

[dg0yt]

IMO one PR shouldn't mix these independent topics:

• Bumping version number
• Adding CMake export namespace and aliases
• Adding a test for external CMake usage.

The PR which adds the test could also add commits with necessary fixes. That's how to get to a good CMake usage pattern. Similar to what was done in vcpkg with vcpkg-ci-msh3.

Dealing with export namespace and aliases would follow the integration of the test.

[dg0yt]

Dealing with export namespace and aliases would follow the integration of the test.

Probably it is enough to add an alias for msquic because this is the only target name which was exported in past releases IIUC.

[talregev]

Dealing with export namespace and aliases would follow the integration of the test.

Probably it is enough to add an alias for msquic because this is the only target name which was exported in past releases IIUC.

the commits are cherry picks. As upstream rules, you just bring previous commits from head without change them. If I understood it correctly.

I have one commit that bring the namespace and refactor platform unittest external cmake. (There is no adding test, it old text).
And second commit is the alias.
and the third is bump the version number (without cherry picks).