def-main 0.10.0__py3-none-any.whl → 0.12.0__py3-none-any.whl

def_main.py → def_main/__init__.py

@@ -1,10 +1,18 @@
-from typing import Callable
+import inspect
 import sys
+from collections.abc import Callable
+
+MAINS = []
 
 
 def def_main(f: Callable) -> Callable:
+    s = inspect.stack()[1]
+    MAINS.append((f, s.filename, s.lineno))
+
     if f.__module__ == '__main__':
-        f(*sys.argv[1:])
+        result = f(*sys.argv[1:])
+        if result:
+            sys.exit(result)
 
     return f
 

def_main-0.12.0.dist-info/METADATA

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: def-main
+Version: 0.12.0
+Summary: 🗣 A decorator for main 🗣
+Author-email: Tom Ritchford <tom@swirly.com>
+License-Expression: MIT
+Classifier: Programming Language :: Python :: 3
+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.14
+Requires-Python: >=3.10
+Requires-Dist: xmod<2,>=1.3.2
+Description-Content-Type: text/markdown
+
+# `def_main`: a tiny decorator to define main
+
+Define the main function in one step.
+
+For any non-trivial projects, use typer and dtyper instead!
+
+## Usage example
+
+### Without an return code
+
+``` python
+import def_main
+
+@def_main
+def main(*argv):
+    print('hello,', *argv)
+```
+
+means precisely the same as:
+
+``` python
+def main(*argv):
+    print('hello,', *argv)
+
+
+if __name__ == '__main__':
+    import sys
+
+    main(sys.argv[1:])
+```
+
+### With a return code
+
+``` python
+import def_main
+
+@def_main
+def main(*argv):
+    print('hello,', *argv)
+    return argv
+```
+
+means precisely the same as:
+
+``` python
+def main(*argv):
+    print('hello,', *argv)
+    return argv
+
+
+if __name__ == '__main__':
+    import sys
+
+    returncode = main(sys.argv[1:])
+    sys.exit(returncode)
+```

def_main-0.12.0.dist-info/RECORD

@@ -0,0 +1,4 @@
+def_main/__init__.py,sha256=v1MPQh_7lMaVeRXOZYBMPeTo76UcnE6OQW6BUOiTctM,462
+def_main-0.12.0.dist-info/METADATA,sha256=o7zePQgYpigYpQuFEkh0nWF2QhOsrFeUQ1fYDQ8Ilmg,1336
+def_main-0.12.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+def_main-0.12.0.dist-info/RECORD,,

{def_main-0.10.0.dist-info → def_main-0.12.0.dist-info}/WHEEL

@@ -1,5 +1,4 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.37.1)
+Generator: hatchling 1.28.0
 Root-Is-Purelib: true
 Tag: py3-none-any
-

def_main-0.10.0.dist-info/METADATA

@@ -1,64 +0,0 @@
-Metadata-Version: 2.1
-Name: def-main
-Version: 0.10.0
-Summary: A simple definition of main
-Home-page: https://github.com/rec/def_main
-Author: Tom Ritchford
-Author-email: tom@swirly.com
-License: MIT
-Keywords: main function
-Classifier: Development Status :: 4 - Beta
-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: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Topic :: Utilities
-
-========================================================
-``def_main``: a tiny decorator to define main
-========================================================
-
-Define a Python main function in one step - no more `__main__`!
-
-For any non-trivial projects, use typer and dtyper instead.
-
-Why?
-=================
-
-1. Less typing
-2. Avoid the foolish ``== '__main_'`` and other mistakes
-
-How to install
-==================
-
-Use ``pip``:
-
-.. code-block:: bash
-
-    pip install def_main
-
-Usage example
-==================
-
-.. code-block:: python
-
-    import def_main
-
-    @def_main
-    def main(*argv):
-        print('hello,', *argv)
-
-
-means precisely the same as:
-
-.. code-block:: python
-
-    def main(*argv):
-        print('hello,', *argv)
-
-    if __name__ == '__main__':
-        import sys
-
-        main(sys.argv[1:])

def_main-0.10.0.dist-info/RECORD

@@ -1,5 +0,0 @@
-def_main.py,sha256=t6KbsD-MujoDtv-0kD0fpHVfopcJpiNBykL_U_FHY04,297
-def_main-0.10.0.dist-info/METADATA,sha256=Wq9XoyzBTy-SglF0UpkO66y8akM3uhNNFvkxSWE2z6Q,1405
-def_main-0.10.0.dist-info/WHEEL,sha256=G16H4A3IeoQmnOrYV4ueZGKSjhipXx8zc8nu9FGlvMA,92
-def_main-0.10.0.dist-info/top_level.txt,sha256=vP5-CDeRdbQoKdJJRVsbHXjiBVzh88ofNMvtM38_xhU,9
-def_main-0.10.0.dist-info/RECORD,,

def_main-0.10.0.dist-info/top_level.txt

@@ -1 +0,0 @@
-def_main