python-undef 0.1.3__tar.gz → 0.1.5__tar.gz

{python_undef-0.1.3 → python_undef-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python_undef
-Version: 0.1.3
+Version: 0.1.5
 Summary: Python undefined header in pyconfig.h
 Project-URL: homepage, https://github.com/Locked-chess-official/python_undef
 Author-email: Locked-chess-official <13140752715@163.com>
@@ -24,16 +24,24 @@ pip install python_undef
 
 ## Usage
 
-This command will create the file "Python_undef.h"
+This command under will create the file "Python_undef.h"
 
 ```bash
 python -m python_undef --generate
 ```
 
-This command will output the include path of "Python_undef.h".
+It defaults output the file "Python_undef.h" in the package directory. You can use the `--output` option to specify the output file:
+
+```bash
+python -m python_undef --generate --output <path>
+```
+
+The command under will output the include path of "Python_undef.h".
 
 You can use this command in your C/C++ project such as "cmake", "gyp" and so on.
 
+If hadn't run `python -m python_undef --generate` it will exit with code 1.
+
 ```bash
 python -m python_undef --include
 ```

{python_undef-0.1.3 → python_undef-0.1.5}/README.md

@@ -14,16 +14,24 @@ pip install python_undef
 
 ## Usage
 
-This command will create the file "Python_undef.h"
+This command under will create the file "Python_undef.h"
 
 ```bash
 python -m python_undef --generate
 ```
 
-This command will output the include path of "Python_undef.h".
+It defaults output the file "Python_undef.h" in the package directory. You can use the `--output` option to specify the output file:
+
+```bash
+python -m python_undef --generate --output <path>
+```
+
+The command under will output the include path of "Python_undef.h".
 
 You can use this command in your C/C++ project such as "cmake", "gyp" and so on.
 
+If hadn't run `python -m python_undef --generate` it will exit with code 1.
+
 ```bash
 python -m python_undef --include
 ```

{python_undef-0.1.3 → python_undef-0.1.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "python_undef"
-version = "0.1.3"
+version = "0.1.5"
 description = "Python undefined header in pyconfig.h"
 readme = "README.md"
 license = {text = "MIT"}

{python_undef-0.1.3 → python_undef-0.1.5}/src/python_undef/__init__.py

@@ -1,3 +1,17 @@
+"""
+python_undef - A utility to generate a header file that undefines non-standard Python macros in pyconfig.h.
+
+Usage:
+    python -m python_undef --generate
+    This is the main command to generate Python_undef.h based on the system's pyconfig.h to the include directly under the package directly.
+    python -m python_undef --generate --output <path>
+    This command generates Python_undef.h and saves it to the specified output path.
+    python -m python_undef --include
+    This command prints the include path where Python_undef.h is located.
+    python -m python_undef --help
+    Display this help message.
+"""
+
 import os
 import re
 import datetime
@@ -71,7 +85,7 @@ def generate_python_undef_header(pyconfig_path: str, output_path: str|None=None)
             try:
                 os.makedirs(f'{file_dir}/include')
             except Exception as e:
-                print(f"Error creating include directory: {e}")
+                print(f"Error creating include directory: {e}", file=sys.stderr)
                 return False
     
     # Read pyconfig.h
@@ -79,10 +93,10 @@ def generate_python_undef_header(pyconfig_path: str, output_path: str|None=None)
         with open(pyconfig_path, 'r', encoding='utf-8') as f:
             lines = f.readlines()
     except FileNotFoundError:
-        print(f"Error: File not found {pyconfig_path}")
+        print(f"Error: File not found {pyconfig_path}", file=sys.stderr)
         return False
     except Exception as e:
-        print(f"Error reading file: {e}")
+        print(f"Error reading file: {e}", file=sys.stderr)
         return False
     
     # Collect macros
@@ -132,7 +146,7 @@ def generate_python_undef_header(pyconfig_path: str, output_path: str|None=None)
  *   #define DONOTUNDEF_MACRO_NAME
  * 
  * Generation rules:
- *   - Macros starting with Py_, PY_, _Py, _PY are preserved (Python standard)
+ *   - Macros starting with Py, PY, _Py, _PY are preserved (Python standard)
  *   - Macros ending with _H are preserved (header guards)
  *   - All other macros are undefined
  *   - Macro name validation uses Python's standard identifier checking
@@ -207,7 +221,7 @@ def generate_python_undef_header(pyconfig_path: str, output_path: str|None=None)
         return True
         
     except Exception as e:
-        print(f"Error writing file: {e}")
+        print(f"Error writing file: {e}", file=sys.stderr)
         return False
 
 def main():
@@ -216,7 +230,9 @@ def main():
         if sys.argv[1] in ('-h', '--help'):
             print("""Usage:
 python -m python_undef --generate
-    Generate Python_undef.h based on the system's pyconfig.h.
+    Generate Python_undef.h based on the system's pyconfig.h to the include directly under the package directly.
+python -m python_undef --generate --output <path>
+    Generate Python_undef.h and specify output path.
 python -m python_undef --include
     Print the include path where Python_undef.h is located.""")
             sys.exit(0)
@@ -229,36 +245,44 @@ python -m python_undef --include
             pyconfig_path = include_dir / "pyconfig.h"
             
             if os.path.exists(pyconfig_path):
-                success = generate_python_undef_header(pyconfig_path)
-                
+                if sys.argv[2:]:
+                    if sys.argv[2] == "--output" and len(sys.argv) == 4:
+                        if not os.path.isdir(sys.argv[3]):
+                            print("Error: Specified output path does not exist.", file=sys.stderr)
+                            sys.exit(1)
+                        output_path = str(Path(sys.argv[3]) / "Python_undef.h")
+                        print(f"Output path specified: {output_path}")
+                    else:
+                        print("Invalid output argument. Use --output <path> to specify output file.", file=sys.stderr)
+                        sys.exit(1)
+                else:
+                    output_path = None
+                success = generate_python_undef_header(pyconfig_path, output_path)
+
                 if success:
                     print(f"\n✅ Generation complete!")
-                    print(f"💡 Tip: Use '{sys.executable} -m python_undef --include' to add this header file path to search path.")
+                    if not output_path:
+                        print(f"💡 Tip: Use '{sys.executable} -m python_undef --include' to add this header file path to search path.")
                     sys.exit(0)
                 else:
-                    print(f"\n❌ Generation failed!")
+                    print(f"\n❌ Generation failed!", file=sys.stderr)
                     sys.exit(1)
-                    
+
             else:
-                print(f"File {pyconfig_path} not found.")
-                print("Please update the pyconfig_path variable to the actual pyconfig.h path.")
-                print("\nTypical paths on Windows:")
-                print("  C:\\\\Python3x\\\\include\\\\pyconfig.h")
-                print("\nTypical paths on Unix/Linux:")
-                print("  /usr/include/python3.x/pyconfig.h")
-                print("  /usr/local/include/python3.x/pyconfig.h")
+                print(f"File {pyconfig_path} not found.", file=sys.stderr)
+                print("Please ensure the python is standard installation with headers.", file=sys.stderr)
                 sys.exit(1)
         elif sys.argv[1] == "--include":
             file_dir = os.path.dirname(os.path.abspath(__file__))
             if not (Path(file_dir) / "include" / "Python_undef.h").exists():
-                print("File not found. Use 'python -m python_undef --generate' to generate the header first.")
+                print(f"File not found. Use '{sys.executable} -m python_undef --generate' to generate the header first.", file=sys.stderr)
                 sys.exit(1)
             include_path = os.path.abspath(os.path.join(file_dir, 'include'))
             print(include_path)
             sys.exit(0)
         else:
-            print("Unknown argument. Use --help for usage information.")
+            print("Unknown argument. Use --help for usage information.", file=sys.stderr)
             sys.exit(1)
     else:
-        print("No arguments provided. Use --help for usage information.")
+        print("No arguments provided. Use --help for usage information.", file=sys.stderr)
         sys.exit(1)