Added:
  - Helper to perform a runtime upgrade on the relaychain
 
```rust
    let wasm = "file_path__or__url_to_*.compact.compressed.wasm";
    network
        .relaychain()
        .runtime_upgrade(RuntimeUpgradeOptions::new(wasm.into()))
        .await?;
```

Fixes:
- `wait` methods for metrics
- `path` checking for `native` provider validation.

- Add binaries verification to
`validate_spec_with_provider_capabilities`
- Improve error display in providers.

Change exports.

@rzadp @Bullrich

This pr introduce the ability to set the `base_dir` used by the
`namespace`. This allow users to reuse the same node's directories
(config and database) and re-start the network from the latest state in
sequential runs.

Thx!

fix #218

cc @sandreim thanks for the suggestion :)

Couple of fixes for docker provider and to use an external tool to build
the chain-spec.

Fix https://github.com/paritytech/zombienet-sdk/issues/169

- Add logic to retrieve available args from node before spawning the
full network using the output of the command with --help

Add:
 - Logic to use db_snapshot in both native/k8s providers
 - Small fix on chain_spec_path (for both native/k8s)
 - New example `db_snapshot`

Add small validation, mostly to ensure that the `image` is set in k8s.

fix #143

Add: Manual variant to `RegistrationStrategy`, allow to deploy the
collators _but_ not register the para.
Fix: `created_paths` in native provider
Fix: Use `rpc` port for ws connections (orchestrator)

This PR introduces the Kubernetes Provider for the SDK, with the use of
kube.rs for common operation and a custom file server using axum to
transfer files back and forth the nodes.

https://github.com/paritytech/zombienet-sdk/issues/35

This also includes the refacto of the native provider to reflect changes
to the provider structure with weak references and simplifying the use
of abstractions

---------

Co-authored-by: Javier Viola <pepoviola@gmail.com>
Co-authored-by: Javier Viola <javier@parity.io>
Co-authored-by: Javier Viola <363911+pepoviola@users.noreply.github.com>

This pr make possible to add a new parachain to a running network (see
`add_para.rs` example), for that we allow to create a new parachain
config (using the same builder but in a different context) like this:

```rs
let para_config = network.para_config_builder()
        .with_id(100)
        .with_default_command("polkadot-parachain")
        .with_collator(|c| {
            c.with_name("col-100-1")
        })
        .build()?;
```
And then deploy that parachain by calling `add_parachain` (the second
parameter of the fn allow to use a custom chain-spec for the
relaychain).

```rs
network.add_parachain(&para_config, None).await?;
```

// TODO:
- [x] docs
- [ ] test (integration)

- Add `pjs-rs` support and mimic the
[javascript](https://polkadot.js.org/apps/#/js) tab from polkadot.js
apps/
- Allow to use an external file or just an string with the `js/ts` code,

TODO: We should implement integration tests for this feature.

Fix parachain spec filename (local) to use when we spawn collators.
Also, adding `Context` to spawner to improve error reporting.

cc @pgherveou



---------

Co-authored-by: PG Herveou <pgherveou@gmail.com>

Adding `tracing` and replace all the `println`. We should add more info
in a followup pr.
Thx!

Following up on take 1
https://github.com/paritytech/zombienet-sdk/pull/124

Apart from better logs, I realize that one of the only thing missing now
for us to start consuming this project is a top level package available
(with it's dependencies) on crates.io. This PR serves mainly as a
discussion point to get there.
It would be great if we could publish an early version (0.0.1?) on
crates.io so that we can start using this asap.

Register the parachains (that aren't included in the genesis) after we
run the verifier and remove the need for using sleep.
Thx!

- Split native provider into multiple smaller files and each with their
respective tests
- Update ProviderNode.command() to ProviderNode.program()
- Update ProviderNamespace.id() to ProviderNamespace.name()

Fixes #106

---------

Co-authored-by: Javier Viola <javier@parity.io>

* wip, refactor provider trait

* fmt

* wip

* wip, add from_config to NetworkSpec

* config reorgs

* add logic for create NetworkSpec

* feat: refactored FileSystem trait and errors

* chore: removed unused local_file, stdout will be hardcoded in provider at the moment

* feat: moved MockFileSystem to InMemoryFileSystem, files too, and added mirror implementation of tokio::fs with tests

* feat: added new method append to FileSystem trait

* feat: implemented new append method on InMemoryFileSystem

* feat: added anyhow dependencies to support crate

* feat: refactored FileSystem trait to expose only a single wrapped error

* feat: refacto InMemoryFileSystem following FileSystem trait refacto

* feat: added conversion between io::Error and FileSystemError

* feat: added implementation of LocalFileSystem using tokio::fs

* feat: added nix crate dependency to workspace and provider crate

* feat: added uuid with v4 as dev-dependencies for testing in support crate

* feat: added unit tests for LocalFileSystem

* feat: updated Provider, ProviderNamespace and ProviderNode traits and related DTO

* feat: added anyhow as dependency to provider crate

* feat: updated ProviderError

* feat: work on NativeProvider with individual Node, Namespace and Provider struct threadsafe using RwLock and Arc, added implementation logic of resume/restart/pause, destroy and helpers for logs

* feat: rename some provider constants

* wip

* feat: added uuid with v4 features as normal dependency

* feat: added new set_mode method on FileSystem trait to modify permissions bits, added implementations and tests

* feat: added builder for options types used in provider traits methods, moved error next to provider traits

* feat: added modified implementation of run_script/run_command/copy_from_node in NativeProvider, removed unused comments

* feat: moved filesystem, capabilities and tmp_dir out of NativeProviderInner

* wip on network spec creation

* move chain_spec to generators

* change defaults for validator/invulnerable settings

* Add test and clean-ups

* nits and clean

* fmt

* fmt

* fix docs/clippy

* fixes from clippy

* add TODO and allow dead_code for now

* fmt

* more nits

* fmt

* feat: make constructors and fields public for testing on InMemoryFileSystem

* feat: removed unused types atm and added TransferedFile

* feat: updated types for Provider methods output, updated non needed async methods

* feat: added generate_files implementation on namespace using temporary nodes, moved some non mutable fields out of inners

* feat: removed comment

* feat: refactored provider types and added builders

* feat(orchestrator) add generators

* feat(orchestrator) add logic to compute the network spec

* small changes in provider trait and native impl

* wip, example to drive exec

* make paras working, first design draft of network public api

* cleanups

* add spawner

* add logic to add new nodes to running network and methods on nodes

* modify example

* fmt

* allow to add collators to a running network

* modify example

* move Network related structs

* reorg code

* fmt

* fixes and clean-up

* removed commented code

* clippy

* fmt

* clippy

* fmt

* clippy in example

* fix validator/invulnerable true as default

* fmt

* fix base_dir for mac/linux compat

* fix, allow generate files with fullpaths (encapsualate as part of the ns)

* Add todos

* fix p2p port for full_node in collator

* fix p2p port for full_node in collator

* clippy

* fmt

* Update crates/orchestrator/src/network_spec/node.rs

Co-authored-by: Loris Moulin <45130584+l0r1s@users.noreply.github.com>

* Update crates/orchestrator/src/network_spec/relaychain.rs

Co-authored-by: Loris Moulin <45130584+l0r1s@users.noreply.github.com>

* Update crates/orchestrator/src/generators/chain_spec.rs

Co-authored-by: Nikos Kontakis <wirednkod@gmail.com>

* Update crates/examples/examples/small_network_with_default.rs

Co-authored-by: Loris Moulin <45130584+l0r1s@users.noreply.github.com>

* Update crates/orchestrator/src/generators/bootnode_addr.rs

Co-authored-by: Loris Moulin <45130584+l0r1s@users.noreply.github.com>

* Update crates/orchestrator/src/network_spec/node.rs

Co-authored-by: Loris Moulin <45130584+l0r1s@users.noreply.github.com>

* Update crates/orchestrator/src/network_spec/node.rs

Co-authored-by: Loris Moulin <45130584+l0r1s@users.noreply.github.com>

* Update crates/orchestrator/src/network_spec/relaychain.rs

Co-authored-by: Loris Moulin <45130584+l0r1s@users.noreply.github.com>

* changes from feedback

* reorg deps

* clippy/fmt

* reorg generators and add some unittest

* more unittest and cleans

* fmt/clippy

* fmt/clippy

* add TODOs from feedback

---------

Co-authored-by: l0r1s <contact@lorismoulin.com>
Co-authored-by: Loris Moulin <45130584+l0r1s@users.noreply.github.com>
Co-authored-by: Nikos Kontakis <wirednkod@gmail.com>