caisin/typst
1
0
Fork 0
mirror of https://github.com/typst/typst synced 2025-08-14 23:18:32 +08:00
Code Issues Packages Projects Releases Wiki Activity

Style nits

Browse Source
This commit is contained in:
Laurenz 2025-03-11 11:43:09 +01:00
parent 82ffc61d59
commit 2464ff3e93
1 changed files with 18 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
crates/typst-kit/src/package.rs
View File

@ -194,9 +194,8 @@ impl PackageStorage {
}; };
// Temporary place where the package will be extracted before being // Temporary place where the package will be extracted before being
// moved to the target directory. // moved to the target directory. To avoid name clashing we use a PRNG
// // to get a unique directory name.
// To avoid name clashing we use PRNG to get unique directory name.
let extracted_package_dir = package_base_dir.join(format!( let extracted_package_dir = package_base_dir.join(format!(
".tmp-{}-{}-{}", ".tmp-{}-{}-{}",
spec.name, spec.name,
@ -204,21 +203,21 @@ impl PackageStorage {
fastrand::u32(..), fastrand::u32(..),
)); ));
let create_dir = |dir, dir_name| { let create_dir = |dir: &Path, dir_name| {
fs::create_dir_all(dir).map_err(|err| { fs::create_dir_all(dir).map_err(|err| {
PackageError::Other(Some(eco_format!( PackageError::Other(Some(eco_format!(
"failed to create a {dir_name} directory ({err})" "failed to create {dir_name} directory ({err})"
))) )))
}) })
}; };
create_dir(extracted_package_dir.as_path(), "temporary package")?; create_dir(&extracted_package_dir, "temporary package")?;
create_dir(package_dir, "package")?; create_dir(package_dir, "package")?;
let removed_download_dir = || { let remove_download_dir = || {
fs::remove_dir_all(&extracted_package_dir).map_err(|err| { fs::remove_dir_all(&extracted_package_dir).map_err(|err| {
PackageError::Other(Some(eco_format!( PackageError::Other(Some(eco_format!(
"failed to remove a temporary package directory: {err}" "failed to remove temporary package directory ({err})"
))) )))
}) })
}; };
@ -227,17 +226,17 @@ impl PackageStorage {
tar::Archive::new(decompressed) tar::Archive::new(decompressed)
.unpack(&extracted_package_dir) .unpack(&extracted_package_dir)
.map_err(|err| { .map_err(|err| {
let message = match removed_download_dir() { let message = match remove_download_dir() {
Err(PackageError::Other(Some(str))) => eco_format!("{err}\n{str}"), Err(PackageError::Other(Some(str))) => eco_format!("{err}\n{str}"),
_ => eco_format!("{err}"), _ => eco_format!("{err}"),
}; };
PackageError::MalformedArchive(Some(message)) PackageError::MalformedArchive(Some(message))
})?; })?;
// As to not overcomplicate the code base to combat an already rare case // As to not overcomplicate the code to combat an already rare case
// where multiple instances try to download the same package version // where multiple instances try to download the same package version
// concurrently, we are abusing the behavior of the `rename` FS operation // concurrently, we are abusing the behavior of the `rename` FS
// without the help of file locking. // operation without the help of file locking.
// //
// From the function's documentation it is stated that: // From the function's documentation it is stated that:
// //
@ -247,27 +246,27 @@ impl PackageStorage {
// live we are (trying our best) making sure that `extracted_package_dir` // live we are (trying our best) making sure that `extracted_package_dir`
// and `package_dir` are on the same mount point. // and `package_dir` are on the same mount point.
// //
// When trying to move (i.e., `rename`) directory from one place to // When trying to move (i.e., `rename`) the directory from one place to
// another and the target/destination directory name is empty, then the // another and the target/destination directory is empty, then the
// operation will succeed (if it's atomic, or hardware doesn't fail, or // operation will succeed (if it's atomic, or hardware doesn't fail, or
// power doesn't go off, etc.). If however the target directory is not // power doesn't go off, etc.). If however the target directory is not
// empty, i.e., other instance already successfully moved the package, // empty, i.e., another instance already successfully moved the package,
// then we can safely ignore the `DirectoryNotEmpty` error. // then we can safely ignore the `DirectoryNotEmpty` error.
// //
// This means that we do not check the integrity of the existing moved // This means that we do not check the integrity of the existing moved
// package in a very rare case where it is broken, as it does not // package in a very rare case where it is broken, as it does not
// (currently) justify the additional code complexity. If such situation // (currently) justify the additional code complexity. If such situation
// occur and it will be reported, then we probably would consider a // occur and it will be reported, then we probably would consider a
// better solution (i.e., file locking or checksums). // more comprehensive solution (i.e., file locking or checksums).
match fs::rename(&extracted_package_dir, package_dir) { match fs::rename(&extracted_package_dir, package_dir) {
Ok(()) => Ok(()), Ok(()) => Ok(()),
Err(err) if err.kind() == std::io::ErrorKind::DirectoryNotEmpty => { Err(err) if err.kind() == std::io::ErrorKind::DirectoryNotEmpty => {
removed_download_dir() remove_download_dir()
} }
Err(err) => { Err(err) => {
removed_download_dir()?; remove_download_dir()?;
Err(PackageError::Other(Some(eco_format!( Err(PackageError::Other(Some(eco_format!(
"failed to move the downloaded package directory: {err}" "failed to move the downloaded package directory ({err})"
)))) ))))
} }
} }