Release v0.1.0 beta.4+2.4.4 (#27)

* Use xtask to download nuget package in order to avoid downloading on build task (#23)

This allow to publish doc on docs.rs

* Add EOF in main README.md

* Use cfg_attr instead of build.rs for FieldNamesAsSlice

* Bump bindgen to 0.72

* Bump to beta 4 and WSLPluginAPI 2.4.4

Author: mveril

.cargo/config.toml

@@ -0,0 +1,2 @@
+[alias]
+xtask = "run --package xtask --"

.github/workflows/ci.yml

@@ -56,23 +56,20 @@ jobs:
 
       - name: Lint with Clippy (Stable Only)
         if: matrix.toolchain == 'stable'
-        run: cargo clippy --all-targets --features="runtime-features"
+        run: cargo clippy --all-targets --all-features
 
       - name: Check Code Formatting (Stable Only)
         if: matrix.toolchain == 'stable'
         run: cargo fmt -- --check
 
-      - name: Build the Project with nuget
-        run: cargo build --features="runtime-features" --verbose
-
-      - name: Build the Project without nuget
+      - name: Build the Project
         run: cargo build --all-features --verbose
 
       - name: Run Tests
-        run: cargo test --features="runtime-features" --verbose
+        run: cargo test --all-features --verbose
 
       - name: Generate Documentation (${{ matrix.DOCTYPE }}, ${{ matrix.toolchain }})
-        run: cargo doc --no-deps --features="runtime-features"
+        run: cargo doc --no-deps --all-features
 
       - name: Install and Run Security Audit (Nightly Only)
         if: matrix.toolchain == 'nightly'
@@ -120,7 +117,7 @@ jobs:
           echo "CARGO_TARGET_${var_name}_AR=${{ matrix.target.ar }}" >> $GITHUB_ENV
 
       - name: Build Project for target ${{ matrix.target.triple }}
-        run: cargo build --target=${{ matrix.target.triple }} --features=no-nuget --release
+        run: cargo build --target=${{ matrix.target.triple }} --all-features --release
 
       - name: Run doc
         run: cargo doc --target=${{ matrix.target.triple }} --no-deps --all-features

.github/workflows/release-and-deploy.yml

@@ -148,7 +148,7 @@ jobs:
         continue-on-error: false
 
       - name: Run Cargo Publish in Dry-Run Mode
-        run: cargo publish --dry-run
+        run: cargo publish -p wslpluginapi-sys --dry-run
 
       - name: Create GitHub Release
         id: release
@@ -162,7 +162,7 @@ jobs:
             - This version provides bindings for **WSLPluginAPI v${{ env.nuget_version }}**, available on [NuGet](https://www.nuget.org/packages/Microsoft.WSL.PluginApi/${{ env.nuget_version }}).
           prerelease: ${{ env.prerelease == 'true' }}
 
-      - name: Cargo Publish on crates.io
-        run: cargo publish
+      - name: Cargo publish on crates.io
+        run: cargo publish -p wslpluginapi-sys
         env:
           CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}

.github/workflows/release-checks.yml

@@ -75,7 +75,7 @@ jobs:
               exit 1
           }
           cargo generate-lockfile
-          $pkgid = cargo pkgid --quiet
+          $pkgid = cargo pkgid -p wslpluginapi-sys --quiet
           if ($pkgid -match "#(.+)$") {
               $currentVersion = $matches[1]
           } else {
@@ -125,11 +125,11 @@ jobs:
       - name: Run Tests
         shell: pwsh
         run: |
-          cargo test --all-targets
+          cargo test -p wslpluginapi-sys --all-targets
 
       - name: Publish Dry-Run
         env:
           CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
         shell: pwsh
         run: |
-          cargo publish --dry-run
+          cargo publish -p wslpluginapi-sys --dry-run

.gitignore

@@ -1,3 +1,3 @@
 /target
-/nuget_packages/*
-Cargo.lock
+/nuget_packages/
+Cargo.lock

Cargo.toml

@@ -1,55 +1,15 @@
-[package]
+[workspace]
+resolver = "3"
+members = ["wslpluginapi-sys", "xtask"]
+default-members = ["wslpluginapi-sys"]
+
+
+[workspace.package]
 name = "wslpluginapi-sys"
-version = "0.1.0-beta.3+2.1.3"
+version = "0.1.0-beta.4+2.4.4"
 edition = "2021"
 readme = "README.md"
 authors = ["Mickaël Véril <mika.veril@wanadoo.fr>"]
 description = "Rust bindings for the WSL Plugin API"
 license = "MIT"
 repository = "https://github.com/mveril/wslpluginapi-sys"
-keywords = ["wsl", "plugin", "windows", "linux", "ffi"]
-categories = ["os::windows-apis", "external-ffi-bindings", "virtualization"]
-build = "build/main.rs"
-
-[features]
-# Enables all features that modify the library's behavior at runtime.
-# Unlike build-related features, this impacts the API's functionalities.
-runtime-features = ["hooks-field-names"]
-hooks-field-names = ["dep:struct-field-names-as-array"]
-# build features
-no-nuget = ["dep:zip", "dep:reqwest", "dep:tempfile"]
-
-[build-dependencies]
-zip = { version = "2.2", optional = true }
-tempfile = { version = "3.16", optional = true }
-reqwest = { version = "0.12", optional = true, features = ["blocking"] }
-semver = { version = "1.0" }
-bindgen = "0.71"
-cfg-if = "1.0"
-constcat = "0.6.0"
-
-
-[dependencies]
-libc = "0.2"
-struct-field-names-as-array = { version = "0.3", features = [
-  "derive",
-], optional = true }
-
-[dependencies.windows]
-version = ">0.32"
-features = [
-  "Win32_Foundation",
-  "Win32_Security",
-  "Win32_System_Diagnostics_Debug",
-  "Win32_Networking_WinSock",
-]
-
-[package.metadata.docs.rs]
-all-features = true
-targets = [
-  "x86_64-pc-windows-msvc",
-  "x86_64-pc-windows-gnu",
-  "x86_64-pc-windows-gnullvm",
-  "aarch64-pc-windows-msvc",
-  "aarch64-pc-windows-gnullvm",
-]

README.MD

@@ -1,39 +1,48 @@
 # wslpluginapi-sys
 
-[![Crates.io](https://img.shields.io/crates/v/wslpluginapi-sys?logo=rust)](https://crates.io/crates/wslpluginapi-sys)
-[![Docs.rs](https://img.shields.io/badge/docs.rs-wslpluginapi--sys-blue?logo=docs.rs)](https://docs.rs/wslpluginapi-sys)
-[![Build Status](https://github.com/mveril/wslpluginapi-sys/actions/workflows/ci.yml/badge.svg?logo=github)](https://github.com/mveril/wslpluginapi-sys/actions)
-[![License](https://img.shields.io/badge/license-MIT-blue.svg?logo=license)](LICENSE)
-[![Native API version](https://img.shields.io/badge/Microsoft.WSL.PluginApi-2.1.3-blue?logo=nuget)](https://www.nuget.org/packages/Microsoft.WSL.PluginApi/2.1.3)
+[![Crates.io](https://img.shields.io/crates/v/wslpluginapi-sys?logo=rust)](https://crates.io/crates/wslpluginapi-sys)  
+[![Docs.rs](https://img.shields.io/badge/docs.rs-wslpluginapi--sys-blue?logo=docs.rs)](https://docs.rs/wslpluginapi-sys)  
+[![Build Status](https://github.com/mveril/wslpluginapi-sys/actions/workflows/ci.yml/badge.svg?logo=github)](https://github.com/mveril/wslpluginapi-sys/actions)  
+[![License](https://img.shields.io/badge/license-MIT-blue.svg?logo=license)](LICENSE)  
+[![Native API version](https://img.shields.io/badge/Microsoft.WSL.PluginApi-2.4.4-blue?logo=nuget)](https://www.nuget.org/packages/Microsoft.WSL.PluginApi/2.4.4)  
 [![Platform](https://img.shields.io/badge/platform-Windows-blue?logo=windows&logoColor=white)](#)
 
 `wslpluginapi-sys` is a Rust crate that provides low-level bindings to the Windows Subsystem for Linux (WSL) Plugin API. It offers a direct interface to the functions and structures defined in the WSL Plugin API, facilitating the development of WSL plugins in Rust.
 
 ## Features
 
-- **Comprehensive Bindings**: Provides complete bindings to the WSL Plugin API, including structures like `GUID` and other essential components.
+- **Comprehensive Bindings**: Provides complete bindings to the WSL Plugin API, including structures like `WSLPluginAPIV1` or `WSLPluginHooksV1` and other essential components.  
 - **Unsafe Abstractions**: Direct, unsafe bindings closely mirroring the original C API for maximum control and flexibility.
 
 ## Prerequisites
 
 Before using `wslpluginapi-sys`, ensure you have the following installed:
 
 - **Rust**: Latest stable version.
-- **Nuget**: require nuget cli in the Path or use the `no-nuget` feature to manage the nuget packages via reqwest and zip (useful if nuget is not installed or on non windows environement).
+
+### Optional
+
+- **NuGet**: Use the NuGet CLI in the xtask nuget process to download NuGet (if not present, we use reqwest to do this process).
 
 ## Installation
 
 Add `wslpluginapi-sys` to your `Cargo.toml`:
 
 ```toml
 [dependencies]
-wslpluginapi-sys = "0.1.0-beta.3+2.1.3"
+wslpluginapi-sys = "0.1.0-beta.4+2.4.4"
 ```
 
-Safety
+## Safety
+
 This crate provides unsafe bindings that closely follow the original C API. Users must ensure they uphold the necessary safety invariants when interacting with these bindings. Proper handling of pointers, memory management, and adherence to the API's expected usage patterns are crucial.
 
-License
+## NuGet package dependency
+
+This project depends on a third-party dependency called [Microsoft.WSL.PluginApi](https://www.nuget.org/packages/Microsoft.WSL.PluginApi) from Microsoft, available on NuGet and providing bindings for it. To upgrade it, change the version build metadata of the project and run `cargo xtask nuget` (don't forget to commit changes generated from the xtask). This xtask extracts all the needed content from the NuGet package. For more info see `THIRD-PARTY-NOTICES.md`
+
+## License
+
 This project is licensed under the MIT License. See the LICENSE file for details.
 
-Note: This crate is part of the [WSLPlugin-rs](https://github.com/mveril/wslpluginapi-sys) project, which aims to create an idiomatic Rust framework for developing WSL plugins.
+Note: This crate is part of the [WSLPlugins-rs](https://github.com/mveril/wslplugins-rs) project, which aims to create an idiomatic Rust framework for developing WSL plugins.

THIRD-PARTY-NOTICES.md

@@ -0,0 +1,22 @@
+# Third Party Notices
+
+## wslpluginapi-sys
+
+### Microsoft.WSL.PluginApi
+
+**Version :** **2.4.4**
+
+**License :** MIT
+
+**Source:**
+[Microsoft.WSL.PluginApi](https://www.nuget.org/packages/Microsoft.WSL.PluginApi/2.4.4)
+
+#### Included files from the package.
+
+- `wslpluginapi-sys/third_party/Microsoft.WSL.PluginApi/include/WslPluginApi.h` unmodified
+- `wslpluginapi-sys/third_party/Microsoft.WSL.PluginApi/README.MD` unmodified
+- `wslpluginapi-sys/third_party/Microsoft.WSL.PluginApi/LICENSE` generated from package metadata
+
+**copyright:**
+
+> © Microsoft Corporation. All rights reserved.