Working on path

gto76 · gto76 · commit 8ebaf8f6e674 · 2019-12-22T16:07:46.000+01:00
diff --git a/README.md b/README.md
@@ -1567,6 +1567,8 @@ from glob import glob
 
 ```python
 <str>  = getcwd()                   # Returns the current working directory.
+<str>  = path.join('<path>', ...)   # Joins two or more pathname components.
+<str>  = path.abspath('<path>')     # Return an absolute path.
 ```
 
 ```python
@@ -1580,6 +1582,12 @@ from glob import glob
 <list> = glob('<pattern>')          # Returns paths matching the wildcard pattern.
 ```
 
+```python
+<str>  = path.basename('<path>')    # Returns final component.
+<str>  = path.dirname('<path>')     # Returns path without final component.
+<str>  = path.splitext('<path>')[1] # Returns final component's extension.
+```
+
 ### Pathlib
 ```python
 from pathlib import Path
@@ -1592,8 +1600,9 @@ from pathlib import Path
 
 ```python
 <Path> = Path()                     # Or: Path('.')
+<Path> = Path.cwd()                 # Returns absolute cwd. Or: Path().resolve()
 <Path> = <Path>.resolve()           # Returns absolute Path without symlinks.
-<Path> = <Path>.parent              # Returns path without final component.
+<Path> = <Path>.parent              # Returns Path without final component.
 ```
 
 ```python
@@ -1620,6 +1629,7 @@ from pathlib import Path
 ```
 
 ### DirEntry
+**Using scandir() instead of listdir() can significantly increase the performance of code that also needs file type or file attribute information.**
 ```python
 <iter> = os.scandir(path='.')       # Returns DirEntry objects located at path.
 ```
diff --git a/index.html b/index.html
@@ -1448,6 +1448,8 @@
 </code></pre></div>
 
 <pre><code class="python language-python hljs">&lt;str&gt;  = getcwd()                   <span class="hljs-comment"># Returns the current working directory.</span>
+&lt;str&gt;  = path.join(<span class="hljs-string">'&lt;path&gt;'</span>, ...)   <span class="hljs-comment"># Joins two or more pathname components.</span>
+&lt;str&gt;  = path.abspath(<span class="hljs-string">'&lt;path&gt;'</span>)     <span class="hljs-comment"># Return an absolute path.</span>
 </code></pre>
 <pre><code class="python language-python hljs">&lt;bool&gt; = path.exists(<span class="hljs-string">'&lt;path&gt;'</span>)
 &lt;bool&gt; = path.isfile(<span class="hljs-string">'&lt;path&gt;'</span>)
@@ -1456,15 +1458,20 @@
 <pre><code class="python language-python hljs">&lt;list&gt; = listdir(<span class="hljs-string">'&lt;path&gt;'</span>)          <span class="hljs-comment"># Returns filenames located at path.</span>
 &lt;list&gt; = glob(<span class="hljs-string">'&lt;pattern&gt;'</span>)          <span class="hljs-comment"># Returns paths matching the wildcard pattern.</span>
 </code></pre>
+<pre><code class="python language-python hljs">&lt;str&gt;  = path.basename(<span class="hljs-string">'&lt;path&gt;'</span>)    <span class="hljs-comment"># Returns final component.</span>
+&lt;str&gt;  = path.dirname(<span class="hljs-string">'&lt;path&gt;'</span>)     <span class="hljs-comment"># Returns path without final component.</span>
+&lt;str&gt;  = path.splitext(<span class="hljs-string">'&lt;path&gt;'</span>)[<span class="hljs-number">1</span>] <span class="hljs-comment"># Returns final component's extension.</span>
+</code></pre>
 <div><h3 id="pathlib">Pathlib</h3><pre><code class="python language-python hljs"><span class="hljs-keyword">from</span> pathlib <span class="hljs-keyword">import</span> Path
 </code></pre></div>
 
 <pre><code class="python language-python hljs">&lt;Path&gt; = Path(<span class="hljs-string">'&lt;path&gt;'</span> [, <span class="hljs-string">'&lt;path&gt;'</span>, &lt;Path&gt;, ...])
 &lt;Path&gt; = &lt;Path&gt; / <span class="hljs-string">'&lt;dir&gt;'</span> / <span class="hljs-string">'&lt;file&gt;'</span>
 </code></pre>
 <pre><code class="python language-python hljs">&lt;Path&gt; = Path()                     <span class="hljs-comment"># Or: Path('.')</span>
+&lt;Path&gt; = Path.cwd()                 <span class="hljs-comment"># Returns absolute cwd. Or: Path().resolve()</span>
 &lt;Path&gt; = &lt;Path&gt;.resolve()           <span class="hljs-comment"># Returns absolute Path without symlinks.</span>
-&lt;Path&gt; = &lt;Path&gt;.parent              <span class="hljs-comment"># Returns path without final component.</span>
+&lt;Path&gt; = &lt;Path&gt;.parent              <span class="hljs-comment"># Returns Path without final component.</span>
 </code></pre>
 <pre><code class="python language-python hljs">&lt;bool&gt; = &lt;Path&gt;.exists()
 &lt;bool&gt; = &lt;Path&gt;.is_file()
@@ -1481,9 +1488,10 @@
 </code></pre>
 <pre><code class="python language-python hljs">&lt;file&gt; = open(&lt;Path&gt;)               <span class="hljs-comment"># Opens the file and returns a file object.</span>
 </code></pre>
-<div><h3 id="direntry">DirEntry</h3><pre><code class="python language-python hljs">&lt;iter&gt; = os.scandir(path=<span class="hljs-string">'.'</span>)       <span class="hljs-comment"># Returns DirEntry objects located at path.</span>
+<div><h3 id="direntry">DirEntry</h3><p><strong>Using scandir() instead of listdir() can significantly increase the performance of code that also needs file type or file attribute information.</strong></p><pre><code class="python language-python hljs">&lt;iter&gt; = os.scandir(path=<span class="hljs-string">'.'</span>)       <span class="hljs-comment"># Returns DirEntry objects located at path.</span>
 </code></pre></div>
 
+
 <pre><code class="python language-python hljs">&lt;bool&gt; = &lt;DirEntry&gt;.is_file()
 &lt;bool&gt; = &lt;DirEntry&gt;.is_dir()
 </code></pre>
