Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		 Previous revision
indigo_2025.1_documentation:python_packages [2025/09/22 19:58] – created - external edit 127.0.0.1indigo_2025.1_documentation:python_packages [2026/02/11 22:53] (current) – [Python 3.11.6 Packages Installed by Indigo] davel17
Line 3: Line 3:
 This page describes how **Indigo 2025.1.0** works with Python, specifically with respect to packages/libraries. This page describes how **Indigo 2025.1.0** works with Python, specifically with respect to packages/libraries.
  
-Indigo 2025.1 shipped with [[api_release_notes:3.4|API version 3.4]] and is the first version to contain support for Python version 3 (check the [[:API Version Chart]] to see what version of the API is available in which Indigo versions). With this version of the API, Python 3 is now automatically installed as part of the Indigo installer. For Indigo 2025.1, we are including Python 3.11.6.+Indigo 2025.1 shipped with [[api_release_notes:3.7|API version 3.4]] and is the first version to contain support for Python version 3 (check the [[:API Version Chart]] to see what version of the API is available in which Indigo versions). With this version of the API, Python 3 is now automatically installed as part of the Indigo installer. For Indigo 2025.1, we are including **Python 3.11.6**.
  
 **All embedded and external Python scripts are run in Python 3** - so you will need to update your scripts if they aren't working (we can't automatically tell if they will work or not unfortunately). We believe that simple scripts will most likely work without change, but if not, you can walk through [[https://github.com/IndigoDomotics/IndigoSDK/blob/main/Updating%20to%20API%20version%203.0%20(Python%203).md|the document]] mentioned above and perhaps spot the changes you need. You can also post your scripts on the [[https://forums.indigodomo.com/viewforum.php?f=364|Help Converting to Python 3]] forum to get help with any conversion issues. **All embedded and external Python scripts are run in Python 3** - so you will need to update your scripts if they aren't working (we can't automatically tell if they will work or not unfortunately). We believe that simple scripts will most likely work without change, but if not, you can walk through [[https://github.com/IndigoDomotics/IndigoSDK/blob/main/Updating%20to%20API%20version%203.0%20(Python%203).md|the document]] mentioned above and perhaps spot the changes you need. You can also post your scripts on the [[https://forums.indigodomo.com/viewforum.php?f=364|Help Converting to Python 3]] forum to get help with any conversion issues.
Line 180: Line 180:
 === Python 3.11.6 Packages Installed by Indigo === === Python 3.11.6 Packages Installed by Indigo ===
  
-Indigo 2025.1 ships with support for the following Python 3 packages in addition to the packages installed with the standard Python framework. Generally, if earlier versions of the listed packages are installed at the location Indigo uses, they will be upgraded to the version numbers below. The //''>=''// symbol means the version installed by Indigo may be newer than the version listed, but will not be older. //''pyserial''// is also installed but is installed differently than the other packages listed above and should be unmodifiable.+Indigo 2025.1 ships with support for the following Python 3 packages in addition to the packages installed with the standard Python framework. Generally, if earlier versions of the listed packages are installed at the location Indigo uses, they will be upgraded to the version numbers below. The //''>=''// symbol means the version installed by Indigo may be newer than the version listed, but will not be older. //''pyserial''// is also installed but is installed differently than the other packages listed above and should be unmodifiable. Libraries marked with * are dependencies and may get newer versions on later installs. **You should not update any of the libraries listed as they (and their dependencies may rely on a specific version.)**
  
 ^  PIP installed by Indigo\\ PIP Modifiable (but not recommended)  ^^ ^  PIP installed by Indigo\\ PIP Modifiable (but not recommended)  ^^
 ^  Package  ^  Version  ^ ^  Package  ^  Version  ^
-| certifi               |  >= 2023.11.17 | +| * aiofiles          |      >=24.1.0 | 
-| charset_normalizer    |       >= 3.3.2 | +| * anyio             |       >=4.8.0 | 
-| cryptography          |      >= 41.0.7 | +| certifi             |  ==2023.11.17 | 
-| - cffi                |      >= 1.16.0 | +| * cffi              |      >=1.17.1 | 
-| - pycparser           |        >= 2.21 | +| charset_normalizer  |       ==3.3.2 | 
-| cycler                |         0.12.1 | +| * contourpy         |       >=1.3.1 | 
-| dictdiffer            |       >= 0.9.0 | +| cryptography        |      ==41.0.7 | 
-| future                |      >= 0.18.3 | +| * cycler            |      >=0.12.1 | 
-| httpx                 |      >= 0.25.2 | +| dictdiffer          |       ==0.9.0 | 
-| - anyio               |       >= 4.1.0 | +| * fonttools         |      >=4.56.0 | 
-| - certifi             |  >= 2023.11.17 | +| future              |      ==0.18.3 | 
-| - h11                 |      >= 0.14.0 | +| * h11               |      >=0.14.0 | 
-| - httpcore            |       >= 1.0.2 | +| * html5tagger       |       >=1.3.0 | 
-| - idna                |         >= 3.6 | +| * httpcore          |       >=1.0.7 | 
-| - sniffio             |       >= 1.3.0 | +| * httptools         |       >=0.6.4 | 
-| idna                  |         >= 3.6 | +| httpx               |      ==0.25.2 | 
-| janus                 |       >= 1.0.0 | +| idna                |         ==3.6 | 
-| - typing_extensions   |       >= 4.8.0 | +| janus               |       ==1.0.0 | 
-| Jinja2                |       >= 3.1.2 | +| * jedi              |      >=0.19.2 | 
-| kiwisolver            |          1.4.5 | +| Jinja2              |       ==3.1.2 | 
-| MarkupSafe            |       >= 2.1.3 | +| * kiwisolver        |       >=1.4.8 | 
-| matplotlib            |       >= 3.8.2 | +| MarkupSafe          |       ==2.1.3 | 
-| - fonttools           |      >= 4.45.1 | +| matplotlib          |       ==3.8.2 | 
-| - contourpy           |       >= 1.2.0 | +| * multidict         |       >=6.1.0 | 
-| numpy                 |         1.26.2 | +| * numpy             |      >=1.26.4 | 
-| oauthlib              |       >= 3.2.2 | +| oauthlib            |       ==3.2.2 | 
-| Pillow                |      >= 10.1.0 | +| * packaging         |        >=24.2 | 
-| pudb                  |      >= 2023.1 | +| * parso             |       >=0.8.4 | 
-| - jedi                |      >= 0.19.0 | +| Pillow              |      ==11.1.0 | 
-| - packaging           |        >= 23.2 | +| pudb                |      ==2023.1 | 
-| - parso               |       >= 0.8.3 | +| py-applescript      |       ==1.0.3 | 
-| - pygments            |      >= 2.17.2 | +| pyaes               |       ==1.6.1 | 
-| - urwid               |       >= 2.3.4 | +| * pycparser         |        >=2.22 | 
-| - urwid-readline      |        >= 0.13 | +| * Pygments          |      >=2.19.1 | 
-| py-applescript        |       >= 1.0.3 | +| pyobjc              |        ==10.0 | 
-| pyaes                 |       >= 1.6.1 | +| pyparsing           |       ==3.1.1 | 
-| pyobjc                |       >=  10.0 | +| python-box          |       ==7.3.2 | 
-| pyparsing             |       >= 3.1.1 | +| python-dateutil     |       ==2.8.2 | 
-| python-box            |       >= 7.3.2 | +| requests            |      ==2.31.0 | 
-| python-dateutil       |       >= 2.8.2 | +| requests-oauthlib   |       ==1.3.1 | 
-| requests              |      >= 2.31.0 | +| sanic               |      ==23.6.0 | 
-| requests-oauthlib     |       >= 1.3.1 | +| * sanic-routing     |     >=23.12.0 | 
-| sanic                 |      >= 23.6.0 | +| sanic-session       |       ==0.8.0 | 
-| - aiofiles            |      >= 23.2.1 | +| scipy               |      ==1.11.4 | 
-| - httptools           |       >= 0.6.1 | +| six                 |      ==1.16.0 | 
-| - html5tagger         |       >= 1.3.0 | +| * sniffio           |       >=1.3.1 | 
-| - multidict           |       >= 6.0.4 | +| * tracerite         |       >=1.1.1 | 
-| - sanic-routing       |      >= 23.6.0 | +| * typing_extensions |      >=4.12.2 | 
-| - sanic-session       |       >= 0.8.0 | +| * ujson             |      >=5.10.0 | 
-| - tracerite           |       >= 1.1.1 | +| urllib3             |       ==2.1.0 | 
-| - ujson               |       >= 5.8.0 | +| * urwid             |      >=2.6.16 | 
-| - uvloop              |      >= 0.19.0 | +| * urwid-readline    |      >=0.15.1 | 
-| - websockets          |        >= 12.0 | +| * uvloop            |      >=0.21.0 | 
-| scipy                 |      >= 1.11.4 | +| * wcwidth           |     >= 0.2.13 | 
-| six                   |      >= 1.16.0 | +| websockets          |        ==14.1 | 
-| urllib3               |       >= 2.1.0 | +| xmljson             |       ==0.2.1 | 
-| xmljson               |       >= 0.2.1 | +^                     ^               ^ 
-^                       ^                ^ +| pyserial            |           3.5 | 
-| pyserial              |            3.5 |+===== Special Packages ===== 
 +This section contains notes and examples about some library features that may be of particular help to developers.
  
 +==== Python Box ====
 +Depending on your Indigo version, we may have installed the [[https://github.com/cdgriffith/Box|Python-Box library]]. This library allows the user to use JavaScript style dot notation to access parts of a collection. There are good descriptions of all the functionality on the library's page link above. What we were most interested in is a `box` instance that has the `box_dots` option set to true, like this:
 +
 +<code>
 +my_box = box.Box(some_dict, box_dots=True)
 +</code>
 +
 +This allows developers to specify a string using JavaScript style dot notation to get to parts of the `box` object:
 +
 +<code>
 +some_element = my_box["keyhere.[0].anotherkey"]
 +</code>
 +
 +Here are some concrete examples:
 +
 +<code>
 +import box
 +
 +# Given this dictionary
 +my_dict = {
 +    "a-list":[1, 2, {"dict-in-list":"fun stuff"}],
 +    "a-dict":{"first":"first element", "second":"second element"}
 +}
 +
 +my_box = box.Box(my_dict, box_dots=True)  # create a box object of my_dict
 +
 +dict_in_list = my_box["a-list.[2].dict-in-list"]  # equals "fun stuff"
 +
 +int_from_list = my_box["a-list.[0]"]  # equals 1
 +
 +a_dict = my_box["a-dict"]  # equals {'first': 'first element', 'second': 'second element'}
 +</code>
 +
 +This is useful in a variety of ways, but we use it extensively in the [[indigo_2025.1_documentation:events_data_passing|Event Data Passing]] and [[indigo_2025.1_documentation:webhooks|Webhook]] features. You can determine whether you have the //''box''// library installed by simply trying to import it into a scripting shell or embedded script.
  • /www/perceptive/wiki/data/attic/indigo_2025.1_documentation/python_packages.1758571102.txt.gz
  • Last modified: 2025/09/22 19:58
  • by 127.0.0.1