Продуктивность

Дневник одной командой

Дописывает запись дня в месячный Markdown-файл и показывает вопросы для размышления.

Python Windows macOS Linux Новичок
Скачать journal.py
Описание

Что делает скрипт

Запись можно передать аргументом, прочитать из файла или получить из стандартного ввода. Скрипт создаёт отдельный файл на каждый месяц и никогда не перезаписывает старые записи. Вопросы помогают быстро начать, если нет готового текста.

Запуск

Быстрый старт

python journal.py add --text "Что получилось сегодня" --mood 4

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python journal.py add --text "Спокойный день" --mood 4
  • python journal.py add --file entry.txt
  • python journal.py prompts
Зависимости

Что понадобится

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
Исходник

journal.py

#!/usr/bin/env python3
"""Дневник: одна запись дня в месячном Markdown-файле."""
from __future__ import annotations

import argparse
import sys
from datetime import date, datetime
from pathlib import Path

DEFAULT_DIR = Path.home() / ".productivity" / "journal"
PROMPTS = [
    "Что сегодня получилось лучше всего?",
    "Что забрало больше всего энергии?",
    "Какую одну вещь стоит повторить завтра?",
    "Чему я научился сегодня?",
    "Кому стоит сказать спасибо?",
]


def target_file(directory: Path, day: date) -> Path:
    return directory / f"{day.strftime('%Y-%m')}.md"


def read_text(args: argparse.Namespace) -> str:
    if args.text:
        return args.text
    if args.file:
        path = args.file.expanduser()
        if not path.is_file():
            raise SystemExit(f"Файл не найден: {path}")
        return path.read_text(encoding="utf-8")
    if sys.stdin.isatty():
        raise SystemExit("Передайте --text, --file или текст через stdin")
    return sys.stdin.read()


def command_add(args: argparse.Namespace) -> int:
    try:
        day = date.fromisoformat(args.date) if args.date else date.today()
    except ValueError:
        raise SystemExit("Дата указывается в формате YYYY-MM-DD")
    text = read_text(args).strip()
    if not text:
        raise SystemExit("Запись пустая")
    if not 1 <= args.mood <= 5:
        raise SystemExit("--mood должен быть от 1 до 5")
    directory = args.dir.expanduser()
    path = target_file(directory, day)
    directory.mkdir(parents=True, exist_ok=True)
    is_new = not path.exists()
    stamp = datetime.now().strftime("%H:%M")
    block = f"\n## {day.isoformat()} {stamp}\n\nНастроение: {args.mood}/5\n\n{text}\n"
    with path.open("a", encoding="utf-8") as handle:
        if is_new:
            handle.write(f"# Дневник {day.strftime('%Y-%m')}\n")
        handle.write(block)
    print(f"Записано в {path}")
    return 0


def command_prompts(args: argparse.Namespace) -> int:
    for index, question in enumerate(PROMPTS, start=1):
        print(f"{index}. {question}")
    return 0


def command_list(args: argparse.Namespace) -> int:
    directory = args.dir.expanduser()
    files = sorted(directory.glob("*.md")) if directory.is_dir() else []
    if not files:
        print("Записей нет.")
        return 0
    for path in files:
        headings = [line for line in path.read_text(encoding="utf-8").splitlines() if line.startswith("## ")]
        print(f"{path.name}: {len(headings)} записей")
    return 0


def build_parser() -> argparse.ArgumentParser:
    parser = argparse.ArgumentParser(description="Дневник в Markdown")
    parser.add_argument("--dir", type=Path, default=DEFAULT_DIR)
    sub = parser.add_subparsers(dest="command", required=True)

    add_parser = sub.add_parser("add", help="Добавить запись")
    add_parser.add_argument("--text", default="")
    add_parser.add_argument("--file", type=Path)
    add_parser.add_argument("--date", default="")
    add_parser.add_argument("--mood", type=int, default=3)
    add_parser.set_defaults(func=command_add)

    prompts_parser = sub.add_parser("prompts", help="Показать вопросы")
    prompts_parser.set_defaults(func=command_prompts)

    list_parser = sub.add_parser("list", help="Показать файлы дневника")
    list_parser.set_defaults(func=command_list)
    return parser


def main() -> int:
    args = build_parser().parse_args()
    return args.func(args)


if __name__ == "__main__":
    raise SystemExit(main())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get productivity-journal
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Продуктивность

Заметки, время, задачи, напоминания и автоматизация рутины.