upstream/ipython Files · docs/examples/core/example-embed-short.py

Move crash handling to the application level and simplify class structure....

Move crash handling to the application level and simplify class structure. Starting to try to take real advantage of the refactoring, to have generic crash handling. This also lets us initialize the app without needing all the self.attempt() wrappers, since now there's a good system-wide crash handler at the app level (not inside the shell instance). I didn't yet remove the attempt() method because we may have occasional uses for it (we still do, but in one place only). I also removed some extra class layers that weren't quite needed. Creating classes solely for the purpose of passing parameters makes the code (IMO) harder to understand, I kept getting lost in parts of the class hierarchy. I think these changes provide the same flexibility but with easier to follow code (less things to remember, basically). What I tried to do was to use argument passing instead of inheritance for all cases I saw where the inheritance wasn't really adding new functionality. In some cases, this actually allowed me to remove methods that were effectively duplicated in the subclasses.

Brian E Granger - - Load All Authors

File last commit:

r1251:99658885


                r2403:08d6ac78

Download file

             example-embed-short.py
        
                    51 lines
            
             | 1.9 KiB
            
                | text/x-python
            
             |
                PythonLexer
            
             / docs / examples / core / example-embed-short.py
          
                    History
                
                 |
                  Annotation
                 | Raw
                 |Copy content
                 |Copy permalink

      """Quick code snippets for embedding IPython into other programs.

      See example-embed.py for full details, this file has the bare minimum code for

      cut and paste use once you understand how to use the system."""

      #---------------------------------------------------------------------------

      # This code loads IPython but modifies a few things if it detects it's running

      # embedded in another IPython session (helps avoid confusion)

      try:

          __IPYTHON__

      except NameError:

          argv = ['']

          banner = exit_msg = ''

      else:

          # Command-line options for IPython (a list like sys.argv)

          argv = ['-pi1','In <\\#>:','-pi2','   .\\D.:','-po','Out<\\#>:']

          banner = '*** Nested interpreter ***'

          exit_msg = '*** Back in main IPython ***'

      # First import the embeddable shell class

      from IPython.Shell import IPShellEmbed

      # Now create the IPython shell instance. Put ipshell() anywhere in your code

      # where you want it to open.

      ipshell = IPShellEmbed(argv,banner=banner,exit_msg=exit_msg)

      #---------------------------------------------------------------------------

      # This code will load an embeddable IPython shell always with no changes for

      # nested embededings.

      from IPython.Shell import IPShellEmbed

      ipshell = IPShellEmbed()

      # Now ipshell() will open IPython anywhere in the code.

      #---------------------------------------------------------------------------

      # This code loads an embeddable shell only if NOT running inside

      # IPython. Inside IPython, the embeddable shell variable ipshell is just a

      # dummy function.

      try:

          __IPYTHON__

      except NameError:

          from IPython.Shell import IPShellEmbed

          ipshell = IPShellEmbed()

          # Now ipshell() will open IPython anywhere in the code

      else:

          # Define a dummy ipshell() so the same code doesn't crash inside an

          # interactive IPython

          def ipshell(): pass

      #******************* End of file <example-embed-short.py> ********************

	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

				"""Quick code snippets for embedding IPython into other programs.

				See example-embed.py for full details, this file has the bare minimum code for
				cut and paste use once you understand how to use the system."""

				#---------------------------------------------------------------------------
				# This code loads IPython but modifies a few things if it detects it's running
				# embedded in another IPython session (helps avoid confusion)

				try:
				__IPYTHON__
				except NameError:
				argv = ['']
				banner = exit_msg = ''
				else:
				# Command-line options for IPython (a list like sys.argv)
				argv = ['-pi1','In <\\#>:','-pi2',' .\\D.:','-po','Out<\\#>:']
				banner = '* Nested interpreter *'
				exit_msg = '* Back in main IPython *'

				# First import the embeddable shell class
				from IPython.Shell import IPShellEmbed
				# Now create the IPython shell instance. Put ipshell() anywhere in your code
				# where you want it to open.
				ipshell = IPShellEmbed(argv,banner=banner,exit_msg=exit_msg)

				#---------------------------------------------------------------------------
				# This code will load an embeddable IPython shell always with no changes for
				# nested embededings.

				from IPython.Shell import IPShellEmbed
				ipshell = IPShellEmbed()
				# Now ipshell() will open IPython anywhere in the code.

				#---------------------------------------------------------------------------
				# This code loads an embeddable shell only if NOT running inside
				# IPython. Inside IPython, the embeddable shell variable ipshell is just a
				# dummy function.

				try:
				__IPYTHON__
				except NameError:
				from IPython.Shell import IPShellEmbed
				ipshell = IPShellEmbed()
				# Now ipshell() will open IPython anywhere in the code
				else:
				# Define a dummy ipshell() so the same code doesn't crash inside an
				# interactive IPython
				def ipshell(): pass

				#***************** End of file <example-embed-short.py> ******************