swpc-kit 0.3.0__tar.gz → 0.3.1__tar.gz

{swpc_kit-0.3.0 → swpc_kit-0.3.1}/CHANGELOG.md

@@ -6,6 +6,32 @@ All notable changes to this project are listed here. The format follows
 
 ## [Unreleased]
 
+## [0.3.1] - 2026-10-26
+
+### Added
+
+- `MessageKind.CANCEL_WARNING`.
+
+### Changed
+
+- Windows is supported: the CI runs the whole test suite on Windows too.
+- The docs describe `data_time` the same way everywhere, present the `304`
+  as a saving rather than a promise, and the skill lists the plausibility
+  limits, the fields each record must have and the strict products.
+- The docs treat a `429` as a refusal (slow down, stop until the next run)
+  rather than a reason to retry soon, and explain how to use the parsers
+  behind your own download code. The client still raises `SourceNotReady`.
+- `python -m swpc_kit.skill check` without `--target` looks for the copy
+  from the current folder up to the root of the repository, so it works
+  from a subfolder too.
+
+### Fixed
+
+- A `CANCEL WARNING` message had `kind=None`.
+- The skill's API reference left out the methods the solar wind models
+  inherit (`latest_active`, `active_series` and the others), and wrote
+  some types as `Optional[...]`.
+
 ## [0.3.0] - 2026-10-26
 
 The first release on PyPI. 0.1.0 and 0.2.0 were never published; their
@@ -172,5 +198,6 @@ First version. Never published or tagged.
   declares.
 - Recorded fixtures and the tools that record them (`tools/`).
 
-[Unreleased]: https://github.com/Tabrigos/swpc-kit/compare/v0.3.0...HEAD
+[Unreleased]: https://github.com/Tabrigos/swpc-kit/compare/v0.3.1...HEAD
+[0.3.1]: https://github.com/Tabrigos/swpc-kit/releases/tag/v0.3.1
 [0.3.0]: https://github.com/Tabrigos/swpc-kit/releases/tag/v0.3.0

{swpc_kit-0.3.0 → swpc_kit-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: swpc-kit
-Version: 0.3.0
+Version: 0.3.1
 Summary: Typed readers for NOAA SWPC space weather data products, with GeoJSON and GeoTIFF export.
 Project-URL: Homepage, https://github.com/Tabrigos/swpc-kit
 Project-URL: Issues, https://github.com/Tabrigos/swpc-kit/issues
@@ -34,7 +34,7 @@ for what is known about each SWPC format.
 
 ## Install
 
-Requires Python 3.12 or later.
+Requires Python 3.12 or later; the tests run on Linux and Windows.
 
 ```bash
 pip install swpc-kit              # parsers, models, JSON, GeoJSON, GeoTIFF
@@ -72,8 +72,10 @@ Parsers live in `swpc_kit.parse`, models in `swpc_kit.models`, the clients in
 ## Parse content you already have
 
 Parsers are pure functions: `str` or `bytes` in, a frozen dataclass out, with
-every time an aware UTC `datetime`. Each model has `data_time`, the most
-recent time its content declares, and `source_url`.
+every time an aware UTC `datetime`. Each model has `data_time`, the time its
+data describes and never a forecast time (the last observed value, the
+observation time of a grid, the issue time of a bulletin; the docstring of
+each model says which), and `source_url`.
 
 ```pycon
 >>> from pathlib import Path
@@ -212,8 +214,10 @@ write_geotiff(drap, "drap.tif")  # EPSG:4326, times in the tags
 
 The client (`client` extra) downloads, classifies the errors of the source,
 parses, and checks the age of the data on the time the content declares.
-Requests are conditional: an unchanged file comes back as `304 Not Modified`
-and the previous model is reused.
+Requests are conditional: when the `ETag` of a file has not changed, SWPC
+answers `304 Not Modified` and the previous model is reused. The `ETag` may
+also change when the content does not, so a `304` is a saving, not a
+promise.
 
 ```python
 from datetime import timedelta
@@ -261,9 +265,14 @@ wants.
 
 ### Trying again
 
-`SourceNotReady` is the only error worth retrying: SWPC is busy (`429`,
-`5xx`), the network failed, or the file was caught while SWPC was rewriting
-it. Wait, and wait longer each time; give up after a few attempts.
+`SourceNotReady` is the only error worth retrying: SWPC is busy (`5xx`), the
+network failed, or the file was caught while SWPC was rewriting it. Wait, and
+wait longer each time; give up after a few attempts.
+
+A `429` is a `SourceNotReady` too, but it is a refusal: SWPC asks you to slow
+down. If the attempts below do not get past it, stop and try at the next run
+of your job, and make the runs less frequent. A later version will give the
+`429` an error of its own.
 
 ```python
 import time
@@ -294,6 +303,26 @@ updated the product yet: try at the next run of your job, not within
 seconds. The client does not read `Retry-After` and keeps its `ETag`s in
 memory only, so keep one `Client` for the life of your program.
 
+### Downloading with your own code
+
+If your program already downloads through a layer of its own (a scheduler,
+a rate limiter, a cache), keep it and use only the parsers. Read the answers
+the way the client does:
+
+- **200**: parse the body. A `SourceNotReady` from the parser is a file
+  caught while SWPC was rewriting it: try again later, by the rules of your
+  layer.
+- **408, 425, 5xx**, a timeout or a network failure: try again later, by the
+  rules of your layer. If that layer records failures and pauses the host,
+  "later" is its next run, never a loop in the same process.
+- **429**: a refusal. Slow down, honour `Retry-After` if your layer reads
+  it, and do not retry in the same run.
+- **A redirect, a 404 or any other status**, or an HTML page: stop. SWPC
+  moved or changed the product, or the URL is wrong.
+
+Then measure the age on `data_time`, not on the HTTP headers: a `304` or a
+recent `Last-Modified` does not say that the data is new.
+
 ### When SWPC moves a product or changes a format
 
 - **A product that moved** answers `UnexpectedContent`, with `status` (301,

{swpc_kit-0.3.0 → swpc_kit-0.3.1}/README.md

@@ -11,7 +11,7 @@ for what is known about each SWPC format.
 
 ## Install
 
-Requires Python 3.12 or later.
+Requires Python 3.12 or later; the tests run on Linux and Windows.
 
 ```bash
 pip install swpc-kit              # parsers, models, JSON, GeoJSON, GeoTIFF
@@ -49,8 +49,10 @@ Parsers live in `swpc_kit.parse`, models in `swpc_kit.models`, the clients in
 ## Parse content you already have
 
 Parsers are pure functions: `str` or `bytes` in, a frozen dataclass out, with
-every time an aware UTC `datetime`. Each model has `data_time`, the most
-recent time its content declares, and `source_url`.
+every time an aware UTC `datetime`. Each model has `data_time`, the time its
+data describes and never a forecast time (the last observed value, the
+observation time of a grid, the issue time of a bulletin; the docstring of
+each model says which), and `source_url`.
 
 ```pycon
 >>> from pathlib import Path
@@ -189,8 +191,10 @@ write_geotiff(drap, "drap.tif")  # EPSG:4326, times in the tags
 
 The client (`client` extra) downloads, classifies the errors of the source,
 parses, and checks the age of the data on the time the content declares.
-Requests are conditional: an unchanged file comes back as `304 Not Modified`
-and the previous model is reused.
+Requests are conditional: when the `ETag` of a file has not changed, SWPC
+answers `304 Not Modified` and the previous model is reused. The `ETag` may
+also change when the content does not, so a `304` is a saving, not a
+promise.
 
 ```python
 from datetime import timedelta
@@ -238,9 +242,14 @@ wants.
 
 ### Trying again
 
-`SourceNotReady` is the only error worth retrying: SWPC is busy (`429`,
-`5xx`), the network failed, or the file was caught while SWPC was rewriting
-it. Wait, and wait longer each time; give up after a few attempts.
+`SourceNotReady` is the only error worth retrying: SWPC is busy (`5xx`), the
+network failed, or the file was caught while SWPC was rewriting it. Wait, and
+wait longer each time; give up after a few attempts.
+
+A `429` is a `SourceNotReady` too, but it is a refusal: SWPC asks you to slow
+down. If the attempts below do not get past it, stop and try at the next run
+of your job, and make the runs less frequent. A later version will give the
+`429` an error of its own.
 
 ```python
 import time
@@ -271,6 +280,26 @@ updated the product yet: try at the next run of your job, not within
 seconds. The client does not read `Retry-After` and keeps its `ETag`s in
 memory only, so keep one `Client` for the life of your program.
 
+### Downloading with your own code
+
+If your program already downloads through a layer of its own (a scheduler,
+a rate limiter, a cache), keep it and use only the parsers. Read the answers
+the way the client does:
+
+- **200**: parse the body. A `SourceNotReady` from the parser is a file
+  caught while SWPC was rewriting it: try again later, by the rules of your
+  layer.
+- **408, 425, 5xx**, a timeout or a network failure: try again later, by the
+  rules of your layer. If that layer records failures and pauses the host,
+  "later" is its next run, never a loop in the same process.
+- **429**: a refusal. Slow down, honour `Retry-After` if your layer reads
+  it, and do not retry in the same run.
+- **A redirect, a 404 or any other status**, or an HTML page: stop. SWPC
+  moved or changed the product, or the URL is wrong.
+
+Then measure the age on `data_time`, not on the HTTP headers: a `304` or a
+recent `Last-Modified` does not say that the data is new.
+
 ### When SWPC moves a product or changes a format
 
 - **A product that moved** answers `UnexpectedContent`, with `status` (301,

{swpc_kit-0.3.0 → swpc_kit-0.3.1}/SPEC.md

@@ -97,8 +97,8 @@ A hierarchy under `SwpcError`:
 The age of the data is measured **on the time the content declares**
 (`Observation Time`, `:Issued:`, the last `time_tag`), never on the HTTP
 outcome: a `304 Not Modified` or a recent modification date does not say that
-the data is new. Every model exposes `data_time` (the most recent time in the
-content), and the client accepts `max_age`.
+the data is new. Every model exposes `data_time` (the time its data
+describes, never a forecast time), and the client accepts `max_age`.
 
 ## Changing formats
 

{swpc_kit-0.3.0 → swpc_kit-0.3.1}/docs/DECISIONI.md

@@ -414,3 +414,61 @@ scelte già prese e sparse fra `SPEC.md`, `docs/FONTI.md` e il diario; la data
   minimi di numpy e rasterio provati dal job `lowest` diventano quelli dei
   test.
 
+## D-022 — Windows supportato; tempi testuali con una parte comune; niente stub di rasterio
+
+- **Data e tappa**: 2026-10-26, T12 (scelte del maintainer)
+- **Contesto**: su Windows la suite non passava tutta. Le cause stavano
+  tutte nei test:
+  - la barriera di rete bloccava la coppia di socket con cui l'event loop
+    di asyncio si risveglia, che su Windows si connette a 127.0.0.1;
+  - gli id di `test_drap_inconsistent_lines` contenevano un file D-RAP
+    intero, oltre il limite di una variabile d'ambiente di Windows (pytest
+    ci mette l'id);
+  - `test_readme` creava un symlink, che su Windows richiede un privilegio.
+
+  Gli avvisi lasciati dai test async cadevano poi su test innocenti.
+- **Decisione**:
+  - Windows è supportato. Un job `windows` nella CI fa girare la suite
+    intera con la wheel. È un job a sé, non una voce della matrice di
+    `checks`, così i nomi dei controlli richiesti di `main` non cambiano;
+    il maintainer lo aggiunge fra i richiesti dopo il primo giro verde.
+  - La barriera lascia aperto solo `connect` verso l'indirizzo locale
+    (`127.0.0.1`, `::1`); `connect_ex`, `create_connection` e
+    `getaddrinfo` restano chiusi. Un test lo prova.
+  - Tempi testuali: la tabella dei mesi e la costruzione dell'ora UTC
+    (`text_time`) stanno in `parse/_common.py`. Ogni formato tiene il suo
+    pattern e il suo modo di leggere il mese: i bollettini lo leggono senza
+    badare alle maiuscole, gli avvisi solo come `Oct`. Due test fissano
+    questa differenza.
+  - rasterio resta con l'override di mypy (`ignore_missing_imports`).
+- **Alternative scartate**:
+  - saltare su Windows i test che falliscono (la suite di chi sviluppa qui
+    restava rossa, e un guasto vero si sarebbe confuso con quelli noti);
+  - un solo parser per i due formati (gli avvisi avrebbero accettato
+    `OCT`, un cambio di comportamento);
+  - `types-rasterio` (una dipendenza in più, legata alla versione di
+    rasterio, per un solo file di test dopo D-021).
+- **Conseguenze**: la suite è verde anche su Windows, e un guasto solo di
+  Windows si vede nella CI.
+
+
+## D-023 — Il 429 è un rifiuto: per ora lo dice la documentazione
+
+- **Data e tappa**: 2026-10-26, T19 (scelta del maintainer, concordata con
+  l'agente di politefetch)
+- **Contesto**: README e SKILL mettevano il 429 fra gli errori da ritentare
+  presto, con `SourceNotReady`. Per chi interroga SWPC da un job, e per
+  politefetch, un 429 è un rifiuto: si rallenta, non si ritenta subito.
+  Mancava anche una guida per chi scarica con un livello suo e usa solo i
+  parser.
+- **Decisione**: il comportamento del client non cambia fino alla T17. README
+  e SKILL dicono che il 429 è un rifiuto: dopo pochi tentativi distanziati ci
+  si ferma fino al giro successivo del job. Una sezione nuova spiega come
+  leggere le risposte HTTP a chi scarica da sé; con un livello che registra i
+  fallimenti, "più tardi" vuol dire il suo giro successivo, mai un ciclo nello
+  stesso processo.
+- **Alternative scartate**: una classe d'errore per il 429 già nella prossima
+  patch (cambia il contratto prima che la T17 lo progetti insieme
+  all'errore per l'host congelato, D-016).
+- **Conseguenze**: fino alla T17 il 429 si distingue solo dal messaggio, che
+  la SKILL sconsiglia di leggere; la T17 gli dà un errore suo.

{swpc_kit-0.3.0 → swpc_kit-0.3.1}/docs/DIARIO.md

@@ -4,21 +4,22 @@
 
 Riscritto da capo a ogni fine sessione, mai accodato.
 
-- **Stato**: T0–T11, T13–T16 e T18 fatte e in `main` (PR #2–#7). Il
-  commit `Version 0.3.0` (ramo `version-0.3.0`) porta la versione, la
-  sezione 0.3.0 del CHANGELOG, che presenta il pacchetto intero perché
-  0.1.0 e 0.2.0 non sono mai uscite, e il tag `v0.3.0`.
-- **Prossimo passo**: la prima pubblicazione (`AGENTS.md`, "Releases"). Il
-  maintainer registra il pending publisher su pypi.org; poi il merge della
-  PR di versione e il push del tag, che avvia `release.yml`, e il
-  maintainer approva l'environment `pypi`. Subito prima del tag, ricontrollare
-  che `swpc-kit` sia libero su PyPI. Dopo la 0.3.0: T12, e T17 (il
-  trasporto educato su politefetch, la cui API è cambiata: rileggerla).
-- **Decisioni in sospeso**: quelle di T12 (parser dei tempi testuali, stub
-  di rasterio, supporto di Windows). Il job `lowest` resta fuori dai
-  controlli richiesti di `main` (maintainer, 2026-10-26): per chi usa la
-  libreria il solo minimo è httpx2 2.13, e il job lo prova lo stesso su ogni
-  PR.
+- **Stato**: tutte le tappe fino alla T18 fatte, più la T12; **0.3.0
+  pubblicata su PyPI** il 2026-10-26 (tag `v0.3.0`, release su GitHub). Lo
+  stesso giorno la T19 (PR #10) e la ricopia del modello delle skill
+  (PR #11), poi la **0.3.1** (tag `v0.3.1`) con T12, T19 e la ricopia.
+- **Prossimo passo**: T17, il trasporto educato su politefetch, che è su
+  PyPI dal 2026-10-26 (0.1.0). La sua API è cambiata prima della
+  pubblicazione (client con retry propri rifiutato, `NoPolicy`,
+  `Transport.send` con un context manager): rileggerla, e decidere con
+  quella sessione la semantica del 429 e il client HTTP.
+- **Decisioni in sospeso**: niente. Il maintainer ha scelto (2026-10-26): il
+  429 resta `SourceNotReady` fino alla T17 e la documentazione lo dice un
+  rifiuto (D-023). Il job `windows` è fra i controlli richiesti di `main`
+  dal 2026-10-26, dopo il primo giro verde (D-022). Il
+  job `lowest` resta fuori dai richiesti (maintainer, 2026-10-26): per chi
+  usa la libreria il solo minimo è httpx2 2.13, e il job lo prova lo stesso
+  su ogni PR.
 - **Da sapere** (per chi scrive i prossimi parser):
   - `swpc_kit/parse/_common.py` è il kit comune: `load_json` classifica gli
     errori (vuoto o troncato → `SourceNotReady`; HTML o non JSON →
@@ -195,9 +196,6 @@ Riscritto da capo a ogni fine sessione, mai accodato.
     `remember` (log e cache): l'async fa il parse fra i due, in
     `asyncio.to_thread`. Gli argomenti dei client li controlla
     `_check_arguments`; il trasporto `check_transport`.
-  - Su Windows i test async si provano con
-    `uv run pytest --noconftest tests/test_client.py -k async`: senza la
-    barriera di rete, dato che usano trasporti finti.
 - **T16** (rilascio):
   - Job `lowest` in `.github/workflows/ci.yml` (D-020). In locale si prova
     con `UV_PROJECT_ENVIRONMENT=<cartella a parte>` e `uv sync --all-extras
@@ -208,8 +206,21 @@ Riscritto da capo a ogni fine sessione, mai accodato.
   - `swpc_kit/export/_tiff.py` è il contenitore TIFF; i numeri dei tag
     GeoTIFF e GDAL sono commentati in `geotiff.py`. rasterio serve solo ai
     test, per rileggere.
-  - Su Windows, nella suite intera, l'avviso dei test async può cadere su
-    un test GeoTIFF o GeoJSON: è il guasto noto, e da soli passano.
+- **T12** (Windows e debiti):
+  - Su Windows la suite intera è verde, anche in locale (D-022). La
+    barriera di `tests/conftest.py` lascia aperto solo `connect` verso
+    l'indirizzo locale; un test lungo con id costruiti dai dati deve dare
+    id corti (`ids=`), perché pytest mette l'id in una variabile
+    d'ambiente.
+  - `MONTHS` e `text_time` stanno in `parse/_common.py`; i pattern e le
+    maiuscole del mese restano di ciascun formato.
+- **T19** (riscontri):
+  - `MessageKind.CANCEL_WARNING`; il caso sta come testo in
+    `tests/test_alerts.py`, perché la fixture registrata non ha un warning
+    annullato.
+  - Il generatore di `api.md` prende solo la prima riga delle docstring
+    (con la regola D205 il primo paragrafo è una riga): i dettagli vanno
+    nella SKILL, non nelle docstring.
 - **Dubbi aperti**: le ipotesi rimaste in `docs/FONTI.md` (UTC dei
   `time_tag` senza `Z`, millisecondi del vecchio Dst e flusso, significato
   delle chiavi di `noaa-scales.json`, unità dei valori OVATION).
@@ -292,3 +303,16 @@ Una riga per sessione: data, tappa, cosa è entrato, cosa resta.
   CHANGELOG che presenta il pacchetto, i link in fondo e il tag `v0.3.0`.
   Note della release provate con lo stesso `awk` del workflow. Il nome
   `swpc-kit` su PyPI era ancora libero.
+- 2026-10-26 — 0.3.0 pubblicata. T12: Windows supportato, con la suite
+  verde e un job `windows` nella CI (barriera aperta solo verso l'indirizzo
+  locale, id corti, fixture copiate invece del symlink); tabella dei mesi e
+  `text_time` in `_common.py`; override di mypy per rasterio tenuto
+  (D-022). Resta: T17.
+- 2026-10-26 — T19 (in locale, ramo `t19-riscontri`): riscontri
+  della prima prova d'uso vagliati sul codice; `MessageKind.CANCEL_WARNING`;
+  `data_time`, `304` ed ETag, limiti, campi obbligatori e prodotti rigidi
+  descritti allo stesso modo in README, SPEC, FONTI e SKILL; il 429 è un
+  rifiuto e c'è una sezione per chi scarica da sé (D-023). Prossima: 0.3.1.
+- 2026-10-26 — Ricopia del modello delle skill (PR #11: `check` dalla radice
+  del repo, metodi ereditati e tipi concreti in `api.md`) e versione 0.3.1
+  (Windows, `CANCEL_WARNING`, documentazione, 429 come rifiuto). Resta: T17.

{swpc_kit-0.3.0 → swpc_kit-0.3.1}/docs/FONTI.md

@@ -143,8 +143,9 @@ texts end with `\n`. The server sends `Last-Modified`, `ETag` and
   instant is the one with `active: true` (if there were two, the first in
   the file wins); an instant with no active record stays without one, with
   no fallback to another source. Unknown sources stay strings.
-  `data_time` is the last `time_tag` of any source; the freshness of the
-  active source alone is `latest_active().time`.
+  Since T13 (D-012) `data_time` is the `time_tag` of the last active
+  record, not of any source: a backup that keeps running after the active
+  source stopped does not make the data look new.
 
 ## GOES
 
@@ -216,7 +217,7 @@ texts end with `\n`. The server sends `Last-Modified`, `ETag` and
 - First three lines always present: `Space Weather Message Code: WARK04`,
   `Serial Number: 5435`, `Issue Time: 2026 Oct 13 2058 UTC`. Then the title
   (`ALERT:`, `WARNING:`, `EXTENDED WARNING:`, `WATCH:`, `CONTINUED ALERT:`,
-  `CANCEL WATCH:`, `SUMMARY:`) and fields such as `Valid From:`,
+  `CANCEL WATCH:`, `SUMMARY:`; `CANCEL WARNING:` too, below) and fields such as `Valid From:`,
   `Valid To:`, `Now Valid Until:`, `Threshold Reached:`,
   `Synoptic Period:`, `Active Warning:`, `Begin Time:`, `End Time:`,
   `Maximum Time:`, `Extension to Serial Number:`,
@@ -281,6 +282,13 @@ Verified in T4 on the same fixture:
   are lines without `Name:` (`THIS SUPERSEDES ANY/ALL PRIOR WATCHES IN EFFECT`,
   `CORRECTED`, free sentences, the continuation of `Potential Impacts:`),
   and `Comment:` can contain long runs of spaces.
+- **`CANCEL WARNING`**, **verified** on one record of `alerts.json` issued
+  2026-07-12 21:01 UTC, outside the recorded fixture (the test keeps its
+  text): `product_id` `K05W`, code `WARK05`, the same as the warning it
+  cancels, then `Cancel Serial Number:` and `Original Issue Time:`. Its
+  scale line is glued to a sentence
+  (`... until 12/2100 UTC.NOAA Scale: G1 - Minor`), so it is not read as a
+  field.
 - **Hypothesis**: an empty array `[]` has never been seen; the parser reads
   it as "no messages" (not as `SourceNotReady`), because a period without
   alerts is a legitimate state.
@@ -476,6 +484,11 @@ comes):
   downloads and parses all 16 products of the day; SWPC sends **weak**
   `ETag`s (`W/"12c4-…"`) and `Last-Modified`, and answers
   `304 Not Modified` to the conditional request with `If-None-Match`.
+- **Hypothesis** (reported by a user of the library, measured on
+  2026-09-13, not verified here): the `ETag` of a product can change about
+  every 165 seconds while the content stays byte for byte the same, so the
+  `304` saves less than it seems. The docs present the `304` as a saving,
+  not a promise.
 
 ## Plausibility limits (T14, 2026-10-25)
 

{swpc_kit-0.3.0 → swpc_kit-0.3.1}/docs/TAPPE.md

@@ -201,18 +201,30 @@ Non fa parte della tappa (da concordare con politefetch): la semantica del
 
 ## T12 — Debiti rimasti dalle tappe nel cloud
 
-- [ ] Fatta
+- [x] Fatta
 
 Rinvii scritti nel diario e mai chiusi:
 
-- [ ] Unire il parser dei tempi testuali (`2026 Oct 13 2058 UTC`) di
+- [x] Unire il parser dei tempi testuali (`2026 Oct 13 2058 UTC`) di
   `parse/alerts.py` con quello di `parse/_text.py` in `parse/_common.py`
   (rinviato da T4 e T5 a T8, poi rimasto).
-- [ ] rasterio: tenere l'override mypy (`ignore_missing_imports`) o passare
+- [x] rasterio: tenere l'override mypy (`ignore_missing_imports`) o passare
   agli stub `types-rasterio` (nuova dipendenza di sviluppo, da giustificare).
-- [ ] Windows: la suite non passa tutta (async con la barriera sul socket del
+- [x] Windows: la suite non passa tutta (async con la barriera sul socket del
   loop Proactor, griglie, esempi del README). Decidere se Windows è
   supportato; se sì, CI anche su Windows.
+- Esito (D-022), con le scelte del maintainer:
+  - Windows supportato, job `windows` nella CI;
+  - in `_common.py` la tabella dei mesi e `text_time`, mentre pattern e
+    maiuscole restano di ciascun formato: un solo parser avrebbe cambiato
+    il comportamento degli avvisi;
+  - l'override di mypy per rasterio resta.
+
+  In più, in un commit a sé, la parte comune di `tests/test_skill.py`
+  ricopiata dal modello `c3371e9`: i percorsi citati in SKILL.md si devono
+  aprire dalla copia di un progetto. La `829d005` non passava `ruff format`.
+  La SKILL.md di swpc-kit cita solo `references/api.md`; il test si è visto
+  fallire con un percorso del repo aggiunto per prova.
 
 ## Revisione prima della pubblicazione (2026-10-25)
 
@@ -340,8 +352,9 @@ tolleranza per record (D-015).
   `numpy>=2.0`, `rasterio>=1.4`.
 - [x] Valutare un writer GeoTIFF senza rasterio (il raster è piccolo):
   solo valutazione, con la scelta in `docs/DECISIONI.md`.
-- [ ] Ricontrollare che `swpc-kit` sia libero su PyPI subito prima del tag
-  (libero il 2026-10-25: `https://pypi.org/pypi/swpc-kit/json` dà 404).
+- [x] Ricontrollare che `swpc-kit` sia libero su PyPI subito prima del tag
+  (libero il 2026-10-25: `https://pypi.org/pypi/swpc-kit/json` dà 404; di
+  nuovo libero il 2026-10-26, subito prima di spingere `v0.3.0`).
 - Esito (D-019, D-020):
   - classifier "4 - Beta";
   - job `lowest` nella CI;
@@ -374,6 +387,37 @@ Quando: prima della 0.3.0, deciso dal maintainer il 2026-10-25 (D-019).
   in più ora controllano la compressione, l'elenco completo dei tag,
   l'intero raster di OVATION completa e le regole TIFF che GDAL perdona.
 
+## T19 — Riscontri della prima prova d'uso
+
+- [x] Fatta
+
+Quando: dopo la 0.3.0, prima della T17. Il 2026-10-26 un progetto che userebbe
+solo i parser ha provato la 0.3.0 sulle sue risposte registrate. Ogni voce
+del suo riscontro è stata ricontrollata sul codice prima di tenerla buona.
+
+- [x] `MessageKind.CANCEL_WARNING`: un `CANCEL WARNING` aveva `kind=None`.
+  Ha lo stesso codice del warning che annulla, quindi `info` va letto
+  dopo `kind` (docstring e SKILL).
+- [x] `data_time` descritto allo stesso modo in README, SPEC, FONTI e SKILL:
+  il tempo che i dati descrivono, mai un tempo di previsione. In FONTI la
+  riga del vento solare era rimasta a prima di D-012.
+- [x] Il `304` è un risparmio, non una promessa: l'ETag può cambiare a
+  contenuto identico (ipotesi riportata, in FONTI).
+- [x] SKILL: installazione senza extra, limiti di plausibilità, campi
+  obbligatori in ogni record, `noaa-scales.json` fra i prodotti rigidi,
+  veicolo attivo fermo, dettagli del GeoTIFF, `partial` di OVATION.
+- Restano come sono, per scelta già presa (D-015, D-017): colonna assente
+  da tutti i record = `UnexpectedContent`; `noaa-scales`, bollettini e
+  griglie rigidi; `a_running` e `station_count` obbligatori (nessun null
+  visto nelle risposte registrate); classe dei flare troncata, come la
+  `max_class` di SWPC nell'elenco dei flare della prova; nessun ripiego
+  automatico sul veicolo di riserva (D-012).
+- [x] Il 429 è un rifiuto (D-023): README e SKILL lo dicono, il
+  comportamento cambia in T17. Sezione per chi scarica con codice suo,
+  concordata con l'agente di politefetch (scelte del maintainer).
+- Fuori da questa tappa: i metodi ereditati in `api.md` sono un difetto del
+  modello comune, corretto con la sua ricopia.
+
 ## T17 — Trasporto educato su politefetch
 
 - [ ] Fatta

{swpc_kit-0.3.0 → swpc_kit-0.3.1}/src/swpc_kit/__init__.py

@@ -20,7 +20,7 @@ from swpc_kit.errors import (
     UnexpectedContent,
 )
 
-__version__ = "0.3.0"
+__version__ = "0.3.1"
 
 __all__ = [
     "ParseError",

{swpc_kit-0.3.0 → swpc_kit-0.3.1}/src/swpc_kit/export/geotiff.py

@@ -46,7 +46,7 @@ def write_geotiff(
     *,
     nodata: float = math.nan,
 ) -> None:
-    """Write a gridded product to a GeoTIFF file.
+    """Write a gridded product to a GeoTIFF file, in place; nodata is declared.
 
     Cells the grid does not have (the missing longitudes of a reduced
     OVATION file) are set to ``nodata``.

{swpc_kit-0.3.0 → swpc_kit-0.3.1}/src/swpc_kit/models/alerts.py

@@ -40,6 +40,7 @@ class MessageKind(StrEnum):
     CONTINUED_ALERT = "CONTINUED ALERT"
     WARNING = "WARNING"
     EXTENDED_WARNING = "EXTENDED WARNING"
+    CANCEL_WARNING = "CANCEL WARNING"
     WATCH = "WATCH"
     CANCEL_WATCH = "CANCEL WATCH"
     SUMMARY = "SUMMARY"
@@ -179,6 +180,8 @@ class AlertMessage:
     def info(self) -> MessageCode | None:
         """Catalogue entry of the message, by short code then long code.
 
+        A cancel has the code of the message it cancels, so the meaning of
+        the entry holds only when ``kind`` is not a ``CANCEL_*`` kind.
         ``None`` when neither code is in :mod:`swpc_kit.codes`.
         """
         return by_short(self.product_id) or by_long(self.code)

{swpc_kit-0.3.0 → swpc_kit-0.3.1}/src/swpc_kit/parse/_common.py

@@ -109,6 +109,41 @@ def parse_time(text: str) -> datetime:
     return value.astimezone(UTC)
 
 
+MONTHS = {
+    name: number
+    for number, name in enumerate(
+        (
+            "Jan",
+            "Feb",
+            "Mar",
+            "Apr",
+            "May",
+            "Jun",
+            "Jul",
+            "Aug",
+            "Sep",
+            "Oct",
+            "Nov",
+            "Dec",
+        ),
+        start=1,
+    )
+}
+"""English month abbreviations as SWPC writes them, to month numbers."""
+
+
+def text_time(year: str, month: int, day: str, hour: str, minute: str) -> datetime:
+    """Return the UTC time of the parts of a text time (``2026 Oct 13 2058 UTC``).
+
+    The text products and the alerts each match their own pattern and look up
+    the month in :data:`MONTHS`; this builds the time from the parts.
+
+    Raises:
+        ValueError: If the parts are not a valid date and time.
+    """
+    return datetime(int(year), month, int(day), int(hour), int(minute), tzinfo=UTC)
+
+
 class Record:
     """One record of a JSON product, with typed accessors.
 

{swpc_kit-0.3.0 → swpc_kit-0.3.1}/src/swpc_kit/parse/_text.py

@@ -22,32 +22,10 @@ import re
 from bisect import bisect_right
 from collections.abc import Sequence
 from dataclasses import dataclass
-from datetime import UTC, date, datetime
+from datetime import date, datetime
 
 from swpc_kit.errors import ParseError, SourceNotReady, SwpcError, UnexpectedContent
-from swpc_kit.parse._common import decode
-
-MONTHS = {
-    name: number
-    for number, name in enumerate(
-        (
-            "Jan",
-            "Feb",
-            "Mar",
-            "Apr",
-            "May",
-            "Jun",
-            "Jul",
-            "Aug",
-            "Sep",
-            "Oct",
-            "Nov",
-            "Dec",
-        ),
-        start=1,
-    )
-}
-"""English month abbreviations as SWPC writes them, to month numbers."""
+from swpc_kit.parse._common import MONTHS, decode, text_time
 
 _PRODUCT = re.compile(r":Product:\s*(.*)")
 _ISSUED = re.compile(
@@ -325,9 +303,7 @@ def open_text_product(
     if number is None:
         raise reader.error(f"unknown month {month!r}", line.number, "Issued")
     try:
-        issued = datetime(
-            int(year), number, int(day), int(hour), int(minute), tzinfo=UTC
-        )
+        issued = text_time(year, number, day, hour, minute)
     except ValueError as exc:
         raise reader.error(f"not a valid time: {exc}", line.number, "Issued") from None
     reader.skip_comments()