web/_scripts/py/pages_generator.py

#!/usr/bin/env python
# -*- coding: utf-8 -*-

'''
Generates HTML pages for Categories and Tags in posts.

Dependencies:
  - git
  - ruamel.yaml

© 2018-2019 Cotes Chung
MIT License
'''


import os
import glob
import shutil
import sys
import subprocess

from ruamel.yaml import YAML
from utils.common import get_yaml
from utils.common import check_py_version


DRAFTS_DIR = '_drafts'
POSTS_DIR = ['_posts']

CATEGORIES_DIR = 'categories'
CATEGORY_LAYOUT = 'category'

TAG_DIR = 'tags'
TAG_LAYOUT = 'tag'

LEVEL = 3  # Tree level for current script file.


def help():
    print("Usage: "
          "   python pages_generator.py [Option]\n\n"
          "Options:\n"
          "   -d, --drafts         Enable drafts\n"
          "   -v, --verbose        Print verbose logs\n")


def get_path(dir):
    path = os.path.abspath(__file__)
    count = LEVEL
    r_index = len(path)
    while r_index > 0:
        r_index -= 1
        if (path[r_index] == '/' or path[r_index] == '\\'):
            count -= 1
            if count == 0:
                return path[:r_index + 1] + dir


def get_categories():
    all_categories = []
    yaml = YAML()

    for dir in POSTS_DIR:
        path = get_path(dir)
        for file in glob.glob(os.path.join(path, '*.md')):
            meta = yaml.load(get_yaml(file)[0])

            if 'category' in meta:
                if type(meta['category']) == list:
                    err_msg = (
                        "[Error] File {} 'category' type"
                        " can not be LIST!").format(file)
                    raise Exception(err_msg)
                else:
                    if meta['category'] not in all_categories:
                        all_categories.append(meta['category'])
            else:
                if 'categories' in meta:
                    if type(meta['categories']) == str:
                        error_msg = (
                            "[Error] File {} 'categories' type"
                            " can not be STR!").format(file)
                        raise Exception(error_msg)

                    for ctg in meta['categories']:
                        if ctg not in all_categories:
                            all_categories.append(ctg)
                else:
                    err_msg = (
                        "[Error] File:{} at least "
                        "have one category.").format(file)
                    print(err_msg)

    return all_categories


def generate_category_pages(is_verbose):
    categories = get_categories()
    path = get_path(CATEGORIES_DIR)

    if os.path.exists(path):
        shutil.rmtree(path)

    os.makedirs(path)

    for category in categories:
        new_page = path + '/' + category.replace(' ', '-').lower() + '.html'
        with open(new_page, 'w+', encoding='utf-8') as html:
            html.write("---\n")
            html.write("layout: {}\n".format(CATEGORY_LAYOUT))
            html.write("title: {}\n".format(category))
            html.write("category: {}\n".format(category))
            html.write("---")

            if is_verbose:
                print("[INFO] Created page: " + new_page)

    change = subprocess.getoutput("git status categories -s")
    if change:
        print("[INFO] Succeed! {} category-pages created."
              .format(len(categories)))


def get_all_tags():
    all_tags = []
    yaml = YAML()

    for dir in POSTS_DIR:
        path = get_path(dir)
        for file in glob.glob(os.path.join(path, '*.md')):
            meta = yaml.load(get_yaml(file)[0])

            if 'tags' in meta:
                for tag in meta['tags']:
                    if tag not in all_tags:
                        all_tags.append(tag)
            else:
                raise Exception("Didn't find 'tags' in \
                  post '{}' !".format(file))

    return all_tags


def generate_tag_pages(is_verbose):
    all_tags = get_all_tags()
    tag_path = get_path(TAG_DIR)

    if os.path.exists(tag_path):
        shutil.rmtree(tag_path)

    os.makedirs(tag_path)

    for tag in all_tags:
        tag_page = tag_path + '/' + tag.replace(' ', '-').lower() + '.html'
        with open(tag_page, 'w+', encoding='utf-8') as html:
            html.write("---\n")
            html.write("layout: {}\n".format(TAG_LAYOUT))
            html.write("title: {}\n".format(tag))
            html.write("tag: {}\n".format(tag))
            html.write("---")

            if is_verbose:
                print("[INFO] Created page: " + tag_page)

    change = subprocess.getoutput("git status tags -s")
    if change:
        print("[INFO] Succeed! {} tag-pages created.".format(len(all_tags)))


def main():
    check_py_version()

    is_verbose = False

    if len(sys.argv) > 1:
        for arg in sys.argv:
            if arg != sys.argv[0]:
                if arg == '-d' or arg == '--drafts':
                    POSTS_DIR.insert(0, DRAFTS_DIR)
                elif arg == '-v' or arg == '--verbose':
                    is_verbose = True
                else:
                    help()
                    return

    generate_category_pages(is_verbose)
    generate_tag_pages(is_verbose)


main()