Дневник одной командой
Дописывает запись дня в месячный Markdown-файл и показывает вопросы для размышления.
Что делает скрипт
Запись можно передать аргументом, прочитать из файла или получить из стандартного ввода. Скрипт создаёт отдельный файл на каждый месяц и никогда не перезаписывает старые записи. Вопросы помогают быстро начать, если нет готового текста.
Быстрый старт
python journal.py add --text "Что получилось сегодня" --mood 4
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python journal.py add --text "Спокойный день" --mood 4python journal.py add --file entry.txtpython journal.py prompts
Что понадобится
winget install Python.Python.3.12
brew install python
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.