1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
|
import os
from argparse import ArgumentParser, Namespace
from typing import Union
from jinja2 import Environment, FileSystemLoader
from markdown import Markdown
from importlib.metadata import version
from importlib.resources import contents
from datetime import datetime, timezone
from .configuration import Configuration
from .database import Database
from .builder import HTMLBuilder
from .page import Page
from .rss import RSSBuilder
from .sitemap import SitemapBuilder
VERSION = version('pyssg')
def get_options() -> Namespace:
parser = ArgumentParser(prog='pyssg',
description='''Static Site Generator that reads
Markdown files and creates HTML files.\nIf
[-c]onfig file is provided (or exists in default
location) all other options are ignored.\nFor
datetime formats see:
https://docs.python.org/3/library/datetime.html#strftime-and-strptime-format-codes''')
parser.add_argument('-v', '--version',
action='store_true',
help='''print program version''')
parser.add_argument('-c', '--config',
default='$XDG_CONFIG_HOME/pyssg/pyssgrc',
type=str,
help='''config file (path) to read from; defaults to
'$XDG_CONFIG_HOME/pyssg/pyssgrc' ''')
parser.add_argument('-s', '--src',
default='src',
type=str,
help='''src directory; handmade files, templates and
metadata directory; defaults to 'src' ''')
parser.add_argument('-d', '--dst',
default='dst',
type=str,
help='''dst directory; generated (and transfered html)
files; defaults to 'dst' ''')
parser.add_argument('-t', '--plt',
default='plt',
type=str,
help='''plt directory; all template files; defaults to
'plt' ''')
parser.add_argument('-u', '--url',
default='',
type=str,
help='''base url without trailing slash''')
parser.add_argument('--static-url',
default='',
type=str,
help='''base static url without trailing slash''')
parser.add_argument('--title',
default='Blog',
type=str,
help='''general title for the website; defaults to
'Blog' ''')
parser.add_argument('--date-format',
default='%a, %b %d, %Y @ %H:%M %Z',
type=str,
help='''date format used inside pages (for creation and
modification times, for example); defaults to '%%a, %%b
%%d, %%Y @ %%H:%%M %%Z' ('Tue, Mar 16, 2021 @ 02:46 UTC',
for example)''')
parser.add_argument('--list-date-format',
default='%b %d',
type=str,
help='''date format used for page entries in a list;
defaults to '%%b %%d' ('Mar 16', for example)''')
parser.add_argument('--list-sep-date-format',
default='%B %Y',
type=str,
help='''date format used for the separator between page
entries in a list; defaults to '%%B %%Y' ('March 2021',
for example)''')
parser.add_argument('-i', '--init',
action='store_true',
help='''initializes the dir structure, templates,
as well as the 'src' and 'dst' directories''')
parser.add_argument('-b', '--build',
action='store_true',
help='''generates all html files and passes over
existing (handmade) ones''')
parser.add_argument('-f', '--force',
action='store_true',
help='''force building all pages and not only the
updated ones''')
return parser.parse_args()
def main() -> None:
opts: dict[str, Union[str, bool]] = vars(get_options())
conf_path: str = opts['config']
conf_path = os.path.expandvars(conf_path)
config: Configuration = Configuration(conf_path)
config.read()
config.fill_missing(opts)
if opts['version']:
print(f'pyssg v{VERSION}')
return
if opts['init']:
try:
os.mkdir(config.src)
os.makedirs(os.path.join(config.dst, 'tag'))
os.mkdir(config.plt)
except FileExistsError:
pass
for f in contents('pyssg'):
print(f)
return
if opts['build']:
# start the db
db: Database = Database(os.path.join(config.src, '.files'))
db.read()
# the autoescape option could be a security risk if used in a dynamic
# website, as far as i can tell
env: Environment = Environment(loader=FileSystemLoader(config.plt),
autoescape=False,
trim_blocks=True,
lstrip_blocks=True)
md: Markdown = Markdown(extensions=['extra', 'meta', 'sane_lists',
'smarty', 'toc', 'wikilinks'],
output_format='html5')
builder: HTMLBuilder = HTMLBuilder(config,
env,
db,
md)
builder.build()
# get all parsed pages and tags for rss and sitemap construction
all_pages: list[Page] = builder.all_pages
all_tags: list[tuple[str]] = builder.all_tags
rss_builder: RSSBuilder = RSSBuilder(config,
env,
all_pages,
all_tags)
rss_builder.build()
sm_builder: SitemapBuilder = SitemapBuilder(config,
env,
all_pages,
all_tags)
sm_builder.build()
db.write()
return
|
