pdfcrowd-cli 1.0.0__py3-none-any.whl

pdfcrowd_cli/windows.py

@@ -0,0 +1,173 @@
+# Copyright (C) 2009-2026 pdfcrowd.com
+#
+# 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.
+
+"""Owner-only credential DACLs using native Windows security APIs.
+
+See Microsoft's GetNamedSecurityInfoW and SetNamedSecurityInfoW contracts.
+Native Windows validation remains part of platform release acceptance.
+"""
+
+import ctypes
+from ctypes import wintypes
+
+from .catalog import CLIError
+
+
+class ACLSize(ctypes.Structure):
+    _fields_ = [('count', wintypes.DWORD), ('used', wintypes.DWORD),
+                ('free', wintypes.DWORD)]
+
+
+class ACEHeader(ctypes.Structure):
+    _fields_ = [('kind', wintypes.BYTE), ('flags', wintypes.BYTE),
+                ('size', wintypes.WORD)]
+
+
+class Security:
+    def __init__(self):
+        self.advapi = ctypes.WinDLL('advapi32', use_last_error=True)
+        self.kernel = ctypes.WinDLL('kernel32', use_last_error=True)
+        pointer = ctypes.c_void_p
+        output = ctypes.POINTER(pointer)
+        integer = wintypes.DWORD
+        self.function(self.kernel, 'GetCurrentProcess', pointer, [])
+        self.function(self.kernel, 'CloseHandle', wintypes.BOOL, [pointer])
+        self.function(self.kernel, 'LocalFree', pointer, [pointer])
+        signatures = {
+            'OpenProcessToken': (wintypes.BOOL, [pointer, integer, output]),
+            'GetTokenInformation': (wintypes.BOOL, [
+                pointer, integer, pointer, integer, ctypes.POINTER(integer)]),
+            'ConvertSidToStringSidW': (wintypes.BOOL, [pointer, output]),
+            'ConvertStringSecurityDescriptorToSecurityDescriptorW': (
+                wintypes.BOOL, [wintypes.LPCWSTR, integer, output, pointer]),
+            'GetSecurityDescriptorDacl': (wintypes.BOOL, [
+                pointer, ctypes.POINTER(wintypes.BOOL), output,
+                ctypes.POINTER(wintypes.BOOL)]),
+            'GetNamedSecurityInfoW': (integer, [wintypes.LPCWSTR, integer,
+                integer, output, output, output, output, output]),
+            'SetNamedSecurityInfoW': (integer, [wintypes.LPWSTR, integer,
+                integer, pointer, pointer, pointer, pointer]),
+            'GetAclInformation': (wintypes.BOOL, [pointer, pointer,
+                                                integer, integer]),
+            'GetAce': (wintypes.BOOL, [pointer, integer, output]),
+        }
+        for name, (result, arguments) in signatures.items():
+            self.function(self.advapi, name, result, arguments)
+
+    @staticmethod
+    def function(library, name, result, arguments):
+        function = getattr(library, name)
+        function.restype, function.argtypes = result, arguments
+
+    @staticmethod
+    def require(succeeded):
+        if not succeeded:
+            raise CLIError('Could not establish or verify private Windows '
+                           'credential access. Use environment credentials.', 3)
+
+    def sid_text(self, sid):
+        text = ctypes.c_void_p()
+        self.require(self.advapi.ConvertSidToStringSidW(
+            sid, ctypes.byref(text)))
+        try:
+            return ctypes.wstring_at(text)
+        finally:
+            self.kernel.LocalFree(text)
+
+    def current_sid(self):
+        token = ctypes.c_void_p()
+        self.require(self.advapi.OpenProcessToken(
+            self.kernel.GetCurrentProcess(), 8, ctypes.byref(token)))
+        try:
+            size = wintypes.DWORD()
+            self.advapi.GetTokenInformation(token, 1, None, 0,
+                                             ctypes.byref(size))
+            self.require(size.value)
+            buffer = ctypes.create_string_buffer(size.value)
+            self.require(self.advapi.GetTokenInformation(
+                token, 1, buffer, size, ctypes.byref(size)))
+            sid = ctypes.cast(buffer, ctypes.POINTER(ctypes.c_void_p))[0]
+            return self.sid_text(sid)
+        finally:
+            self.kernel.CloseHandle(token)
+
+    def descriptor(self, path):
+        owner, dacl, descriptor = (ctypes.c_void_p() for _ in range(3))
+        result = self.advapi.GetNamedSecurityInfoW(
+            str(path), 1, 5, ctypes.byref(owner), None, ctypes.byref(dacl),
+            None, ctypes.byref(descriptor))
+        self.require(result == 0)
+        return owner, dacl, descriptor
+
+
+def check_private(path):
+    security = Security()
+    current = security.current_sid()
+    owner, dacl, descriptor = security.descriptor(path)
+    try:
+        security.require(owner and security.sid_text(owner) == current and dacl)
+        size = ACLSize()
+        security.require(security.advapi.GetAclInformation(
+            dacl, ctypes.byref(size), ctypes.sizeof(size), 2))
+        allowed = False
+        for index in range(size.count):
+            ace = ctypes.c_void_p()
+            security.require(security.advapi.GetAce(dacl, index,
+                                                     ctypes.byref(ace)))
+            header = ctypes.cast(ace, ctypes.POINTER(ACEHeader)).contents
+            if header.flags & 8 or header.kind == 1:
+                continue  # Inherit-only or denying ACEs cannot grant access.
+            security.require(header.kind == 0)
+            security.require(security.sid_text(ace.value + 8) == current)
+            allowed = True
+        security.require(allowed)
+    finally:
+        security.kernel.LocalFree(descriptor)
+
+
+def protect(path):
+    security = Security()
+    current = security.current_sid()
+    owner, _, existing = security.descriptor(path)
+    try:
+        security.require(owner and security.sid_text(owner) == current)
+    finally:
+        security.kernel.LocalFree(existing)
+    descriptor = ctypes.c_void_p()
+    inheritance = 'OICI' if path.is_dir() else ''
+    security.require(
+        security.advapi.ConvertStringSecurityDescriptorToSecurityDescriptorW(
+            f'D:P(A;{inheritance};FA;;;{current})', 1,
+            ctypes.byref(descriptor), None))
+    try:
+        present, defaulted = wintypes.BOOL(), wintypes.BOOL()
+        dacl = ctypes.c_void_p()
+        security.require(security.advapi.GetSecurityDescriptorDacl(
+            descriptor, ctypes.byref(present), ctypes.byref(dacl),
+            ctypes.byref(defaulted)))
+        security.require(present.value and dacl)
+        security.require(security.advapi.SetNamedSecurityInfoW(
+            str(path), 1, 0x80000004, None, None, dacl, None) == 0)
+        check_private(path)
+    finally:
+        security.kernel.LocalFree(descriptor)

pdfcrowd_cli-1.0.0.dist-info/LICENSE

@@ -0,0 +1,22 @@
+Copyright (C) 2009-2026 pdfcrowd.com
+
+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.

pdfcrowd_cli-1.0.0.dist-info/METADATA

@@ -0,0 +1,112 @@
+Metadata-Version: 2.1
+Name: pdfcrowd-cli
+Version: 1.0.0
+Summary: Command-line converters for the PDFCrowd API.
+Home-page: https://pdfcrowd.com/api/
+Author: PDFCrowd Team
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pdfcrowd <7.1.0,>=7.0.0
+Requires-Dist: platformdirs <5,>=4.3.6
+
+# PDFCrowd CLI
+
+Install with Python 3.8 or newer using pipx or uv:
+
+```sh
+pipx install pdfcrowd-cli
+# Alternatively: uv tool install pdfcrowd-cli
+pdfcrowd html2pdf --output example.pdf https://example.com
+pdfcrowd --help
+pdfcrowd html2pdf help page-margins
+pdfcrowd html2pdf help --json
+```
+
+The CLI package also provides the converter commands directly:
+
+```sh
+html2pdf --output example.pdf https://example.com
+html2pdf --help
+html2pdf help page-margins
+html2pdf help --json
+```
+
+The available commands are `html2pdf`, `html2image`, `image2pdf`,
+`image2image`, `pdf2pdf`, `pdf2html`, `pdf2text`, and `pdf2image`.
+Without personal credentials, conversions use the demo account and produce
+marked output. Set `PDFCROWD_USERNAME` and `PDFCROWD_API_KEY`, or save your
+account with `pdfcrowd auth login`. For unattended login, set both environment
+variables and run `pdfcrowd auth login --non-interactive`. Conversions never
+prompt for credentials.
+
+Environment credentials take priority over the saved account. To use demo
+even when personal credentials are saved:
+
+```sh
+PDFCROWD_USERNAME=demo PDFCROWD_API_KEY=demo \
+  html2pdf --output example.pdf https://example.com
+```
+
+Long options use `--name`. Account credentials are not accepted as arguments.
+Boolean conversion options accept `true` or `false`. Compound option arguments
+are separate values: `--page-margins 10mm 10mm 10mm 10mm`. Quote each value
+individually when needed; semicolons inside values are preserved. Use
+`--option=VALUE` for values that match an option name. Compound options can
+also take a JSON array: `--http-auth='["username", "password"]'`.
+
+`help`, version, and JSON help work offline. Conversion output uses
+`--output FILE` or redirected stdout; only `pdf2text` writes results directly
+to a terminal. Failed file conversions preserve the previous output.
+Options can appear between input files:
+
+```sh
+pdfcrowd pdf2pdf first.pdf -o merged.pdf second.pdf
+```
+
+Diagnostics use stderr. Service errors preserve the SDK's complete message,
+including URLs, option values, and documentation links.
+Exit status 1 means an output
+pipe closed; Ctrl-C exits with status 130.
+
+Converter settings are read from a per-converter sectionless INI file, but
+command invocations never automatically save settings. `--init-config` creates
+a commented starter; `--show-config` inspects effective defaults; `--no-config`
+bypasses saved conversion defaults while keeping credentials available.
+`--show-config` lists conversion settings from the file and command line;
+other options use their API defaults. Compound configuration values use JSON
+arrays of strings. `auth login` explicitly saves shared credentials;
+`auth logout` removes them. Use `help configuration` and `help authentication`
+for paths, precedence, examples, and details.
+
+For example:
+
+```sh
+pdfcrowd html2pdf --init-config
+# Open the created file and uncomment the settings you want to use.
+pdfcrowd html2pdf --show-config
+pdfcrowd html2pdf help --init-config
+```
+
+For scripts, integrations, and AI agents, `pdfcrowd html2pdf help --json`
+describes available options, argument types, defaults, and exit codes as JSON.
+Use `pdfcrowd help --json` for all converters.
+
+pipx and uv expose `pdfcrowd` and all eight converter commands. The CLI
+installation includes the compatible SDK automatically.
+
+The Python SDK contains only the API clients. All commands are provided by
+`pdfcrowd-cli`, so the SDK and CLI can share a virtual environment:
+
+```sh
+python -m pip install pdfcrowd-cli
+html2pdf --help
+```
+
+This public source builds independently of the private generator checkout:
+
+```sh
+python -m pip install .
+make build
+```

pdfcrowd_cli-1.0.0.dist-info/RECORD

@@ -0,0 +1,16 @@
+pdfcrowd_cli/__init__.py,sha256=HEsPJe7uOwJ9JkLw3flOPt_zYly_uemsmk00_Z_35bQ,1172
+pdfcrowd_cli/__main__.py,sha256=VdO8UKRaPmhkzGaU82myBFhkdQTumCvDzljh8z8j2o4,1171
+pdfcrowd_cli/adapter.py,sha256=YDfwR0DrqRsorue00CizCCg36Yc8cz8N4LXc4Kiq7MQ,5940
+pdfcrowd_cli/catalog.py,sha256=AYobCGFuGN4RiHA3tPFA2dzTuIBC23hyLUHnTMe2ZUU,1797
+pdfcrowd_cli/command-spec.json,sha256=gi4xG6v_cmiEwq9tK0Hr3YYS35tW9a0Ts1Gu8La5Rzw,585697
+pdfcrowd_cli/entrypoints.py,sha256=u1iiQVLQkqDuUHMtl3vo7-897JYdQL-QL6Nvy_H2UKs,8850
+pdfcrowd_cli/help.py,sha256=lmP0YbEyt-vPi6-J93sxA5Kz6SwhJBdilgZ-nmR6KuI,19679
+pdfcrowd_cli/parser.py,sha256=Eq3DrVfjhxdsSZKhX4FJPXi3EgKvfSMQJmp8PqEzyTQ,8415
+pdfcrowd_cli/state.py,sha256=rhh1CSQBwne_q9qDTwx8Tow-UNrLxg-MoSvHgQHd0LU,16308
+pdfcrowd_cli/windows.py,sha256=_7BNRSY3Fqrlt-6ChWT76kvbCDHn1lg2nnG1IXBQFvU,7378
+pdfcrowd_cli-1.0.0.dist-info/LICENSE,sha256=0LSvXvYHjr5lcJ--6Ls67xN9PHiIpmgFs8S1MIo4YKs,1061
+pdfcrowd_cli-1.0.0.dist-info/METADATA,sha256=kzIE8UGmvzKX97vVl8Cd6uS_vcI3nNi0iR-3dKGTjWc,3994
+pdfcrowd_cli-1.0.0.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+pdfcrowd_cli-1.0.0.dist-info/entry_points.txt,sha256=ihqC11MHeM0jQP37OYxpiOYqWO-FT8hMyC51hQqgzpY,435
+pdfcrowd_cli-1.0.0.dist-info/top_level.txt,sha256=FnsOZBTnncYSPU9Zqgzbnp46GzHwrqBYSRdpDQLS1JA,13
+pdfcrowd_cli-1.0.0.dist-info/RECORD,,

pdfcrowd_cli-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.42.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pdfcrowd_cli-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,10 @@
+[console_scripts]
+html2image = pdfcrowd_cli.entrypoints:html2image
+html2pdf = pdfcrowd_cli.entrypoints:html2pdf
+image2image = pdfcrowd_cli.entrypoints:image2image
+image2pdf = pdfcrowd_cli.entrypoints:image2pdf
+pdf2html = pdfcrowd_cli.entrypoints:pdf2html
+pdf2image = pdfcrowd_cli.entrypoints:pdf2image
+pdf2pdf = pdfcrowd_cli.entrypoints:pdf2pdf
+pdf2text = pdfcrowd_cli.entrypoints:pdf2text
+pdfcrowd = pdfcrowd_cli.entrypoints:cli_main

pdfcrowd_cli-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+pdfcrowd_cli