Metadata-Version: 2.1
Name: dpaste_magic
Version: 0.2.1
Summary: Magic command to dpaste / get line & cell content
Home-page: http://github.com/HerveMignot/dpaste_magic
Author: HerveMignot
Author-email: HerveMignot@github.com
License: MIT
Description: # dpaste_magic
        Magic function that pushes or pulls code snippets out of pastebins.
        dpaste.org is currently supported.
        
        ### Pushing code & cells
        <pre>
          %dpaste answer = 42
          <i>https://dpaste.org/WXYZ</i>
        </pre>
        pushes line content & print the dpaste url.
        <pre>
          %%dpaste
          answer = 42
          <i>https://dpaste.org/WXYZ</i>
        </pre>
        pushes cell content & print the dpaste url.
        <pre>
          %%dpaste {-1x -1h -1d -1w}
          answer = 42
          <i>https://dpaste.org/WXYZ</i>
        </pre>
        returns a dpaste url with expires duration:
        * -1x: just for one read
        * -1h: one hour (default)
        * -1d: one day
        * -1w: one week
        
        These are the supported expiration time supported by dpaste.org.
        
        Options:
        * -o: return URL as value (for storage in a variable)
        * -s: silent mode (URL not printed)
        
        `my_url = %dpaste -o answer = 42`
        push code on line, prints & stores url in `my_url` variable.
        
        `my_url = %dpaste -o -s answer = 42`
        push code on line & stores url in `my_url` variable (silent mode, no print).
        
        ### Getting back the paste
        <pre>
          %getdpaste WXYZ
        </pre>
        retrieves snippet from WXYZ dpaste hash or URL and changes cell to:
        <pre>
          answer = 42
        </pre>
        
        <pre>
          %getdpaste -u WXYZ
        </pre>
        add retrieved URL as a Python comment in first line:
        <pre>
          #https://dpaste.org/WXYZ/raw
        
          answer = 42
        </pre>
        
        With `%dpaste -g` get option:
        <pre>
          %dpaste -g WXYZ
        </pre>
        retrieves snippet from WXYZ dpaste hash or URL and changes cell to:
        <pre>
          answer = 42
        </pre>
        
        
        ## Installation
        
        Use:
        `pip install dpaste-magic`
        to install the magic command.
        
        First load the magic in a cell:
        
        `%load_ext dpaste_magic`
        
        and then use the function in your cell to dpaste its content.
        
        `%%dpaste`, `%dpaste` or `%getdpaste`.
        
        
        ## TO DO
        
        * increase tests range
        * code unload function
        * catch HTTPError exception 404 to display friendly message
        
Keywords: pastebin dpaste magic command IPython Jupyter Jupyterlab
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Framework :: IPython
Classifier: Framework :: Jupyter
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Education
Classifier: Topic :: Scientific/Engineering
Description-Content-Type: text/markdown
