adobepy 0.1.0__tar.gz

adobepy-0.1.0/LICENSE-APACHE

@@ -0,0 +1,146 @@
+Apache License
+Version 2.0, January 2004
+https://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction, and
+distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by the copyright
+owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all other entities
+that control, are controlled by, or are under common control with that entity.
+For the purposes of this definition, "control" means (i) the power, direct or
+indirect, to cause the direction or management of such entity, whether by
+contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising
+permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications, including
+but not limited to software source code, documentation source, and configuration
+files.
+
+"Object" form shall mean any form resulting from mechanical transformation or
+translation of a Source form, including but not limited to compiled object code,
+generated documentation, and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or Object form,
+made available under the License, as indicated by a copyright notice that is
+included in or attached to the work.
+
+"Derivative Works" shall mean any work, whether in Source or Object form, that
+is based on (or derived from) the Work and for which the editorial revisions,
+annotations, elaborations, or other modifications represent, as a whole, an
+original work of authorship. For the purposes of this License, Derivative Works
+shall not include works that remain separable from, or merely link (or bind by
+name) to the interfaces of, the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including the original
+version of the Work and any modifications or additions to that Work or
+Derivative Works thereof, that is intentionally submitted to Licensor for
+inclusion in the Work by the copyright owner or by an individual or Legal Entity
+authorized to submit on behalf of the copyright owner. For the purposes of this
+definition, "submitted" means any form of electronic, verbal, or written
+communication sent to the Licensor or its representatives, including but not
+limited to communication on electronic mailing lists, source code control
+systems, and issue tracking systems that are managed by, or on behalf of, the
+Licensor for the purpose of discussing and improving the Work, but excluding
+communication that is conspicuously marked or otherwise designated in writing by
+the copyright owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity on behalf
+of whom a Contribution has been received by Licensor and subsequently
+incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of this
+License, each Contributor hereby grants to You a perpetual, worldwide,
+non-exclusive, no-charge, royalty-free, irrevocable copyright license to
+reproduce, prepare Derivative Works of, publicly display, publicly perform,
+sublicense, and distribute the Work and such Derivative Works in Source or
+Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of this License,
+each Contributor hereby grants to You a perpetual, worldwide, non-exclusive,
+no-charge, royalty-free, irrevocable patent license to make, have made, use,
+offer to sell, sell, import, and otherwise transfer the Work.
+
+4. Redistribution. You may reproduce and distribute copies of the Work or
+Derivative Works thereof in any medium, with or without modifications, and in
+Source or Object form, provided that You meet the following conditions:
+
+(a) You must give any other recipients of the Work or Derivative Works a copy
+of this License; and
+
+(b) You must cause any modified files to carry prominent notices stating that
+You changed the files; and
+
+(c) You must retain, in the Source form of any Derivative Works that You
+distribute, all copyright, patent, trademark, and attribution notices from the
+Source form of the Work, excluding those notices that do not pertain to any part
+of the Derivative Works; and
+
+(d) If the Work includes a "NOTICE" text file as part of its distribution, then
+any Derivative Works that You distribute must include a readable copy of the
+attribution notices contained within such NOTICE file, excluding those notices
+that do not pertain to any part of the Derivative Works, in at least one of the
+following places: within a NOTICE text file distributed as part of the
+Derivative Works; within the Source form or documentation, if provided along
+with the Derivative Works; or, within a display generated by the Derivative
+Works, if and wherever such third-party notices normally appear. The contents of
+the NOTICE file are for informational purposes only and do not modify the
+License. You may add Your own attribution notices within Derivative Works that
+You distribute, alongside or as an addendum to the NOTICE text from the Work,
+provided that such additional attribution notices cannot be construed as
+modifying the License.
+
+You may add Your own copyright statement to Your modifications and may provide
+additional or different license terms and conditions for use, reproduction, or
+distribution of Your modifications, or for any such Derivative Works as a whole,
+provided Your use, reproduction, and distribution of the Work otherwise complies
+with the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise, any
+Contribution intentionally submitted for inclusion in the Work by You to the
+Licensor shall be under the terms and conditions of this License, without any
+additional terms or conditions.
+
+6. Trademarks. This License does not grant permission to use the trade names,
+trademarks, service marks, or product names of the Licensor, except as required
+for reasonable and customary use in describing the origin of the Work and
+reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or agreed to in
+writing, Licensor provides the Work on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied, including, without
+limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT,
+MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely
+responsible for determining the appropriateness of using or redistributing the
+Work and assume any risks associated with Your exercise of permissions under
+this License.
+
+8. Limitation of Liability. In no event and under no legal theory, whether in
+tort (including negligence), contract, or otherwise, unless required by
+applicable law (such as deliberate and grossly negligent acts) or agreed to in
+writing, shall any Contributor be liable to You for damages, including any
+direct, indirect, special, incidental, or consequential damages of any character
+arising as a result of this License or out of the use or inability to use the
+Work, even if such Contributor has been advised of the possibility of such
+damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing the Work or
+Derivative Works thereof, You may choose to offer, and charge a fee for,
+acceptance of support, warranty, indemnity, or other liability obligations
+and/or rights consistent with this License. However, in accepting such
+obligations, You may act only on Your own behalf and on Your sole
+responsibility, not on behalf of any other Contributor, and only if You agree to
+indemnify, defend, and hold each Contributor harmless for any liability incurred
+by, or claims asserted against, such Contributor by reason of your accepting any
+such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS

adobepy-0.1.0/LICENSE-MIT

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 adobepy contributors
+
+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.

adobepy-0.1.0/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: adobepy
+Version: 0.1.0
+Summary: Python SDK and broker contracts for controlling Adobe desktop hosts through UXP and CEP bridges.
+Author: adobepy contributors
+License: MIT OR Apache-2.0
+Project-URL: Homepage, https://github.com/loonghao/adobepy
+Project-URL: Repository, https://github.com/loonghao/adobepy
+Project-URL: Bug Tracker, https://github.com/loonghao/adobepy/issues
+Project-URL: Documentation, https://github.com/loonghao/adobepy/tree/main/docs
+Keywords: adobe,photoshop,indesign,premiere,after-effects,illustrator,uxp,cep,python,mcp
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+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: Typing :: Typed
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE-MIT
+License-File: LICENSE-APACHE
+Dynamic: license-file
+
+# adobepy
+
+Shared Adobe desktop communication runtime for Python tools and DCC MCP
+adapters. Python talks to a local Rust broker; Adobe applications run thin UXP
+or CEP/ExtendScript bridges.
+
+`adobepy` is intended to be the common Adobe host layer for projects such as
+[`dcc-mcp-photoshop`](https://github.com/loonghao/dcc-mcp-photoshop) and future
+Adobe adapters. The public Python surface mirrors Adobe's JavaScript DOM where
+possible, while adding Pythonic aliases for agent and script ergonomics.
+
+Implemented pieces:
+
+- Rust `adobepy` CLI with `broker`, `doctor`, `install-bridge`, and `repl`.
+- Local JSON-RPC broker with per-session token, target, timeout, and capability gates.
+- Python SDK under `adobe.core`, `adobe.raw`, `adobe.photoshop`, `adobe.indesign`, `adobe.premiere`, `adobe.after_effects`, and `adobe.illustrator`.
+- Optional DCC MCP result helpers under `adobe.dcc_mcp` for adapter skill code.
+- UXP bridge templates for Photoshop, InDesign, and Premiere that dispatch to host APIs and broker raw JavaScript escape hatches.
+- CEP bridge templates for After Effects and Illustrator.
+- IR validation, proxy-aware `.pyi` stub generation, and stub/runtime drift checks.
+- `vx just package` distribution workflow.
+
+Validate everything:
+
+```powershell
+npm install
+npm run test:all
+```
+
+The full test suite type-checks bridge code, builds and exercises UXP/CEP
+bundles with mocked host runtimes, validates IR contracts, checks Python
+coverage, and runs Rust workspace tests.
+
+Python support starts at 3.8. The current SDK wheel is pure Python; any future
+native Python extension must publish `cp38-abi3-*` wheels rather than
+per-minor-version wheels.
+
+Build a redistributable Windows package:
+
+```powershell
+vx just package
+```
+
+The archive is written to `dist/adobepy-0.1.0-windows-x64.zip` with a sibling
+SHA256 file. Usage and packaging notes are in `docs/usage.md` and
+`docs/distribution.md`. Architecture boundaries and Adobe API source tracking
+are documented in `docs/architecture.md`, `docs/api-sources.md`, and
+`docs/dcc-mcp-integration.md`.
+
+Python facade example:
+
+```python
+from adobe.photoshop import Photoshop
+
+app = Photoshop()
+for layer in app.activeLayers:
+    print(layer.name)
+
+doc = app.activeDocument
+doc.selection.select_rectangle({"top": 10, "left": 10, "bottom": 256, "right": 256})
+for channel in doc.channels:
+    print(channel.name)
+
+text = app.activeText
+if text:
+    text.set_contents("Hello from Python")
+    text.character_style.update(size=36, tracking=20)
+    text.paragraph_style.update(justification="center")
+
+layer = app.activeLayer
+if layer:
+    layer.filters.apply_gaussian_blur(2)
+    layer.smart_object.convert_to_smart_object()
+
+doc.exports.jpg_high("C:/renders/demo.jpg")
+```

adobepy-0.1.0/README.md

@@ -0,0 +1,76 @@
+# adobepy
+
+Shared Adobe desktop communication runtime for Python tools and DCC MCP
+adapters. Python talks to a local Rust broker; Adobe applications run thin UXP
+or CEP/ExtendScript bridges.
+
+`adobepy` is intended to be the common Adobe host layer for projects such as
+[`dcc-mcp-photoshop`](https://github.com/loonghao/dcc-mcp-photoshop) and future
+Adobe adapters. The public Python surface mirrors Adobe's JavaScript DOM where
+possible, while adding Pythonic aliases for agent and script ergonomics.
+
+Implemented pieces:
+
+- Rust `adobepy` CLI with `broker`, `doctor`, `install-bridge`, and `repl`.
+- Local JSON-RPC broker with per-session token, target, timeout, and capability gates.
+- Python SDK under `adobe.core`, `adobe.raw`, `adobe.photoshop`, `adobe.indesign`, `adobe.premiere`, `adobe.after_effects`, and `adobe.illustrator`.
+- Optional DCC MCP result helpers under `adobe.dcc_mcp` for adapter skill code.
+- UXP bridge templates for Photoshop, InDesign, and Premiere that dispatch to host APIs and broker raw JavaScript escape hatches.
+- CEP bridge templates for After Effects and Illustrator.
+- IR validation, proxy-aware `.pyi` stub generation, and stub/runtime drift checks.
+- `vx just package` distribution workflow.
+
+Validate everything:
+
+```powershell
+npm install
+npm run test:all
+```
+
+The full test suite type-checks bridge code, builds and exercises UXP/CEP
+bundles with mocked host runtimes, validates IR contracts, checks Python
+coverage, and runs Rust workspace tests.
+
+Python support starts at 3.8. The current SDK wheel is pure Python; any future
+native Python extension must publish `cp38-abi3-*` wheels rather than
+per-minor-version wheels.
+
+Build a redistributable Windows package:
+
+```powershell
+vx just package
+```
+
+The archive is written to `dist/adobepy-0.1.0-windows-x64.zip` with a sibling
+SHA256 file. Usage and packaging notes are in `docs/usage.md` and
+`docs/distribution.md`. Architecture boundaries and Adobe API source tracking
+are documented in `docs/architecture.md`, `docs/api-sources.md`, and
+`docs/dcc-mcp-integration.md`.
+
+Python facade example:
+
+```python
+from adobe.photoshop import Photoshop
+
+app = Photoshop()
+for layer in app.activeLayers:
+    print(layer.name)
+
+doc = app.activeDocument
+doc.selection.select_rectangle({"top": 10, "left": 10, "bottom": 256, "right": 256})
+for channel in doc.channels:
+    print(channel.name)
+
+text = app.activeText
+if text:
+    text.set_contents("Hello from Python")
+    text.character_style.update(size=36, tracking=20)
+    text.paragraph_style.update(justification="center")
+
+layer = app.activeLayer
+if layer:
+    layer.filters.apply_gaussian_blur(2)
+    layer.smart_object.convert_to_smart_object()
+
+doc.exports.jpg_high("C:/renders/demo.jpg")
+```

adobepy-0.1.0/pyproject.toml

@@ -0,0 +1,57 @@
+[build-system]
+requires = [
+    "setuptools>=69,<77; python_version < '3.9'",
+    "setuptools>=77; python_version >= '3.9'",
+]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "adobepy"
+version = "0.1.0"
+description = "Python SDK and broker contracts for controlling Adobe desktop hosts through UXP and CEP bridges."
+readme = "README.md"
+requires-python = ">=3.8"
+authors = [{ name = "adobepy contributors" }]
+license = { text = "MIT OR Apache-2.0" }
+keywords = ["adobe", "photoshop", "indesign", "premiere", "after-effects", "illustrator", "uxp", "cep", "python", "mcp"]
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Typing :: Typed",
+    "Topic :: Multimedia :: Graphics",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/loonghao/adobepy"
+Repository = "https://github.com/loonghao/adobepy"
+"Bug Tracker" = "https://github.com/loonghao/adobepy/issues"
+Documentation = "https://github.com/loonghao/adobepy/tree/main/docs"
+
+[tool.setuptools]
+package-dir = {"" = "python"}
+license-files = ["LICENSE-MIT", "LICENSE-APACHE"]
+
+[tool.setuptools.packages.find]
+where = ["python"]
+exclude = ["tests", "tests.*"]
+namespaces = false
+
+[tool.setuptools.package-data]
+"*" = ["py.typed", "*.pyi"]
+
+[tool.coverage.run]
+branch = true
+source = ["python/adobe", "generators"]
+
+[tool.coverage.report]
+fail_under = 90
+show_missing = true
+skip_covered = true

adobepy-0.1.0/python/adobe/__init__.py

@@ -0,0 +1,3 @@
+from __future__ import annotations
+
+__all__ = ["after_effects", "core", "dcc_mcp", "illustrator", "indesign", "photoshop", "premiere", "raw"]

adobepy-0.1.0/python/adobe/after_effects/__init__.py

@@ -0,0 +1,5 @@
+from __future__ import annotations
+
+from .session import AfterEffects, AfterEffectsSession, ProjectProxy, connect, connect_async
+
+__all__ = ["AfterEffects", "AfterEffectsSession", "ProjectProxy", "connect", "connect_async"]

adobepy-0.1.0/python/adobe/after_effects/py.typed

@@ -0,0 +1 @@
+