Improve documentation (#449)

* cli: Remove whitespaces from readme

Signed-off-by: Alexandru Vasile <alexandru.vasile@parity.io>

* cli: Fix typo

Signed-off-by: Alexandru Vasile <alexandru.vasile@parity.io>

* subxt: Modify codegen path

Signed-off-by: Alexandru Vasile <alexandru.vasile@parity.io>

* subxt: Remove rustfmt arguments

Signed-off-by: Alexandru Vasile <alexandru.vasile@parity.io>

* cli: Update Readme

Signed-off-by: Alexandru Vasile <alexandru.vasile@parity.io>

* examples: Fix typo

Signed-off-by: Alexandru Vasile <alexandru.vasile@parity.io>

* subxt: Add Hash for WrapperKeepOpaque and PhantomDataSendSync

Signed-off-by: Alexandru Vasile <alexandru.vasile@parity.io>
This commit is contained in:
Alexandru Vasile
2022-02-14 20:01:40 +02:00
committed by GitHub
parent b1b717332e
commit 5c04b09c78
4 changed files with 14 additions and 12 deletions
+7 -7
View File
@@ -7,10 +7,10 @@ USAGE:
subxt <SUBCOMMAND>
FLAGS:
-h, --help
-h, --help
Prints help information
-V, --version
-V, --version
Prints version information
@@ -37,9 +37,9 @@ OPTIONS:
## Codegen
Use to invoke the `subxt-codegen` crate which is used by `subxt-macro` to generate the the runtime API and types. Useful
for troubleshooting codegen as an alternative to `cargo expand`, and also provides the possibility of customizing the
generated code if the macro does not produce the desired API. e.g.
Use to invoke the `subxt-codegen` crate which is used by `subxt-macro` to generate the runtime API and types. Useful
for troubleshooting codegen as an alternative to `cargo expand`, and also provides the possibility to customize the
generated code if the macro does not produce the desired API. e.g.
`subxt codegen | rustfmt --edition=2018 --emit=stdout`
@@ -48,10 +48,10 @@ USAGE:
subxt codegen [OPTIONS]
OPTIONS:
-f, --file <file>
-f, --file <file>
the path to the encoded metadata file
--url <url>
--url <url>
the url of the substrate node to query for metadata for codegen
```
+2 -2
View File
@@ -22,9 +22,9 @@
runtime_metadata_path = "examples/polkadot_metadata.scale",
// We can add (certain) custom derives to the generated types by providing
// a comma separated list to the below attribute. Most useful for adding `Clone`.
// The derives that we can add ultiamtely is limited to the traits that the base
// The derives that we can add ultimately is limited to the traits that the base
// types relied upon by the codegen implement.
generated_type_derives = "Clone, PartialEq"
generated_type_derives = "Clone, PartialEq, Hash"
)]
pub mod polkadot {}
+4 -2
View File
@@ -180,7 +180,8 @@ pub enum Phase {
Clone(bound = ""),
PartialEq(bound = ""),
Eq(bound = ""),
Default(bound = "")
Default(bound = ""),
Hash(bound = "")
)]
pub struct WrapperKeepOpaque<T> {
data: Vec<u8>,
@@ -223,7 +224,8 @@ impl<T: Decode> WrapperKeepOpaque<T> {
PartialEq(bound = ""),
Debug(bound = ""),
Eq(bound = ""),
Default(bound = "")
Default(bound = ""),
Hash(bound = "")
)]
#[scale_info(skip_type_params(T))]
#[doc(hidden)]
+1 -1
View File
@@ -20,7 +20,7 @@
/// Generate by:
///
/// - run `polkadot --dev --tmp` node locally
/// - `cargo run --release -p subxt-cli -- codegen | rustfmt --edition=2018 --emit=stdout > tests/integration/codegen/polkadot.rs`
/// - `cargo run --release -p subxt-cli -- codegen | rustfmt > subxt/tests/integration/codegen/polkadot.rs`
#[rustfmt::skip]
#[allow(clippy::all)]
mod polkadot;