Skip to content

SUYA 0.1.9

Choose a tag to compare

@github-actions github-actions released this 12 Nov 01:34
· 18 commits to main since this release

Download / 내려받기

OS File / 파일 Size First run / 처음 실행
Windows 10/11 x64 SUYA-0.1.9-windows-x64-setup.exe ≈ 50 MB Installer (English/Korean). SmartScreen: More info → Run anyway / "추가 정보 → 실행"
macOS 12+ Apple Silicon (M1–M4) SUYA-0.1.9-macos-arm64.dmg ≈ 59 MB Drag to Applications. macOS 15+: open once, then System Settings → Privacy & Security → Open Anyway; macOS 12–14: right-click → Open / macOS 15 이상: 한 번 연 뒤 시스템 설정 → 개인정보 보호 및 보안 → 그래도 열기, 12~14: 우클릭 → 열기
macOS 12+ Intel SUYA-0.1.9-macos-x86_64.dmg ≈ 64 MB Same / 위와 같음
Linux x86_64 (glibc ≥ 2.35) SUYA-0.1.9-linux-x86_64.tar.gz ≈ 109 MB Extract, run ./install.sh / 풀고 ./install.sh

Not sure which Mac you have? Apple menu → About This Mac: "Chip Apple M…" → Apple Silicon, "Processor … Intel" → Intel. / Apple 메뉴 → 이 Mac에 관하여: "칩 Apple M…"이면 Apple Silicon, "프로세서 … Intel"이면 Intel.

Already on 0.1.2 to 0.1.8? You do not need to download anything. SUYA finds this release by itself when it starts and once a day. 0.1.5 to 0.1.8 install it by themselves after a 20-second prompt that lets you postpone; 0.1.2, 0.1.3 and 0.1.4 ask before installing (Help ▸ Check for updates… looks right away).
0.1.2~0.1.8을 쓰고 있으면 내려받을 필요가 없습니다. 시작할 때와 하루 한 번 이 릴리스를 스스로 찾습니다. 0.1.5~0.1.8은 20초 동안 미룰 수 있게 물어본 뒤 스스로 설치하고, 0.1.2·0.1.3·0.1.4는 설치 전에 물어봅니다(*도움말 ▸ 업데이트 확인…*으로 바로 확인).

Checksums: SHA256SUMS.txt (below, under Assets). Every file is built by GitHub Actions from this tag (.github/workflows/release.yml) and installed on the build machine, where the installed copy has to pass its self-test before the file is attached. The builds are unsigned, hence the first-run warning.
Updating from 0.1.0 or 0.1.1: install over the old version. Your database, settings and Excel workbooks stay where they are.
Python users: pip install "suya[gui] @ git+https://github.com/jongsu-king/SUYA.git@v0.1.9" then run suya. Without [gui] you get the collector alone, with no Qt.
Containers: docker build -t suya https://github.com/jongsu-king/SUYA.git#v0.1.9, then docker run -d --name suya --restart unless-stopped -v suya-data:/data suya.
macOS with Homebrew: brew install --cask jongsu-king/suya/suya installs the same disk image, with the same first-run warning.
Homebrew를 쓰는 macOS: brew install --cask jongsu-king/suya/suya로 같은 디스크 이미지를 설치합니다. 처음 실행 경고도 같습니다.


SUYA 0.1.9 — Antarctic Ocean Monitor: Southern Ocean temperature, salinity and air temperature collected continuously from public APIs into SQLite and monthly Excel; south-polar map, profiles, T-S diagrams; English/Korean.
SUYA 0.1.9 — 남극해 수온·염분·기온 실시간 수집 프로그램.

Copyright © 2026 Jongsu Lim (Department of Physics, HMOL, Incheon National University; imjongsu1102@gmail.com; ORCID 0009-0000-3395-1484) and Suyeon Park (Department of Materials Science and Engineering, CELLMATE, Incheon National University; dbsnt110@inu.ac.kr) · MIT License

DOI — all versions (concept DOI): 10.5281/zenodo.23937852 · this version: 10.5281/zenodo.24149153 · archived on Zenodo
DOI — 전체 버전(개념 DOI): 10.5281/zenodo.23937852 · 이 버전: 10.5281/zenodo.24149153

This release fixes the "Unhandled exception in script" window that could appear on Windows while the monthly workbooks were being saved. It also removes the temporary files a failed save left behind, checks the free disk space before a save, and keeps the update check working when GitHub's API limit is reached.
이번 릴리스는 월별 엑셀을 저장하는 중에 Windows에서 뜰 수 있던 "Unhandled exception in script" 오류 창을 고칩니다. 실패한 저장이 남기던 임시 파일을 지우고, 저장 전에 디스크 여유 공간을 확인하며, GitHub API 한도에 걸려도 업데이트 확인이 되게 했습니다.

Fixed / 고친 것

  • The "Unhandled exception in script" window on Windows. When the program was closed, or a save ran past its time limit, while the monthly workbooks were being written, the program removed the temporary folder of the save but left the saving process running. That process finished its work, could not write its result file into the folder that no longer existed, and ended with FileNotFoundError: [Errno 2] No such file or directory: '…\Temp\tmp…\result.json' in an error window. The saving process is now stopped and waited for before its folder is removed, an unfinished .tmp.xlsx it leaves in the Excel folder is deleted, and a failure inside the saving process is passed back in the result file and shown in the status tab, not in an error window.
    Windows의 "Unhandled exception in script" 오류 창. 월별 엑셀을 쓰는 중에 프로그램을 닫거나 저장이 제한 시간을 넘기면, 프로그램은 저장용 임시 폴더를 지우면서 저장 프로세스는 그대로 두었습니다. 그 프로세스는 일을 마친 뒤 이미 없어진 폴더에 결과 파일을 쓰지 못해 FileNotFoundError: [Errno 2] No such file or directory: '…\Temp\tmp…\result.json'을 오류 창으로 띄우며 끝났습니다. 이제 저장 프로세스를 먼저 멈추고 끝나기를 기다린 뒤에 폴더를 지우고, 엑셀 폴더에 남은 미완성 .tmp.xlsx를 지우며, 저장 프로세스 안의 실패는 결과 파일로 넘겨받아 오류 창이 아니라 상태 탭에 보여 줍니다.
  • A save that was stopped is written again. A save that was stopped or failed after its first workbook was complete could be taken for a finished one: when the Excel folder had been empty and no new data came in, the remaining workbooks were not written until the next data arrived. The mark of a finished save is now cleared when a save starts and set only when all workbooks are written.
    멈춘 저장은 다시 씁니다. 첫 엑셀이 완성된 뒤에 멈추거나 실패한 저장이 끝난 저장으로 여겨질 수 있었습니다. 엑셀 폴더가 비어 있었고 새 자료가 들어오지 않으면, 나머지 엑셀은 다음 자료가 올 때까지 쓰이지 않았습니다. 이제 끝난 저장의 표시는 저장을 시작할 때 지우고, 모든 엑셀을 다 쓴 뒤에만 남깁니다.
  • Temporary files left behind by a failed save. The workbook writer keeps the rows of every sheet in temporary files until the workbook is complete: up to 14 times the size of the finished workbook, 468 MB for one month of Argo levels in a measurement on 2026-11-12. When a save failed partway, for example because the disk filled up, these files stayed in the system's temporary folder and added up with every attempt. Each workbook now keeps its pieces in a folder of its own (suya-excel-…) that is removed whether the save succeeds or fails. A folder of that name older than a day, left by a process that was killed, is removed at the start of the next save.
    실패한 저장이 남기던 임시 파일. 엑셀을 쓰는 도구는 엑셀 하나가 완성될 때까지 모든 시트의 행을 임시 파일에 둡니다. 완성된 엑셀 크기의 최대 14배이고, 2026-11-12에 잰 값으로는 Argo 수심별 자료 한 달에 468 MB입니다. 디스크가 가득 차는 등으로 저장이 도중에 실패하면 이 파일들이 시스템 임시 폴더에 남아 시도할 때마다 쌓였습니다. 이제 엑셀마다 조각을 자기 폴더(suya-excel-…)에 두고, 저장이 성공하든 실패하든 그 폴더를 지웁니다. 강제 종료된 프로세스가 남긴, 하루가 넘은 같은 이름의 폴더는 다음 저장을 시작할 때 지웁니다.
  • A save no longer starts without room for it. Before writing, the free space of the temporary folder and of the Excel folder is compared with what the largest workbook of the months to write needs: 20 times its size for the pieces and twice its size for the new file, at least 128 MB and 32 MB. When it is short nothing is written and the status tab shows "Not enough disk space to save: … has … MB free, … MB needed".
    공간이 모자라면 저장을 시작하지 않습니다. 쓰기 전에 임시 폴더와 엑셀 폴더의 여유 공간을, 쓸 달 가운데 가장 큰 엑셀에 필요한 크기와 비교합니다. 조각에는 그 크기의 20배, 새 파일에는 2배이고 최소 128 MB와 32 MB입니다. 모자라면 아무것도 쓰지 않고 상태 탭에 "저장할 공간이 부족합니다: … 여유 … MB, 필요 … MB"를 보여 줍니다.

Changed / 바꾼 것

  • The update check works when GitHub's API limit is reached. The check asks the GitHub API for the latest release, which allows 60 requests an hour for each address; when the limit was reached, the check stopped with "GitHub's request limit was reached". It now reads the version from the address the public release page releases/latest points to and builds the file links from the release naming. The download is still checked against SHA256SUMS.txt; when that file cannot be read, nothing is installed.
    GitHub API 한도에 걸려도 업데이트 확인이 됩니다. 업데이트 확인은 GitHub API에 최신 릴리스를 묻는데, 이 API는 주소 하나에 한 시간 60번까지만 답합니다. 한도에 걸리면 확인이 "GitHub 요청 한도에 걸렸습니다"로 멈췄습니다. 이제 공개 릴리스 페이지 releases/latest가 가리키는 주소에서 버전을 읽고, 릴리스 파일 이름 규칙으로 내려받을 주소를 만듭니다. 내려받은 파일은 전과 같이 SHA256SUMS.txt와 대조하고, 그 파일을 읽지 못하면 아무것도 설치하지 않습니다.

After updating / 올린 뒤

  • Temporary files left by 0.1.8 and earlier carry no name of their own, so SUYA does not touch them. The disk cleanup of the operating system removes them (Windows: Settings ▸ System ▸ Storage ▸ Temporary files). Nothing else has to be done by hand.
    0.1.8까지의 버전이 남긴 임시 파일은 이름에 표시가 없어 SUYA가 건드리지 않습니다. 운영체제의 디스크 정리가 지웁니다(Windows: 설정 ▸ 시스템 ▸ 저장소 ▸ 임시 파일). 그 밖에 손으로 할 일은 없습니다.

Full list: CHANGELOG.md.