TXT2PYNB
Converts text script to iPython notebook
Details
Installs
- Total 391
- Win 266
- Mac 84
- Linux 41
Jul 1 | Jun 30 | Jun 29 | Jun 28 | Jun 27 | Jun 26 | Jun 25 | Jun 24 | Jun 23 | Jun 22 | Jun 21 | Jun 20 | Jun 19 | Jun 18 | Jun 17 | Jun 16 | Jun 15 | Jun 14 | Jun 13 | Jun 12 | Jun 11 | Jun 10 | Jun 9 | Jun 8 | Jun 7 | Jun 6 | Jun 5 | Jun 4 | Jun 3 | Jun 2 | Jun 1 | May 31 | May 30 | May 29 | May 28 | May 27 | May 26 | May 25 | May 24 | May 23 | May 22 | May 21 | May 20 | May 19 | May 18 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Windows | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
Mac | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
Linux | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
Readme
- Source
- raw.githubusercontent.com
TXT2PYNB
TXT2PYNB is a Sublime Text package that takes a Python (or Julia) file with inline block-commented markdown blocks and turns it into an iPython (or iJulia) notebook (.ipynb
). Please view the “Tags” section below or the Examples
folder for examples of scripts. The package will output a notebook of the same name as the script in the same directory where the script is saved. (e.g. my_script.py
will output my_script.ipynb
in the same directory)
Download
This package can be dowloaded from package control in Sublime Text. Search for “TXT2PYNB” after installing package control and searching for it within the 'install packages' option.
Building Notebook
Once installed in Sublime Text, TXT2PYNB can be called as a build-system by pressing C + b
where C
is the command
key on Apple computers and ctrl
on others. For some users, the TXT2PYNB build system will be called by default with .py
or .jl
scripts, but others might need to select it from Tools->Build System->TXT2PYNB
.
Alternatively, TXT2PYNB can be searched and called using the Command Palette (cmd + shift + p
). This is particularly useful if a user regularly uses other build systems for Python or Julia scripts. The default call to the TXT2PYNB build system can be turned off by removing the TXT2PYNB.sublime-build
file in this package's folder.
Script Execution (For use outside of Sublime Text)
Example execution of code for a python script, Julia works similarly. The command-line-executable script txt2pynb.py is in the txt2pynb
folder.
python /path/to/txt2pynb.py /path/to/example_script.py
Tags
The beginning and ending tags for code and markdown follow a typical html-like format. It is recommended that the entire markdown blocks be commented out and also the code tags be commented out (as below) in order to preserve the script's capability to be ran as a Python file.
#<code>
# This is a comment inside of a code block
#</code>
'''<md>
This is markdown!
</md>'''
Space Delimiting
Having no code or markdown tags will result in the script being parsed with double space delimiting. Please view example number 2 to see this demonstrated. The markdown blocks must be in block comment format such as '''markdown''' (or “”“markdown”“” for Julia) in order to be correctly parsed. Also, markdown blocks can be squished on top of code blocks to allow for a markdown and code block in one double space-delimited block, as seen in Example_2 in the Examples
folder.
Examples
View Examples
folder for sample code and output.
Common Issues
C+b
doesn't output anything.- If a build system is already assigned by default for
.py
or.jl
files, it may be necessary to manually change the build system while the script is open by going toTools > Build System
and selectingTXT2PYNB
. Likewise, if a different build system is desired for an open.py
or.jl
file, switch it back using the same procedure.
- If a build system is already assigned by default for
To Do
- Add ability to 'pull back' code from edited notebook
- iPython 3+ compatability (output version 4 .ipynb)