spyder-watchlist


Namespyder-watchlist JSON
Version 1.1.1 PyPI version JSON
download
home_pageNone
SummaryWatchlist plugin for the debugger in the Spyder IDE
upload_time2024-12-20 07:25:36
maintainerNone
docs_urlNone
authorNone
requires_python>=3.7
licenseNone
keywords spyder watchlist debugger
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Spyder Watchlist plugin

Watchlist plugin for the debugger in the Spyder IDE

A watchlist is a functionality some IDEs offer while debugging code. It is
related to the display of all variables accessible in the current scope (aka
Variable Explorer in Spyder). But there is an important distinction: A Watchlist
consists of a user-definable list of expressions. These expressions are
evaluated after each debugger step and the result of the evaluation is
displayed. See [here](https://github.com/spyder-ide/spyder/issues/16438) for a
screencast which demonstrates the plugin.


## Installation

    pip install spyder-watchlist

## Features

* Any Python expression can be entered. The Watchlist displays the stringified
  result of the evaluation. In terms of Python code `value =
  str(eval(expression, globals, locals))`.

  > **Warning**
  > This makes the Watchlist a very powerful tool, but this comes at a cost: Any
  > side effects of an expression will affect your execution environment.

* The values of expressions are refreshed whenever they might have changed
  (after executing commands in the IPython Console and after debugger commands).
* The list of expressions can be modified at any time; see [Usage](#usage) for
  details.
* The value of an expression is shown with bold font if it has changed
* The value of an invalid expression is show as `<exception name>`. Hover the
  mouse over the value to show the full exception message in a tooltip.

## Usage

* Rearranging of expressions: Use Drag & Drop
* Changing an existing expression: Double click on expression (first column)
* Adding a new expression
  * Toolbar `+` button
  * Menu entry in right-click menu (anywhere in the table)
  * Double click at the end of the table (only possible if there is no
    scrollbar)
  * Drag & Drop text. If the text consists of multiple lines, each line is added
    as an expression.
* Removing expressions. The following actions remove the currently selected
  expressions:
  * Toolbar `-` button
  * Menu entry in right-click menu
  * `Del` keyboard key
* There is also a “Remove all expression” action in the toolbar and right-click
  menu

## Known Issues

* The value of variables in the current scope can be changed in Spyder’s
  Variable Explorer plugin. Expressions in the Watchlist depending on any
  variable changed in the Variable Explorer will display an outdated value. The
  new expression value is displayed after a refresh of the Watchlist. A
  refresh is trigged by:
  * Executing commands in the IPython Console. Pressing Enter with an empty
    input prompt is sufficient.
  * Modifying the list of expressions in some way (add, remove or edit an
    expression)

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "spyder-watchlist",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": "\"A. Reit\" <a.reit@procitec.de>",
    "keywords": "Spyder, watchlist, debugger",
    "author": null,
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/98/79/342c968b30b0d08711c567770bc3a8958a76cea359318c06fef146b08627/spyder_watchlist-1.1.1.tar.gz",
    "platform": null,
    "description": "# Spyder Watchlist plugin\n\nWatchlist plugin for the debugger in the Spyder IDE\n\nA watchlist is a functionality some IDEs offer while debugging code. It is\nrelated to the display of all variables accessible in the current scope (aka\nVariable Explorer in Spyder). But there is an important distinction: A Watchlist\nconsists of a user-definable list of expressions. These expressions are\nevaluated after each debugger step and the result of the evaluation is\ndisplayed. See [here](https://github.com/spyder-ide/spyder/issues/16438) for a\nscreencast which demonstrates the plugin.\n\n\n## Installation\n\n    pip install spyder-watchlist\n\n## Features\n\n* Any Python expression can be entered. The Watchlist displays the stringified\n  result of the evaluation. In terms of Python code `value =\n  str(eval(expression, globals, locals))`.\n\n  > **Warning**\n  > This makes the Watchlist a very powerful tool, but this comes at a cost: Any\n  > side effects of an expression will affect your execution environment.\n\n* The values of expressions are refreshed whenever they might have changed\n  (after executing commands in the IPython Console and after debugger commands).\n* The list of expressions can be modified at any time; see [Usage](#usage) for\n  details.\n* The value of an expression is shown with bold font if it has changed\n* The value of an invalid expression is show as `<exception name>`. Hover the\n  mouse over the value to show the full exception message in a tooltip.\n\n## Usage\n\n* Rearranging of expressions: Use Drag & Drop\n* Changing an existing expression: Double click on expression (first column)\n* Adding a new expression\n  * Toolbar `+` button\n  * Menu entry in right-click menu (anywhere in the table)\n  * Double click at the end of the table (only possible if there is no\n    scrollbar)\n  * Drag & Drop text. If the text consists of multiple lines, each line is added\n    as an expression.\n* Removing expressions. The following actions remove the currently selected\n  expressions:\n  * Toolbar `-` button\n  * Menu entry in right-click menu\n  * `Del` keyboard key\n* There is also a \u201cRemove all expression\u201d action in the toolbar and right-click\n  menu\n\n## Known Issues\n\n* The value of variables in the current scope can be changed in Spyder\u2019s\n  Variable Explorer plugin. Expressions in the Watchlist depending on any\n  variable changed in the Variable Explorer will display an outdated value. The\n  new expression value is displayed after a refresh of the Watchlist. A\n  refresh is trigged by:\n  * Executing commands in the IPython Console. Pressing Enter with an empty\n    input prompt is sufficient.\n  * Modifying the list of expressions in some way (add, remove or edit an\n    expression)\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Watchlist plugin for the debugger in the Spyder IDE",
    "version": "1.1.1",
    "project_urls": {
        "Changelog": "https://github.com/procitec/spyder-watchlist/blob/main/CHANGELOG.md",
        "Source": "https://github.com/procitec/spyder-watchlist"
    },
    "split_keywords": [
        "spyder",
        " watchlist",
        " debugger"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "afc4992875e885f0595b99e0625701e255b803e089286961422e05b49c84f499",
                "md5": "8057f8fcd4d78df3c425f00d6092dac2",
                "sha256": "10df6e4772c4e90b422180389f9469c71cdc8ba2982fb1b488d1c3e69f63d8d9"
            },
            "downloads": -1,
            "filename": "spyder_watchlist-1.1.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "8057f8fcd4d78df3c425f00d6092dac2",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 14097,
            "upload_time": "2024-12-20T07:25:33",
            "upload_time_iso_8601": "2024-12-20T07:25:33.961198Z",
            "url": "https://files.pythonhosted.org/packages/af/c4/992875e885f0595b99e0625701e255b803e089286961422e05b49c84f499/spyder_watchlist-1.1.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "9879342c968b30b0d08711c567770bc3a8958a76cea359318c06fef146b08627",
                "md5": "5cb120be9e944e7a37647e644efd77ea",
                "sha256": "ec4b37a2af1a3e62f355962b6662df4421a950cb44b584fc5ce278e24232ccfd"
            },
            "downloads": -1,
            "filename": "spyder_watchlist-1.1.1.tar.gz",
            "has_sig": false,
            "md5_digest": "5cb120be9e944e7a37647e644efd77ea",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 12672,
            "upload_time": "2024-12-20T07:25:36",
            "upload_time_iso_8601": "2024-12-20T07:25:36.563941Z",
            "url": "https://files.pythonhosted.org/packages/98/79/342c968b30b0d08711c567770bc3a8958a76cea359318c06fef146b08627/spyder_watchlist-1.1.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-12-20 07:25:36",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "procitec",
    "github_project": "spyder-watchlist",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "spyder-watchlist"
}
        
Elapsed time: 0.43578s