`v1` version support define a parachain with a single collator using
`[parachain.collator]` (note this is a map and not a sequence). But in
the `sdk` we drop support in favor of always use a vec<NodeConfig>. This
pr allow to use the old toml definition __only__ with the load_from_toml
method.

cc:  @AlexD10S

WIP

---------

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

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

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

A follow-up of #171 with the same motivation.

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

fix #143

- Add `custom_parchain_fs_prefix` parameter to `add_para` fn (on running
network), this allow to manage the fs layout and allow to add paras with
the same id.
- Minor clippy auto-fixes

cc: @metricaez

---------

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

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 lists some issues and suggested fixes for them (feel free to
pick them up separately and close this PR):

In addition to issues outlined in
https://github.com/paritytech/zombienet-sdk/issues/117#issuecomment-1867941395,
here are some issues spotted when writing
https://github.com/paritytech/disabling-e2e-tests:
- runtime genesis patch is applied incorrectly (extra `/genesis` pointer
shouldn't be added)
- malus accepts
[subcommands](https://github.com/paritytech/polkadot-sdk/blob/4c0e0e071355c1048d75fba538c96c35ac743547/polkadot/zombienet_tests/functional/0008-dispute-old-finalized.toml#L25),
having a command with spaces not supported, so I added a subcommand
support
- some types need to be exported in order to be able to reuse
setup/helper functions across multiple tests
- test cleanup doesn't always work (zombie polkadot processes - not
fixed here)

---------

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)

Changes to publish `0.1.0-alpha.0` version.

just wanted to throw a quick implementation that exposes the
OnclineClient on the node.
This would make the sdk super useful to enable cross chain e2e tests in
ink!

---------

Co-authored-by: Javier Viola <pepoviola@gmail.com>

In order to ensure that backward compatibility with existing node
Zombienet, this PR migrates (as a start) a [simple example of a test
from
Polkadot-SDK](https://github.com/paritytech/polkadot-sdk/blob/0a6dfdf973b8e7b669eda6e2ed202fb3549a20b9/polkadot/zombienet_tests/smoke/0001-parachains-smoke-test.toml),
and fixes some bugs in order to make the test work;

- Added genesis_overrides fields to RelaychainConfig and ParachainConfig
builders and added logic to merge it into the specs being created

* 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>