Print information about the magic function system. Supported formats: -latex, -brief, -rest
(self, parameter_s='')
| 202 | |
| 203 | @line_magic |
| 204 | def magic(self, parameter_s=''): |
| 205 | """Print information about the magic function system. |
| 206 | |
| 207 | Supported formats: -latex, -brief, -rest |
| 208 | """ |
| 209 | |
| 210 | mode = '' |
| 211 | try: |
| 212 | mode = parameter_s.split()[0][1:] |
| 213 | except IndexError: |
| 214 | pass |
| 215 | |
| 216 | brief = (mode == 'brief') |
| 217 | rest = (mode == 'rest') |
| 218 | magic_docs = self._magic_docs(brief, rest) |
| 219 | |
| 220 | if mode == 'latex': |
| 221 | print(self.format_latex(magic_docs)) |
| 222 | return |
| 223 | else: |
| 224 | magic_docs = format_screen(magic_docs) |
| 225 | |
| 226 | out = [""" |
| 227 | IPython's 'magic' functions |
| 228 | =========================== |
| 229 | |
| 230 | The magic function system provides a series of functions which allow you to |
| 231 | control the behavior of IPython itself, plus a lot of system-type |
| 232 | features. There are two kinds of magics, line-oriented and cell-oriented. |
| 233 | |
| 234 | Line magics are prefixed with the % character and work much like OS |
| 235 | command-line calls: they get as an argument the rest of the line, where |
| 236 | arguments are passed without parentheses or quotes. For example, this will |
| 237 | time the given statement:: |
| 238 | |
| 239 | %timeit range(1000) |
| 240 | |
| 241 | Cell magics are prefixed with a double %%, and they are functions that get as |
| 242 | an argument not only the rest of the line, but also the lines below it in a |
| 243 | separate argument. These magics are called with two arguments: the rest of the |
| 244 | call line and the body of the cell, consisting of the lines below the first. |
| 245 | For example:: |
| 246 | |
| 247 | %%timeit x = numpy.random.randn((100, 100)) |
| 248 | numpy.linalg.svd(x) |
| 249 | |
| 250 | will time the execution of the numpy svd routine, running the assignment of x |
| 251 | as part of the setup phase, which is not timed. |
| 252 | |
| 253 | In a line-oriented client (the terminal or Qt console IPython), starting a new |
| 254 | input with %% will automatically enter cell mode, and IPython will continue |
| 255 | reading input until a blank line is given. In the notebook, simply type the |
| 256 | whole cell as one entity, but keep in mind that the %% escape can only be at |
| 257 | the very start of the cell. |
| 258 | |
| 259 | NOTE: If you have 'automagic' enabled (via the command line option or with the |
| 260 | %automagic function), you don't need to type in the % explicitly for line |
| 261 | magics; cell magics always require an explicit '%%' escape. By default, |