v0.3.1

Author: tom-pytel

CHANGELOG.md

@@ -1,4 +1,4 @@
-## 0.3.1 - alpha - ????-??-??
+## 0.3.1 - alpha - 2026-03-13
 
 ### Added
 

README.md

@@ -2,7 +2,7 @@
 
 **High-level Python AST manipulation that preserves formatting**
 
-[![PyPI version](https://img.shields.io/badge/pypi-0.3.0-orange.svg)](https://pypi.org/project/pfst/)
+[![PyPI version](https://img.shields.io/badge/pypi-0.3.1-orange.svg)](https://pypi.org/project/pfst/)
 [![Python versions](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14%20%7C%203.15a-blue.svg)](https://www.python.org/)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)
 

VERSION

@@ -1 +1 @@
-0.3.1.dev202603121952
+0.3.1

docs/fst.html

@@ -31,9 +31,6 @@ <h2>API Documentation</h2>
             <li>
                     <a class="class" href="#NodeError">NodeError</a>
                             <ul class="memberlist">
-                        <li>
-                                <a class="variable" href="#NodeError.rawable">rawable</a>
-                        </li>
                 </ul>
 
             </li>
@@ -149,17 +146,6 @@ <h1 class="modulename">
 </div>
 
 
-                            <div id="NodeError.rawable" class="classattr">
-                                <div class="attr variable">
-            <span class="name">rawable</span><span class="annotation">: bool</span>
-
-        
-    </div>
-    <a class="headerlink" href="#NodeError.rawable"></a>
-    
-    
-
-                            </div>
                 </section>
                 <section id="astfield">
                     <div class="attr class">

docs/fst/common.html

@@ -59,7 +59,7 @@ <h1 class="modulename">
 
                         <div class="docstring"><p>This is rather crude documentation that hopefully can show usage through many small examples.</p>
 
-<p><code><a href="docs/d01_parse.html">fst.docs.d01_parse</a></code>: Parse and unparse from source or <code>AST</code></p>
+<p><code><a href="docs/d01_parse.html">fst.docs.d01_parse</a></code>: Parse and unparse from source or AST</p>
 
 <p><code><a href="docs/d02_locations.html">fst.docs.d02_locations</a></code>: Node locations in the source code</p>
 

docs/fst/docs.html

@@ -26,7 +26,7 @@
 
             <h2>Contents</h2>
             <ul>
-  <li><a href="#parse-and-unparse-from-source-or-ast">Parse and unparse from source or <code>AST</code></a>
+  <li><a href="#parse-and-unparse-from-source-or-ast">Parse and unparse from source or AST</a>
   <ul>
     <li><a href="#parse">Parse</a></li>
     <li><a href="#basic-structure">Basic structure</a></li>
@@ -36,6 +36,7 @@ <h2>Contents</h2>
     <li><a href="#from-fst-nodes">From <code>FST</code> nodes</a></li>
     <li><a href="#underlying-functions">Underlying functions</a></li>
     <li><a href="#source">Source</a></li>
+    <li><a href="#parse_ast"><code>parse_ast()</code></a></li>
   </ul></li>
 </ul>
 
@@ -55,7 +56,7 @@ <h2>Contents</h2>
                     <h1 class="modulename">
 <a href="./../../fst.html">fst</a><wbr>.<a href="./../docs.html">docs</a><wbr>.d01_parse    </h1>
 
-                        <div class="docstring"><h1 id="parse-and-unparse-from-source-or-ast">Parse and unparse from source or <code>AST</code></h1>
+                        <div class="docstring"><h1 id="parse-and-unparse-from-source-or-ast">Parse and unparse from source or AST</h1>
 
 <p>To be able to execute the examples, import this.</p>
 
@@ -551,6 +552,33 @@ <h2 id="source">Source</h2>
 <span class="go">             .operand Name &#39;a&#39; Load - 4,15..4,16</span>
 </code></pre>
 </div>
+
+<h2 id="parse_ast"><code>parse_ast()</code></h2>
+
+<p>The <code>FST</code> class makes its internal extended <code>AST</code> parsing available via the <code>FST.parse_ast()</code> function. This allows
+parsing individual nodes as pure <code>AST</code> (without any <code>FST</code> nodes added) that are otherwise unparsable by themselves by
+the standard <code>ast</code> module.</p>
+
+<div class="pdoc-code codehilite">
+<pre><span></span><code><span class="gp">&gt;&gt;&gt; </span><span class="nb">print</span><span class="p">(</span><span class="n">dump</span><span class="p">(</span><span class="n">FST</span><span class="o">.</span><span class="n">parse_ast</span><span class="p">(</span><span class="s1">&#39;except Exception: pass&#39;</span><span class="p">)))</span>
+<span class="go">ExceptHandler(type=Name(id=&#39;Exception&#39;, ctx=Load()), body=[Pass()])</span>
+</code></pre>
+</div>
+
+<div class="pdoc-code codehilite">
+<pre><span></span><code><span class="gp">&gt;&gt;&gt; </span><span class="nb">print</span><span class="p">(</span><span class="n">dump</span><span class="p">(</span><span class="n">FST</span><span class="o">.</span><span class="n">parse_ast</span><span class="p">(</span><span class="s1">&#39;kw=value&#39;</span><span class="p">,</span> <span class="s1">&#39;keyword&#39;</span><span class="p">)))</span>
+<span class="go">keyword(arg=&#39;kw&#39;, value=Name(id=&#39;value&#39;, ctx=Load()))</span>
+</code></pre>
+</div>
+
+<div class="pdoc-code codehilite">
+<pre><span></span><code><span class="gp">&gt;&gt;&gt; </span><span class="nb">print</span><span class="p">(</span><span class="n">dump</span><span class="p">(</span><span class="n">FST</span><span class="o">.</span><span class="n">parse_ast</span><span class="p">(</span><span class="s1">&#39;upper:lower:step&#39;</span><span class="p">,</span> <span class="n">Slice</span><span class="p">),</span> <span class="n">indent</span><span class="o">=</span><span class="mi">2</span><span class="p">))</span>
+<span class="go">Slice(</span>
+<span class="go">  lower=Name(id=&#39;upper&#39;, ctx=Load()),</span>
+<span class="go">  upper=Name(id=&#39;lower&#39;, ctx=Load()),</span>
+<span class="go">  step=Name(id=&#39;step&#39;, ctx=Load()))</span>
+</code></pre>
+</div>
 </div>