pathlibutil 0.3.2__tar.gz → 0.3.4__tar.gz

pathlibutil-0.3.2/README.md → pathlibutil-0.3.4/PKG-INFO

@@ -1,3 +1,27 @@
+Metadata-Version: 2.1
+Name: pathlibutil
+Version: 0.3.4
+Summary: inherits from pathlib.Path with methods for hashing, copying, deleting and more
+License: MIT
+Keywords: pathlib,hashlib,shutil,urllib.parse,json,urlpath
+Author: Christoph Dörrer
+Author-email: d-chris@web.de
+Requires-Python: >=3.8.1,<4.0.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.8
+Provides-Extra: 7z
+Requires-Dist: py7zr (>=0.20.2) ; extra == "7z"
+Project-URL: documentation, https://d-chris.github.io/pathlibutil
+Project-URL: repository, https://github.com/d-chris/pathlibutil
+Description-Content-Type: text/markdown
+
 <!--
 filename: ./README.md
 -->
@@ -49,7 +73,8 @@ Parse and modify URLs with `pathlibutil.urlpath`.
 
 - `pathlibutil.urlpath.UrlPath()` modify URL and easy access the `path` of the url like a `pathlib.PurePosixPath` object.
 - `pathlibutil.urlpath.UrlNetloc()` to parse and modify the `netloc` part of a URL.
-- `pathlibutil.urlpath.normalize_url()` to normalize a URL string.
+- `pathlibutil.urlpath.normalize()` to normalize a URL string.
+- `pathlibutil.urlpath.url_from()` to create a URL from an UNC path object.
 
 
 ## Installation
@@ -296,4 +321,93 @@ os.getcwd is                    K:/pathlibutil
 Path.cwd(frozen=True) is        K:/pathlibutil/examples
 Path.cwd(frozen=False) is       K:/pathlibutil
 Path.cwd(frozen=_MEIPASS) is    C:/Users/CHRIST~1.DOE/AppData/Local/Temp/_MEI106042
-```
+```
+
+## Example 7
+
+Console application to convert UNC paths to intranet URLs.
+
+By default, it checks if the filename and URL are available and copies the
+normalized URL to the clipboard.
+
+> `pathlibutil.urlpath.url_from()`
+
+```python
+import argparse
+import sys
+
+try:
+    import pyperclip
+
+    import pathlibutil.urlpath as up
+except ModuleNotFoundError as e:
+    raise ModuleNotFoundError(f"pip install {e.name.split('.')[0]}") from e
+
+
+def intranet_from(uncpath: str, check: bool = True) -> str:
+    """
+    Return the intranet URL for the given UNC path.
+    """
+
+    url = up.url_from(
+        uncpath,
+        hostname="http://intranet.example.de",
+        strict=check,
+    )
+
+    return url.normalize()
+
+
+def cli():
+
+    parser = argparse.ArgumentParser(
+        description=intranet_from.__doc__,
+        formatter_class=argparse.ArgumentDefaultsHelpFormatter,
+    )
+
+    parser.add_argument(
+        "filename",
+        nargs="*",
+        help="The UNC path to the file.",
+    )
+    parser.add_argument(
+        "-c",
+        "--no-check",
+        action="store_false",
+        dest="check",
+        help="Don't check if filename and url is available.",
+    )
+    parser.add_argument(
+        "-s",
+        "--silent",
+        action="store_true",
+        help="Do not print the url to stdout.",
+    )
+    parser.add_argument(
+        "-n",
+        "--no-clip",
+        action="store_false",
+        dest="clip",
+        help="Don't copy the url to the clipboard.",
+    )
+
+    args = parser.parse_args()
+    filename = " ".join(args.filename)
+
+    url = intranet_from(filename, check=args.check)
+
+    if not args.silent:
+        print(url)
+
+    if args.clip:
+        pyperclip.copy(url)
+
+
+if __name__ == "__main__":
+    try:
+        cli()
+    except Exception as e:
+        print(e, file=sys.stderr)
+        sys.exit(1)
+```
+

pathlibutil-0.3.2/PKG-INFO → pathlibutil-0.3.4/README.md

@@ -1,28 +1,3 @@
-Metadata-Version: 2.1
-Name: pathlibutil
-Version: 0.3.2
-Summary: inherits from pathlib.Path with methods for hashing, copying, deleting and more
-Home-page: https://d-chris.github.io
-License: MIT
-Keywords: pathlib,hashlib,shutil,urllib.parse
-Author: Christoph Dörrer
-Author-email: d-chris@web.de
-Requires-Python: >=3.8.1,<4.0.0
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.8
-Provides-Extra: 7z
-Requires-Dist: py7zr (>=0.20.2,<0.21.0) ; extra == "7z"
-Project-URL: Documentation, https://d-chris.github.io/pathlibutil
-Project-URL: Repository, https://github.com/d-chris/pathlibutil
-Description-Content-Type: text/markdown
-
 <!--
 filename: ./README.md
 -->
@@ -74,7 +49,8 @@ Parse and modify URLs with `pathlibutil.urlpath`.
 
 - `pathlibutil.urlpath.UrlPath()` modify URL and easy access the `path` of the url like a `pathlib.PurePosixPath` object.
 - `pathlibutil.urlpath.UrlNetloc()` to parse and modify the `netloc` part of a URL.
-- `pathlibutil.urlpath.normalize_url()` to normalize a URL string.
+- `pathlibutil.urlpath.normalize()` to normalize a URL string.
+- `pathlibutil.urlpath.url_from()` to create a URL from an UNC path object.
 
 
 ## Installation
@@ -322,3 +298,91 @@ Path.cwd(frozen=True) is        K:/pathlibutil/examples
 Path.cwd(frozen=False) is       K:/pathlibutil
 Path.cwd(frozen=_MEIPASS) is    C:/Users/CHRIST~1.DOE/AppData/Local/Temp/_MEI106042
 ```
+
+## Example 7
+
+Console application to convert UNC paths to intranet URLs.
+
+By default, it checks if the filename and URL are available and copies the
+normalized URL to the clipboard.
+
+> `pathlibutil.urlpath.url_from()`
+
+```python
+import argparse
+import sys
+
+try:
+    import pyperclip
+
+    import pathlibutil.urlpath as up
+except ModuleNotFoundError as e:
+    raise ModuleNotFoundError(f"pip install {e.name.split('.')[0]}") from e
+
+
+def intranet_from(uncpath: str, check: bool = True) -> str:
+    """
+    Return the intranet URL for the given UNC path.
+    """
+
+    url = up.url_from(
+        uncpath,
+        hostname="http://intranet.example.de",
+        strict=check,
+    )
+
+    return url.normalize()
+
+
+def cli():
+
+    parser = argparse.ArgumentParser(
+        description=intranet_from.__doc__,
+        formatter_class=argparse.ArgumentDefaultsHelpFormatter,
+    )
+
+    parser.add_argument(
+        "filename",
+        nargs="*",
+        help="The UNC path to the file.",
+    )
+    parser.add_argument(
+        "-c",
+        "--no-check",
+        action="store_false",
+        dest="check",
+        help="Don't check if filename and url is available.",
+    )
+    parser.add_argument(
+        "-s",
+        "--silent",
+        action="store_true",
+        help="Do not print the url to stdout.",
+    )
+    parser.add_argument(
+        "-n",
+        "--no-clip",
+        action="store_false",
+        dest="clip",
+        help="Don't copy the url to the clipboard.",
+    )
+
+    args = parser.parse_args()
+    filename = " ".join(args.filename)
+
+    url = intranet_from(filename, check=args.check)
+
+    if not args.silent:
+        print(url)
+
+    if args.clip:
+        pyperclip.copy(url)
+
+
+if __name__ == "__main__":
+    try:
+        cli()
+    except Exception as e:
+        print(e, file=sys.stderr)
+        sys.exit(1)
+```

{pathlibutil-0.3.2 → pathlibutil-0.3.4}/pathlibutil/__init__.py

@@ -5,4 +5,11 @@
 from pathlibutil.path import Path, Register7zFormat
 from pathlibutil.types import ByteInt, StatResult, TimeInt, byteint
 
-__all__ = ["Path", "Register7zFormat", "ByteInt", "byteint", "TimeInt", "StatResult"]
+__all__ = [
+    "Path",
+    "Register7zFormat",
+    "ByteInt",
+    "byteint",
+    "TimeInt",
+    "StatResult",
+]