Fix documentation on docs.rs (#11)

* Fix documentation on docs.rs

* Fix ci pipeline

eric-bindings/CHANGELOG.md

@@ -6,6 +6,11 @@
 - changed
 - removed
 
+## v0.4.1 (2024-08-07)
+
+- changed
+  - Fix publishing on docs.rs
+
 ## v0.4.0 (2024-08-07)
 
 - added

eric-bindings/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "eric-bindings"
-version = "0.4.0"
+version = "0.4.1"
 authors.workspace = true
 edition.workspace = true
 readme.workspace = true
@@ -13,14 +13,20 @@ keywords = ["eric", "bindings",  "taxes", "accounting"]
 categories = ["external-ffi-bindings"]
 build = "build.rs"
 
+[lib]
+path = "src/lib.rs"
+name = "eric_bindings"
+
+[package.metadata.docs.rs]
+features = ["docs-rs"]
+
 [features]
 default = []
 generate-bindings = ["dep:bindgen"]
+# This feature is used in CI pipeline for unit tests.
 no-linking = []
-
-[lib]
-path = "src/lib.rs"
-name = "eric_bindings"
+# This feature is used to publish the documentation for `eric-bindings`.
+docs-rs = []
 
 [dependencies]
 anyhow = { workspace = true }

eric-bindings/build.rs

@@ -29,13 +29,20 @@ pub fn main() -> io::Result<()> {
     generate_bindings()?;
 
     #[cfg(not(feature = "generate-bindings"))]
-    select_bindings()?;
+    {
+        #[cfg(not(feature = "docs-rs"))]
+        select_bindings()?;
+
+        #[cfg(feature = "docs-rs")]
+        select_bindings_for_docs_rs()?;
+    }
 
     Ok(())
 }
 
 /// Select existing bindings
 #[cfg(not(feature = "generate-bindings"))]
+#[cfg(not(feature = "docs-rs"))]
 fn select_bindings() -> io::Result<()> {
     let target_arch = std::env::var("CARGO_CFG_TARGET_ARCH").expect("Set by cargo");
     let is_windows = std::env::var("CARGO_CFG_WINDOWS").is_ok();
@@ -126,3 +133,24 @@ fn generate_bindings() -> io::Result<()> {
 
     Ok(())
 }
+
+/// Select latest bindings for documentation on docs.rs
+#[cfg(feature = "docs-rs")]
+fn select_bindings_for_docs_rs() -> io::Result<()> {
+    let bindings_file = "bindings_eric_40_1_8_0_linux_x86_64.rs";
+
+    let root_dir = std::env::var("CARGO_MANIFEST_DIR").expect("Set by cargo");
+    let bindings_path = Path::new(&root_dir).join("bindings").join(bindings_file);
+
+    let out_dir = env::var("OUT_DIR").expect("Can't read environment variable 'OUT_DIR'");
+    let bindings_target = PathBuf::from(out_dir).join("bindings.rs");
+
+    std::fs::copy(bindings_path.clone(), bindings_target.clone()).unwrap_or_else(|_| {
+        panic!(
+            "Can't copy file from {} to {}",
+            bindings_path.display(),
+            bindings_target.display(),
+        )
+    });
+    Ok(())
+}

eric-sdk/CHANGELOG.md

@@ -6,6 +6,11 @@
 - changed
 - removed
 
+## v0.3.1 (2024-08-07)
+
+- changed
+  - Fix publishing on docs.rs
+
 ## v0.3.0 (2024-08-07)
 
 - added

eric-sdk/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "eric-sdk"
-version = "0.3.0"
+version = "0.3.1"
 authors.workspace = true
 edition.workspace = true
 readme.workspace = true
@@ -16,13 +16,19 @@ categories = ["finance"]
 path = "src/lib.rs"
 name = "eric_sdk"
 
+[package.metadata.docs.rs]
+features = ["docs-rs"]
+
 [features]
 default = []
-no-linking = ["eric-bindings/no-linking"]
 external-test = []
+# This feature is used in CI pipeline for unit tests.
+no-linking = ["eric-bindings/no-linking"]
+# This feature is used to publish the documentation for `eric-sdk`.
+docs-rs = ["eric-bindings/docs-rs"]
 
 [dependencies]
-eric-bindings = { version = "0.4.0", path = "../eric-bindings" }
+eric-bindings = { version = "0.4.1", path = "../eric-bindings" }
 anyhow = { workspace = true }
 
 [dev-dependencies]