Metadata-Version: 2.3
Name: recnys
Version: 0.4.0
Summary: A simple dotfile synchronization helper
Author: VioletsOleander
Author-email: VioletsOleander <1377232072@qq.com>
Requires-Dist: jinja2>=3.1.6
Requires-Dist: pyyaml>=6.0.3
Requires-Python: >=3.14
Description-Content-Type: text/markdown

# Recnys

Recnys is a simple dotfiles synchronization helper. I coded it primarily for personal use.

It supports Windows and Linux platforms.

It is called as "Recnys" because it is the reverse of "Syncer".

## Installation

Use [uv](https://github.com/astral-sh/uv) or [pipx](https://github.com/pypa/pipx) for installation:

```shell
uv tool install recnys
```

or

```shell
pipx install recnys
```

After installation, there will be two executables named `recnys` and `syncer`, with the same functionality.

## Usage

Recnys requires a `recnys.yaml` configuration file defined in the root of the dotfile repository.
This configuration file gives instructions on which files to sync, where to sync, and how to sync.

See `recnys.example.yaml` for detailed introduction about the configuration syntax.

Recnys supports using variables. This requires a `variables.yaml` file in the root of the dotfiles repository. Files that are to be rendered using these variables must have a `.template` suffix.

See `recnys.example.yaml` for the configuration syntax and `variables.example.yaml` for an example of variable definitions.

With configuration file correctly set, run `recnys` or `syncer` in the dotfile repository root, the
synchronization will start. For example:

```shell
syncer
```

Recnys will prompt for confirmation request for each file's synchronization, specify `-s` or `--skip-confirmation` to
disable the behavior. For example:

```shell
syncer -f
```

For more options, run:

```shell
syncer --help
```
