Metadata-Version: 2.1
Name: dpaste-magic
Version: 0.1.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
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
Requires-Dist: requests

dpaste\_magic
=============

Magic function that pushes or pulls code snippets out of pastebins.
dpaste.de is currently supported.

Pushing code & cells
--------------------

::

    %dpaste answer = 42
    ---
    https://dpaste.de/XYZ

pushes line content & print the dpaste url.

::

    %%dpaste
    answer = 42
    ---
    https://dpaste.de/XYZ

pushes cell content & print the dpaste url.

::

    %%dpaste {-1x -1h -1d -1w -0}
    answer = 42
    ---
    https://dpaste.de/XYZ

returns a dpaste url with expires duration:

- -1x: just for one read
- -1h: one hour (default)
- -1d: one day
- -1w: one week
- -0: never

These are the supported expiration time supported by dpaste.de.

Options:

- -o: return URL as value (for storage in a variable)
- -s: silent mode (URL not printed)

``my_url = %dpaste -o answer = 42`` pushes code online, prints & stores
url in ``my_url`` variable.

``my_url = %dpaste -o -s answer = 42`` pushes code online & stores url in
``my_url`` variable (silent mode, no print).

Getting back the paste
----------------------

::

    %getdpaste XYZ

retrieves snippet from XYZ dpaste hash or URL and changes cell to:
::
    # %load https://dpaste.de/XYZ/raw
    answer = 42

With `%dpaste -g` get option:
::
    %dpaste -g XYZ

retrieves snippet from XYZ dpaste hash or URL and changes cell to:
::
    # %load https://dpaste.de/XYZ/raw
    answer = 42

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


