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
|
import os
from argparse import ArgumentParser, Namespace
from typing import Union
from .configuration import Configuration
from .database import Database
from .template import Template
from .builder import HTMLBuilder
from .page import Page
from .rss import RSSBuilder
from .sitemap import SitemapBuilder
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('-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('-u', '--url',
default='',
type=str,
help='''base url without trailing slash''')
parser.add_argument('-t', '--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['init']:
try:
os.mkdir(config.src)
os.makedirs(os.path.join(config.dst, 'tag'))
except FileExistsError:
pass
# write default templates
template: Template = Template(config.src)
template.write()
return
if opts['build']:
# start the db
db: Database = Database(os.path.join(config.src, '.files'))
db.read()
# read templates
template: Template = Template(config.src)
template.read()
builder: HTMLBuilder = HTMLBuilder(config, template, db)
builder.build()
# get all parsed pages for rss construction
all_pages: list[Page] = builder.get_pages()
rss_builder: RSSBuilder = RSSBuilder(config, template.rss, all_pages)
rss_builder.build()
# get all tags for sitemap construction
all_tags: list[str] = builder.get_tags()
sm_builder: SitemapBuilder = SitemapBuilder(config,
template.sitemap,
all_pages,
all_tags)
sm_builder.build()
db.write()
return
|