syncmoss 0.4.1__tar.gz → 0.4.2__tar.gz

syncmoss-0.4.2/.gitattributes

@@ -0,0 +1,3 @@
+# Verbatim license texts: keep LF on every OS, so Windows checkouts (and the
+# Windows bundle) carry the files byte-for-byte as published by gnu.org.
+bundle/licenses/*.txt text eol=lf

{syncmoss-0.4.1 → syncmoss-0.4.2}/.github/workflows/_MacOS.yml

@@ -3,7 +3,8 @@ name: _macOS (PyInstaller universal2 app)
 # Modelled on crispy's release workflow (github.com/mretegan/crispy):
 #   1. build the app natively on an Apple Silicon AND an Intel runner,
 #   2. fuse the two bundles into one universal2 SYNCmoss.app,
-#   3. sign it (Developer ID + hardened runtime), pack the DMG, notarize, staple.
+#   3. sign it (Developer ID + hardened runtime), pack the drag-and-drop DMG
+#      (window laid out as crispy's create-dmg.sh does), notarize, staple.
 #
 # Signing and notarization run only when the Apple secrets are set (repository
 # Settings -> Secrets and variables -> Actions; release.yml forwards them).
@@ -136,6 +137,8 @@ jobs:
     runs-on: macos-15
     timeout-minutes: 90
     steps:
+      - uses: actions/checkout@v6
+
       - uses: actions/setup-python@v6
         with:
           python-version: "3.13"
@@ -377,25 +380,119 @@ jobs:
           ditto dist/universal2/SYNCmoss.app "${RUNNER_TEMP}/smoke/SYNCmoss.app"
           "${RUNNER_TEMP}/smoke/SYNCmoss.app/Contents/MacOS/SYNCmoss" --test
 
+      # The drag-and-drop installer window, built as crispy's
+      # package/create-dmg.sh does: a writable image holding the app, a link to
+      # /Applications, the background picture (bundle/dmg_background.pdf) and
+      # the volume icon; Finder lays the window out (positions match the
+      # picture); then it is converted to the compressed read-only DMG.
       - name: Create the DMG
         run: |
           set -euo pipefail
+          APP="dist/universal2/SYNCmoss.app"
           STAGING="${RUNNER_TEMP}/dmg"
-          mkdir -p "${STAGING}"
-          ditto dist/universal2/SYNCmoss.app "${STAGING}/SYNCmoss.app"
+          RW_DMG="${RUNNER_TEMP}/SYNCmoss-rw.dmg"
+          rm -rf "${STAGING}" "${RW_DMG}"
+
+          mkdir -p "${STAGING}/.background" "${STAGING}/.fseventsd"
+          ditto "${APP}" "${STAGING}/SYNCmoss.app"
           ln -s /Applications "${STAGING}/Applications"
-          # hdiutil is occasionally "Resource busy" on hosted runners: retry.
+          cp bundle/dmg_background.pdf "${STAGING}/.background/background.pdf"
+          # The volume shows the app's own icon.
+          ICON_FILE="$(/usr/libexec/PlistBuddy -c 'Print :CFBundleIconFile' "${APP}/Contents/Info.plist")"
+          case "${ICON_FILE}" in *.icns) ;; *) ICON_FILE="${ICON_FILE}.icns" ;; esac
+          cp "${APP}/Contents/Resources/${ICON_FILE}" "${STAGING}/.VolumeIcon.icns"
+          touch "${STAGING}/.fseventsd/no_log"
+
+          # Room for the .DS_Store Finder writes. hdiutil is occasionally
+          # "Resource busy" on hosted runners: retry.
+          SIZE_MB=$(( $(du -sm "${STAGING}" | cut -f1) + 50 ))
           for attempt in 1 2 3; do
-            if hdiutil create -volname SYNCmoss -srcfolder "${STAGING}" -ov -format UDZO -imagekey zlib-level=9 dist/SYNCmoss.dmg; then
+            if hdiutil create -format UDRW -fs APFS -volname SYNCmoss -size "${SIZE_MB}m" \
+                -srcfolder "${STAGING}" -ov "${RW_DMG}"; then
               break
             fi
             if [ "${attempt}" -eq 3 ]; then
               exit 1
             fi
-            echo "hdiutil failed, retrying in 10 s"
+            echo "hdiutil create failed, retrying in 10 s"
             sleep 10
           done
 
+          ATTACH="$(hdiutil attach -readwrite -noverify -noautoopen "${RW_DMG}" | grep '^/dev/')"
+          DEVICE="$(echo "${ATTACH}" | head -n 1 | awk '{print $1}')"
+          MOUNT_POINT="$(echo "${ATTACH}" | awk -F'\t' '$3 != "" {print $3}' | tail -n 1 | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')"
+          echo "Attached ${DEVICE} at ${MOUNT_POINT}"
+          if [ ! -d "${MOUNT_POINT}" ]; then
+            echo "::error::could not find where the image was mounted"
+            echo "${ATTACH}"
+            exit 1
+          fi
+          SetFile -a C "${MOUNT_POINT}"
+          SetFile -a V "${MOUNT_POINT}/.background"
+
+          LAYOUT="${RUNNER_TEMP}/dmg-layout.applescript"
+          cat > "${LAYOUT}" <<'EOF'
+          on run argv
+              tell application "Finder"
+                  tell disk (item 1 of argv)
+                      open
+                      set current view of container window to icon view
+                      set toolbar visible of container window to false
+                      set statusbar visible of container window to false
+                      set bounds of container window to {200, 120, 700, 420}
+                      set viewOptions to the icon view options of container window
+                      set arrangement of viewOptions to not arranged
+                      set icon size of viewOptions to 96
+                      set background picture of viewOptions to file ".background:background.pdf"
+                      set position of item "SYNCmoss.app" to {114, 124}
+                      set position of item "Applications" to {386, 124}
+                      close
+                      open
+                      delay 1
+                      update without registering applications
+                      delay 2
+                      close
+                  end tell
+              end tell
+          end run
+          EOF
+          # Finder scripting can time out on a busy runner: retry.
+          for attempt in 1 2 3; do
+            if osascript "${LAYOUT}" "$(basename "${MOUNT_POINT}")"; then
+              break
+            fi
+            if [ "${attempt}" -eq 3 ]; then
+              echo "::error::Finder could not lay out the DMG window"
+              exit 1
+            fi
+            echo "Finder layout failed, retrying in 5 s"
+            sleep 5
+          done
+          # Finder saves the layout in .DS_Store when the window closes.
+          for _ in $(seq 1 30); do
+            [ -f "${MOUNT_POINT}/.DS_Store" ] && break
+            sleep 1
+          done
+          if [ ! -f "${MOUNT_POINT}/.DS_Store" ]; then
+            echo "::error::Finder did not save the DMG window layout (.DS_Store)"
+            exit 1
+          fi
+
+          sync
+          for attempt in 1 2 3 4 5; do
+            if hdiutil detach "${DEVICE}"; then
+              break
+            fi
+            if [ "${attempt}" -eq 5 ]; then
+              hdiutil detach "${DEVICE}" -force
+              break
+            fi
+            echo "volume still busy, retrying in 5 s"
+            sleep 5
+          done
+          hdiutil convert "${RW_DMG}" -format UDZO -imagekey zlib-level=9 -ov -o dist/SYNCmoss.dmg
+          rm -f "${RW_DMG}"
+
       - name: Notarize and staple the DMG
         id: notarize
         if: steps.sign.outputs.developer_id == 'true'

{syncmoss-0.4.1 → syncmoss-0.4.2}/COPYING.txt

@@ -10,5 +10,11 @@ Third-party components are used under their respective licenses:
   - NumPy: BSD 3-Clause
   - SciPy: BSD 3-Clause
   - Matplotlib: BSD-compatible
+  - Numba: BSD 2-Clause
+  - llvmlite: BSD 2-Clause (contains LLVM: Apache 2.0 with LLVM Exceptions)
+  - Bliss (optional, not included; used only if installed separately):
+    LGPL v3.0
 
-For complete third-party license details, see NOTICE.txt.
+For complete third-party license details, see NOTICE.txt. The Windows and
+macOS bundles also carry the full license text of every third-party package
+they contain, in a "licenses" folder.

syncmoss-0.4.2/NOTICE.txt

@@ -0,0 +1,120 @@
+SYNCmoss - Third-Party Software Notices and Information
+=========================================================
+
+This project is licensed under the MIT License. See LICENSE for details.
+It uses the following third-party libraries, each distributed under
+their own license terms.
+
+The Windows and macOS bundles contain the full license text of every
+third-party package they include -- the libraries below, their own
+dependencies and the Python runtime -- in a "licenses" folder:
+  - Windows: _internal/licenses/
+  - macOS:   SYNCmoss.app/Contents/Resources/licenses/
+In the program, Supp -> License shows this notice and all of those texts.
+
+PySide6 (Qt for Python)
+-----------------------
+Licensed under the GNU Lesser General Public License (LGPL) v3.0
+Copyright (C) The Qt Company Ltd.
+https://www.qt.io/licensing/
+
+LGPL v3.0 COMPLIANCE NOTICE:
+This software dynamically links to PySide6. Under the terms of the
+LGPL v3.0, you may:
+  - Use this MIT-licensed software without your own code becoming LGPL.
+  - Replace the PySide6 library with any compatible version.
+  - Obtain PySide6 source code at:
+    https://code.qt.io/cgit/pyside/pyside-setup.git/
+  - Read the full LGPL v3.0 license, and the GNU GPL v3.0 it builds on,
+    in the bundles' licenses/LGPL-3.0.txt and licenses/GPL-3.0.txt, or at:
+    https://www.gnu.org/licenses/lgpl-3.0.html
+(The PySide6 wheels themselves carry only a Qt commercial-license notice,
+which is why the two texts are shipped separately.) Qt itself contains
+third-party components (FreeType, HarfBuzz, libpng, zlib, ...) under their
+own licenses; The Qt Company lists them at
+https://doc.qt.io/qt-6/licenses-used-in-qt.html
+
+NumPy
+-----
+Licensed under the BSD 3-Clause License
+Copyright (c) 2005-2025, NumPy Developers
+https://numpy.org/doc/stable/license.html
+
+SciPy
+-----
+Licensed under the BSD 3-Clause License
+Copyright (c) 2001-2002 Enthought, Inc. 2003, SciPy Developers
+https://scipy.org/scipylib/license.html
+
+Matplotlib
+----------
+Licensed under the Matplotlib License (BSD-compatible)
+Copyright (c) 2012- Matplotlib Development Team
+Copyright (c) 2002-2011 John D. Hunter
+https://matplotlib.org/stable/users/project/license.html
+
+Numba
+-----
+Licensed under the BSD 2-Clause License
+Copyright (c) 2012, Anaconda, Inc.
+https://github.com/numba/numba/blob/main/LICENSE
+
+llvmlite
+--------
+Licensed under the BSD 2-Clause License
+Copyright (c) 2014, Anaconda, Inc.
+https://github.com/numba/llvmlite/blob/main/LICENSE
+It contains LLVM, licensed under the Apache License v2.0 with LLVM
+Exceptions (https://llvm.org/LICENSE.txt).
+
+Python
+------
+Licensed under the Python Software Foundation License
+Copyright (c) Python Software Foundation; All Rights Reserved
+https://docs.python.org/3/license.html
+The bundles contain the Python runtime; its LICENSE.txt is included as
+licenses/Python/LICENSE.txt. The C libraries built into the runtime
+(OpenSSL, expat, libffi, zlib, libmpdec, ...) and their licenses are
+listed at the address above.
+
+Microsoft Visual C++ Runtime (Windows bundle only)
+--------------------------------------------------
+Copyright (c) Microsoft Corporation
+The Windows bundle contains Microsoft's C and C++ run-time libraries
+(VCRUNTIME140*.dll, MSVCP140*.dll, VCOMP140.dll and, where present,
+ucrtbase.dll with the api-ms-win-*.dll forwarders). They are "Microsoft
+Distributable Code", which Microsoft allows to be redistributed unmodified
+with the programs that use them, provided that whoever uses or passes on
+the Windows bundle does not:
+  - alter any copyright, trademark or patent notice in Microsoft's
+    Distributable Code;
+  - use Microsoft's trademarks in their programs' names or in a way that
+    suggests the programs come from or are endorsed by Microsoft;
+  - distribute Microsoft's Distributable Code to run on a platform other
+    than Microsoft operating systems, run-time technologies or application
+    platforms; or
+  - include Microsoft Distributable Code in malicious, deceptive or
+    unlawful programs.
+These conditions apply only to Microsoft's files, not to SYNCmoss or to
+the other components. The full terms are in Microsoft's documentation
+(included in its developer tools and on microsoft.com).
+
+Bliss (optional -- NOT included)
+--------------------------------
+Licensed under the GNU Lesser General Public License (LGPL) v3.0
+Copyright (c) Beamline Control Unit, ESRF
+https://gitlab.esrf.fr/bliss/bliss
+SYNCmoss neither contains nor distributes Bliss, and the Windows and macOS
+bundles never include it. Only when Bliss has been installed separately
+(Linux beamline installations) does SYNCmoss import it at run time, to read
+spectra online from a Bliss channel.
+
+PyInstaller (bundling only)
+---------------------------
+Licensed under the GPL 2.0 with a special bootloader exception that
+permits distributing non-GPL applications bundled with PyInstaller.
+Copyright (c) 2010-2023, PyInstaller Development Team
+https://pyinstaller.org/en/stable/license.html
+The Windows and macOS bundles are created with PyInstaller. The
+bootloader exception explicitly allows this use without requiring
+the application itself to be GPL-licensed.

{syncmoss-0.4.1/syncmoss.egg-info → syncmoss-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: syncmoss
-Version: 0.4.1
+Version: 0.4.2
 Summary: SYNCmoss — Mössbauer spectroscopy analysis application
 Author: Sergey Yaroslavtsev
 License: MIT
@@ -103,6 +103,34 @@ syncmoss
   magnetic polar order `Am` on the Faraday-active ones - a random powder,
   a textured foil and a single crystal are the same model at different values
 
+## Bug report and Feature request
+
+Both are very welcome — SYNCmoss gets better mainly from user feedback.
+
+* write to **sergey.yaroslavtsev@esrf.fr** or open an issue: https://github.com/sergey-yaroslavtsev/syncmoss/issues
+
+When something goes wrong the program opens a *report a bug* window containing
+the error message.
+
+### Reporting a bug
+
+Please describe the problem and provide all related material:
+
+* **what you did** — which button or action created the problem, and what you
+  expected to happen instead;
+* **the error message** — copy it from the *report a bug* window (or from the
+  terminal);
+* **the spectrum file(s)** and **the model** (`.mdl`) you were working with —
+  without them most problems cannot be reproduced;
+* the SYNCmoss version and your operating system;
+* a screenshot, if the problem is about what is drawn or displayed.
+
+### Requesting a feature
+
+Please describe what exactly is needed: the physics or the workflow behind it,
+where in the program it should appear, and — if it exists elsewhere — a
+reference, an article or an example file showing the expected result.
+
 ## Author
 
 Yaroslavtsev Sergey (ESRF | ADA and ID14)
@@ -121,5 +149,13 @@ This software uses third-party libraries that are distributed under their own li
 - **NumPy**: BSD 3-Clause License
 - **SciPy**: BSD 3-Clause License  
 - **Matplotlib**: Matplotlib License (BSD-compatible)
-
-For complete third-party license information, see [NOTICE.txt](NOTICE.txt).
+- **Numba**: BSD 2-Clause License
+- **llvmlite**: BSD 2-Clause License (contains LLVM: Apache License 2.0 with LLVM Exceptions)
+- **Bliss** (optional, not included): LGPL v3.0 — imported only if installed
+  separately (Linux beamline installations), to read spectra online from a Bliss
+  channel; never part of the bundles
+
+For complete third-party license information, see [NOTICE.txt](NOTICE.txt). The
+Windows and macOS bundles also carry the full license text of every third-party
+package they contain, in a `licenses` folder; in the program, **Supp → License**
+shows all of it.

{syncmoss-0.4.1 → syncmoss-0.4.2}/README.md

@@ -70,6 +70,34 @@ syncmoss
   magnetic polar order `Am` on the Faraday-active ones - a random powder,
   a textured foil and a single crystal are the same model at different values
 
+## Bug report and Feature request
+
+Both are very welcome — SYNCmoss gets better mainly from user feedback.
+
+* write to **sergey.yaroslavtsev@esrf.fr** or open an issue: https://github.com/sergey-yaroslavtsev/syncmoss/issues
+
+When something goes wrong the program opens a *report a bug* window containing
+the error message.
+
+### Reporting a bug
+
+Please describe the problem and provide all related material:
+
+* **what you did** — which button or action created the problem, and what you
+  expected to happen instead;
+* **the error message** — copy it from the *report a bug* window (or from the
+  terminal);
+* **the spectrum file(s)** and **the model** (`.mdl`) you were working with —
+  without them most problems cannot be reproduced;
+* the SYNCmoss version and your operating system;
+* a screenshot, if the problem is about what is drawn or displayed.
+
+### Requesting a feature
+
+Please describe what exactly is needed: the physics or the workflow behind it,
+where in the program it should appear, and — if it exists elsewhere — a
+reference, an article or an example file showing the expected result.
+
 ## Author
 
 Yaroslavtsev Sergey (ESRF | ADA and ID14)
@@ -88,5 +116,13 @@ This software uses third-party libraries that are distributed under their own li
 - **NumPy**: BSD 3-Clause License
 - **SciPy**: BSD 3-Clause License  
 - **Matplotlib**: Matplotlib License (BSD-compatible)
-
-For complete third-party license information, see [NOTICE.txt](NOTICE.txt).
+- **Numba**: BSD 2-Clause License
+- **llvmlite**: BSD 2-Clause License (contains LLVM: Apache License 2.0 with LLVM Exceptions)
+- **Bliss** (optional, not included): LGPL v3.0 — imported only if installed
+  separately (Linux beamline installations), to read spectra online from a Bliss
+  channel; never part of the bundles
+
+For complete third-party license information, see [NOTICE.txt](NOTICE.txt). The
+Windows and macOS bundles also carry the full license text of every third-party
+package they contain, in a `licenses` folder; in the program, **Supp → License**
+shows all of it.

{syncmoss-0.4.1 → syncmoss-0.4.2}/bundle/MacOS.spec

@@ -1,6 +1,10 @@
 # -*- mode: python ; coding: utf-8 -*-
 from PyInstaller.utils.hooks import collect_data_files, collect_submodules
 import os
+import sys
+
+sys.path.insert(0, SPECPATH)  # third_party_licenses.py lives next to this spec
+from third_party_licenses import license_datas
 
 # ── Hidden imports ──────────────────────────────────────────────
 # numba/llvmlite/scipy do a lot of dynamic importing, so collect their submodules
@@ -95,6 +99,8 @@ a = Analysis(
     cipher=block_cipher,
     noarchive=False,
 )
+# The license texts of every bundled third-party package, under licenses/
+a.datas += license_datas(a)
 
 pyz = PYZ(a.pure, a.zipped_data, cipher=block_cipher)
 
@@ -125,6 +131,7 @@ coll = COLLECT(
 app = BUNDLE(
     coll,
     name='SYNCmoss.app',
-    icon=None,
+    # Next to this spec; PyInstaller converts the PNG to .icns (with Pillow).
+    icon='SYNCmoss.png',
     bundle_identifier=None,
 )

{syncmoss-0.4.1 → syncmoss-0.4.2}/bundle/Windows.spec

@@ -1,6 +1,10 @@
 # -*- mode: python ; coding: utf-8 -*-
 from PyInstaller.utils.hooks import collect_data_files, collect_submodules
 import os
+import sys
+
+sys.path.insert(0, SPECPATH)  # third_party_licenses.py lives next to this spec
+from third_party_licenses import license_datas
 
 # ── Hidden imports ──────────────────────────────────────────────
 # numba/llvmlite/scipy do a lot of dynamic importing, so collect their submodules
@@ -87,6 +91,8 @@ a = Analysis(
     cipher=block_cipher,
     noarchive=False,
 )
+# The license texts of every bundled third-party package, under licenses/
+a.datas += license_datas(a)
 
 pyz = PYZ(a.pure, a.zipped_data, cipher=block_cipher)
 

{syncmoss-0.4.1 → syncmoss-0.4.2}/bundle/bundle.py

@@ -122,6 +122,11 @@ def verify():
         "COPYING.txt",
         "NOTICE.txt",
         "LICENSE",
+        # third-party license texts (Windows.spec -> third_party_licenses.py)
+        "_internal/licenses/LGPL-3.0.txt",
+        "_internal/licenses/GPL-3.0.txt",
+        "_internal/licenses/numba",
+        "_internal/licenses/llvmlite",
     ]
     ok = True
     for rel in required: