I am reading Pelican source code. Sometimes I do not have a computer nearby, and I want to print out the source code on paper. The current release of Pelican is version 4.2.0. The source code is available on github.
After you git clone the code to local drive, you can run the following Linux
command to have a basic idea of the code base. The number of lines of Pelican 4.2 code is
5,762. The file
generators.py is the longest with 937 lines. The main code base has
15 python files.
$ git clone https://github.com/getpelican/pelican.git
$ git checkout 4.2.0 ## code is on master branch by default
$ cd pelican
$ find . -maxdepth 1 -name '*.py' -exec wc -l '{}' + | sort -n
10 ./__main__.py
52 ./signals.py
95 ./rstdirectives.py
133 ./urlwrappers.py
141 ./cache.py
143 ./server.py
163 ./paginator.py
269 ./log.py
278 ./writers.py
578 ./__init__.py
615 ./contents.py
668 ./settings.py
759 ./readers.py
921 ./utils.py
937 ./generators.py
5762 total
A Google search finds this article Print Out Your Code On Paper on medium.com. The
author made some good points in the article. It also introduces
a piece of Unix/Linux command line software called enscript, which can covert
text code to postscript file. A typical command looks like this,
enscript -1rG --line-numbers -p out.ps --highlight=python \
-c inputfile.py
A furthur Google search finds an online man page for enscript. The page has
detailed infomation regarding the software options and configuration files.
The default fancy header configuration file enscript.hdr is stored in the directory
/usr/share/enscript/. I want to change the date and time on the left corner to
current date/time. Also I want to change the page number on the right corner to "number
of pages processed so far" rather than the default "current page numbers". An easy way
is to copy the enscript.hdr to a new enscript_mod.hdr file and copy back
the modified file to the directory. I only change three lines of code in
enscript_mod.hdr file.
%Format: moddatestr %W
%Format: modtimestr %C
%Format: pagenumstr $p
After that, I write a short python script to call the enscript command. The
python code is shown below.
#! python3
#
# sudo cp enscript_mod.hdr /usr/share/enscript/
# the mod hdr file change the file mod date/time to current date/time
#
# note that the hdr file should be in configuration dir
# see ubuntu manpage
# http://manpages.ubuntu.com/manpages/precise/en/man1/enscript.1.html
#
# convert ps to pdf
# ps2pdfwr pelican.ps pelican_print.pdf
import os
import subprocess
# result of $ls -S -l *.py
files ='''
-rw-r--r-- 1 george george 38186 Apr 23 17:00 generators.py
-rw-r--r-- 1 george george 30603 Apr 23 17:00 utils.py
-rw-r--r-- 1 george george 27685 Apr 23 17:00 readers.py
-rw-r--r-- 1 george george 25993 Apr 23 17:00 settings.py
-rw-r--r-- 1 george george 23017 Apr 23 17:00 contents.py
-rw-r--r-- 1 george george 22475 Apr 23 17:00 __init__.py
-rw-r--r-- 1 george george 11345 Apr 23 17:00 writers.py
-rw-r--r-- 1 george george 8038 Apr 23 17:00 log.py
-rw-r--r-- 1 george george 5466 Apr 23 17:00 paginator.py
-rw-r--r-- 1 george george 5283 Apr 23 17:00 server.py
-rw-r--r-- 1 george george 5247 Apr 23 17:00 cache.py
-rw-r--r-- 1 george george 3980 Apr 23 17:00 urlwrappers.py
-rw-r--r-- 1 george george 3026 Apr 23 17:00 rstdirectives.py
-rw-r--r-- 1 george george 1770 Apr 23 17:00 signals.py
-rw-r--r-- 1 george george 165 Apr 23 17:00 __main__.py
'''
def fnlist(files):
filenames = []
fns = files.split('\n')
for fn in fns:
if fn:
filename = fn[46:]
if filename.startswith('__'):
filenames.insert(0, filename)
else:
filenames.append(filename)
# print(filenames)
return filenames
def main():
cwd = os.getcwd()
os.chdir('./pelican/pelican')
filenames = ' '.join(fnlist(files))
p1 = subprocess.run(
'enscript --fancy-header=enscript_mod --line-numbers ' + \
'-p ../../pelican_code_print.ps ' + \
'--highlight=python ' + \
f'--color=1 -c {filenames}',
shell = True,
capture_output = True
)
print(p1.stdout.decode())
os.chdir(cwd)
if __name__ == '__main__':
main()
After those steps. the final pdf file (277KB) of Pelican 4.2 source code can be downloaded here. If you print it out, it will be 103 pages on letter size paper.