DearPyGui v0.4.0 Release Notes

Release Date: 2020-09-29 // over 3 years ago
  • Background

    All, this is one of the biggest releases to date. We apologize in advance for breaking any code. This release served 3 purposes:

    1. Solidify current API's features for Version 1.0
    2. Complete plotting capabilities ๐Ÿšง 3. Prepare the backend for more long term maintenance.


    • 99% of the current API will remain for version 1.0. We don't plan on breaking backwards compatibility for the current API unless there is a very good reason and it will extremely isolated.
    • ๐Ÿ“š I'm sure we missed some changes. It would be best to review the documentation.
    • ๐Ÿ‘‰ Checkout the new show_demo command in dearpygui.demo
    • Some previous commands are now in dearpygui.simple.
    • Several widgets received a considerable amount of new flags, please review.
    • ๐Ÿ”ง Every keyword you used to create a widget can now be modified with configure_item("some widget", keyword1=blah, keyword2=blah).
    • โšก๏ธ The examples have been updated to work, however they are not necessarily the best reference on best way to use the library. We will be updating this soon.
    • ๐Ÿ“š The documentation has been updated, but will need to be massively extended to include all the new features and possibilities.
    • The data source system has been separated from the widget shared value system.
    • We will be adding a lot more helpers and wrappers to simple. In particular to help with plotting.
    • ๐Ÿ”จ If you need help refactoring your code for these changes, feel free to reach out in the discord!
    • ๐Ÿ‘‰ We are sure there may be a few bugs with these number of changes, but we have made our best effort in testing all the features. You can actually see our testing cases with the show_demo command.

    ๐Ÿ›  Fixes

    • ๐Ÿ›  Threadpool: Fixed issue with some tasks going uncompleted
    • Popups: Can now be added anywhere (doesn't have to be right after their parent)
    • Tooltips: Can now be added anywhere (doesn't have to be right after their parent)
    • Widgets: Can widths can now be negative (size from the right side of screen)

    ๐Ÿ’ฅ Breaking Changes

    • ๐Ÿ– Handlers: removed handler from all callbacks except resize
    • Data Source: data_source keywords changed to source
    • Tables: tables no longer use set/get value
    • Modules: dearpygui module is now called core
    • Modules: wrapper module is now called simple
    • Line Series: Removed fill keyword (use the new shade series)
    • ๐Ÿšš Plots: Removed all flags in favor of keywords
    • Plots: x/y_axis_name keyword now required
    • โž• Window: For the add_window command, we changed start_x,start_y
      to x_pos, y_pos
    • โž• Window: For the add_window command, changed resizable keyword to no_resize
    • โž• Window: For the add_window command, changed title_bar keyword to no_title_bar
    • โž• Window: For the add_window command, changed movable keyword to no_move
    • ๐Ÿšš Images: Removed secondary data source from images
    • Listbox: Changed height keyword to num_items
    • Listbox: items keyword now required
    • RadioButton: items keyword now required
    • Combo: items keyword now required
    • Dummy: height and width keyword now required
    • Simple Plot: autoscale keyword removed

    ๐Ÿ†• New Commands

    • Widgets: Every widgets has a few more flags which could be: label, show, etc.
    • ๐Ÿ‘‰ Demo: Added show_demo command to dearpygui.demo
    • โž• Widgets: Added " add_color_button
    • โž• Plots: Added add_drag_point
    • โž• Plots: Added add_drag_line
    • โœ‚ Plots: Added delete_drag_line
    • โœ‚ Plots: Added delete_drag_point
    • โž• Plots: Added add_annotation
    • โœ‚ Plots: Added delete_annotation
    • Tables: Added set_table_data
    • Tables: Added get_table_data
    • โž• Widgets: Added add_value
    • Widgets: Added incref_value
    • Widgets: Added decref_value
    • Main Window: Added set_main_window_pos command #193
    • Inputs: Added get_plot_mouse_pos command #225
    • โž• Widgets: Added add_time_picker command
    • โž• Widgets: Added add_date_picker command
    • Widgets: Added get_item_type command
    • ๐Ÿ”ง Widgets: Added configure_item command
    • Widgets: Added get_item_configuration command
    • โž• Widgets: Added add_pie_series command
    • โž• Plots: Added add_shade_series command
    • โž• Plots: Added add_image_series command
    • โž• Plots: Added add_bar_series command
    • โž• Plots: Added add_error_series command
    • โž• Plots: Added add_heat_series command
    • Radio Button: Added horizontal keyword to radio button #215
    • โšก๏ธ Radio Button: Added update_bounds keyword to add_*_series commands
    • Color Items: Alot of new flags
    • Columns: Added managed_columns
    • โž• Columns: Added add_columns
    • โž• Columns: Added add_next_column
    • Selectable: Added span_columns keyword


    We really appreciate the community for working with us through all the bugs, changes, and new features. We in particular would like to thank our sponsors:

Previous changes from v0.3.7

  • ๐Ÿ”– VERSION 0.3.7 (9/14/2020)

    โšก๏ธ Updates:

    • โฌ†๏ธ ImPlot: upgraded to commit 4f0a09f

    ๐Ÿ†• New Commands:

    • โž• Widgets: Added add_image_button command
    • โž• Plots: Added add_pie_chart command
    • โž• Plots: Added add_pie_chart_data command
    • Plots: Added clear_pie_chart_data command
    • โž• Plots: Added add_stem_series command

    ๐Ÿ›  Fixes:

    • ๐Ÿ›  Threadpool: Fixed issue with threads freezing