Merge pull request #101 from AstroTechies/better_readme

Better READMEs
AstroTechies · Sep 21, 2023 · fa96f1d · fa96f1d
2 parents 3a4a5ff + a2aa446
commit fa96f1d
Show file tree

Hide file tree

Showing 11 changed files with 64 additions and 23 deletions.
diff --git a/LICENSE b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 AstroTechies
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/unreal_asset/Cargo.toml b/unreal_asset/Cargo.toml
@@ -4,7 +4,8 @@ version.workspace = true
 authors.workspace = true
 description = "Unreal Engine 4/5 game asset serialization library."
 license.workspace = true
-homepage.workspace = true
+repository.workspace = true
+homepage = "https://github.com/AstroTechies/unrealmodding/tree/main/unreal_asset"
 documentation = "https://docs.rs/unreal_asset"
 edition = "2021"
 exclude = ["tests/*"]

diff --git a/unreal_asset/README.md b/unreal_asset/README.md
@@ -1,16 +1,22 @@
 # unreal_asset
 
-The unreal_asset crate is a Rust library that allows parsing of Unreal Engine binary asset files.
+[![Documentation](https://docs.rs/unreal_asset/badge.svg)](https://docs.rs/unreal_asset/)
+[![Crates.io](https://img.shields.io/crates/v/unreal_asset.svg)](https://crates.io/crates/unreal_asset)
+[![Build status](https://github.com/AstroTechies/unrealmodding/workflows/CI/badge.svg)](https://github.com/AstroTechies/unrealmodding/actions?query=workflow%3ACI)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+The `unreal_asset` crate is a Rust library that allows parsing of Unreal Engine binary asset files.
 
 ## Documentation
 
-Crate documentation is published to
-[docs.rs/unreal_asset](https://docs.rs/unreal_asset/).
+Crate documentation is published to [docs.rs/unreal_asset](https://docs.rs/unreal_asset/).
 
 ## Unreal Engine binary asset files
 
 Unreal Engine binary asset files are usually stored with the following extensions:
-* `.uasset` - The file that has asset metadata as well as some information, if the game is built without split bulk data files, then it also contains all of asset data.
+
+* `.uasset` - The file that has asset metadata as well as some information, if the game is built without split bulk
+  data files, then it also contains all of asset data.
 * `.uexp` - If the game is built with split bulk data files, it contains binary data related to components, etc.
 * `.umap` - Same as `.uasset` but for maps/levels.
 * `.usmap` - Mapping files for reading unversioned assets.
@@ -19,8 +25,7 @@ These files are what stores most of the game's assets and what you might want to
 
 ## Usage
 
-The crate can be added to a Rust project as a dependency by running the command
-`cargo add unreal_asset`.
+The crate can be added to a Rust project as a dependency by running the command `cargo add unreal_asset`.
 
 ## Features
 

diff --git a/unreal_asset/unreal_asset_base/Cargo.toml b/unreal_asset/unreal_asset_base/Cargo.toml
@@ -4,7 +4,8 @@ version.workspace = true
 authors.workspace = true
 description = "Base unreal_asset implementations"
 license.workspace = true
-homepage.workspace = true
+repository.workspace = true
+homepage = "https://github.com/AstroTechies/unrealmodding/tree/main/unreal_asset/unreal_asset_base"
 documentation = "https://docs.rs/unreal_asset_base"
 edition = "2021"
 

diff --git a/unreal_asset/unreal_asset_exports/Cargo.toml b/unreal_asset/unreal_asset_exports/Cargo.toml
@@ -4,7 +4,8 @@ version.workspace = true
 authors.workspace = true
 description = "Exports implementations for unreal_asset"
 license.workspace = true
-homepage.workspace = true
+repository.workspace = true
+homepage = "https://github.com/AstroTechies/unrealmodding/tree/main/unreal_asset/unreal_asset_exports"
 documentation = "https://docs.rs/unreal_asset_exports"
 edition = "2021"
 

diff --git a/unreal_asset/unreal_asset_kismet/Cargo.toml b/unreal_asset/unreal_asset_kismet/Cargo.toml
@@ -4,7 +4,8 @@ version.workspace = true
 authors.workspace = true
 description = "Kismet implementations for unreal_asset"
 license.workspace = true
-homepage.workspace = true
+repository.workspace = true
+homepage = "https://github.com/AstroTechies/unrealmodding/tree/main/unreal_asset/unreal_asset_kismet"
 documentation = "https://docs.rs/unreal_asset_kismet"
 edition = "2021"
 

diff --git a/unreal_asset/unreal_asset_proc_macro/Cargo.toml b/unreal_asset/unreal_asset_proc_macro/Cargo.toml
@@ -4,8 +4,9 @@ version.workspace = true
 authors.workspace = true
 description = "Proc macro implementations for unreal_asset"
 license.workspace = true
-homepage.workspace = true
-documentation = "https://docs.rs/unreal_asset"
+repository.workspace = true
+homepage = "https://github.com/AstroTechies/unrealmodding/tree/main/unreal_asset/unreal_asset_proc_macro"
+documentation = "https://docs.rs/unreal_asset_proc_macro"
 edition = "2021"
 
 [lib]

diff --git a/unreal_asset/unreal_asset_properties/Cargo.toml b/unreal_asset/unreal_asset_properties/Cargo.toml
@@ -4,7 +4,8 @@ version.workspace = true
 authors.workspace = true
 description = "Properties implementations for unreal_asset"
 license.workspace = true
-homepage.workspace = true
+repository.workspace = true
+homepage = "https://github.com/AstroTechies/unrealmodding/tree/main/unreal_asset/unreal_asset_properties"
 documentation = "https://docs.rs/unreal_asset_properties"
 edition = "2021"
 

diff --git a/unreal_asset/unreal_asset_registry/Cargo.toml b/unreal_asset/unreal_asset_registry/Cargo.toml
@@ -4,7 +4,8 @@ version.workspace = true
 authors.workspace = true
 description = "Asset registry implementations for unreal_asset"
 license.workspace = true
-homepage.workspace = true
+repository.workspace = true
+homepage = "https://github.com/AstroTechies/unrealmodding/tree/main/unreal_asset/unreal_asset_registry"
 documentation = "https://docs.rs/unreal_asset_registry"
 edition = "2021"
 

diff --git a/unreal_helpers/Cargo.toml b/unreal_helpers/Cargo.toml
@@ -4,7 +4,8 @@ version.workspace = true
 authors.workspace = true
 description.workspace = true
 license.workspace = true
-homepage.workspace = true
+repository.workspace = true
+homepage = "https://github.com/AstroTechies/unrealmodding/tree/main/unreal_helpers"
 documentation = "https://docs.rs/unreal_helpers"
 edition = "2021"
 

diff --git a/unreal_helpers/README.md b/unreal_helpers/README.md
@@ -1,22 +1,29 @@
 # unreal_helpers
 
-The unreal_helpers crate is a Rust library that implements common functionality for reading Unreal Engine files.
+[![Documentation](https://docs.rs/unreal_helpers/badge.svg)](https://docs.rs/unreal_helpers/)
+[![Crates.io](https://img.shields.io/crates/v/unreal_helpers.svg)](https://crates.io/crates/unreal_helpers)
+[![Build status](https://github.com/AstroTechies/unrealmodding/workflows/CI/badge.svg)](https://github.com/AstroTechies/unrealmodding/actions?query=workflow%3ACI)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](../LICENSE)
+
+The `unreal_helpers` crate is a Rust library that implements common functionality for reading Unreal Engine files.
 
 ## Documentation
 
-Crate documentation is published to
-[docs.rs/unreal_helpers](https://docs.rs/unreal_helpers/).
+Crate documentation is published to [docs.rs/unreal_helpers](https://docs.rs/unreal_helpers/).
 
 ## Usage
 
-The crate can be added to a Rust project as a dependency by running the command
-`cargo add unreal_helpers`.
+The crate can be added to a Rust project as a dependency by running the command `cargo add unreal_helpers`.
 
 ## Features
 
-* `read_write` - enables read/write extensions for unreal binary files
-* `bitvec` - enables bitvec extensions commonly used when working with unreal bitvecs
-* `path` - enables path conversion extensions used to convert paths in pak files
+All content in this crate is hidden behind feature flags. Enabling most features will also enable further dependencies.
+
+* `read_write`: Enables extension Traits `UnrealReadExt` and `UnrealWriteExt` which help with parsing Unreal data formats.
+* `path`: Enables `game_to_absolute` function.
+* `guid`: Enables `Guid` type.
+* `serde`: Enables `serde` support for `Guid` type.
+* `bitvec`: Enables extension Trait `BitVecExt`.
 
 ## Examples