upstream/ipython Files · IPython/utils/strdispatch.py

Multiple improvements to tab completion....

Multiple improvements to tab completion. I refactored the API quite a bit, to retain readline compatibility but make it more independent of readline. There's still more to do in cleaning up our init_readline() method, but now the completer objects have separate rlcomplete() and complete() methods. The former uses the quirky readline API with a state flag, while the latter is stateless, takes only text information, and is more suitable for GUIs and other frontends to call programatically. Made other minor fixes to ensure the test suite passes in full. While all this code is a bit messy, we're getting in the direction of the APIs we need in the long run.

Brian Granger - - Load All Authors

File last commit:

r2048:d5d637e4


                r2839:8cff4913

Download file

             strdispatch.py
        
                    68 lines
            
             | 1.8 KiB
            
                | text/x-python
            
             |
                PythonLexer
            
             / IPython / utils / strdispatch.py
          
                    History
                
                 |
                  Annotation
                 | Raw
                 |Copy content
                 |Copy permalink

      """String dispatch class to match regexps and dispatch commands.

      """

      # Stdlib imports

      import re

      # Our own modules

      from IPython.core.hooks import CommandChainDispatcher

      # Code begins

      class StrDispatch(object):

          """Dispatch (lookup) a set of strings / regexps for match.

          Example:

          >>> dis = StrDispatch()

          >>> dis.add_s('hei',34, priority = 4)

          >>> dis.add_s('hei',123, priority = 2)

          >>> dis.add_re('h.i', 686)

          >>> print list(dis.flat_matches('hei'))

          [123, 34, 686]

          """

          def __init__(self):

              self.strs = {}

              self.regexs = {}

          def add_s(self, s, obj, priority= 0 ):

              """ Adds a target 'string' for dispatching """

              chain = self.strs.get(s, CommandChainDispatcher())

              chain.add(obj,priority)

              self.strs[s] = chain

          def add_re(self, regex, obj, priority= 0 ):

              """ Adds a target regexp for dispatching """

              chain = self.regexs.get(regex, CommandChainDispatcher())

              chain.add(obj,priority)

              self.regexs[regex] = chain

          def dispatch(self, key):

              """ Get a seq of Commandchain objects that match key """

              if key in self.strs:

                  yield self.strs[key]

              for r, obj in self.regexs.items():

                  if re.match(r, key):

                      yield obj

                  else: 

                      #print "nomatch",key  # dbg

                      pass

          def __repr__(self):

              return "<Strdispatch %s, %s>" % (self.strs, self.regexs)

          def s_matches(self, key):

              if key not in self.strs:

                   return

              for el in self.strs[key]:

                  yield el[1]

          def flat_matches(self, key):

              """ Yield all 'value' targets, without priority """

              for val in self.dispatch(key):

                  for el in val:

                      yield el[1] # only value, no priority

              return

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages

				"""String dispatch class to match regexps and dispatch commands.
				"""

				# Stdlib imports
				import re

				# Our own modules
				from IPython.core.hooks import CommandChainDispatcher

				# Code begins
				class StrDispatch(object):
				"""Dispatch (lookup) a set of strings / regexps for match.

				Example:

				>>> dis = StrDispatch()
				>>> dis.add_s('hei',34, priority = 4)
				>>> dis.add_s('hei',123, priority = 2)
				>>> dis.add_re('h.i', 686)
				>>> print list(dis.flat_matches('hei'))
				[123, 34, 686]
				"""

				def __init__(self):
				self.strs = {}
				self.regexs = {}

				def add_s(self, s, obj, priority= 0 ):
				""" Adds a target 'string' for dispatching """

				chain = self.strs.get(s, CommandChainDispatcher())
				chain.add(obj,priority)
				self.strs[s] = chain

				def add_re(self, regex, obj, priority= 0 ):
				""" Adds a target regexp for dispatching """

				chain = self.regexs.get(regex, CommandChainDispatcher())
				chain.add(obj,priority)
				self.regexs[regex] = chain

				def dispatch(self, key):
				""" Get a seq of Commandchain objects that match key """
				if key in self.strs:
				yield self.strs[key]

				for r, obj in self.regexs.items():
				if re.match(r, key):
				yield obj
				else:
				#print "nomatch",key # dbg
				pass

				def __repr__(self):
				return "<Strdispatch %s, %s>" % (self.strs, self.regexs)

				def s_matches(self, key):
				if key not in self.strs:
				return
				for el in self.strs[key]:
				yield el[1]

				def flat_matches(self, key):
				""" Yield all 'value' targets, without priority """
				for val in self.dispatch(key):
				for el in val:
				yield el[1] # only value, no priority
				return