fix: behavior tests ci

.github/workflows/check.yml

@@ -1,4 +1,5 @@
 name: check
+
 on:
   workflow_dispatch:
   push:
@@ -25,7 +26,7 @@ jobs:
       - uses: Swatinem/rust-cache@v2
 
       - name: clippy
-        run: cargo clippy --all-features
+        run: cargo clippy --all-features --workspace
         env:
           RUSTFLAGS: "-Dwarnings"
 

.github/workflows/test_behavior.yml

@@ -0,0 +1,24 @@
+name: test behavior
+
+on:
+  workflow_dispatch:
+  push:
+    paths:
+      - "**.rs"
+      - "**/Cargo.toml"
+      - ".github/workflows/test_behavior.yml"
+  pull_request:
+    paths:
+      - "**.rs"
+      - "**/Cargo.toml"
+      - ".github/workflows/test_behavior.yml"
+
+jobs:
+  test:
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+
+      - name: cargo test
+        run: cargo test --test behavior --all-features

Cargo.toml

@@ -1,42 +1,63 @@
 [package]
-name = "wincs"
-version = "0.1.0"
+name = "cloud-filter"
+version = "0.0.4"
+authors = [
+  "ok-nick <nick.libraries@gmail.com>",
+  "ho-229 <ho229v3666@gmail.com>",
+]
 edition = "2021"
+description = "A safe and idiomatic wrapper around the Windows Cloud Filter API"
+license = "MIT"
+repository = "https://github.com/ho-229/cloud-filter-rs"
+documentation = "https://docs.rs/cloud-filter"
+exclude = ["examples/", ".github/", "test/"]
+
+[package.metadata.docs.rs]
+default-target = "x86_64-pc-windows-msvc"
 
 [dependencies]
+flagset = "0.4.5"
 widestring = "1.0.2"
-memoffset = "0.6.4"
-windows = { version = "0.33.0", features = [
-  "alloc",
+nt-time = "0.8.0"
+memoffset = "0.9.1"
+windows = { version = "0.58.0", features = [
   "Win32_Foundation",
   "Win32_Storage_CloudFilters",
-  "Win32_System_SystemServices",
   "Win32_System_CorrelationVector",
   "Win32_Storage_FileSystem",
   "Win32_System_IO",
   "Storage_Provider",
   "Win32_System_Memory",
   "Storage",
+  "Storage_Search",
   "Foundation",
   "Foundation_Collections",
   "Win32_Security_Authorization",
   "Win32_UI_Shell",
   "Win32_System_Com",
   "Win32_UI_Shell_PropertiesSystem",
-  "Win32_System_Com_StructuredStorage",
-  "Win32_Storage_EnhancedStorage",
-  "Win32_System_Ole",
   "Win32_System_Search",
   "Storage_Streams",
   "Win32_System_Ioctl",
   "Win32_Security",
 ] }
 globset = { version = "0.4.9", optional = true }
 
+[dev-dependencies]
+libtest-mimic = "0.7.3"
+futures = "0.3.30"
+anyhow = "1.0.86"
+powershell_script = "1.1.0"
+
 [features]
 # Enable globs in the `info::FetchPlaceholders` struct.
 globs = ["globset"]
 
 # TODO: temporarily ignored
 [workspace]
 members = ["examples/sftp"]
+
+[[test]]
+harness = false
+name = "behavior"
+path = "tests/behavior/main.rs"

README.md

@@ -1,18 +1,17 @@
 <div align="center">
-  <h1><code>wincs</code></h1>
+  <h1><code>cloud-filter</code></h1>
   <p><strong>Windows Cloud Sync</strong></p>
   <p>
-    <a href="https://docs.rs/wincs/0.0.0/wincs/"><img src="https://img.shields.io/readthedocs/wincs" alt="docs" /></a>
-    <a href="https://crates.io/crates/wincs"><img src="https://img.shields.io/crates/v/wincs" alt="crates" /></a>
-    <a href="https://discord.gg/w9Bc6xH7uC"><img src="https://img.shields.io/discord/834969350061424660?label=discord" alt="discord" /></a>
+    <a href="https://docs.rs/cloud-filter/"><img src="https://img.shields.io/docsrs/cloud-filter" alt="docs" /></a>
+    <a href="https://crates.io/crates/cloud-filter"><img src="https://img.shields.io/crates/v/cloud-filter" alt="crates" /></a>
   </p>
 </div>
 
-> **Warning**
-> Read more about the future of `wincs` in [issue #8](https://github.com/ok-nick/wincs/issues/8).
+> This is a fork of [wincs](https://github.com/ok-nick/wincs), thanks for [ok-nick](https://github.com/ok-nick)'s great work.
 
-`wincs` is a safe and idiomatic wrapper around the native [Windows Cloud Filter API](https://docs.microsoft.com/en-us/windows/win32/cfapi/build-a-cloud-file-sync-engine). The Cloud Filter API enables developers to implement their own remote file system from within user space. It is much like [FUSE](#why-not-fuse), although it contains many first-class Windows features that are only available through its API.
+`cloud-filter` is a safe and idiomatic wrapper around the native [Windows Cloud Filter API](https://docs.microsoft.com/en-us/windows/win32/cfapi/build-a-cloud-file-sync-engine). The Cloud Filter API enables developers to implement their own remote file system from within user space. It is much like [FUSE](#why-not-fuse), although it contains many first-class Windows features that are only available through its API.
 For example:
+
 * [Placeholder files](#what-are-placeholders)
     * Partial files
     * Full files
@@ -41,33 +40,37 @@ For example:
 As of right now, the Cloud Filter API is used in production by OneDrive, Google Drive, Dropbox, and many other clients.
 
 ## Examples
-Below is a simple snippet of implementing a sync engine. For more, in-depth examples, please check out the [examples directory](https://github.com/ok-nick/wincs/tree/main/examples).
-```rs
-// TODO
-```
+
+Below is a simple snippet of implementing a sync engine. For more, in-depth examples, please check out the [examples directory](https://github.com/ho-229/cloud-filter/tree/main/examples).
 
 ## FAQ
 
 ### Why not FUSE?
 Unfortunately, FUSE is only implemented for Unix-like operating systems. Luckily, there are numerous alternatives for implementing file systems on Windows, such as `dokany` or `winfsp`.
 
 #### Why not `dokany`?
-`dokany` has a Rust API and is accessible using safe code. However, it is fairly low-level and does not have the first-class capabilities supported by `wincs`. Read more [here](#wincs).
+
+`dokany` has a Rust API and is accessible using safe code. However, it is fairly low-level and does not have the first-class capabilities supported by `cloud-filter`.
 
 #### Why not `winfsp`?
-Unlike `dokany`, `winfsp` currently does not have a Rust API. Perhaps at some point it may, but even so, it is impossible to have the first-class features supported by `wincs`. Read more [here](#wincs).
+
+Unlike `dokany`, `winfsp` currently does not have a Rust API. Perhaps at some point it may, but even so, it is impossible to have the first-class features supported by `cloud-filter`.
 
 ### What are placeholders?
+
 Placeholders are internally [NTFS sparse files](https://docs.microsoft.com/en-us/windows/win32/fileio/sparse-files) and some [reparse point magic](https://docs.microsoft.com/en-us/windows/win32/cfapi/build-a-cloud-file-sync-engine#compatibility-with-applications-that-use-reparse-points). To put it simple, they are empty files that are meant to represent real files, although are not backed by any allocation unless requested. The way they work is heavily dependent on the sync engines' configuration. Know that if a process were to read the content of the placeholder, it would be "hydrated" (its file contents would be allocated). For more information, read [here](https://docs.microsoft.com/en-us/windows/win32/cfapi/build-a-cloud-file-sync-engine). 
 
-### I know `wincs` is maintained, but does Microsoft maintain the Cloud Filter API?
-Of course, it is used by Microsoft's very own OneDrive Client. I have reported numerous issues and received quick feedback via the [Microsoft Q&A](https://docs.microsoft.com/en-us/answers/search.html?c=7&includeChildren=false&type=question&redirect=search%2Fsearch&sort=newest&q=cfapi). There are a lot of undocumented and unimplemented portions of the API, although they are not necessary for the features described [here](#wincs).
+### I know `cloud-filter` is maintained, but does Microsoft maintain the Cloud Filter API?
+
+Of course, it is used by Microsoft's very own OneDrive Client. I have reported numerous issues and received quick feedback via the [Microsoft Q&A](https://docs.microsoft.com/en-us/answers/search.html?c=7&includeChildren=false&type=question&redirect=search%2Fsearch&sort=newest&q=cfapi). There are a lot of undocumented and unimplemented portions of the API, although they are not necessary for the features described.
+
+### Why is `cloud-filter` only for remote files?
 
-### Why is `wincs` only for remote files?
 You are more than welcome to use it for local files, although the extra features may not suit your needs. It is recommended to instead use [ProjFS](https://docs.microsoft.com/en-us/windows/win32/projfs/projected-file-system), of which is also backed by Microsoft, but dedicated to "high-speed backing data stores."
 
 ## Additional Resources
-If you are looking to contribute or want a deeper understanding of `wincs`, be sure to check out these resources:
+
+If you are looking to contribute or want a deeper understanding of `cloud-filter`, be sure to check out these resources:
 * [Build a Cloud Sync Engine that Supports Placeholder Files](https://docs.microsoft.com/en-us/windows/win32/cfapi/build-a-cloud-file-sync-engine)
 * [Integrate a Cloud Storage Provider](https://docs.microsoft.com/en-us/windows/win32/shell/integrate-cloud-storage)
 * [Microsoft Q&A Containing "cfapi"](https://docs.microsoft.com/en-us/answers/search.html?c=7&includeChildren=false&type=question&redirect=search%2Fsearch&sort=newest&q=cfapi)

examples/sftp/Cargo.toml

@@ -4,7 +4,7 @@ version = "0.1.0"
 edition = "2021"
 
 [dependencies]
-wincs = { path = "../../" }
+cloud-filter = { path = "../../" }
 widestring = "1.0.2"
 ssh2 = "0.9.4"
 thiserror = "1.0.30"