Skip to content

Commit 9a732bd

Browse files
Publish new build of docs
1 parent a1dfb59 commit 9a732bd

File tree

7 files changed

+58
-70
lines changed

7 files changed

+58
-70
lines changed

dev/_sources/events/index.rst.txt

Lines changed: 13 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -415,33 +415,39 @@ FileSelected
415415

416416
* ``name``: the file's name
417417
* ``path``: the file's path within its storage location
418-
* ``origin``: the origin storage location of the file, either ``local`` or ``sdcard``
418+
* ``origin``: the origin storage location of the file, either ``local`` or ``printer``
419419

420420
.. versionchanged:: 1.4.0
421421

422422
FileDeselected
423423
No file is selected any more for printing.
424424

425425
TransferStarted
426-
A file transfer to the printer's SD has started.
426+
A file transfer to the printer's storage has started.
427427

428428
Payload:
429429

430-
* ``local``: the file's name as stored locally
431-
* ``remote``: the file's name as stored on SD
430+
* ``remote``: the file's name as stored on the printer
432431

433432
**Note:** Name changed in version 1.1.0
434433

435434
.. versionchanged:: 1.1.0
436435

436+
.. versionchanged:: 2.0.0
437+
438+
Deprecated ``local`` payload, it's always the same as ``remote``.
439+
437440
TransferDone
438-
A file transfer to the printer's SD has finished.
441+
A file transfer to the printer's storage has finished.
439442

440443
Payload:
441444

442445
* ``time``: the time it took for the transfer to complete in seconds
443-
* ``local``: the file's name as stored locally
444-
* ``remote``: the file's name as stored on SD
446+
* ``remote``: the file's name as stored on the printer
447+
448+
.. versionchanged:: 2.0.0
449+
450+
Deprecated ``local`` payload, it's always the same as ``remote``.
445451

446452
.. _sec-events-available_events-printing:
447453

dev/api/job.html

Lines changed: 33 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1731,47 +1731,52 @@ <h3 id="job-information-response"><span id="sec-api-job-datamodel-response"></sp
17311731
<td><p>Last modification date of the file being printed as timestamp</p></td>
17321732
<td><p><em>unset</em></p></td>
17331733
</tr>
1734-
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">job.estimatedPrintTime</span></code></p></td>
1734+
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">job.file.upload</span></code></p></td>
1735+
<td><p><code class="docutils literal notranslate"><span class="pre">bool</span></code></p></td>
1736+
<td><p>Whether this file is currently being uploaded (true) or already available on the storage (false)</p></td>
1737+
<td><p><em>unset</em></p></td>
1738+
</tr>
1739+
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">job.estimatedPrintTime</span></code></p></td>
17351740
<td><p><code class="docutils literal notranslate"><span class="pre">float</span></code></p></td>
17361741
<td><p>Estimated print time in seconds, if known</p></td>
17371742
<td><p><em>unset</em></p></td>
17381743
</tr>
1739-
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">job.filament</span></code></p></td>
1744+
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">job.filament</span></code></p></td>
17401745
<td><p><code class="docutils literal notranslate"><span class="pre">dict[str,</span> <span class="pre">Optional[dict[str,</span> <span class="pre">float]]]</span></code></p></td>
17411746
<td><p>Filament usage information as mapping from printer profile to mappings from tool to used length, if known</p></td>
17421747
<td><p><em>unset</em></p></td>
17431748
</tr>
1744-
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">job.user</span></code></p></td>
1749+
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">job.user</span></code></p></td>
17451750
<td><p><code class="docutils literal notranslate"><span class="pre">str</span></code></p></td>
17461751
<td><p>The user who started the job, if known</p></td>
17471752
<td><p><em>unset</em></p></td>
17481753
</tr>
1749-
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">progress.*</span></code></p></td>
1754+
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">progress.*</span></code></p></td>
17501755
<td></td>
17511756
<td><p>Information about the current job’s progress</p></td>
17521757
<td></td>
17531758
</tr>
1754-
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">progress.completion</span></code></p></td>
1759+
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">progress.completion</span></code></p></td>
17551760
<td><p><code class="docutils literal notranslate"><span class="pre">int</span></code></p></td>
17561761
<td><p>Completion in percentage, if known</p></td>
17571762
<td><p><em>unset</em></p></td>
17581763
</tr>
1759-
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">progress.filepos</span></code></p></td>
1764+
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">progress.filepos</span></code></p></td>
17601765
<td><p><code class="docutils literal notranslate"><span class="pre">int</span></code></p></td>
17611766
<td><p>Current file position, if known</p></td>
17621767
<td><p><em>unset</em></p></td>
17631768
</tr>
1764-
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">progress.printTime</span></code></p></td>
1769+
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">progress.printTime</span></code></p></td>
17651770
<td><p><code class="docutils literal notranslate"><span class="pre">int</span></code></p></td>
17661771
<td><p>Print time so far</p></td>
17671772
<td><p><em>unset</em></p></td>
17681773
</tr>
1769-
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">progress.printTimeLeft</span></code></p></td>
1774+
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">progress.printTimeLeft</span></code></p></td>
17701775
<td><p><code class="docutils literal notranslate"><span class="pre">int</span></code></p></td>
17711776
<td><p>Estimated print time left</p></td>
17721777
<td><p><em>unset</em></p></td>
17731778
</tr>
1774-
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">progress.printTimeLeftOrigin</span></code></p></td>
1779+
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">progress.printTimeLeftOrigin</span></code></p></td>
17751780
<td><p><code class="docutils literal notranslate"><span class="pre">str</span></code></p></td>
17761781
<td><p>Origin of estimate.</p>
17771782
<p>E.g.:</p>
@@ -1787,12 +1792,12 @@ <h3 id="job-information-response"><span id="sec-api-job-datamodel-response"></sp
17871792
</td>
17881793
<td><p><em>unset</em></p></td>
17891794
</tr>
1790-
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">state</span></code></p></td>
1795+
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">state</span></code></p></td>
17911796
<td><p><code class="docutils literal notranslate"><span class="pre">str</span></code></p></td>
17921797
<td><p>Current state</p></td>
17931798
<td><p><em>required</em></p></td>
17941799
</tr>
1795-
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">error</span></code></p></td>
1800+
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">error</span></code></p></td>
17961801
<td><p><code class="docutils literal notranslate"><span class="pre">str</span></code></p></td>
17971802
<td><p>Error, if any</p></td>
17981803
<td><p><em>unset</em></p></td>
@@ -1855,52 +1860,57 @@ <h3 id="job-information-response-pre-1-12-0"><span id="sec-api-job-datamodel-res
18551860
<td><p>Last modification date of the file being printed as timestamp</p></td>
18561861
<td><p><em>unset</em></p></td>
18571862
</tr>
1858-
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">job.estimatedPrintTime</span></code></p></td>
1863+
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">job.file.upload</span></code></p></td>
1864+
<td><p><code class="docutils literal notranslate"><span class="pre">bool</span></code></p></td>
1865+
<td><p>Whether this file is currently being uploaded (true) or already available on the storage (false)</p></td>
1866+
<td><p><em>unset</em></p></td>
1867+
</tr>
1868+
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">job.estimatedPrintTime</span></code></p></td>
18591869
<td><p><code class="docutils literal notranslate"><span class="pre">float</span></code></p></td>
18601870
<td><p>Estimated print time in seconds, if known</p></td>
18611871
<td><p><em>unset</em></p></td>
18621872
</tr>
1863-
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">job.filament</span></code></p></td>
1873+
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">job.filament</span></code></p></td>
18641874
<td><p><code class="docutils literal notranslate"><span class="pre">dict[str,</span> <span class="pre">Optional[dict[str,</span> <span class="pre">float]]]</span></code></p></td>
18651875
<td><p>Filament usage information as mapping from printer profile to mappings from tool to used length, if known</p></td>
18661876
<td><p><em>unset</em></p></td>
18671877
</tr>
1868-
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">job.user</span></code></p></td>
1878+
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">job.user</span></code></p></td>
18691879
<td><p><code class="docutils literal notranslate"><span class="pre">str</span></code></p></td>
18701880
<td><p>The user who started the job, if known</p></td>
18711881
<td><p><em>unset</em></p></td>
18721882
</tr>
1873-
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">job.lastPrintTime</span></code></p></td>
1883+
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">job.lastPrintTime</span></code></p></td>
18741884
<td><p><code class="docutils literal notranslate"><span class="pre">float</span></code></p></td>
18751885
<td><p>The last print time in seconds</p></td>
18761886
<td><p><em>unset</em></p></td>
18771887
</tr>
1878-
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">progress.*</span></code></p></td>
1888+
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">progress.*</span></code></p></td>
18791889
<td></td>
18801890
<td><p>Information about the current job’s progress</p></td>
18811891
<td></td>
18821892
</tr>
1883-
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">progress.completion</span></code></p></td>
1893+
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">progress.completion</span></code></p></td>
18841894
<td><p><code class="docutils literal notranslate"><span class="pre">int</span></code></p></td>
18851895
<td><p>Completion in percentage, if known</p></td>
18861896
<td><p><em>unset</em></p></td>
18871897
</tr>
1888-
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">progress.filepos</span></code></p></td>
1898+
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">progress.filepos</span></code></p></td>
18891899
<td><p><code class="docutils literal notranslate"><span class="pre">int</span></code></p></td>
18901900
<td><p>Current file position, if known</p></td>
18911901
<td><p><em>unset</em></p></td>
18921902
</tr>
1893-
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">progress.printTime</span></code></p></td>
1903+
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">progress.printTime</span></code></p></td>
18941904
<td><p><code class="docutils literal notranslate"><span class="pre">int</span></code></p></td>
18951905
<td><p>Print time so far</p></td>
18961906
<td><p><em>unset</em></p></td>
18971907
</tr>
1898-
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">progress.printTimeLeft</span></code></p></td>
1908+
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">progress.printTimeLeft</span></code></p></td>
18991909
<td><p><code class="docutils literal notranslate"><span class="pre">int</span></code></p></td>
19001910
<td><p>Estimated print time left</p></td>
19011911
<td><p><em>unset</em></p></td>
19021912
</tr>
1903-
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">progress.printTimeLeftOrigin</span></code></p></td>
1913+
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">progress.printTimeLeftOrigin</span></code></p></td>
19041914
<td><p><code class="docutils literal notranslate"><span class="pre">str</span></code></p></td>
19051915
<td><p>Origin of estimate.</p>
19061916
<p>E.g.:</p>
@@ -1916,12 +1926,12 @@ <h3 id="job-information-response-pre-1-12-0"><span id="sec-api-job-datamodel-res
19161926
</td>
19171927
<td><p><em>unset</em></p></td>
19181928
</tr>
1919-
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">state</span></code></p></td>
1929+
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">state</span></code></p></td>
19201930
<td><p><code class="docutils literal notranslate"><span class="pre">str</span></code></p></td>
19211931
<td><p>Current state</p></td>
19221932
<td><p><em>required</em></p></td>
19231933
</tr>
1924-
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">error</span></code></p></td>
1934+
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">error</span></code></p></td>
19251935
<td><p><code class="docutils literal notranslate"><span class="pre">str</span></code></p></td>
19261936
<td><p>Error, if any</p></td>
19271937
<td><p><em>unset</em></p></td>

dev/events/index.html

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1264,32 +1264,36 @@ <h3 id="file-handling"><span id="sec-events-available-events-file-handling"></sp
12641264
<ul class="simple">
12651265
<li><p><code class="docutils literal notranslate"><span class="pre">name</span></code>: the file’s name</p></li>
12661266
<li><p><code class="docutils literal notranslate"><span class="pre">path</span></code>: the file’s path within its storage location</p></li>
1267-
<li><p><code class="docutils literal notranslate"><span class="pre">origin</span></code>: the origin storage location of the file, either <code class="docutils literal notranslate"><span class="pre">local</span></code> or <code class="docutils literal notranslate"><span class="pre">sdcard</span></code></p></li>
1267+
<li><p><code class="docutils literal notranslate"><span class="pre">origin</span></code>: the origin storage location of the file, either <code class="docutils literal notranslate"><span class="pre">local</span></code> or <code class="docutils literal notranslate"><span class="pre">printer</span></code></p></li>
12681268
</ul>
12691269
<div class="admonition versionchanged">
12701270
<p class="admonition-title"><span class="versionmodified changed">Changed in version 1.4.0.</span></p>
12711271
</div>
12721272
</dd>
12731273
<dt>FileDeselected</dt><dd><p>No file is selected any more for printing.</p>
12741274
</dd>
1275-
<dt>TransferStarted</dt><dd><p>A file transfer to the printer’s SD has started.</p>
1275+
<dt>TransferStarted</dt><dd><p>A file transfer to the printer’s storage has started.</p>
12761276
<p>Payload:</p>
12771277
<ul class="simple">
1278-
<li><p><code class="docutils literal notranslate"><span class="pre">local</span></code>: the file’s name as stored locally</p></li>
1279-
<li><p><code class="docutils literal notranslate"><span class="pre">remote</span></code>: the file’s name as stored on SD</p></li>
1278+
<li><p><code class="docutils literal notranslate"><span class="pre">remote</span></code>: the file’s name as stored on the printer</p></li>
12801279
</ul>
12811280
<p><strong>Note:</strong> Name changed in version 1.1.0</p>
12821281
<div class="admonition versionchanged">
12831282
<p class="admonition-title"><span class="versionmodified changed">Changed in version 1.1.0.</span></p>
12841283
</div>
1284+
<div class="admonition versionchanged">
1285+
<p class="admonition-title"><span class="versionmodified changed">Changed in version 2.0.0: </span>Deprecated <code class="docutils literal notranslate"><span class="pre">local</span></code> payload, it’s always the same as <code class="docutils literal notranslate"><span class="pre">remote</span></code>.</p>
1286+
</div>
12851287
</dd>
1286-
<dt>TransferDone</dt><dd><p>A file transfer to the printer’s SD has finished.</p>
1288+
<dt>TransferDone</dt><dd><p>A file transfer to the printer’s storage has finished.</p>
12871289
<p>Payload:</p>
12881290
<ul class="simple">
12891291
<li><p><code class="docutils literal notranslate"><span class="pre">time</span></code>: the time it took for the transfer to complete in seconds</p></li>
1290-
<li><p><code class="docutils literal notranslate"><span class="pre">local</span></code>: the file’s name as stored locally</p></li>
1291-
<li><p><code class="docutils literal notranslate"><span class="pre">remote</span></code>: the file’s name as stored on SD</p></li>
1292+
<li><p><code class="docutils literal notranslate"><span class="pre">remote</span></code>: the file’s name as stored on the printer</p></li>
12921293
</ul>
1294+
<div class="admonition versionchanged">
1295+
<p class="admonition-title"><span class="versionmodified changed">Changed in version 2.0.0: </span>Deprecated <code class="docutils literal notranslate"><span class="pre">local</span></code> payload, it’s always the same as <code class="docutils literal notranslate"><span class="pre">remote</span></code>.</p>
1296+
</div>
12931297
</dd>
12941298
</dl>
12951299
<h3 id="printing"><span id="sec-events-available-events-printing"></span>Printing<a class="headerlink" href="#printing" title="Link to this heading"></a></h3>

dev/genindex.html

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3612,8 +3612,6 @@ <h2 id="R">R</h2>
36123612
</li>
36133613
</ul></li>
36143614
<li><a href="modules/schema.html#octoprint.schema.config.feature.FeatureConfig.rememberFileFolder">rememberFileFolder (octoprint.schema.config.feature.FeatureConfig attribute)</a>
3615-
</li>
3616-
<li><a href="modules/printer.html#octoprint.printer.job.UploadJob.remote_path">remote_path (octoprint.printer.job.UploadJob attribute)</a>
36173615
</li>
36183616
<li><a href="modules/schema.html#octoprint.schema.config.access_control.AccessControlConfig.remoteGroupsHeader">remoteGroupsHeader (octoprint.schema.config.access_control.AccessControlConfig attribute)</a>
36193617
</li>

dev/modules/index.html

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2347,7 +2347,6 @@ <h1 id="internal-modules"><span id="sec-modules"></span>Internal Modules<a class
23472347
</li>
23482348
<li class="toctree-l2"><a class="reference internal" href="printer.html#octoprint.printer.job.UploadJob">octoprint.printer.job.UploadJob</a><ul>
23492349
<li class="toctree-l3"><a class="reference internal" href="printer.html#octoprint.printer.job.UploadJob-config">Config</a></li>
2350-
<li class="toctree-l3"><a class="reference internal" href="printer.html#octoprint.printer.job.UploadJob.remote_path">remote_path</a></li>
23512350
</ul>
23522351
</li>
23532352
</ul>

dev/modules/printer.html

Lines changed: 0 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -11691,30 +11691,6 @@
1169111691

1169211692

1169311693

11694-
11695-
11696-
11697-
11698-
11699-
11700-
11701-
<li class="md-nav__item">
11702-
<a href="#octoprint.printer.job.UploadJob.remote_path" class="md-nav__link">
11703-
11704-
11705-
11706-
<span class="md-ellipsis">
11707-
<span title="octoprint.printer.job.UploadJob.remote_path (Python field)"><span>remote_<wbr>path</span></span>
11708-
11709-
</span>
11710-
11711-
11712-
</a>
11713-
</li>
11714-
11715-
11716-
11717-
1171811694
</ul>
1171911695
</nav>
1172011696

@@ -21440,11 +21416,6 @@ <h1 id="module-octoprint.printer.job"><span id="octoprint-printer-job"></span><s
2144021416
</ul>
2144121417
</dd>
2144221418
</dl>
21443-
<dl class="py attribute pydantic_field objdesc">
21444-
<dt class="sig sig-object highlight py" id="octoprint.printer.job.UploadJob.remote_path">
21445-
<em class="property"><span class="pre">field</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">remote_path</span></span><span class="p"> <span class="pre">:</span> </span><span class="desctype"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.14)"><span class="pre">str</span></a><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.14)"><span class="pre">None</span></a></span><span class="p"> <span class="pre">=</span> </span><code class="code python docutils literal highlight highlight-python"><span class="kc">None</span></code><a class="headerlink" href="#octoprint.printer.job.UploadJob.remote_path" title="Link to this definition">¶</a></dt>
21446-
<dd></dd></dl>
21447-
2144821419
</dd></dl>
2144921420

2145021421
<h1 id="module-octoprint.printer.profile"><span id="octoprint-printer-profile"></span><span id="sec-modules-printer-profile"></span>octoprint.printer.profile<a class="headerlink" href="#module-octoprint.printer.profile" title="Link to this heading">¶</a></h1>

dev/searchindex.js

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)