8000 MEP22: Navigation by events by fariza · Pull Request #3652 · matplotlib/matplotlib · GitHub
[go: up one dir, main page]

Skip to content

MEP22: Navigation by events #3652

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 69 commits into from
Apr 9, 2015
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
69 commits
Select commit Hold shift + click to select a range
8cceed4
navigation and toolbar coexistence
fariza Jan 23, 2014
3118a5a
mod keypress in figuremanager
fariza Jan 23, 2014
b4d5fcf
helper methods in toolbar and navigation
fariza Jan 24, 2014
1e8af47
Adding doc to base methods
fariza Jan 24, 2014
622cb95
property for active_toggle
fariza Jan 26, 2014
d1a9de4
simulate click
fariza Jan 27, 2014
3f89d52
activate renamed to trigger
fariza Jan 28, 2014
4f3c10b
toggle tools using enable/disable from its trigger method
fariza Jan 29, 2014
6065daa
simplifying _handle_toggle
fariza Jan 29, 2014
f6a2f19
reducing number of locks
fariza Jan 29, 2014
05db3b6
changing toggle and persistent attributes for issubclass
fariza Feb 4, 2014
c08fe56
bug in combined key press
fariza Feb 4, 2014
b207a72
untoggle zoom and pan from keypress while toggled
fariza Feb 4, 2014
8000
9266447
classmethods for default tools modification
fariza Feb 6, 2014
a53419a
adding zaxis and some pep8
fariza May 1, 2014
704c717
removing legacy method dynamic update
fariza May 6, 2014
5056729
tk backend
fariza May 6, 2014
e6a4e1e
example working with Tk
fariza May 6, 2014
8942c47
duplicate code in keymap tool initialization
fariza Jul 24, 2014
022de6f
grammar corrections
fariza Jul 24, 2014
2c9a195
moving views and positions to tools
fariza Jul 24, 2014
cafe668
The views positions mixin automatically adds the clear as axobserver
fariza Jul 25, 2014
224f745
bug when navigation was not defined
fariza Jul 25, 2014
94c711e
Small refactor so that we first initiate the Navigation (ToolManager)…
OceanWolf Jul 28, 2014
67257e7
Moved default_tool initilisation to FigureManagerBase and cleaned.
OceanWolf Jul 29, 2014
ffa65d6
Temporary fix to backends
OceanWolf Jul 29, 2014
6739ee0
removing persistent tools
fariza Sep 3, 2014
d18206f
removing unregister
fariza Sep 4, 2014
34a52c8
change cursor inmediately after toggle
fariza Sep 5, 2014
c2da483
removing intoolbar
fariza Oct 15, 2014
44a9b0e
events working
fariza Oct 16, 2014
a2ed47f
using pydispatch
fariza Oct 17, 2014
0665890
using navigation as signal handler
fariza Oct 20, 2014
411e6e2
removing view positions singleton
fariza Oct 20, 2014
d484ebd
moving set_cursor completely out of navigation
fariza Oct 27, 2014
75bf97b
removing unused event class
fariza Nov 10, 2014
6cc040b
underscore in tool_trigger-xxx
fariza Nov 10, 2014
0ff5997
adding radio_group for toggle tools
fariza Nov 14, 2014
af6734f
scroll to zoom in zoom/pan tools
fariza Nov 28, 2014
78513d2
remove ToolAddedEvent incorporating the functionality into toolevent
fariza Dec 5, 2014
377ff54
eliminating repeated loop
fariza Jan 5, 2015
7dbbf58
replace draw by draw_idle in tools
fariza Jan 21, 2015
dd66b57
rename mpl_connect
fariza Jan 21, 2015
67a414f
cleaning navigation and toolbar dependencies
fariza Feb 4, 2015
e415d8d
Made NavigationBase.get_tool() more useful.
OceanWolf Feb 11, 2015
1213086
Refactored Toolbar out of NavigationBase
OceanWolf Feb 12, 2015
ba61dec
Some short cuts for adding tools
OceanWolf Feb 16, 2015
9f2ee2b
Lots of fixes
OceanWolf Feb 18, 2015
9da2b13
Rename ToolbarBase -> ToolContainerBase
OceanWolf Feb 18, 2015
110253f
Statusbar
OceanWolf Feb 20, 2015
e2804ea
tool group position
fariza Feb 26, 2015
9a64b7e
docstrings and small corrections by WeatherGod
fariza Mar 23, 2015
64f947f
tkbackend updated
fariza Mar 31, 2015
e8cd5d5
tacaswell comments aprl 1
fariza Apr 1, 2015
4bbcf4e
renaming tool_trigger_event
fariza Apr 1, 2015
73a2661
add_tools moved out of base classes
8000 fariza Apr 1, 2015
1b83628
figure.setter in tools
fariza Apr 1, 2015
e4edd23
rename tools to default_tools to avoid confusion
fariza Apr 1, 2015
d4ac2fb
docstring helper add_tools methods
fariza Apr 1, 2015
a7640ef
rename navigation to toolmanager
fariza Apr 2, 2015
48a6971
tkagg updated for toolmanager and tool groups
fariza Apr 2, 2015
8dafe09
doc and minor code organization
fariza Apr 2, 2015
a0695d0
whats new
fariza Apr 3, 2015
328b169
missing object from class declaration
fariza Apr 3, 2015
aac4744
remove comments and docstrings
fariza Apr 3, 2015
f09b9ef
import with original name backend_tools
fariza Apr 3, 2015
def3a52
rename 2 -> to, example without gtk only code
fariza Apr 7, 2015
9ee7e25
zoom pan buttons order
fariza Apr 7, 2015
5eae4e1
matplotlib.rcParams['toolbar'] == 'None' starts toolmanager but not t…
fariza Apr 7, 2015
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
removing unregister
  • Loading branch information
fariza committed Apr 7, 2015
commit d18206ff1f82769edf790de2fa83898650c043b5
8 changes: 4 additions & 4 deletions examples/user_interfaces/navigation.py
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
import matplotlib
# matplotlib.use('GTK3Cairo')
matplotlib.use('TkAGG')
matplotlib.use('GTK3Cairo')
# matplotlib.use('TkAGG')
matplotlib.rcParams['toolbar'] = 'navigation'
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since these are examples, I would suggest getting rid of extraneous commented out code, and also highlight important lines of code such as this one. For example, is it important that it gets called before importing pyplot? What is it for? Perhaps a short docstring at the top of this example would help explain its purpose/goal that it is demonstrating?

import matplotlib.pyplot as plt
from matplotlib.backend_tools import ToolBase
Expand Down Expand Up @@ -53,7 +53,7 @@ def trigger(self, event):
if matplotlib.rcParams['backend'] == 'GTK3Cairo':
fig.canvas.manager.navigation.add_tool('copy', CopyToolGTK3)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd be fine with making this a GTK3Cairo-only example. Makes it a little bit simpler


# Just for fun, lets remove the back button
# fig.canvas.manager.navigation.remove_tool('Back')
# Just for fun, lets remove the forward button
fig.canvas.manager.navigation.remove_tool('Forward')

plt.show()
40 changes: 16 additions & 24 deletions lib/matplotlib/backend_bases.py
67ED
Original file line number Diff line number Diff line change
Expand Up @@ -3288,6 +3288,11 @@ def get_tool_keymap(self, name):
keys = [k for k, i in six.iteritems(self._keys) if i == name]
return keys

def _remove_keys(self, name):
keys = [k for k, v in six.iteritems(self._keys) if v == name]
for k in keys:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What do you think about replacing this with:

for k in self.get_tool_keymap(name):

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yes.

del self._keys[k]

def set_tool_keymap(self, name, *keys):
"""Set the keymap associated with a tool

Expand All @@ -3301,9 +3306,7 @@ def set_tool_keymap(self, name, *keys):
if name not in self._tools:
raise AttributeError('%s not in Tools' % name)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This isn't really an AttributeError, is it? Would seem more like a KeyError.


active_keys = [k for k, i in six.iteritems(self._keys) if i == name]
for k in active_keys:
del self._keys[k]
self._remove_keys(name)

for key in keys:
for k in validate_stringlist(key):
Expand All @@ -3312,21 +3315,6 @@ def set_tool_keymap(self, name, *keys):
(k, self._keys[k], name))
self._keys[k] = name

def unregister(self, name):
"""Unregister the tool from Navigation

Parameters
----------
name : string
Name of the tool to unregister
"""

if self._toggled == name:
self._handle_toggle(name, from_toolbar=False)
if name in self._tools:
self._tools[name].destroy()
del self._tools[name]

def remove_tool(self, name):
"""Remove tool from the `Navigation`

Expand All @@ -3336,15 +3324,19 @@ def remove_tool(self, name):
Name of the Tool
"""

self.unregister(name)
tool = self._tools[name]
tool.destroy()

keys = [k for k, v in six.iteritems(self._keys) if v == name]
for k in keys:
del self._keys[k]
if self._toggled == name:
self._handle_toggle(name, from_toolbar=False)

if self.toolbar:
self._remove_keys(name)

if self.toolbar and tool.intoolbar:
self.toolbar._remove_toolitem(name)

del self._tools[name]

def add_tools(self, tools):
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How strongly do you feel about keeping both the singular and plural versions of this? The similarity (leading to many typos) and the difference in signature/what they can do is going to be confusing. If this function stays I think it needs to be able to pass args/kwargs through to the constructors.

Is there any terrifying input parsing we could use to mush this into one function? I am not seeing a way quickly...

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tacaswell, me and @fariza had a discussion on args/kwargs etcetrra over in fariza#11 where I introduced them.

I would have thought the difference in signature would solve the typos problem, I mean if you make a typo, you will get a python error telling you you passed the wrong number of arguments to the function.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We can think of renaming the methods (suggestions any one?), but playing magic with arguments is 👎

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

great, sold on 👎 for args magic (we have it else where where I do not like it, but supposedly users like that sort of thing)

What is the use case for bulk adding tools? Writing this loop in user code does not strike me as super onerous.

My worry with the typo is getting an exception about args being wrong (which leads you to check what you are passing in) rather than an AttributeError (which leads you to check your spelling).

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It is more for backend implementation. It was done automatically at __init__ but @OceanWolf talked me out of that

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ooh, brain wave, how about:

for tool in six.iteritems(tools):
    self.add_tool(*tool)

Or get rid of it altogether, I think it has changed a lot (becoming a lot simpler), especially since we split the adding of tools to the toolbar out and into ToolContainer.addTool as @fariza mentions.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@OceanWolf where do you suggest to add that loop?
Don't you like the helper functions in backend_tools?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍 On putting this helper function as a module-level function. Breaks the OO abstraction a bit, but it keeps the base objects simpler.

@OceanWolf That would unpack as self.add_tool(tool_name, value_in_tools_dict) which does not get you the next level of unpacking you need to pass to add_tool.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, I like that too, brain just sluggish and getting distracted by quite a few conversations. I don't mind, just so long as no core-logic changes.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

""" Add multiple tools to `Navigation`

Expand Down Expand Up @@ -3491,7 +3483,7 @@ def get_tools(self):
for name in sorted(self._tools.keys()):
tool = self._tools[name]
keys = [k for k, i in six.iteritems(self._keys) if i == name]
d[name] = {'cls': tool,
d[name] = {'obj': tool,
'description': tool.description,
'keymap': keys}
return d
Expand Down
13 changes: 0 additions & 13 deletions lib/matplotlib/backend_tools.py
Original file line number Diff line number Diff line change
Expand Up @@ -92,19 +92,6 @@ def set_figure(self, figure):
self.figure = figure
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should this be self._figure, just in case we change our minds about setters later and turn it into a property?

self.navigation = figure.canvas.manager.navigation

def unregister(self, *args):
"""Unregister the tool from the instances of Navigation

It is usually called by during destroy if it is a
graphical Tool.

If the reference in navigation was the last reference
to the instance of the tool, it will be garbage collected
"""

# call this to unregister from navigation
self.navigation.unregister(self._name)

@property
def name(self):
return self._name
Expand Down
0