-'use strict';
-
-const { access, mkdir, readdir, readFile, rm, writeFile } = require('fs/promises');
-const { exec } = require('child_process');
-const { ncp } = require('ncp');
-const { join } = require('path');
-const ParseGemini = require('gemini-to-html/parse');
-const RenderGemini = require('gemini-to-html/render');
-const { debuglog, promisify } = require('util');
+import { access, cp, readdir, readFile, writeFile } from 'fs/promises';
+import { exec } from 'child_process';
+import { basename, join } from 'path';
+import ParseGemini from 'gemini-to-html/parse.js';
+import RenderGemini from 'gemini-to-html/render.js';
+import { debuglog, promisify } from 'util';
+import { ensureDirectoryExists, rmIfExists } from './utils.js';
+import { kFileNotFoundError } from './constants.js';
// Generators for the Blog
-const StaticGenerator = require('./generators/static');
-const HTMLGenerator = require('./generators/html');
-const RSSGenerator = require('./generators/rss');
-const TXTGenerator = require('./generators/txt');
+import StaticGenerator from './generators/static.js';
+import HTMLGenerator from './generators/html.js';
+import RSSGenerator from './generators/rss.js';
+import TXTGenerator from './generators/txt.js';
// Archiving Methods
-const GemlogArchiver = require('./archivers/gemlog');
+import GemlogArchiver from './archivers/gemlog.js';
+
+// Remote Handler
+
+import Remote from './remote.js';
const internals = {
// Promisified functions
exec: promisify(exec),
- ncp: promisify(ncp),
debuglog: debuglog('blog'),
// constants
- kFileNotFoundError: 'ENOENT',
kGeminiRe: /\.gmi$/i,
kMetadataFilename: 'metadata.json',
* @param {Blog.tConfiguration} config the initialization options to
* extend the instance
*/
-module.exports = class Blog {
+export default class Blog {
constructor(config) {
}
/**
- * Shifts the blog posts, adds the passed path to slot 0, and
+ * Shifts the blog posts, adds the passed file to slot 0, and
* generates files.
*
* @function add
* @memberof Blog
- * @param {string} postLocation the path to the directory containing
- * the post structure
+ * @param {string} postLocation the path to the blog post file
* @return {Promise<undefined>} empty promise, returns no value
* @instance
*/
async add(postLocation) {
- await this._ensurePostsDirectoryExists();
+ await ensureDirectoryExists(this.postsDirectory);
+ try {
+ await this.syncDown();
+ }
+ catch {}
+
await this._shift();
- await mkdir(join(this.postsDirectory, '0'));
- await this.update(postLocation);
+ const firstDirectory = join(this.postsDirectory, '0');
+ await rmIfExists(firstDirectory);
+ await ensureDirectoryExists(firstDirectory);
+ await this._update(postLocation);
}
/**
- * Adds the passed path to slot 0, and generates files.
+ * Update slot 0 with the passed gmi file, and generates files.
*
* @function update
* @memberof Blog
- * @param {string} postLocation the path to the directory containing
- * the post structure
+ * @param {string} postLocation the path to the blog post file
* @return {Promise<undefined>} empty promise, returns no value
* @instance
*/
async update(postLocation) {
- const metadata = await this._getMetadata();
- await this._ensurePostsDirectoryExists();
- await this._copyPost(postLocation);
- await this._writeMetadata(metadata);
-
- await this._archive(postLocation);
+ try {
+ await this.syncDown();
+ }
+ catch {}
- await this.generate();
+ await this._update(postLocation);
}
/**
* @return {Promise<undefined>} empty promise, returns no value
* @instance
*/
- async publish(bucket) {
+ async publish(host) {
- internals.debuglog(`Publishing to ${bucket}`);
+ internals.debuglog(`Publishing to ${host}`);
try {
- await internals.exec('which aws');
+ await internals.exec('which rsync');
}
catch (err) {
- console.error('Please install and configure AWS CLI to publish.');
+ console.error('Please install and configure rsync to publish.');
}
try {
- await internals.exec(`aws s3 sync --acl public-read --delete ${this.staticDirectory} s3://${bucket}`);
- await internals.exec(`aws s3 cp --content-type 'text/plain; charset=utf-8 ' --acl public-read ${this.staticDirectory}/index.txt s3://${bucket}`);
+ internals.debuglog(`Copying ephemeral blog from ${this.blogOutputDirectory}`);
+ await internals.exec(`rsync -r ${this.blogOutputDirectory}/ ${host}`);
}
catch (err) {
console.error('Failed to publish');
internals.debuglog('Finished publishing');
}
+ /**
+ * Publishes the archive to a host using rsync. Currently assumes
+ * gemlog archive.
+ *
+ * @function publishArchive
+ * @memberof Blog
+ * @return {Promise<undefined>} empty promise, returns no value
+ * @instance
+ */
+ async publishArchive(host) {
+
+ internals.debuglog(`Publishing archive to ${host}`);
+ try {
+ await internals.exec('which rsync');
+ }
+ catch (err) {
+ console.error('Please install rsync to publish the archive.');
+ }
+
+ try {
+ internals.debuglog(`Copying archive from ${this.archiveOutputDirectory}`);
+ await internals.exec(`rsync -r ${this.archiveOutputDirectory}/ ${host}`);
+ }
+ catch (err) {
+ console.error('Failed to publish archive');
+ console.error(err.stderr);
+ }
+
+ internals.debuglog('Finished publishing');
+ }
+
+ /**
+ * Adds a remote
+ *
+ * @function addRemote
+ * @memberof Blog
+ * @return {Promise<undefined>} empty promise, returns no value
+ * @instance
+ */
+ async addRemote(remote) {
+
+ await ensureDirectoryExists(this.configDirectory);
+ await Remote.add(this.remoteConfig, remote);
+ }
+
+ /**
+ * Removes a remote
+ *
+ * @function removeRemote
+ * @memberof Blog
+ * @return {Promise<undefined>} empty promise, returns no value
+ * @instance
+ */
+ async removeRemote() {
+
+ await Remote.remove(this.remoteConfig);
+ }
+
+
+ /**
+ * Pulls the posts and archive from the remote
+ *
+ * @function syncDown
+ * @memberof Blog
+ * @return {Promise<undefined>} empty promise, returns no value
+ * @instance
+ */
+ async syncDown() {
+
+ internals.debuglog('Pulling remote state');
+ await ensureDirectoryExists(this.dataDirectory);
+ await Remote.syncDown(this.remoteConfig, this.dataDirectory);
+ internals.debuglog('Pulled remote state');
+ }
+
+ /**
+ * Pushes the posts and archive to the remote
+ *
+ * @function syncUp
+ * @memberof Blog
+ * @return {Promise<undefined>} empty promise, returns no value
+ * @instance
+ */
+ async syncUp() {
+
+ internals.debuglog('Pushing remote state');
+ await ensureDirectoryExists(this.dataDirectory);
+ await Remote.syncUp(this.remoteConfig, this.dataDirectory);
+ internals.debuglog('Pushed remote state');
+ }
+
+ // Adds the passed path to slot 0, and generates files.
+
+ async _update(postLocation) {
+
+ const metadata = await this._getMetadata();
+ await ensureDirectoryExists(this.postsDirectory);
+ await this._copyPost(postLocation);
+ await this._writeMetadata(metadata);
+
+ await this._archive(postLocation);
+
+ await this.generate();
+ try {
+ await this.syncUp();
+ }
+ catch {}
+ }
+
+
// Parses Gemini for each page, copies assets and generates index.
async generate() {
const posts = await this._readPosts();
- await StaticGenerator(this.postsDirectory, this.staticDirectory, posts);
- await HTMLGenerator(this.templatesDirectory, this.staticDirectory, posts);
- await RSSGenerator(this.templatesDirectory, this.staticDirectory, posts);
- await TXTGenerator(this.templatesDirectory, this.staticDirectory, posts);
+ // Start from a clean slate.
+ await rmIfExists(this.blogOutputDirectory);
+ await ensureDirectoryExists(this.blogOutputDirectory);
- await GemlogArchiver(this.archiveDirectory);
+ // Run each generator
+ await StaticGenerator(this.staticDirectory, this.blogOutputDirectory, posts);
+ await HTMLGenerator(await this._templateDirectoryFor('index.html'), this.blogOutputDirectory, posts);
+ await RSSGenerator(await this._templateDirectoryFor('feed.xml'), this.blogOutputDirectory, posts);
+ await TXTGenerator(await this._templateDirectoryFor('index.txt'), this.blogOutputDirectory, posts);
+
+ // Start from a clean slate.
+ await rmIfExists(this.archiveOutputDirectory);
+ await ensureDirectoryExists(this.archiveOutputDirectory);
+ await ensureDirectoryExists(this.archiveDirectory);
+
+ // Run each archiver
+ await GemlogArchiver(await this._templateDirectoryFor('index.gmi'), this.archiveDirectory, this.archiveOutputDirectory);
+ // TODO: GopherArchiver
}
// Reads the posts into an array
posts.push(await this._readPost(i));
}
catch (error) {
- if (error.code === internals.kFileNotFoundError) {
+ if (error.code === kFileNotFoundError) {
internals.debuglog(`Skipping ${i}`);
continue;
}
// Reads an individual post
- async _readPost(index=0) {
- const postSourcePath = join(this.postsDirectory, `${index}`);
+ async _readPost(index = 0) {
- internals.debuglog(`Reading ${postSourcePath}`);
+ const postSourcePath = join(this.postsDirectory, `${index}`);
- await access(postSourcePath);
+ internals.debuglog(`Reading ${postSourcePath}`);
- const metadata = await this._getMetadata(index);
+ await access(postSourcePath);
- const postContentPath = await this._findBlogContent(postSourcePath);
- internals.debuglog(`Reading ${postContentPath}`);
- const postContent = await readFile(postContentPath, { encoding: 'utf8' });
+ const metadata = await this._getMetadata(index);
- internals.debuglog('Parsing Gemini');
- return {
- ...metadata,
- location: postSourcePath,
- index,
- html: RenderGemini(ParseGemini(postContent)),
- raw: postContent
- };
+ const postContentPath = await this._findBlogContent(postSourcePath);
+ internals.debuglog(`Reading ${postContentPath}`);
+ const postContent = await readFile(postContentPath, { encoding: 'utf8' });
+
+ internals.debuglog('Parsing Gemini');
+ return {
+ ...metadata,
+ location: postSourcePath,
+ index,
+ html: RenderGemini(ParseGemini(postContent)),
+ raw: postContent
+ };
}
// Shift the posts, delete any remainder.
async _shift() {
- for (let i = this.maxPosts - 1; i >= 0; --i) {
+ for (let i = this.maxPosts - 1; i >= 1; --i) {
const targetPath = join(this.postsDirectory, `${i}`);
const sourcePath = join(this.postsDirectory, `${i - 1}`);
try {
internals.debuglog(`Archiving ${targetPath}`);
- await rm(targetPath, { recursive: true });
-
+ await rmIfExists(targetPath);
await access(sourcePath); // check the source path
internals.debuglog(`Shifting blog post ${sourcePath} to ${targetPath}`);
- await internals.ncp(sourcePath, targetPath);
+ await cp(sourcePath, targetPath, { recursive: true });
}
catch (error) {
- if (error.code === internals.kFileNotFoundError) {
+ if (error.code === kFileNotFoundError) {
internals.debuglog(`Skipping ${sourcePath}: Does not exist.`);
continue;
}
// Moves older posts to the archive
async _archive() {
+
internals.debuglog('Archiving post');
const post = await this._readPost(0);
- await this._ensureDirectoryExists(this.archiveDirectory);
+ await ensureDirectoryExists(this.archiveDirectory);
const targetPath = join(this.archiveDirectory, post.id);
- try {
- internals.debuglog(`Removing ${targetPath}`);
- await rm(targetPath, { recursive: true });
- }
- finally {
- internals.debuglog(`Adding ${post.location} to ${targetPath}`);
- await internals.ncp(post.location, targetPath);
- internals.debuglog(`Added ${post.location} to ${targetPath}`);
- }
+ internals.debuglog(`Removing ${targetPath}`);
+ await rmIfExists(targetPath);
+ internals.debuglog(`Adding ${post.location} to ${targetPath}`);
+ await ensureDirectoryExists(targetPath);
+ await cp(post.location, targetPath, { recursive: true });
+ internals.debuglog(`Added ${post.location} to ${targetPath}`);
}
// Attempts to read existing metadata. Otherwise generates new set.
await writeFile(metadataTarget, JSON.stringify(metadata, null, 2));
}
- // Copies a post directory to the latest slot.
+ // Copies a post file to the latest slot.
async _copyPost(postLocation) {
+ internals.debuglog(`Copying ${postLocation}`);
const targetPath = join(this.postsDirectory, '0');
+ const postName = basename(postLocation);
+ const targetPost = join(targetPath, postName);
- internals.debuglog(`Removing ${targetPath}`);
- await rm(targetPath, { recursive: true });
-
- internals.debuglog(`Adding ${postLocation} to ${targetPath}`);
- await internals.ncp(postLocation, targetPath);
- }
-
- // Ensures a directory exists.
-
- async _ensureDirectoryExists(directory) {
-
- internals.debuglog(`Checking if ${directory} exists.`);
- try {
- await access(directory);
- }
- catch (error) {
- if (error.code === internals.kFileNotFoundError) {
- internals.debuglog('Creating posts directory');
- await mkdir(directory);
- return;
- }
-
- throw error;
- }
- }
-
- // Ensures posts directory exists
-
- async _ensurePostsDirectoryExists() {
-
- return this._ensureDirectoryExists(this.postsDirectory);
- internals.debuglog(`Checking if ${this.postsDirectory} exists.`);
- try {
- await access(this.postsDirectory);
- }
- catch (error) {
- if (error.code === internals.kFileNotFoundError) {
- internals.debuglog('Creating posts directory');
- await mkdir(this.postsDirectory);
- return;
- }
-
- throw error;
- }
+ await rmIfExists(targetPath);
+ await ensureDirectoryExists(targetPath);
+ await cp(postLocation, targetPost, { recursive: true });
+ internals.debuglog(`Added ${postLocation} to ${targetPath}`);
}
// Looks for a `.gmi` file in the blog directory, and returns the path
throw new Error(internals.strings.geminiNotFound);
}
-};
+
+ // Gets the template directory for a given template.
+ async _templateDirectoryFor(template) {
+
+ try {
+ await access(join(this.templatesDirectory, template));
+ return this.templatesDirectory;
+ }
+ catch (error) {
+ if (error.code === kFileNotFoundError) {
+ internals.debuglog(`No custom template for ${template}`);
+ return this.defaultTemplatesDirectory;
+ }
+
+ throw error;
+ }
+ }
+}
git.r.bdr.sh / rbdr / blog / blobdiff