mirror of https://github.com/FreshRSS/FreshRSS.git synced 2026-06-11 00:55:59 -04:00

Files

Julien Herr 5bddc6bed5 feat(cli): add reconfigure-user.php to read/write per-user config attributes (#8873 )

* feat(cli): add reconfigure-user.php to read/write per-user config attributes

Closes #8869.

Adds `cli/reconfigure-user.php`, a first-class CLI for per-user configuration attributes — the user-level equivalent of the existing `reconfigure.php` (system config).

### Usage

```sh
# List all attributes (sensitive keys redacted by default)
./cli/reconfigure-user.php --user alice --list
./cli/reconfigure-user.php --user alice --list --show-secrets

# Read a single attribute (exit 2 if key not found)
./cli/reconfigure-user.php --user alice --key language

# Set an attribute (type inferred from existing value: bool, int, string)
./cli/reconfigure-user.php --user alice --key language --set --value fr

# Set from stdin (recommended for secrets — keeps value out of shell history / ps)
./cli/reconfigure-user.php --user alice --key some_token --set --value-stdin < token.txt

# Create a new key, e.g. for an extension (unknown keys rejected by default)
./cli/reconfigure-user.php --user alice --key my_ext_setting --set --value hello --force

# Delete an attribute (exit 2 if key not found)
./cli/reconfigure-user.php --user alice --key some_token --unset
```

### Changes

- `cli/reconfigure-user.php` — new command
- `lib/Minz/Configuration::toArray()` — exposes the full config array (used by `--list`)
- `cli/README.md` — documents the new command
- `tests/cli/UserConfigOptionsParserTest.php` — PHPUnit tests for the options parser, following the existing `CliOptionsParserTest` pattern (shared `cli-parser-test.php` helper)

### Test plan

- `make test-all` passes
- Tested manually against a local FreshRSS instance: `--list`, `--key` (get), `--set` (bool/int/string inference), `--value-stdin`, `--unset`, `--force`, error paths (unknown key without `--force`, wrong type)

* unserialize allowed_classes

---------

Co-authored-by: Alexandre Alapetite <alexandre@alapetite.fr>

2026-05-24 13:25:04 +02:00

app

New automatic feed visibility/priority during search (#8609 )

2026-03-21 17:15:07 +01:00

cli

feat(cli): add reconfigure-user.php to read/write per-user config attributes (#8873 )

2026-05-24 13:25:04 +02:00

fixtures

Use strict_types (#5830 )

2023-11-16 22:43:00 +01:00

lib

Show time since when a feed has problems + new timeago() method and i18n plurals (#8670 )

2026-04-07 22:56:02 +02:00

.gitignore

Mark as read 1 or 7 days based on publication date (#8163 )

2025-10-28 19:07:14 +01:00

.htaccess

Apache protect more non-public folders and files (#6881 )

2024-10-11 09:25:43 +02:00

bootstrap.php

Change how files are included (#7916 )

2025-09-05 15:56:46 +02:00

index.html

Apache protect more non-public folders and files (#6881 )

2024-10-11 09:25:43 +02:00

README.md

Upgrade to PHP 8.1 (#6711 )

2024-09-06 09:06:46 +02:00

shellchecks.sh

[CI] Run shellcheck and shfmt (#2454 )

2019-07-22 16:07:40 +02:00

README.md

FreshRSS tests

See our documentation about running tests.

make test-all

See test.yml for the GitHub Actions automated tests.

See composer.json for the different tests and versions, to be run locally.

Details about this tests folder

Unit tests are based on PHPUnit. Here is an example of manual install:

cd ./tests/
wget -O phpunit.phar https://phar.phpunit.de/phpunit-10.phar
php phpunit.phar --bootstrap bootstrap.php

The shellchecks.sh script is used to safeguard shell scripts from common shell script bugs and to ensure a consistent style. It requires ShellCheck and shfmt.