python-startfile 0.0.1__tar.gz

python_startfile-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ChenyangGao <https://github.com/ChenyangGao>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

python_startfile-0.0.1/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.1
+Name: python-startfile
+Version: 0.0.1
+Summary: Python startfile.
+Home-page: https://github.com/ChenyangGao/web-mount-packs/tree/main/python-module/python-startfile
+License: MIT
+Keywords: startfile
+Author: ChenyangGao
+Author-email: wosiwujm@gmail.com
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+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: Topic :: Software Development
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Project-URL: Repository, https://github.com/ChenyangGao/web-mount-packs/tree/main/python-module/python-startfile
+Description-Content-Type: text/markdown
+
+# Python startfile.
+
+## Installation
+
+You can install via [pypi](https://pypi.org/project/python-startfile/)
+
+```console
+pip install -U python-startfile
+```
+
+## Usage
+
+### Module
+
+```python
+>>> from startfile import startfile, startfile_async
+```
+
+### Commad
+
+```console
+$ python -m startfile -h
+usage: startfile.py [-h] [-v] [path ...]
+
+Start file(s) with its/their associated application.
+
+positional arguments:
+  path           paths to files or directories
+
+options:
+  -h, --help     show this help message and exit
+  -v, --version  print the current version
+```
+

python_startfile-0.0.1/pyproject.toml

@@ -0,0 +1,30 @@
+[tool.poetry]
+name = "python-startfile"
+version = "0.0.1"
+description = "Python startfile."
+authors = ["ChenyangGao <wosiwujm@gmail.com>"]
+license = "MIT"
+readme = "readme.md"
+homepage = "https://github.com/ChenyangGao/web-mount-packs/tree/main/python-module/python-startfile"
+repository = "https://github.com/ChenyangGao/web-mount-packs/tree/main/python-module/python-startfile"
+keywords = ["startfile"]
+classifiers = [
+    "License :: OSI Approved :: MIT License",
+    "Development Status :: 5 - Production/Stable",
+    "Programming Language :: Python",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+include = [
+    "LICENSE",
+]
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[[tool.poetry.packages]]
+include = "startfile.py"

python_startfile-0.0.1/readme.md

@@ -0,0 +1,33 @@
+# Python startfile.
+
+## Installation
+
+You can install via [pypi](https://pypi.org/project/python-startfile/)
+
+```console
+pip install -U python-startfile
+```
+
+## Usage
+
+### Module
+
+```python
+>>> from startfile import startfile, startfile_async
+```
+
+### Commad
+
+```console
+$ python -m startfile -h
+usage: startfile.py [-h] [-v] [path ...]
+
+Start file(s) with its/their associated application.
+
+positional arguments:
+  path           paths to files or directories
+
+options:
+  -h, --help     show this help message and exit
+  -v, --version  print the current version
+```

python_startfile-0.0.1/startfile.py

@@ -0,0 +1,70 @@
+#!/usr/bin/env python3
+# coding: utf-8
+
+__author__ = "ChenyangGao <https://chenyanggao.github.io>"
+__version__ = (0, 0, 1)
+__all__ = ["startfile", "startfile_async"]
+
+if __name__ == "__main__":
+    from argparse import ArgumentParser, RawTextHelpFormatter
+
+    parser = ArgumentParser(
+        description="Start file(s) with its/their associated application.", 
+        formatter_class=RawTextHelpFormatter, 
+    )
+    parser.add_argument("paths", nargs="*", metavar="path", help="paths to files or directories")
+    parser.add_argument("-v", "--version", action="store_true", help="print the current version")
+
+    args = parser.parse_args()
+    if args.version:
+        print(".".join(map(str, __version__)))
+        raise SystemExit(0)
+    paths = args.paths
+    if not paths:
+        parser.parse_args(["-h"])
+
+try:
+    from os import startfile
+except ImportError:
+    from asyncio import create_subprocess_exec, create_subprocess_shell
+    from platform import system
+    from subprocess import run
+
+    async def run_command(command):
+        if isinstance(command, str):
+            process = await create_subprocess_shell(command)
+        else:
+            process = await create_subprocess_exec(*command)
+        await process.communicate()
+
+    match system():
+        case "Linux":
+            def startfile(path, /, *args):
+                run(["xdg-open", path, *args])
+            async def startfile_async(path, /, *args):
+                await run_command(["xdg-open", path, *args])
+        case "Darwin":
+            def startfile(path, /, *args):
+                run(["open", path, *args])
+            async def startfile_async(path, /, *args):
+                await run_command(["open", path, *args])
+        case "Windows":
+            def startfile(path, /, *args):
+                run(["start", path, *args])
+            async def startfile_async(path, /, *args):
+                await run_command(["start", path, *args])
+        case _:
+            raise RuntimeError("can't get startfile")
+else:
+    from asyncio import to_thread
+    from functools import wraps
+
+    @wraps(startfile)
+    async def startfile_aysnc(*args, **kwds):
+        return await to_thread(startfile, *args, **kwds)
+
+
+if __name__ == "__main__":
+    for path in paths:
+        startfile(path)
+