Skip to content

Commit

Permalink
docs: update 'en/latest' docs built at 37c0753
Browse files Browse the repository at this point in the history
  • Loading branch information
h4l committed Dec 30, 2024
1 parent 3f2a99e commit 475a346
Show file tree
Hide file tree
Showing 19 changed files with 1,926 additions and 750 deletions.
6 changes: 3 additions & 3 deletions en/latest/howto/use_at_a_glance.html
Original file line number Diff line number Diff line change
Expand Up @@ -256,7 +256,7 @@ <h1 class="title">How to use at a glance</h1>
<p>For more details, see <a href="../tutorials/js_to_py.html">the tutorials</a>.</p>
<section id="serialize-with-python" class="level2" data-number="1">
<h2 data-number="1" class="anchored" data-anchor-id="serialize-with-python"><span class="header-section-number">1</span> Serialize with Python</h2>
<div id="40d7d86d" class="cell" data-execution_count="1">
<div id="43bcbb72" class="cell" data-execution_count="1">
<div class="sourceCode cell-code" id="cb1"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true" tabindex="-1"></a><span class="im">from</span> base64 <span class="im">import</span> b64encode</span>
<span id="cb1-2"><a href="#cb1-2" aria-hidden="true" tabindex="-1"></a><span class="im">from</span> datetime <span class="im">import</span> datetime, UTC</span>
<span id="cb1-3"><a href="#cb1-3" aria-hidden="true" tabindex="-1"></a><span class="im">import</span> re</span>
Expand All @@ -283,13 +283,13 @@ <h2 data-number="1" class="anchored" data-anchor-id="serialize-with-python"><spa
<span id="cb1-24"><a href="#cb1-24" aria-hidden="true" tabindex="-1"></a></span>
<span id="cb1-25"><a href="#cb1-25" aria-hidden="true" tabindex="-1"></a><span class="bu">print</span>(b64encode(serialized).decode())</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
<div class="cell-output cell-output-stdout">
<pre><code>/w9BDFMUc3RyaW5ncyDwn6e18J+ntvCfqqFVezBfQQNBAlUAUwFhJAACQQJVAVMBYiQAAkECVZWa7zpTBnNwYXJzZSQAAiQAA29TA21zZ1MCSGl7AUIDwP/uWiIAAAAAAAAAAAAAAAAAAAAAATtTBG1hcHNUOgInUwN5ZXNTBHNldHMsAlJTBV5cdyskgAJEAABAHyXMeEIkAAw=</code></pre>
<pre><code>/w9BDFMUc3RyaW5ncyDwn6e18J+ntvCfqqFVezBfQQNBAlUAUwFhJAACQQJVAVMBYiQAAkECVZWa7zpTBnNwYXJzZSQAAiQAA29TA21zZ1MCSGl7AUIDwP/uWiIAAAAAAAAAAAAAAAAAAAAAATtTBG1hcHNUOgInUwRzZXRzUwN5ZXMsAlJTBV5cdyskgAJEAABAHyXMeEIkAAw=</code></pre>
</div>
</div>
</section>
<section id="deserialize-with-python" class="level2" data-number="2">
<h2 data-number="2" class="anchored" data-anchor-id="deserialize-with-python"><span class="header-section-number">2</span> Deserialize with Python</h2>
<div id="a7a08933" class="cell" data-execution_count="2">
<div id="a30d2590" class="cell" data-execution_count="2">
<div class="sourceCode cell-code" id="cb3"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a><span class="im">from</span> base64 <span class="im">import</span> b64decode</span>
<span id="cb3-2"><a href="#cb3-2" aria-hidden="true" tabindex="-1"></a><span class="im">from</span> v8serialize <span class="im">import</span> loads</span>
<span id="cb3-3"><a href="#cb3-3" aria-hidden="true" tabindex="-1"></a></span>
Expand Down
22 changes: 11 additions & 11 deletions en/latest/reference/api_constants.html
Original file line number Diff line number Diff line change
Expand Up @@ -390,21 +390,21 @@ <h1>API Constants</h1>
</section>
<section id="v8serialize.SerializationFeature" class="level1">
<h1>SerializationFeature</h1>
<p><code>SerializationFeature()</code></p>
<div class="sourceCode" id="cb1"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true" tabindex="-1"></a>SerializationFeature()</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
<p>Changes to serialization within format versions that affect compatibility.</p>
<p>V8 makes changes to its serialization format without bumping the version number, and these changes affect backwards compatibility by making versions before the change unable to deserialize data encoded by versions with the change.</p>
<p>(Based on comments in V8’s value-serializer.cc code) V8’s compatibility policy is that data written by older versions must be deserializable by newer versions, but does not require that data written by newer versions is deserializable by older versions. To remain compatible with older versions, it’s necessary to avoid writing data with features newer than the earliest version of V8 that needs to read serialized data.</p>
<p>In general, only writing features that existed at the point that a new format version was released will ensure that all V8 versions will continue to be able to read the data in the future.</p>
<p>This flag names the format changes that have occurred, to allow enabling and disabling support for them when encoding data.</p>
<section id="examples" class="level2">
<h2 class="anchored" data-anchor-id="examples">Examples</h2>
<div class="sourceCode" id="cb1"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true" tabindex="-1"></a><span class="op">&gt;&gt;&gt;</span> SerializationFeature.MaxCompatibility.first_v8_version</span>
<span id="cb1-2"><a href="#cb1-2" aria-hidden="true" tabindex="-1"></a><span class="op">&lt;</span>Version(<span class="st">'10.0.29'</span>)<span class="op">&gt;</span></span>
<span id="cb1-3"><a href="#cb1-3" aria-hidden="true" tabindex="-1"></a><span class="op">&gt;&gt;&gt;</span> version <span class="op">=</span> SerializationFeature.CircularErrorCause.first_v8_version</span>
<span id="cb1-4"><a href="#cb1-4" aria-hidden="true" tabindex="-1"></a><span class="op">&gt;&gt;&gt;</span> version</span>
<span id="cb1-5"><a href="#cb1-5" aria-hidden="true" tabindex="-1"></a><span class="op">&lt;</span>Version(<span class="st">'12.1.109'</span>)<span class="op">&gt;</span></span>
<span id="cb1-6"><a href="#cb1-6" aria-hidden="true" tabindex="-1"></a><span class="op">&gt;&gt;&gt;</span> <span class="bu">list</span>(SerializationFeature.supported_by(v8_version<span class="op">=</span>version))</span>
<span id="cb1-7"><a href="#cb1-7" aria-hidden="true" tabindex="-1"></a>[<span class="op">&lt;</span>SerializationFeature.RegExpUnicodeSets: <span class="dv">1</span><span class="op">&gt;</span>, <span class="op">&lt;</span>SerializationFeature.ResizableArrayBuffers: <span class="dv">2</span><span class="op">&gt;</span>, <span class="op">&lt;</span>SerializationFeature.CircularErrorCause: <span class="dv">4</span><span class="op">&gt;</span>]</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
<section id="examples" class="level2 doc-section doc-section-examples">
<h2 class="doc-section doc-section-examples anchored" data-anchor-id="examples">Examples</h2>
<div class="sourceCode" id="cb2"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb2-1"><a href="#cb2-1" aria-hidden="true" tabindex="-1"></a><span class="op">&gt;&gt;&gt;</span> SerializationFeature.MaxCompatibility.first_v8_version</span>
<span id="cb2-2"><a href="#cb2-2" aria-hidden="true" tabindex="-1"></a><span class="op">&lt;</span>Version(<span class="st">'10.0.29'</span>)<span class="op">&gt;</span></span>
<span id="cb2-3"><a href="#cb2-3" aria-hidden="true" tabindex="-1"></a><span class="op">&gt;&gt;&gt;</span> version <span class="op">=</span> SerializationFeature.CircularErrorCause.first_v8_version</span>
<span id="cb2-4"><a href="#cb2-4" aria-hidden="true" tabindex="-1"></a><span class="op">&gt;&gt;&gt;</span> version</span>
<span id="cb2-5"><a href="#cb2-5" aria-hidden="true" tabindex="-1"></a><span class="op">&lt;</span>Version(<span class="st">'12.1.109'</span>)<span class="op">&gt;</span></span>
<span id="cb2-6"><a href="#cb2-6" aria-hidden="true" tabindex="-1"></a><span class="op">&gt;&gt;&gt;</span> <span class="bu">list</span>(SerializationFeature.supported_by(v8_version<span class="op">=</span>version))</span>
<span id="cb2-7"><a href="#cb2-7" aria-hidden="true" tabindex="-1"></a>[<span class="op">&lt;</span>SerializationFeature.RegExpUnicodeSets: <span class="dv">1</span><span class="op">&gt;</span>, <span class="op">&lt;</span>SerializationFeature.ResizableArrayBuffers: <span class="dv">2</span><span class="op">&gt;</span>, <span class="op">&lt;</span>SerializationFeature.CircularErrorCause: <span class="dv">4</span><span class="op">&gt;</span>]</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
</section>
<section id="attributes" class="level2">
<h2 class="anchored" data-anchor-id="attributes">Attributes</h2>
Expand Down Expand Up @@ -463,7 +463,7 @@ <h2 class="anchored" data-anchor-id="methods">Methods</h2>
</section>
<section id="v8serialize.SymbolicVersion" class="level1">
<h1>SymbolicVersion</h1>
<p><code>SymbolicVersion()</code></p>
<div class="sourceCode" id="cb3"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a>SymbolicVersion()</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div>
<section id="attributes-1" class="level2">
<h2 class="anchored" data-anchor-id="attributes-1">Attributes</h2>
<table class="caption-top table">
Expand Down
Loading

0 comments on commit 475a346

Please sign in to comment.