circup 1.5.3__tar.gz → 1.6.0__tar.gz

circup-1.6.0/.isort.cfg

@@ -0,0 +1,5 @@
+# SPDX-FileCopyrightText: 2023 Vladimír Kotal
+#
+# SPDX-License-Identifier: Unlicense
+[settings]
+profile = black

{circup-1.5.3/circup.egg-info → circup-1.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: circup
-Version: 1.5.3
+Version: 1.6.0
 Summary: A tool to manage/update libraries on CircuitPython devices.
 Home-page: https://github.com/adafruit/circup
 Author: Adafruit Industries
@@ -57,16 +57,16 @@ Requires-Dist: sphinx; extra == "dev"
 Requires-Dist: wheel; extra == "dev"
 Requires-Dist: twine; extra == "dev"
 Provides-Extra: all
-Requires-Dist: pylint; extra == "all"
-Requires-Dist: coverage; extra == "all"
-Requires-Dist: pytest-cov; extra == "all"
 Requires-Dist: pytest-faulthandler; extra == "all"
-Requires-Dist: sphinx; extra == "all"
-Requires-Dist: pytest-random-order>=1.0.0; extra == "all"
-Requires-Dist: black; extra == "all"
 Requires-Dist: pytest; extra == "all"
-Requires-Dist: wheel; extra == "all"
+Requires-Dist: coverage; extra == "all"
+Requires-Dist: pytest-random-order>=1.0.0; extra == "all"
 Requires-Dist: twine; extra == "all"
+Requires-Dist: sphinx; extra == "all"
+Requires-Dist: wheel; extra == "all"
+Requires-Dist: pytest-cov; extra == "all"
+Requires-Dist: pylint; extra == "all"
+Requires-Dist: black; extra == "all"
 
 
 CircUp
@@ -159,24 +159,32 @@ To get help, just type the command::
       A tool to manage and update libraries on a CircuitPython device.
 
     Options:
-      --verbose         Comprehensive logging is sent to stdout.
-      --version         Show the version and exit.
-      --path DIRECTORY  Path to CircuitPython directory. Overrides automatic
-                        path detection.
-      --help            Show this message and exit.
-      -r --requirement  Supports requirements.txt tracking of library
-                        requirements with freeze and install commands.
+      --verbose           Comprehensive logging is sent to stdout.
+      --path DIRECTORY    Path to CircuitPython directory. Overrides automatic
+                          path detection.
+      --host TEXT         Hostname or IP address of a device. Overrides automatic
+                          path detection.
+      --password TEXT     Password to use for authentication when --host is used.
+      --board-id TEXT     Manual Board ID of the CircuitPython device. If provided
+                          in combination with --cpy-version, it overrides the
+                          detected board ID.
+      --cpy-version TEXT  Manual CircuitPython version. If provided in combination
+                          with --board-id, it overrides the detected CPy version.
+      --version           Show the version and exit.
+      --help              Show this message and exit.
 
     Commands:
-      freeze        Output details of all the modules found on the connected...
-      install       Installs .mpy version of named module(s) onto the device.
-      install --py  Installs .py version of named module(s).
-      list          Lists all out of date modules found on the connected...
-      show          Show the long list of all available modules in the bundle.
-      show <query>  Search the names in the modules in the bundle for a match.
-      uninstall     Uninstall a named module(s) from the connected device.
-      update        Update modules on the device. Use --all to automatically update
-                    all modules.
+      bundle-add     Add bundles to the local bundles list, by "user/repo"...
+      bundle-remove  Remove one or more bundles from the local bundles list.
+      bundle-show    Show the list of bundles, default and local, with URL,...
+      freeze         Output details of all the modules found on the connected...
+      install        Install a named module(s) onto the device.
+      list           Lists all out of date modules found on the connected...
+      show           Show a list of available modules in the bundle.
+      uninstall      Uninstall a named module(s) from the connected device.
+      update         Update modules on the device. Use --all to automatically
+                     update all modules without Major Version warnings.
+
 
 
 To automatically install all modules imported by ``code.py``,
@@ -291,6 +299,12 @@ The ``--version`` flag will tell you the current version of the
     $ circup --version
     CircUp, A CircuitPython module updater. Version 0.0.1
 
+
+To use circup via the `Web Workflow <https://learn.adafruit.com/getting-started-with-web-workflow-using-the-code-editor>`_. on devices that support it. Use the ``--host`` and ``--password`` arguments before your circup command.::
+
+    $ circup --host 192.168.1.119 --password s3cr3t install adafruit_hid
+    $ circup --host cpy-9573b2.local --password s3cr3t install adafruit_hid
+
 That's it!
 
 

{circup-1.5.3 → circup-1.6.0}/README.rst

@@ -89,24 +89,32 @@ To get help, just type the command::
       A tool to manage and update libraries on a CircuitPython device.
 
     Options:
-      --verbose         Comprehensive logging is sent to stdout.
-      --version         Show the version and exit.
-      --path DIRECTORY  Path to CircuitPython directory. Overrides automatic
-                        path detection.
-      --help            Show this message and exit.
-      -r --requirement  Supports requirements.txt tracking of library
-                        requirements with freeze and install commands.
+      --verbose           Comprehensive logging is sent to stdout.
+      --path DIRECTORY    Path to CircuitPython directory. Overrides automatic
+                          path detection.
+      --host TEXT         Hostname or IP address of a device. Overrides automatic
+                          path detection.
+      --password TEXT     Password to use for authentication when --host is used.
+      --board-id TEXT     Manual Board ID of the CircuitPython device. If provided
+                          in combination with --cpy-version, it overrides the
+                          detected board ID.
+      --cpy-version TEXT  Manual CircuitPython version. If provided in combination
+                          with --board-id, it overrides the detected CPy version.
+      --version           Show the version and exit.
+      --help              Show this message and exit.
 
     Commands:
-      freeze        Output details of all the modules found on the connected...
-      install       Installs .mpy version of named module(s) onto the device.
-      install --py  Installs .py version of named module(s).
-      list          Lists all out of date modules found on the connected...
-      show          Show the long list of all available modules in the bundle.
-      show <query>  Search the names in the modules in the bundle for a match.
-      uninstall     Uninstall a named module(s) from the connected device.
-      update        Update modules on the device. Use --all to automatically update
-                    all modules.
+      bundle-add     Add bundles to the local bundles list, by "user/repo"...
+      bundle-remove  Remove one or more bundles from the local bundles list.
+      bundle-show    Show the list of bundles, default and local, with URL,...
+      freeze         Output details of all the modules found on the connected...
+      install        Install a named module(s) onto the device.
+      list           Lists all out of date modules found on the connected...
+      show           Show a list of available modules in the bundle.
+      uninstall      Uninstall a named module(s) from the connected device.
+      update         Update modules on the device. Use --all to automatically
+                     update all modules without Major Version warnings.
+
 
 
 To automatically install all modules imported by ``code.py``,
@@ -221,6 +229,12 @@ The ``--version`` flag will tell you the current version of the
     $ circup --version
     CircUp, A CircuitPython module updater. Version 0.0.1
 
+
+To use circup via the `Web Workflow <https://learn.adafruit.com/getting-started-with-web-workflow-using-the-code-editor>`_. on devices that support it. Use the ``--host`` and ``--password`` arguments before your circup command.::
+
+    $ circup --host 192.168.1.119 --password s3cr3t install adafruit_hid
+    $ circup --host cpy-9573b2.local --password s3cr3t install adafruit_hid
+
 That's it!