moved docs artifacts again

Author: apoorvkh

docs/source/examples/artifacts/accelerate_help.txt renamed to docs/source/artifacts/accelerate_help.txt

@@ -0,0 +1,36 @@
+usage: -c [-h] [OPTIONS]
+
+For configuring the function launch environment.
+
+╭─ options ──────────────────────────────────────────────────────────────────╮
+│ -h, --help                                                                 │
+│     show this help message and exit                                        │
+│ --hostnames {[STR [STR ...]]}|{auto,slurm}                                 │
+│     Nodes on which to launch the function. By default, infer from          │
+│     localhost or SLURM. (default: auto)                                    │
+│ --workers-per-host INT|{[INT [INT ...]]}|{auto}                            │
+│     Number of processes to run per node. By default, number of GPUs per    │
+│     host. (default: auto)                                                  │
+│ --ssh-config-file {None}|STR|PATHLIKE                                      │
+│     For connecting to nodes. By default, ``"~/.ssh/config"`` or            │
+│     ``"/etc/ssh/ssh_config"``. (default: None)                             │
+│ --backend {None,nccl,gloo,mpi,ucc,auto}                                    │
+│     `Backend                                                               │
+│     <https://pytorch.org/docs/stable/distributed.html#torch.distributed.B… │
+│             for worker process group or ``None``. By default, NCCL if GPUs │
+│     detected, else GLOO. (default: auto)                                   │
+│ --timeout INT                                                              │
+│     Worker process group timeout (seconds). (default: 600)                 │
+│ --copy-env-vars [STR [STR ...]]                                            │
+│     Environment variables to copy from the launcher process to workers.    │
+│     Supports Unix pattern matching syntax. (default: PATH LD_LIBRARY       │
+│     LIBRARY_PATH 'PYTHON*' 'CUDA*' 'TORCH*' 'PYTORCH*' 'NCCL*')            │
+│ --extra-env-vars {None}|{[STR STR [STR STR ...]]}                          │
+│     Additional environment variables to load onto workers. (default: None) │
+│ --env-file {None}|STR|PATHLIKE                                             │
+│     Path to a ``.env`` file, containing environment variables to load onto │
+│     workers. (default: None)                                               │
+│ --propagate-exceptions, --no-propagate-exceptions                          │
+│     Whether to raise specific worker exceptions or                         │
+│     :exc:`torchrunx.WorkerFailedError`. (default: True)                    │
+╰────────────────────────────────────────────────────────────────────────────╯

docs/source/artifacts/cli_help.txt

@@ -8,7 +8,7 @@ Here's an example script that uses `torchrunx` with [Accelerate](https://hugging
   <summary><p style="display: inline-block;"><code class="docutils literal notranslate"><span class="pre">python accelerate_train.py --help</span></code></p> (expand)</summary>
 
   ```{eval-rst}
-  .. literalinclude:: ./artifacts/accelerate_help.txt
+  .. literalinclude:: ../artifacts/accelerate_help.txt
   ```
 </details>
 

docs/source/examples/artifacts/deepspeed_help.txt renamed to docs/source/artifacts/deepspeed_help.txt

@@ -8,7 +8,7 @@ Here's an example script that uses `torchrunx` with [DeepSpeed](https://www.deep
   <summary><p style="display: inline-block;"><code class="docutils literal notranslate"><span class="pre">python deepspeed_train.py --help</span></code></p> (expand)</summary>
 
   ```{eval-rst}
-  .. literalinclude:: ./artifacts/deepspeed_help.txt
+  .. literalinclude:: ../artifacts/deepspeed_help.txt
   ```
 </details>
 

docs/source/examples/artifacts/lightning_help.txt renamed to docs/source/artifacts/lightning_help.txt

@@ -8,7 +8,7 @@ Here's an example script that uses `torchrunx` with [PyTorch Lightning](https://
   <summary><p style="display: inline-block;"><code class="docutils literal notranslate"><span class="pre">python lightning_train.py --help</span></code></p> (expand)</summary>
 
   ```{eval-rst}
-  .. literalinclude:: ./artifacts/lightning_help.txt
+  .. literalinclude:: ../artifacts/lightning_help.txt
   ```
 </details>
 

docs/source/examples/artifacts/transformers_help.txt renamed to docs/source/artifacts/transformers_help.txt

@@ -8,7 +8,7 @@ Here's an example script that uses `torchrunx` with [`transformers.Trainer`](htt
   <summary><p style="display: inline-block;"><code class="docutils literal notranslate"><span class="pre">python transformers_train.py --help</span></code></p> (expand)</summary>
 
   ```{eval-rst}
-  .. literalinclude:: ./artifacts/transformers_help.txt
+  .. literalinclude:: ../artifacts/transformers_help.txt
   ```
 </details>
 

docs/source/examples/accelerate.md

@@ -1,6 +1,6 @@
 # CLI Integration
 
-We can automatically populate {mod}`torchrunx.Launcher` arguments using most CLI tools (those that generate interfaces from Data Classes, e.g. [tyro](https://brentyi.github.io/tyro/)):
+We can automatically populate {mod}`torchrunx.Launcher` arguments using most CLI tools, e.g. [`tyro`](https://brentyi.github.io/tyro/) or any that [generate interfaces from dataclasses](https://brentyi.github.io/tyro/goals_and_alternatives).
 
 ```python
 import torchrunx
@@ -16,23 +16,7 @@ if __name__ == "__main__":
 
 `python ... --help` then results in:
 
-```bash
-╭─ options ─────────────────────────────────────────────╮
-│ -h, --help           show this help message and exit  │
-│ --hostnames {[STR [STR ...]]}|{auto,slurm}            │
-│                      (default: auto)                  │
-│ --workers-per-host INT|{[INT [INT ...]]}|{auto,slurm} │
-│                      (default: auto)                  │
-│ --ssh-config-file {None}|STR|PATH                     │
-│                      (default: None)                  │
-│ --backend {None,nccl,gloo,mpi,ucc,auto}               │
-│                      (default: auto)                  │
-│ --timeout INT        (default: 600)                   │
-│ --default-env-vars [STR [STR ...]]                    │
-│                      (default: PATH LD_LIBRARY ...)   │
-│ --extra-env-vars [STR [STR ...]]                      │
-│                      (default: )                      │
-│ --env-file {None}|STR|PATH                            │
-│                      (default: None)                  │
-╰───────────────────────────────────────────────────────╯
+```{eval-rst}
+.. literalinclude:: ../artifacts/cli_help.txt
+  :lines: 3-
 ```