diff --git a/README.md b/README.md index aab267f..b38355e 100644 --- a/README.md +++ b/README.md @@ -12,12 +12,16 @@ Currently, it only works with Postgres. ### Expiring old revisions +Using the `-r` or `--revisions` argument. + All revisions that have been created before the specified age will be removed. If all revisions are expired, the note remains available, it just won't have any revisions to revert to. Once you continue editing it, new revisions will be added. ### Expiring old notes +Using the `-n` or `--notes` argument. + Notes that are being expired will be emailed to the account that initially created the note. This allows that user to restore the note, if necessary. Expiring a note will also remove all existing revisions for the note. @@ -28,10 +32,22 @@ be recovered. ## Running `hedgedoc-expire.py` -Locally from the command line: +Locally from the command line expiring revisions and notes older than 7 days: ```shell -poetry run python ./hedgedoc-expire.py ... +poetry run python ./hedgedoc-expire.py expire -n 7 -r 7 +``` + +Locally from the command line only expiring revisions older than 7 days: + +```shell +poetry run python ./hedgedoc-expire.py expire -r 7 +``` + +Locally from the command line only expiring notes older than 7 days: + +```shell +poetry run python ./hedgedoc-expire.py expire -n 7 ``` From Docker Compose: @@ -65,8 +81,8 @@ Without it, the expiry action will be taken. | Option | Default | Description | |--------|---------|-------------------------------------------------------------------| -| -n | 90 | remove all notes not changed in these many days | -| -r | 7 | remove all revisions created more than these many days ago | +| -n | None | remove all notes not changed in these many days | +| -r | None | remove all revisions created more than these many days ago | | -v | false | Print info on current action during `cron` and `expire` commandds | Command is one of: diff --git a/hedgedoc-expire.py b/hedgedoc-expire.py index 64ed766..9a2e0c1 100644 --- a/hedgedoc-expire.py +++ b/hedgedoc-expire.py @@ -29,7 +29,6 @@ class Config: self.verbose = False self.revision_age = timedelta(days=14) self.note_age = timedelta(days=95) - self.exclude = [] self.postgres_connection_string = getenv('POSTGRES_CONNSTRING', 'postgresql://hedgedoc:geheim@localhost:5432/hedgedoc') @@ -276,29 +275,29 @@ class HedgedocExpire: def cmd_check(self) -> None: with psycopg.connect(self.config.postgres_connection_string) as conn: - if 'revision' not in self.config.exclude: + if self.config.revision_age is not None: print(self.check_revisions_to_be_expired(conn)) elif self.config.verbose: - print("Revisions were excluded from check, not checking.\n") + print("Revisions weren't included in the check, not checking.\n") - if 'note' not in self.config.exclude: + if self.config.note_age is not None: print(self.check_notes_to_be_expired(conn)) elif self.config.verbose: - print("Notes were excluded from check, not checking.\n") + print("Notes weren't included in the check, not checking.\n") def cmd_emailcheck(self) -> None: with psycopg.connect(self.config.postgres_connection_string) as conn: report = '' - if 'revision' not in self.config.exclude: + if self.config.revision_age is not None: report += self.check_revisions_to_be_expired(conn) else: - report += "Revisions were excluded from check.\n" + report += "Revisions weren't included in the check.\n" - if 'note' not in self.config.exclude: + if self.config.note_age is not None: report += self.check_notes_to_be_expired(conn) else: - report += "Notes were excluded from check.\n" + report += "Notes weren't included in the check.\n" msg = MIMEMultipart() msg['From'] = self.email_sender.mail_from msg['To'] = self.email_sender.mail_from @@ -315,15 +314,15 @@ class HedgedocExpire: def cmd_expire(self) -> None: with psycopg.connect(self.config.postgres_connection_string) as conn: - if 'revision' not in self.config.exclude: + if self.config.revision_age is not None: self.expire_old_revisions(conn) elif self.config.verbose: - print("Revisions were excluded from action, not expiring.\n") + print("Revisions weren't included in the expire action, not expiring.\n") - if 'note' not in self.config.exclude: + if self.config.note_age is not None: self.expire_old_notes(conn) elif self.config.verbose: - print("Notes were excluded from action, not expiring.\n") + print("Notes weren't included in the expire action, not expiring.\n") def main(): @@ -346,25 +345,20 @@ def main(): See https://git.hamburg.ccc.de/CCCHH/hedgedoc-expire ''') ) - parser.add_argument('-n', '--notes', metavar='DAYS', type=float, default=95, + parser.add_argument('-n', '--notes', metavar='DAYS', type=float, help='remove all notes not changed in these many days') - parser.add_argument('-r', '--revisions', metavar='DAYS', type=float, default=14, + parser.add_argument('-r', '--revisions', metavar='DAYS', type=float, help='remove all revisions created more than these many days ago') parser.add_argument('command', choices=['check', 'cron', 'emailcheck', 'expire'], default='check', nargs='?', help='action to perform') parser.add_argument('-v', '--verbose', action='store_true', default=False, help='print more info while running') - parser.add_argument('--exclude', nargs="+", choices=['revision', 'note'], - help='Type ("revision" or "note") to exclude from the action.') args = parser.parse_args() config = Config() - config.note_age = timedelta(days=args.notes) - config.revision_age = timedelta(days=args.revisions) + config.note_age = timedelta(days=args.notes) if args.notes is not None else None + config.revision_age = timedelta(days=args.revisions) if args.revisions is not None else None config.verbose = args.verbose - if (args.exclude): - config.exclude = args.exclude - print(config.exclude) mail = EmailSender(config.smtp_hostname, config.smtp_port, config.smtp_username, config.smtp_password, config.smtp_from) hedgedoc_expire = HedgedocExpire(config, mail)