Skip to content
This repository was archived by the owner on Nov 17, 2021. It is now read-only.

Jaykul/Jupyter-PowerShell

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Nov 17, 2021
169a1ef · Nov 17, 2021

History

56 Commits
Mar 4, 2018
Apr 25, 2018
Apr 24, 2018
Mar 7, 2018
Jun 17, 2017
Mar 7, 2018
Apr 20, 2018
Apr 24, 2018
Jun 24, 2017
Apr 24, 2018
Apr 5, 2018
Mar 7, 2018
Nov 17, 2021
Jul 17, 2017
Apr 25, 2018
Apr 25, 2018
Mar 4, 2018

Repository files navigation

This project is archived. Try Microsoft's reimplementation in dotnet/interactive.

A Jupyter Kernel for PowerShell

Create PowerShell notebooks in a web browser, with commands and captured output. Add markdown blocks for documentation!

You can use Jupyter with PowerShell to produce documentation of your troubleshooting, researching, and even your regular processes. You can also use HTML and Javascript with your PowerShell data to create visual reports, do numerical analysis, etc.

Get it for yourself

The easiest way to try the kernel is using Binder. You can just click here: Binder

The next easiest way is using docker (if you have docker installed). You can start a copy like this:

docker run -it --rm -p 8888:8888 jaykul/powershell-notebook-base

You can also install the kernel locally (assuming you have Jupyter or a clone installed) using chocolatey:

choco install jupyter-powershell

Current Status

The PowerShell kernel is based on PowerShell Core, in order to be cross-platform and standalone.

At this point, I'm only handling two messages:

  • KernelInfo request
  • Execute request

Features

Since Jupyter is all about interaction and documentation, if you want details about the features, you can read the Features notebook here on github, or by running the binder link above.

PowerShell Core

In order to get cross-platform support, this kernel is based on PowerShell Core.

To build it yourself --or to run the "PowerShell (Core)" kernel-- you need dotnet core 2. You can build it by running dotnet restore; dotnet build from the root. If you want to build it in Visual Studio, you need VS 2017 version 15.3 or higher.

A Note on the Jupyter library

This kernel is being written in C#, and in the process, I've taken some messaging code from the iCSharp kernel and made a generic library for .Net with a re-usable core for anyone who needs to create Jupyter kernels in .Net languages -- so feel free to borrow that if you like (it's under the Apache license).