semvec/pypi-packages huggingface dataset:
pydotswitcher 0.1.0
Switch up your dotfiles
License: MIT
Requires Python: >3.11
Keywords: dotfiles,backup,utility config ricing colorscheme linux python

<p align="center">
Switch your dotfiles on demand!
<br><br>
<a href="./LICENSE.md"><img src="https://img.shields.io/badge/license-MIT-cba6f7.svg"></a>
</p>
PyDotSwitcher is a Python utility that allows you to easily switch between your dotfiles.

## Features

- 📋 **Declarable**: PDS will only change between dotfiles YOU declare.
- 📁 **Grouped**: Make a group to change multiple configurations at the same time. Especially useful for changing colorschemes!
- 🛟 **Safe**: PDS Backs up files before it switches them, and changes to the dotfiles are linked with your current configuration group.
- 📜 **Scriptable**: You can also embed shell scripts for doing stuff when changing themes.

## Installation:

Install using PIP:
`pip install pydotswitcher` or 'python -m pip install pydotswitcher'

For Arch Linux users, install the `python-pydotswitcher` package

## Usage

Out of the box, PDS won't do anything. That is because you have to declare what files you want.

But first, a configuration group is needed:

`$ dotswitch -n MyConfig # Creates the MyConfig Group if it doesn't exist`

Now, let's add a file to our new group with the -a (Append) flag. For example, let's add our GTK settings:

`$ dotswitch -a ~/.config/gtk-3.0/settings.ini MyConfig`

Groups act as separate Home directories, so, running this command will create a `./.config/gtk-3.0` directory to store the `settings.ini` file inside the **MyConfig** group (Which, by default resides in ~/.config/pydotswitcher/groups/).

Now, to switch up our files, run:
`$ dotswitch -sw [group]`

This will apply all the configurations inside the group and will backup the existing configuration inside `~/.config/pydotswitcher/`, however, if you want to disable this, add the `--no-backup` flag.

For scripting, run `$ dotswitch -sh [group]`. This will auto generate a _.sh_ file for you to do scripting, and it will be executed when you switch up the files. If you have added a script to a group but don't want to execute it, append `--no-script`.

## Tips & Tricks

Some applications require a restart after having an updated. To fix this, create a script in your group and add `killall program-name && program-name &` to your script.
clearvision 0.3.2
Add a short description here!
License: MIT
Requires Python: >=3.9

.. These are examples of badges you might want to add to your README:
   please update the URLs accordingly

    .. image:: https://api.cirrus-ci.com/github/<USER>/AiReader.svg?branch=main
        :alt: Built Status
        :target: https://cirrus-ci.com/github/<USER>/AiReader
    .. image:: https://readthedocs.org/projects/AiReader/badge/?version=latest
        :alt: ReadTheDocs
        :target: https://AiReader.readthedocs.io/en/stable/
    .. image:: https://img.shields.io/coveralls/github/<USER>/AiReader/main.svg
        :alt: Coveralls
        :target: https://coveralls.io/r/<USER>/AiReader
    .. image:: https://img.shields.io/pypi/v/AiReader.svg
        :alt: PyPI-Server
        :target: https://pypi.org/project/AiReader/
    .. image:: https://img.shields.io/conda/vn/conda-forge/AiReader.svg
        :alt: Conda-Forge
        :target: https://anaconda.org/conda-forge/AiReader
    .. image:: https://pepy.tech/badge/AiReader/month
        :alt: Monthly Downloads
        :target: https://pepy.tech/project/AiReader
    .. image:: https://img.shields.io/twitter/url/http/shields.io.svg?style=social&label=Twitter
        :alt: Twitter
        :target: https://twitter.com/AiReader

.. image:: https://img.shields.io/badge/-PyScaffold-005CA0?logo=pyscaffold
    :alt: Project generated with PyScaffold
    :target: https://pyscaffold.org/

|

========
AiReader
========


    Add a short description here!


A longer description of your project goes here...


.. _pyscaffold-notes:

Making Changes & Contributing
=============================

This project uses `pre-commit`_, please make sure to install it before making any
changes::

    pip install pre-commit
    cd AiReader
    pre-commit install

It is a good idea to update the hooks to the latest version::

    pre-commit autoupdate

Don't forget to tell your contributors to also install and use pre-commit.

.. _pre-commit: https://pre-commit.com/

Note
====

This project has been set up using PyScaffold 4.5. For details and usage
information on PyScaffold see https://pyscaffold.org/.