zvonimir/holybar
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Compare commits

base: zvonimir/holybar:8d1a6ba7400f46506a647c8ee5a7468748ddd364
Branches Tags
zvonimir/holybar:main
...
compare: zvonimir/holybar:669032fb48cd8625a9b1aa03bef6b2500b330d1b
Branches Tags
zvonimir/holybar:main

2 Commits
8d1a6ba740 ... 669032fb48

Author SHA1 Message Date
zvonimir 669032fb48 add readme 2026-04-17 15:38:30 +02:00
zvonimir 46c34ba545 add jsdoc 2026-04-17 15:36:11 +02:00
4 changed files with 42 additions and 3 deletions
Expand all files Collapse all files
README.md
+10
View File
@@ -0,0 +1,10 @@
# ✝️ holybar
Simple menu bar app to show the daily readings from the Bible. It uses the [United States Conference of Catholic Bishops](https://bible.usccb.org/) as the source and the Roman Calendar (romcal) package to determine the liturgical color.
## Usage
```bash
# Install dependencies
npm install
# Run the application
npm start
```
handlers/refresh.mjs
+5
View File
@@ -3,6 +3,11 @@ import * as cheerio from "cheerio";
import { error, reading } from "../helpers/html.mjs"; import { error, reading } from "../helpers/html.mjs";
import { log } from "../helpers/logger.mjs"; import { log } from "../helpers/logger.mjs";
/**
* Fetches the daily Bible reading from the USCCB website and updates the app's HTML.
*
* @param {Object} app - The application instance to update with the fetched reading.
*/
export default async function refresh(app) { export default async function refresh(app) {
const key = format(startOfToday(), "MMddyy"); const key = format(startOfToday(), "MMddyy");
helpers/html.mjs
+22 -3
View File
@@ -1,13 +1,19 @@
import { format } from "date-fns"; import { format } from "date-fns";
import Handlebars from "handlebars"; import Handlebars from "handlebars";
import romcal from "romcal"; import romcal from "romcal";
import { isToday } from "date-fns"; import { isToday, startOfToday, getYear } from "date-fns";
/**
* Generates CSS styles for the HTML content, dynamically adjusting colors based on the current liturgical event.
*
* @returns {string} A string containing the CSS styles.
*/
function css() { function css() {
let color = "#007acc"; // Default color let color = "#007acc"; // Default color
// Get today's liturgical event from the Roman calendar
const event = romcal const event = romcal
.calendarFor(new Date().getFullYear()) .calendarFor(getYear(startOfToday()))
.find((e) => isToday(new Date(e.moment))); .find((e) => isToday(new Date(e.moment)));
if (event) { if (event) {
@@ -81,8 +87,15 @@ const readingTemplate = Handlebars.compile(`
</html> </html>
`); `);
/**
* Generates the HTML content for the daily Bible reading, including the title, readings, and a link to the source.
*
* @param {string} title - The title of the reading.
* @param {Array} readings - An array of reading objects, each containing a title, content, and URL.
* @returns {string} A string containing the generated HTML content for the reading.
*/
export function reading(title, readings) { export function reading(title, readings) {
const now = new Date(); const now = startOfToday();
const url = `https://bible.usccb.org/bible/readings/${format(now, "MMddyy")}.cfm`; const url = `https://bible.usccb.org/bible/readings/${format(now, "MMddyy")}.cfm`;
const date = format(now, "MMMM d, yyyy"); const date = format(now, "MMMM d, yyyy");
@@ -94,6 +107,12 @@ export function reading(title, readings) {
}); });
} }
/**
* Generates the HTML content for an error message when fetching the reading fails.
*
* @param {number} status - The HTTP status code of the error.
* @returns {string} A string containing the generated HTML content for the error message.
*/
export function error(status) { export function error(status) {
return ` return `
<html> <html>
helpers/logger.mjs
+5
View File
@@ -1,3 +1,8 @@
/**
* A simple logging utility that prefixes log messages with a timestamp and a tag.
*
* @param {...any} args - The arguments to log, which can be of any type.
*/
export const log = (...args) => { export const log = (...args) => {
const timestamp = new Date().toISOString(); const timestamp = new Date().toISOString();
console.log(`[holybar] [${timestamp}]`, ...args); console.log(`[holybar] [${timestamp}]`, ...args);