📦️
package_json_schema
Load a
package.json
file as a PackageJsonstruct
.
Why?
You want to load a package.json
file and interact with it as a struct.
Installation
Add this line to the [dependencies]
section of your Cargo.toml
:
package_json_schema = "0.1.0"
If you would like to include validation then add the validate
feature.
package_json_schema = { version = "0.1.0", features = ["validate"] }
This adds the validator
crate as a dependency and adds the .validate()
method to the PackageJson
struct. The fields are validated according to the JSON schema specification.
Usage
The following example shows how to load a package.json
file and use it as a struct.
use package_json_schema::PackageJson;
let contents = r###"
{
"name": "my-package",
"version": "0.1.0",
"dependencies": {
"@sveltejs/kit": "1.0.0-next.396"
},
"peerDependencies": {
"aws-sdk": "2.1185.0"
}
}
"###;
let package_json = PackageJson::try_from(contents).unwrap();
assert_eq!(package_json.name.unwrap(), "my-package");
assert_eq!(package_json.version.unwrap(), "0.1.0");
This crate leaves it to the user to load the package.json
content from the filesystem. Here is an example of loading the file contents and parsing the contents into a struct.
use std::fs::read_to_string;
use package_json_schema::PackageJson;
let contents = read_to_string("./tests/fixtures/1/package.json").unwrap();
let package_json = PackageJson::try_from(contents).unwrap();
assert_eq!(package_json.name.unwrap(), "test");
A package.json
file can also be created from a builder.
use package_json_schema::PackageJson;
use package_json_schema::AdditionalFields;
use package_json_schema::Person;
use indexmap::IndexMap;
let mut additional_fields: AdditionalFields = IndexMap::new();
additional_fields.insert("custom".into(), "value".into());
let package_json = PackageJson::builder()
.name("awesome")
.author(Person::String("Tester".into()))
.other(additional_fields)
.build();
let string_value = package_json.try_to_string().unwrap();
assert_eq!(
string_value,
r#"{"name":"awesome","author":"Tester","custom":"value"}"#
);
To validate the package.json
fields, enable the validate
feature.
package_json_schema = { version = "0.1.0", features = ["validate"] }
And then use the validate
method.
use std::fs::read_to_string;
use package_json_schema::PackageJson;
#[cfg(feature = "validate")]
use validator::Validate;
let contents = read_to_string("./tests/fixtures/1/package.json").unwrap();
let package_json = PackageJson::try_from(contents).unwrap();
#[cfg(feature = "validate")]
package_json.validate().unwrap();
License
This project is licensed under the Unlicense license.