Metadata-Version: 2.1
Name: jupyter-spaces
Version: 0.0.3
Summary: Create parallel namespaces in Jupyter Notebooks
Home-page: https://github.com/davidesarra/jupyter_spaces
Author: Davide Sarra
License: MIT
Description: # Jupyter Spaces
        
        [![Build Status](https://travis-ci.org/davidesarra/jupyter_spaces.svg?branch=master)](https://travis-ci.org/davidesarra/jupyter_spaces)
        [![codecov](https://codecov.io/gh/davidesarra/jupyter_spaces/branch/master/graph/badge.svg)](https://codecov.io/gh/davidesarra/jupyter_spaces)
        [![Supported Python Versions](https://img.shields.io/pypi/pyversions/jupyter_spaces.svg)](https://pypi.org/project/jupyter_spaces/)
        
        Jupyter Spaces is an IPython extension for creating parallel namespaces
        available within the user namespace. It is designed to be used via IPython
        magics in Jupyter notebooks.
        
        ## Installation
        
        ```bash
        pip install jupyter_spaces
        ```
        
        `jupyter_spaces` supports Python versions `3.4`, `3.5` and `3.6`.
        
        ## Usage
        
        ### Load `jupyter_spaces` extension
        
        ```python
        %load_ext jupyter_spaces
        ```
        
        ### Reload `jupyter_spaces` extension
        
        ```python
        %reload_ext jupyter_spaces
        ```
        
        Reloading the extension will remove all spaces.
        
        ### Run a cell within a space
        
        ```python
        %%space <space-name>
        alpha = 0.50
        print(alpha)
        ```
        
        When you execute a cell within a space, all references are firstly searched in
        the space namespace and secondly in the user namespace. All assignments are
        made in the space namespace. However, as expected, `global` assigments are made
        in the user namespace.
        
        #### Console output
        
        Conversely to the standard usage of the python console, you need to use print
        to get a output in the console or Jupyter cell output.
        
        - No output to console
            ```python
            %%space <space-name>
            100
            ```
        - Output to console
            ```python
            %%space <space-name>
            print(100)
            ```
        
        ### Remove a space
        
        ```python
        %remove_space <space-name>
        ```
        
        ### Access all spaces at once
        
        Without using any magic you can access the spaces' namespaces.
        This might be useful to jointly post-process or compare the spaces' contents.
        
        ```python
        from jupyter_spaces import get_spaces
        
        spaces = get_spaces()
        space = spaces[<space-name>]
        reference = space.namespace[<reference-name>]
        ```
        
        `Space` objects have two properties:
        
        - `name` the name of the space
        - `namespace` a dictionary with the namespace of the space
        
        Modifying the spaces via `get_spaces` will actually modify the underlying
        spaces.
        
        ## Acknowledgements
        
        Many thanks to [Yeray Diaz Diaz](https://github.com/yeraydiazdiaz) and
        [Karol Duleba](https://github.com/mrfuxi)!
        
Keywords: jupyter ipython magic extension namespace
Platform: UNKNOWN
Classifier: Environment :: Console
Classifier: Framework :: IPython
Classifier: Framework :: Jupyter
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Requires-Python: ~=3.4
Description-Content-Type: text/markdown
