anycubic-cloud-api 0.4.2__tar.gz → 0.4.4__tar.gz

anycubic_cloud_api-0.4.4/COPYRIGHT

@@ -0,0 +1,54 @@
+anycubic-cloud-api
+==================
+
+Copyright (C) 2024-2026 WaresWichall
+Copyright (C) 2026 Nino Bondonno
+
+This library originated as part of the Home Assistant integration
+"hass-anycubic_cloud" by WaresWichall:
+
+    https://github.com/WaresWichall/hass-anycubic_cloud
+
+It was extracted into a standalone package, modified and extended by
+Nino Bondonno from 2026 onwards. Modifications include the LAN Mode
+client, filament-usage estimation, tolerant parsing of partial printer
+reports, and the test suite.
+
+This program is free software: you can redistribute it and/or modify it
+under the terms of the GNU General Public License as published by the
+Free Software Foundation, either version 3 of the License, or (at your
+option) any later version.
+
+This program is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+General Public License for more details.
+
+You should have received a copy of the GNU General Public License along
+with this program. If not, see <https://www.gnu.org/licenses/>.
+
+
+THIRD-PARTY MATERIAL — NOT COVERED BY THIS LICENCE
+--------------------------------------------------
+
+src/anycubic_cloud_api/resources/
+    anycubic_mqqt_tls_ca.crt
+    anycubic_mqqt_tls_client.crt
+    anycubic_mqqt_tls_client.key
+
+These are Anycubic's own X.509 certificates and the matching client key,
+issued by "AC Root CA, O=Anycubic" to "CN=AnycubicSlicer". They are the
+property of Shenzhen Anycubic Technology Co., Ltd.
+
+They are NOT the work of the authors above, are NOT licensed under the GNU
+General Public License, and no claim of ownership over them is made here.
+They are included solely because Anycubic's MQTT broker requires mutual TLS
+using this identity, and there is no other way for a third-party client to
+connect to a service the user already has an account with.
+
+They are a shared identity distributed inside Anycubic's own desktop slicer,
+not a per-user credential, and were present in the upstream project this is
+derived from.
+
+If Anycubic would prefer these were not redistributed, contact the maintainer
+and they will be removed.

anycubic_cloud_api-0.4.4/MANIFEST.in

@@ -0,0 +1,3 @@
+include LICENSE
+include COPYRIGHT
+include README.md

{anycubic_cloud_api-0.4.2/src/anycubic_cloud_api.egg-info → anycubic_cloud_api-0.4.4}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: anycubic-cloud-api
-Version: 0.4.2
+Version: 0.4.4
 Summary: Async client for the Anycubic Cloud API and its MQTT stream
-Author: Nino Bondonno
+Author: WaresWichall, Nino Bondonno
 Maintainer: Nino Bondonno
 License: GPL-3.0-or-later
 Project-URL: Homepage, https://github.com/Nino6689/anycubic-cloud-api
@@ -29,9 +29,33 @@ Dynamic: license-file
 
 Async Python client for the **Anycubic Cloud** API and its MQTT telemetry stream.
 
-Extracted from the [Home Assistant Anycubic Cloud integration](https://github.com/Nino6689/hass-anycubic_cloud)
+Extracted from the [Home Assistant Anycubic integration](https://github.com/Nino6689/hass-anycubic)
 so it can be versioned, tested and used independently.
 
+## Attribution
+
+**The bulk of this library is the work of [@WaresWichall](https://github.com/WaresWichall), from
+[hass-anycubic_cloud](https://github.com/WaresWichall/hass-anycubic_cloud)** — the Anycubic cloud
+API client, the MQTT layer and the printer data models all originated there, under GPL-3.0.
+
+This package extracts that code so it can be versioned and tested on its own, and adds to it:
+the LAN Mode client, the filament-usage maths, tolerant parsing of partial reports, and the test
+suite. Those additions and modifications are by [@Nino6689](https://github.com/Nino6689), from
+2026 onwards.
+
+It remains **GPL-3.0-or-later**, as it must.
+
+### Anycubic's certificates
+
+This package ships Anycubic's own TLS certificates and client key, because their MQTT broker
+requires mutual TLS using that identity and there is no other way for a third-party client to reach
+it. **They are Anycubic's property, not covered by this licence, and no ownership is claimed** — see
+[COPYRIGHT](COPYRIGHT). They are a shared identity taken from Anycubic's own slicer rather than a
+per-user credential, and they came from the upstream project this is derived from.
+
+The **LAN Mode** client needs none of this. If you only talk to the printer locally, no Anycubic
+credential is involved at any point.
+
 ## Install
 
 ```bash

{anycubic_cloud_api-0.4.2 → anycubic_cloud_api-0.4.4}/README.md

@@ -2,9 +2,33 @@
 
 Async Python client for the **Anycubic Cloud** API and its MQTT telemetry stream.
 
-Extracted from the [Home Assistant Anycubic Cloud integration](https://github.com/Nino6689/hass-anycubic_cloud)
+Extracted from the [Home Assistant Anycubic integration](https://github.com/Nino6689/hass-anycubic)
 so it can be versioned, tested and used independently.
 
+## Attribution
+
+**The bulk of this library is the work of [@WaresWichall](https://github.com/WaresWichall), from
+[hass-anycubic_cloud](https://github.com/WaresWichall/hass-anycubic_cloud)** — the Anycubic cloud
+API client, the MQTT layer and the printer data models all originated there, under GPL-3.0.
+
+This package extracts that code so it can be versioned and tested on its own, and adds to it:
+the LAN Mode client, the filament-usage maths, tolerant parsing of partial reports, and the test
+suite. Those additions and modifications are by [@Nino6689](https://github.com/Nino6689), from
+2026 onwards.
+
+It remains **GPL-3.0-or-later**, as it must.
+
+### Anycubic's certificates
+
+This package ships Anycubic's own TLS certificates and client key, because their MQTT broker
+requires mutual TLS using that identity and there is no other way for a third-party client to reach
+it. **They are Anycubic's property, not covered by this licence, and no ownership is claimed** — see
+[COPYRIGHT](COPYRIGHT). They are a shared identity taken from Anycubic's own slicer rather than a
+per-user credential, and they came from the upstream project this is derived from.
+
+The **LAN Mode** client needs none of this. If you only talk to the printer locally, no Anycubic
+credential is involved at any point.
+
 ## Install
 
 ```bash

{anycubic_cloud_api-0.4.2 → anycubic_cloud_api-0.4.4}/pyproject.toml

@@ -4,12 +4,16 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "anycubic-cloud-api"
-version = "0.4.2"
+version = "0.4.4"
 description = "Async client for the Anycubic Cloud API and its MQTT stream"
 readme = "README.md"
 requires-python = ">=3.12"
 license = { text = "GPL-3.0-or-later" }
+# Most of this library originated in WaresWichall's Home Assistant
+# integration; it is extracted, modified and extended here. See the
+# attribution section of the README.
 authors = [
+    { name = "WaresWichall" },
     { name = "Nino Bondonno" },
 ]
 maintainers = [

{anycubic_cloud_api-0.4.2 → anycubic_cloud_api-0.4.4}/src/anycubic_cloud_api/const/enums.py

@@ -15,6 +15,8 @@ class AnycubicPrintStatus(IntEnum):
     Checking = 5
     Preheating = 6
     Slicing = 7
+    # 8 is unclaimed -- no printer has been observed reporting it.
+    Levelling = 9
 
 
 class AnycubicOrderID(IntEnum):

{anycubic_cloud_api-0.4.2 → anycubic_cloud_api-0.4.4}/src/anycubic_cloud_api/data_models/project.py

@@ -1018,10 +1018,12 @@ class AnycubicProject:
             return "preheating"
         elif self._print_status == AnycubicPrintStatus.Slicing:
             return "slicing"
+        elif self._print_status == AnycubicPrintStatus.Levelling:
+            return "levelling"
 
-        # Newer firmware reports codes this enum doesn't cover -- a Kobra S1
-        # sends 9 while levelling. The printer also sends a plain-text phase
-        # alongside it, which is far more useful than "unknown", so prefer it.
+        # Newer firmware still reports codes this enum doesn't cover. The
+        # printer sends a plain-text phase alongside the code, which is far
+        # more useful than "unknown", so prefer it over giving up.
         reported_state = self._get_print_setting('state')
 
         if reported_state:

{anycubic_cloud_api-0.4.2 → anycubic_cloud_api-0.4.4/src/anycubic_cloud_api.egg-info}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: anycubic-cloud-api
-Version: 0.4.2
+Version: 0.4.4
 Summary: Async client for the Anycubic Cloud API and its MQTT stream
-Author: Nino Bondonno
+Author: WaresWichall, Nino Bondonno
 Maintainer: Nino Bondonno
 License: GPL-3.0-or-later
 Project-URL: Homepage, https://github.com/Nino6689/anycubic-cloud-api
@@ -29,9 +29,33 @@ Dynamic: license-file
 
 Async Python client for the **Anycubic Cloud** API and its MQTT telemetry stream.
 
-Extracted from the [Home Assistant Anycubic Cloud integration](https://github.com/Nino6689/hass-anycubic_cloud)
+Extracted from the [Home Assistant Anycubic integration](https://github.com/Nino6689/hass-anycubic)
 so it can be versioned, tested and used independently.
 
+## Attribution
+
+**The bulk of this library is the work of [@WaresWichall](https://github.com/WaresWichall), from
+[hass-anycubic_cloud](https://github.com/WaresWichall/hass-anycubic_cloud)** — the Anycubic cloud
+API client, the MQTT layer and the printer data models all originated there, under GPL-3.0.
+
+This package extracts that code so it can be versioned and tested on its own, and adds to it:
+the LAN Mode client, the filament-usage maths, tolerant parsing of partial reports, and the test
+suite. Those additions and modifications are by [@Nino6689](https://github.com/Nino6689), from
+2026 onwards.
+
+It remains **GPL-3.0-or-later**, as it must.
+
+### Anycubic's certificates
+
+This package ships Anycubic's own TLS certificates and client key, because their MQTT broker
+requires mutual TLS using that identity and there is no other way for a third-party client to reach
+it. **They are Anycubic's property, not covered by this licence, and no ownership is claimed** — see
+[COPYRIGHT](COPYRIGHT). They are a shared identity taken from Anycubic's own slicer rather than a
+per-user credential, and they came from the upstream project this is derived from.
+
+The **LAN Mode** client needs none of this. If you only talk to the printer locally, no Anycubic
+credential is involved at any point.
+
 ## Install
 
 ```bash

{anycubic_cloud_api-0.4.2 → anycubic_cloud_api-0.4.4}/src/anycubic_cloud_api.egg-info/SOURCES.txt

@@ -1,4 +1,6 @@
+COPYRIGHT
 LICENSE
+MANIFEST.in
 README.md
 pyproject.toml
 src/anycubic_cloud_api/__init__.py

{anycubic_cloud_api-0.4.2 → anycubic_cloud_api-0.4.4}/tests/test_lan_reports.py

@@ -415,3 +415,67 @@ class TestWhatTheCloudWouldHaveSaid:
         )
 
         assert printer.supports_function_multi_color_box is True
+
+
+class TestLevellingStatus:
+    """Upstream issue #55: job state read 'unknown' while the printer levelled.
+
+    The status enum stopped at 7, so code 9 fell through as unrecognised.
+    """
+
+    def test_levelling_is_a_known_status(self):
+        from anycubic_cloud_api.const.enums import AnycubicPrintStatus
+
+        assert AnycubicPrintStatus(9).name == "Levelling"
+
+    def test_the_existing_statuses_are_unchanged(self):
+        """Their numbers are on the wire; renumbering would break history."""
+        from anycubic_cloud_api.const.enums import AnycubicPrintStatus
+
+        assert [(s.name, s.value) for s in AnycubicPrintStatus] == [
+            ("Printing", 1),
+            ("Complete", 2),
+            ("Cancelled", 3),
+            ("Downloading", 4),
+            ("Checking", 5),
+            ("Preheating", 6),
+            ("Slicing", 7),
+            ("Levelling", 9),
+        ]
+
+
+class TestLevellingReadsAsLevelling:
+    """The job state should say what the printer is doing, not "unknown"."""
+
+    def _status(self, code, reported=None):
+        from anycubic_cloud_api.data_models.project import AnycubicProject
+
+        class Stub(AnycubicProject):
+            """Only the two inputs print_status reads, so no full project."""
+
+            __slots__ = ("_reported",)
+
+            def __init__(self, code, reported):
+                self._print_status = code
+                self._reported = reported
+
+            @property
+            def print_is_paused(self):
+                return False
+
+            def _get_print_setting(self, key):
+                return self._reported if key == "state" else None
+
+        return Stub(code, reported).print_status
+
+    def test_levelling(self):
+        assert self._status(9) == "levelling"
+
+    def test_printing_is_unaffected(self):
+        assert self._status(1) == "printing"
+
+    def test_an_unmapped_code_prefers_the_printers_own_words(self):
+        assert self._status(99, reported="calibrating") == "calibrating"
+
+    def test_an_unmapped_code_with_no_text_is_unknown(self):
+        assert self._status(99) == "unknown"