filemaker-patchwork 0.1.0__py3-none-any.whl

filemaker_patchwork-0.1.0.dist-info/METADATA

@@ -0,0 +1,245 @@
+Metadata-Version: 2.4
+Name: filemaker-patchwork
+Version: 0.1.0
+Summary: Let your AI agent edit FileMaker: fields, scripts, value lists, layouts and themes, checked and reversible. MCP server for Claude Code, Cursor, Codex and Antigravity.
+Author: Abdeltoto
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Abdeltoto/patchwork-filemaker-mcp
+Project-URL: Issues, https://github.com/Abdeltoto/patchwork-filemaker-mcp/issues
+Project-URL: Changelog, https://github.com/Abdeltoto/patchwork-filemaker-mcp/blob/main/CHANGELOG.md
+Keywords: filemaker,claris,fmupgradetool,fmp12,mcp,mcp-server,ai-agents,claude-code,cursor,codex,antigravity,low-code
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Database
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: image
+Requires-Dist: Pillow>=9; extra == "image"
+Dynamic: license-file
+
+<!-- mcp-name: io.github.Abdeltoto/patchwork -->
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/Abdeltoto/patchwork-filemaker-mcp/main/docs/images/banner.png" alt="Patchwork: let your AI agent edit FileMaker" width="100%">
+
+<br>
+
+[![CI](https://img.shields.io/github/actions/workflow/status/Abdeltoto/patchwork-filemaker-mcp/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/Abdeltoto/patchwork-filemaker-mcp/actions/workflows/ci.yml)
+[![Stars](https://img.shields.io/github/stars/Abdeltoto/patchwork-filemaker-mcp?style=flat-square&color=8b5cf6)](https://github.com/Abdeltoto/patchwork-filemaker-mcp/stargazers)
+[![License: MIT](https://img.shields.io/badge/license-MIT-14b8a6?style=flat-square)](https://github.com/Abdeltoto/patchwork-filemaker-mcp/blob/main/LICENSE)
+![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-3776AB?style=flat-square&logo=python&logoColor=white)
+![FileMaker 2026](https://img.shields.io/badge/FileMaker-2026-000000?style=flat-square&logo=claris&logoColor=white)
+![MCP server](https://img.shields.io/badge/MCP-server-000000?style=flat-square&logo=modelcontextprotocol&logoColor=white)
+![Zero dependencies](https://img.shields.io/badge/dependencies-0-f59e0b?style=flat-square)
+[![PRs welcome](https://img.shields.io/badge/PRs-welcome-ff69b4?style=flat-square)](https://github.com/Abdeltoto/patchwork-filemaker-mcp/blob/main/CONTRIBUTING.md)
+
+<a href="#connect-your-agent"><img src="https://img.shields.io/badge/Claude_Code-191919?style=for-the-badge&logo=claude&logoColor=D97757" alt="Claude Code"></a>
+<a href="#connect-your-agent"><img src="https://img.shields.io/badge/Cursor-000000?style=for-the-badge&logo=cursor&logoColor=white" alt="Cursor"></a>
+<a href="#connect-your-agent"><img src="https://img.shields.io/badge/Codex-000000?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHJlY3QgeD0iMS41IiB5PSIzIiB3aWR0aD0iMjEiIGhlaWdodD0iMTgiIHJ4PSI0IiBmaWxsPSJub25lIiBzdHJva2U9IiNmZmYiIHN0cm9rZS13aWR0aD0iMiIvPjxwYXRoIGQ9Ik02LjUgOWwzLjUgMy0zLjUgMyIgZmlsbD0ibm9uZSIgc3Ryb2tlPSIjZmZmIiBzdHJva2Utd2lkdGg9IjIiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCIvPjxwYXRoIGQ9Ik0xMi41IDE1LjVoNSIgc3Ryb2tlPSIjZmZmIiBzdHJva2Utd2lkdGg9IjIiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPjwvc3ZnPg==" alt="Codex"></a>
+<a href="#connect-your-agent"><img src="https://img.shields.io/badge/Antigravity-1a1a2e?style=for-the-badge&logo=google&logoColor=4285F4" alt="Google Antigravity"></a>
+
+**[Quick start](#quick-start)** · **[Examples](#see-it-in-action)** · **[Connect your agent](#connect-your-agent)** · **[What it can change](#what-it-can-change)** · **[Field guide](https://github.com/Abdeltoto/patchwork-filemaker-mcp/blob/main/docs/fmupgradetool-field-guide.md)** · **[Français](https://github.com/Abdeltoto/patchwork-filemaker-mcp/blob/main/README.fr.md)**
+
+</div>
+
+<br>
+
+> **Friday, 4 PM. A client asks for "just one more field" on the detail layout.**
+> You know the drill: define the field, copy the label, nudge every object below it, stretch the part… then do it all again on the next layout.
+>
+> **Patchwork lets your AI agent do those clicks for you.** Just ask, in your own words, the way you would ask a colleague. Your agent adds the field and places it right where you said, writes scripts, creates value lists and restyles layouts, in a real `.fmp12` file. Every change is checked, every change can be undone, and your original file is never touched.
+
+Free and open source. Works with Claude Code, Cursor, Codex and Antigravity.
+
+<p align="center"><a href="https://youtu.be/AkFhBpB0YYY"><img src="https://raw.githubusercontent.com/Abdeltoto/patchwork-filemaker-mcp/main/docs/images/video-card.jpg" alt="Watch the 90-second Patchwork intro on YouTube" width="80%"></a><br><sub>▶ <a href="https://youtu.be/AkFhBpB0YYY">Watch the 90-second intro on YouTube</a> · <a href="https://youtu.be/g5UkJLiYAhA">Version française</a></sub></p>
+
+## Quick start
+
+Three commands, then you just talk to your agent.
+
+```bash
+pip install filemaker-patchwork
+patchwork doctor          # finds the Claris command-line tools
+patchwork init .          # wires this folder for Claude Code, Cursor, Codex and Antigravity
+```
+
+No install with [uv](https://docs.astral.sh/uv/): `uvx filemaker-patchwork doctor`, and `uvx filemaker-patchwork mcp` as the MCP server command.
+
+Then ask your agent: *"Open Invoice.fmp12 and add a Status field to Clients."* That's it.
+
+### Good to know
+
+- **It changes structure, not records.** Fields, scripts, layouts, value lists, themes. For your data, use the Data API or OData.
+- **It works on closed files, not hosted ones.** Edit a copy, test it, then deploy it as you usually do.
+- **It needs the Claris command-line tools** (FMUpgradeTool and FMDeveloperTool). They come with the FileMaker Server installer, the free trial works, and no server has to run: [install the Claris tools](https://github.com/Abdeltoto/patchwork-filemaker-mcp/blob/main/docs/install-fmupgradetool.md). Patchwork itself has no other dependency.
+
+## See it in action
+
+Four real sessions on the free [Claris Invoice solution](https://marketplace.claris.com/detail/2000.html). For each one: what was asked, what the agent did, and the file before and after. No mockups.
+
+<p align="center"><img src="https://raw.githubusercontent.com/Abdeltoto/patchwork-filemaker-mcp/main/docs/images/example-schema.png" alt="Prompt: add a Loyalty Tier field and a value list. The field and the value list appear in the file." width="100%"></p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/Abdeltoto/patchwork-filemaker-mcp/main/docs/images/example-script.png" alt="Prompt: write a Say Hello script. The agent copies a real dialog step and creates a two-step script." width="100%"></p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/Abdeltoto/patchwork-filemaker-mcp/main/docs/images/example-cleanup.png" alt="Prompt: remove the Dev layouts. Six layouts are deleted and the agent warns about three scripts that pointed at them." width="100%"></p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/Abdeltoto/patchwork-filemaker-mcp/main/docs/images/example-rebrand.png" alt="Prompt: rebrand for Maple and Oak. The blue Claris header becomes a forest green Maple and Oak header." width="100%"></p>
+
+## How it works
+
+<p align="center"><img src="https://raw.githubusercontent.com/Abdeltoto/patchwork-filemaker-mcp/main/docs/images/how-it-works.jpg" alt="An AI agent stitches patches onto a FileMaker file, with a verified check and an undo arrow" width="80%"></p>
+
+Why can't your agent just do this on its own? A FileMaker file is a binary file, and its structure hides behind dialogs an agent cannot click. Claris does ship a command-line way in, [FMUpgradeTool](https://help.claris.com/en/app-upgrade-tool-guide/content/index.html), but it is picky: every object is addressed by a UUID, and a patch that is slightly wrong is **silently skipped**, while the tool still prints `Patch File Applied`.
+
+Patchwork is the careful assistant in between:
+
+| | |
+|:-:|---|
+| 🧵 **Writes the patch** | Reads the file's XML export and builds a patch with the right UUIDs, ids and catalog structure, so your agent doesn't have to |
+| 🔍 **Checks the result** | Re-exports the file after every change and compares it with the previous version. If FileMaker skipped something, the change is refused, not silently lost |
+| 🧭 **Warns before breaking** | Before a delete, it lists the scripts, layouts and calculations that use the object, and waits for your OK |
+| 🕐 **Keeps every version** | Each change is a numbered version with its diff. Changed your mind? `undo` always works |
+| 🔒 **Protects the original** | Everything happens on a working copy. `save` writes a new file and never overwrites yours |
+
+More in [how it works](https://github.com/Abdeltoto/patchwork-filemaker-mcp/blob/main/docs/how-it-works.md).
+
+## Connect your agent
+
+One command sets everything up. Run `patchwork init .` in your project folder, new or existing: it adds the rules, the skills and the MCP configuration for every agent, and keeps the files you already have.
+
+| Agent | Configuration written by `init` | Then |
+|---|---|---|
+| <img src="https://cdn.simpleicons.org/claude/D97757" width="16"> **Claude Code** | `.mcp.json` · `CLAUDE.md` · `.claude/skills/` | Run `claude` in the folder and approve `patchwork` |
+| <img src="https://cdn.simpleicons.org/cursor/808080" width="16"> **Cursor** | `.cursor/mcp.json` · `.cursor/skills/` | Enable `patchwork` in Settings › MCP |
+| ⌨️ **Codex** | `.codex/config.toml` · `AGENTS.md` · `.agents/skills/` | Trust the project when Codex asks |
+| <img src="https://cdn.simpleicons.org/google/4285F4" width="16"> **Antigravity** | `.agents/mcp_config.json` · `AGENTS.md` · `.agents/skills/` | Open the folder as a workspace |
+
+Every agent gets the same 21 tools through `patchwork mcp`, a stdio MCP server. Your file's password stays yours: set it once in your shell with `PATCHWORK_PASSWORD`, and agents never see it. Manual setup and the full tool list: [AI agents](https://github.com/Abdeltoto/patchwork-filemaker-mcp/blob/main/docs/ai-agents.md).
+
+## What it can change
+
+Fields, plain-text scripts, value lists, colors and fonts, even a full rebrand. Every operation below was tried on real files and confirmed by re-exporting them.
+
+| | Add | Edit | Delete |
+|---|:-:|:-:|:-:|
+| **Fields** · text, number, date, time, timestamp, container, calculation, global | ✅ | | ✅ |
+| **Scripts**, read and written as FileMaker text | ✅ | ✅ | ✅ |
+| **Value lists** | ✅ | ✅ | ✅ |
+| **Custom functions** | ✅ | ✅ | ✅ |
+| **Layouts** · place a field with its label, whole layout, colors, fonts, swap a field | ✅ field | ✅ | ✅ |
+| **Themes** · colors, fonts, name | | ✅ | |
+| **Tables**, table occurrences | 👁 read | | |
+
+> [!TIP]
+> Scripts read and write the way the Script Workspace shows them, one step per line:
+> `Set Field [ Clients::Status ; "Gold" ]`. Edit the text of `patchwork show script NAME` and send it back with `set-steps`: untouched lines keep their exact step, and every step is re-read after the change, so a dropped parameter is caught.
+
+What FMUpgradeTool cannot do (record data, a brand-new theme, a single layout object on its own) is listed in [the field guide](https://github.com/Abdeltoto/patchwork-filemaker-mcp/blob/main/docs/fmupgradetool-field-guide.md).
+
+## Use it without an agent
+
+Prefer the terminal? Everything the agent does is a plain command you can run yourself:
+
+```bash
+patchwork open "Invoice.fmp12" --account Admin     # working copy, version v000
+patchwork add-field Clients "Loyalty Tier"
+patchwork add-value-list "Loyalty Tiers" Bronze Silver Gold
+patchwork log                                       # every version and what changed
+patchwork undo
+patchwork save "Invoice v2.fmp12"
+```
+
+<details>
+<summary><b>All commands</b></summary>
+
+<br>
+
+| Command | What it does |
+|---|---|
+| `open SRC --account NAME` | Starts a working copy in `.patchwork/` (version v000). The source is never modified |
+| `status`, `log` | Current version, and every version with what changed |
+| `ls [KIND] [TABLE]` | Lists layouts, scripts, value lists, custom functions, themes, tables, fields |
+| `show KIND NAME` | Prints a script as FileMaker text (`--xml` for XML), anything else as XML. `show step NAME` prints a real example of a step |
+| `add-field TABLE NAME` | Adds a field: `--type`, `--calc`, `--global`, `--image logo.png` |
+| `add-value-list NAME VALUES...` | Adds a custom value list |
+| `add-custom-function NAME --calc` | Adds a custom function, with `--param` |
+| `add-script NAME STEPS.txt` | Creates a script from FileMaker script text (or `<Step>` XML) |
+| `set-steps`, `append-steps` | Rewrites a script with edited text from `show`, or adds steps at the end |
+| `place-field LAYOUT TO::FIELD --near FIELD` | Puts a field on a layout below another one, with a copy of its look and label. `--side right`, `--label` |
+| `replace KIND NAME FILE.xml` | Replaces an object with your edited version of `show` |
+| `uses KIND NAME` | Lists what references an object, and where its name appears in calculations |
+| `delete KIND NAME` | Deletes a script, layout, value list, custom function or field. Refused while other objects reference it, unless `--force` |
+| `retheme`, `recolor-layouts` | Rewrites colors and fonts of a theme, or of the layouts' local styles |
+| `push PATCH.xml` | Applies a hand-written FMUpgradeTool patch, with the same checks |
+| `undo` | Drops the last version |
+| `save DEST` | Writes the current version to a new `.fmp12` |
+| `rebrand SRC DEST --brand brand.json` | One shot: colors, fonts, logo and theme name on a whole solution |
+| `mcp` | The MCP server for agents |
+| `init DIR` | Wires a folder for Claude Code, Cursor, Codex and Antigravity |
+| `doctor` | Shows which Claris tools Patchwork found |
+
+Every editing command takes `-m "note"` for the log and `--dry-run` to write the patch without applying it. More in [examples and recipes](https://github.com/Abdeltoto/patchwork-filemaker-mcp/tree/main/examples).
+
+</details>
+
+## The FMUpgradeTool field guide
+
+The [field guide](https://github.com/Abdeltoto/patchwork-filemaker-mcp/blob/main/docs/fmupgradetool-field-guide.md) collects every trap FMUpgradeTool sets without telling you, found the hard way on real files. Useful even if you never use Patchwork. A taste:
+
+- without `--generateGUIDs`, theme and field patches are skipped;
+- a layout's UUID is **not** the first `<UUID>` inside it;
+- replacing one layout object is skipped, replacing the whole layout works;
+- deleting a script step needs a `ScriptReference` inside each `ScriptStepReference`.
+
+Found another one? [Add it](https://github.com/Abdeltoto/patchwork-filemaker-mcp/issues/new?template=field-guide.yml).
+
+## FAQ
+
+<details>
+<summary><b>Does it work on hosted files?</b></summary>
+<br>
+It works on closed <code>.fmp12</code> files on disk. Take a copy of the hosted file, edit it, test it, then deploy it as you usually do, or move the data with the Claris Data Migration Tool.
+</details>
+
+<details>
+<summary><b>Can the agent change records?</b></summary>
+<br>
+No, FMUpgradeTool changes structure only. For records, use the Data API or OData. The <code>fm-data</code> skill explains how.
+</details>
+
+<details>
+<summary><b>Which FileMaker versions?</b></summary>
+<br>
+Developed and verified with FileMaker 2026 (26.0.3). Earlier versions that ship FMUpgradeTool and <code>FMDeveloperTool --saveAsXML</code> should work but are untested. A report either way is very welcome.
+</details>
+
+<details>
+<summary><b>macOS and Linux?</b></summary>
+<br>
+Wherever the Claris tools run. CI runs on Windows, macOS and Linux.
+</details>
+
+<details>
+<summary><b>Is my password safe with an agent?</b></summary>
+<br>
+Yes. It is read from the <code>PATCHWORK_PASSWORD</code> environment variable, passed to the Claris tools, and printed as <code>***</code>. It is never written in a configuration file or shown to the agent.
+</details>
+
+## Contributing
+
+Found a new FMUpgradeTool trap, wrote a recipe, or want a new operation? Everything is welcome: start with [CONTRIBUTING.md](https://github.com/Abdeltoto/patchwork-filemaker-mcp/blob/main/CONTRIBUTING.md). And if Patchwork gives you your Friday afternoon back, a ⭐ helps other FileMaker developers find it.
+
+<a href="https://star-history.com/#Abdeltoto/patchwork-filemaker-mcp&Date">
+  <img src="https://api.star-history.com/svg?repos=Abdeltoto/patchwork-filemaker-mcp&type=Date" alt="Star history" width="600">
+</a>
+
+## License
+
+[MIT](https://github.com/Abdeltoto/patchwork-filemaker-mcp/blob/main/LICENSE). Patchwork is a community project, not affiliated with or endorsed by Claris International Inc. FileMaker and Claris are trademarks of Claris International Inc. Other product names and logos belong to their owners.

filemaker_patchwork-0.1.0.dist-info/RECORD

@@ -0,0 +1,28 @@
+filemaker_patchwork-0.1.0.dist-info/licenses/LICENSE,sha256=tYpPJpuSYncF1HiTGOgl5M215KDfX2b7WhfpnGN0UPM,1093
+patchwork/__init__.py,sha256=-TW4CHTQrh5b5aod0Jf_cGmaNOoIX2XLZFA0t9tn0sc,211
+patchwork/__main__.py,sha256=hQWhtFhhRDv2VHKgv2GPoUboHChvzL9PPVZ3bJakvKs,61
+patchwork/build.py,sha256=lFzj4HlhXp_A8TYtHdPStn_M2TG8lBR2gBrEzGMjU58,10099
+patchwork/cli.py,sha256=VcObp7ZE1SeraAZziS39v_-kqleDXqSv9giMj8hsb3w,16604
+patchwork/export.py,sha256=9evQDjFlVEEM0piJ3SBfz2WQcRPs9XIEx-L_7bUFyoU,6765
+patchwork/mcp.py,sha256=xTvyqvfvomtzdZcdgZ6knrMIel82NC2iYttYMig-u6A,12684
+patchwork/objects.py,sha256=azG8ksbR-BsL1qJ2acmYoXYW4EXmBAmI1xHfnpOhCRM,15326
+patchwork/ops.py,sha256=twTiEJ7YnrziW1iJztM4bcGfZdUbPtKdcY0q0rS3t7k,12332
+patchwork/place.py,sha256=HAnW1-J-Gb27i3L5WMFTWYiH25q4YosnbfGrJn2pRU4,9442
+patchwork/project.py,sha256=iAqMhSnlHjLe1vVfsRMSmpZ0DDfm4bGzUybM5BWgwLo,3756
+patchwork/rebrand.py,sha256=yPNrsAsQlCqvGnDLnJ71svSq-NJQ-23IeMzOJ1Ry6V4,5821
+patchwork/script.py,sha256=CWYiLMbuYCWJYPSKPm0Q-NnKUcf9OLTTeAHbHtxl13M,20795
+patchwork/tools.py,sha256=R5K2viv9Y1Ygw8gHkQqSrUvNScQFoq90QDX4YyQa2Tg,7293
+patchwork/uses.py,sha256=A8d67oFX7o4X11bpW_ZOsdjhyKoagKeD3FEjVz5Uds8,6064
+patchwork/workspace.py,sha256=wUoE0W2WVJLP_CBg6VcTe1D3Vx9fwPrlPjrBZpHfSbY,6827
+patchwork/skills/fm-data/SKILL.md,sha256=rIZd1csH4AsKBhA-mSnyQeUjqlyQKNvMumclZJJYOyM,825
+patchwork/skills/fm-explore/SKILL.md,sha256=oGRrc7_ifVOTTOong1o5MW5_6HGA9jl_TJpVYFQcghs,1080
+patchwork/skills/fm-standards/SKILL.md,sha256=aHwfSlc_jOjeTPI64dWXM6aHWMzPY4OhLpPIv0Da58o,931
+patchwork/skills/patchwork/SKILL.md,sha256=nzmJU0IS7Hz_HbSsL_N337xDxRNA9iUARehIni7FIyw,4767
+patchwork/templates/AGENTS.md,sha256=ry3_Rf3zywEWj4FEv_UFTlS3uW95nIaPNdmZiZ6aGEI,2216
+patchwork/templates/gitignore,sha256=_p3SXFZkpN-dtsh1FvMp5bUDHRiD9oAfIh8uOdbFNEc,132
+patchwork/templates/naming.md,sha256=GkyqgjTvBPHvbftMgW8VJ9ZwFfprlj19nPrRe1IIZZE,344
+filemaker_patchwork-0.1.0.dist-info/METADATA,sha256=KEcQZFbKyifxgkXaqiyzBzBI0Zf29su9iQRKsDsjr28,17220
+filemaker_patchwork-0.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+filemaker_patchwork-0.1.0.dist-info/entry_points.txt,sha256=Ad6JebZC0Te3zIxYcJcXWZl9iUA2YnuLBTgBe43Pgog,90
+filemaker_patchwork-0.1.0.dist-info/top_level.txt,sha256=aLF4R1vFf2HfqmKmZHlBkLny_-8Ye5nT-Pi8pKL2vE8,10
+filemaker_patchwork-0.1.0.dist-info/RECORD,,

filemaker_patchwork-0.1.0.dist-info/WHEEL

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

filemaker_patchwork-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+filemaker-patchwork = patchwork.cli:main
+patchwork = patchwork.cli:main

filemaker_patchwork-0.1.0.dist-info/licenses/LICENSE

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

filemaker_patchwork-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+patchwork

patchwork/__init__.py

@@ -0,0 +1,7 @@
+"""Patchwork: patch FileMaker files from code, with Claris FMUpgradeTool."""
+
+__version__ = "0.1.0"
+
+
+class PatchworkError(Exception):
+    """An error the user can fix. The CLI prints it without a traceback."""

patchwork/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+from patchwork.cli import main
+
+sys.exit(main())

patchwork/build.py

@@ -0,0 +1,249 @@
+"""Build FMUpgradeTool patches (root element FMUpgradeToolPatch) from an Export.
+
+Rules learned on real files, all enforced here:
+- Replace a whole layout or a whole theme. A lone LayoutObject replace, a ReplaceAction
+  around a LayoutCatalog and an AddAction of a new theme are skipped by FMUpgradeTool.
+- An added field needs membercount="1", a <TagList> after the catalog UUID, and id = max + 1.
+- A FieldReference in a layout may carry repetition="1"; it must be kept.
+"""
+
+from __future__ import annotations
+
+import base64
+import io
+import re
+import uuid
+from pathlib import Path
+
+from patchwork import PatchworkError
+from patchwork.export import Export, escape
+
+PATCH_VERSION = "2.3.0.0"
+CALC_MAX_CHARS = 28000
+RGBA = re.compile(r"rgba\(([\d.]+)%,([\d.]+)%,([\d.]+)%,([\d.]+)\)")
+FIELD_TYPES = {
+    "Text": "Text",
+    "Number": "Number",
+    "Date": "Date",
+    "Time": "Time",
+    "Timestamp": "TimeStamp",
+    "Container": "Binary",
+}
+
+
+def recolor(css: str, colors: dict[str, str]) -> str:
+    """Swap hex colors inside FileMaker rgba(r%,g%,b%,a) values. Alpha is kept."""
+    table = {normalize_hex(k): normalize_hex(v) for k, v in colors.items()}
+    if not table:
+        return css
+
+    def repl(match: re.Match) -> str:
+        rgb = "".join(f"{round(float(match.group(i)) * 2.55):02X}" for i in (1, 2, 3))
+        new = table.get(rgb)
+        if not new:
+            return match.group(0)
+        parts = [int(new[i:i + 2], 16) / 255 * 100 for i in (0, 2, 4)]
+        values = ",".join(f"{p:.4f}".rstrip("0").rstrip(".") + "%" for p in parts)
+        return f"rgba({values},{match.group(4)})"
+
+    return RGBA.sub(repl, css)
+
+
+def palette(css: str) -> list[tuple[str, int]]:
+    """Hex colors used in a block of FileMaker CSS, most frequent first."""
+    found = ["".join(f"{round(float(m.group(i)) * 2.55):02X}" for i in (1, 2, 3)) for m in RGBA.finditer(css)]
+    counts: dict[str, int] = {}
+    for color in found:
+        counts[color] = counts.get(color, 0) + 1
+    return sorted(counts.items(), key=lambda item: (-item[1], item[0]))
+
+
+def palette(css: str) -> list[tuple[str, int]]:
+    """Hex colors used in a block of FileMaker CSS, most frequent first."""
+    found = ["".join(f"{round(float(m.group(i)) * 2.55):02X}" for i in (1, 2, 3)) for m in RGBA.finditer(css)]
+    counts: dict[str, int] = {}
+    for color in found:
+        counts[color] = counts.get(color, 0) + 1
+    return sorted(counts.items(), key=lambda item: (-item[1], item[0]))
+
+
+def normalize_hex(value: str) -> str:
+    value = value.strip().lstrip("#").upper()
+    if not re.fullmatch(r"[0-9A-F]{6}", value):
+        raise PatchworkError(f"Color must be a 6-digit hex value like 2F5D50: {value}")
+    return value
+
+
+def remap_fonts(css: str, fonts: dict[str, str]) -> str:
+    """Fonts are written -fm-font-family(WindowsName,MacPostScriptName)."""
+    for old, new in fonts.items():
+        css = css.replace(f"-fm-font-family({old})", f"-fm-font-family({new})")
+    return css
+
+
+def wrap(*actions: str, version: str = PATCH_VERSION) -> str:
+    """The patch version must equal the FMSaveAsXML version of the export it was built from."""
+    body = "".join(a for a in actions if a)
+    return (
+        '<?xml version="1.0" encoding="UTF-8"?>\n'
+        f'<FMUpgradeToolPatch version="{version}">\n\t<Structure>\n'
+        f"{body}\t</Structure>\n</FMUpgradeToolPatch>\n"
+    )
+
+
+def replace_action(blocks: list[tuple[str, str, str]]) -> str:
+    """blocks: (type, UUID, XML) for each Replace."""
+    if not blocks:
+        return ""
+    inner = "".join(f'\t\t\t<Replace type="{kind}" UUID="{uid}">\n{xml}\n\t\t\t</Replace>\n' for kind, uid, xml in blocks)
+    return f"\t\t<ReplaceAction>\n{inner}\t\t</ReplaceAction>\n"
+
+
+def field_xml(
+    export: Export,
+    table: str,
+    name: str,
+    kind: str = "Text",
+    comment: str = "",
+    is_global: bool = False,
+    calc: str | None = None,
+    context: str | None = None,
+) -> str:
+    if kind not in FIELD_TYPES:
+        raise PatchworkError(f"Unknown field type: {kind}. Choose from {', '.join(FIELD_TYPES)}.")
+    if export.has_field(table, name):
+        raise PatchworkError(f"{table}::{name} already exists.")
+    field_id = export.next_field_id(table)
+    head = (
+        f'<Field id="{field_id}" name="{escape(name)}" fieldtype="{"Calculated" if calc else "Normal"}" '
+        f'datatype="{FIELD_TYPES[kind]}" comment="{escape(comment)}">\n'
+        f"\t<UUID>{new_uuid()}</UUID>\n"
+    )
+    language = '\t\t<LanguageReference name="English" id="21"></LanguageReference>\n'
+    flag = "True" if is_global else "False"
+    if calc:
+        if len(calc) > CALC_MAX_CHARS:
+            raise PatchworkError(
+                f"Calculation too long ({len(calc)} characters, max {CALC_MAX_CHARS}). "
+                "For an image, pass a smaller width."
+            )
+        occurrence = export.table_occurrence(context or table)
+        body = (
+            '\t<AutoEnter alwaysEvaluate="False"></AutoEnter>\n'
+            f'\t<Storage storeCalculationResults="True" global="{flag}" maxRepetitions="1">\n{language}\t</Storage>\n'
+            f"\t<Calculation>\n\t\t{occurrence}\n\t\t<Text><![CDATA[{calc}]]></Text>\n\t</Calculation>\n"
+        )
+    else:
+        storage = (
+            f'\t<Storage global="{flag}" maxRepetitions="1"></Storage>\n'
+            if kind == "Container"
+            else f'\t<Storage autoIndex="True" index="None" global="{flag}" maxRepetitions="1">\n{language}\t</Storage>\n'
+        )
+        body = (
+            '\t<AutoEnter type="" prohibitModification="False"></AutoEnter>\n'
+            '\t<Validation alwaysValidate="False" type="OnlyDuringDataEntry" allowOverride="True" '
+            'notEmpty="False" unique="False" existing="False"></Validation>\n'
+            f"{storage}"
+        )
+    return head + body + '\t<TagList></TagList>\n\t<Annotation></Annotation>\n\t<DisplayNames enable="False"></DisplayNames>\n</Field>\n'
+
+
+def add_field_action(export: Export, table: str, field: str) -> str:
+    catalog_uuid, base_ref, _ = export.field_catalog(table)
+    return (
+        "\t\t<AddAction>\n"
+        '\t\t\t<FieldsForTables membercount="1">\n'
+        f"\t\t\t\t<FieldCatalog>\n\t\t\t\t\t<UUID>{catalog_uuid}</UUID>\n"
+        "\t\t\t\t\t<TagList></TagList>\n"
+        f"\t\t\t\t\t{base_ref}\n"
+        f'\t\t\t\t\t<ObjectList membercount="1">\n{field}\t\t\t\t\t</ObjectList>\n'
+        "\t\t\t\t</FieldCatalog>\n\t\t\t</FieldsForTables>\n"
+        "\t\t</AddAction>\n"
+    )
+
+
+def add_field_patch(export: Export, table: str, field: str) -> str:
+    return wrap(add_field_action(export, table, field), version=export.version)
+
+
+def image_calc(png: Path, width: int | None = None) -> str:
+    """A calculation that turns an embedded PNG into container data."""
+    if not png.is_file():
+        raise PatchworkError(f"Image not found: {png}")
+    data = png.read_bytes()
+    if width:
+        try:
+            from PIL import Image
+        except ImportError as exc:
+            raise PatchworkError("Resizing an image needs Pillow: pip install \"filemaker-patchwork[image]\"") from exc
+        img = Image.open(png).convert("RGBA")
+        img = img.resize((width, round(img.height * width / img.width)), Image.LANCZOS)
+        buf = io.BytesIO()
+        img.save(buf, "PNG", optimize=True)
+        data = buf.getvalue()
+    encoded = base64.b64encode(data).decode("ascii")
+    return f'Base64Decode ( "{encoded}" ; "{png.stem}.png" )'
+
+
+def theme_replace(export: Export, label: str, rename: str | None, colors: dict, fonts: dict) -> str:
+    theme = export.theme(label)
+    xml = recolor(remap_fonts(theme.xml, fonts), colors)
+    if rename:
+        xml = re.sub(r'Display="[^"]*"', f'Display="{escape(rename)}"', xml, count=1)
+    return replace_action([("Theme", theme.uuid, xml)])
+
+
+def theme_patch(export: Export, label: str, rename: str | None, colors: dict, fonts: dict) -> str:
+    return wrap(theme_replace(export, label, rename, colors, fonts), version=export.version)
+
+
+def layouts_patch(
+    export: Export,
+    only: list[str] | None = None,
+    colors: dict | None = None,
+    fonts: dict | None = None,
+    remap: tuple[str, str] | None = None,
+) -> tuple[str, list[str]]:
+    """Rewrite only the layouts that change. Returns (patch, names of changed layouts)."""
+    colors, fonts = colors or {}, fonts or {}
+    pattern = target = None
+    if remap:
+        (src_table, src_name), (dst_table, dst_name) = split_field(remap[0]), split_field(remap[1])
+        if src_table != dst_table:
+            raise PatchworkError("A field can only be swapped for another field of the same table.")
+        _, src_uuid = export.field(src_table, src_name)
+        dst_id, dst_uuid = export.field(dst_table, dst_name)
+        pattern = re.compile(rf'<FieldReference id="\d+" name="[^"]*"( repetition="\d+")? UUID="{src_uuid}">')
+        target = rf'<FieldReference id="{dst_id}" name="{escape(dst_name)}"\1 UUID="{dst_uuid}">'
+    if only:
+        known = {layout.name for layout in export.layouts()}
+        missing = [name for name in only if name not in known]
+        if missing:
+            raise PatchworkError(f"Layout not found: {', '.join(missing)}")
+    blocks, names = [], []
+    for layout in export.layouts():
+        if only and layout.name not in only:
+            continue
+        xml = recolor(remap_fonts(layout.xml, fonts), colors)
+        if pattern:
+            xml = pattern.sub(target, xml)
+        if xml != layout.xml:
+            blocks.append(("Layout", layout.uuid, xml))
+            names.append(layout.name)
+    return wrap(replace_action(blocks), version=export.version), names
+
+
+def extract_layout_patch(export: Export, name: str) -> str:
+    layout = export.layout(name)
+    return wrap(replace_action([("Layout", layout.uuid, layout.xml)]), version=export.version)
+
+
+def split_field(qualified: str) -> tuple[str, str]:
+    if "::" not in qualified:
+        raise PatchworkError(f"Expected a field as Table::Field, got: {qualified}")
+    table, name = qualified.split("::", 1)
+    return table, name
+
+
+def new_uuid() -> str:
+    return str(uuid.uuid4()).upper()