{ "info": { "author": "Saxon Wolfkok", "author_email": "saxonwolfkok@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: GNU General Public License v3 (GPLv3)", "Programming Language :: Python :: 3", "Topic :: System :: Archiving :: Backup" ], "description": "n++ dotfiles\n============\n\nnpp\\_dotfiles makes it easy to use and manage your configuration files\nwhile keeping them in one secure directory (like Dropbox or other\nhosts). You can configure it to symlink your files to their destination\ndirectory with support to different names in backup and working dirs.\nMore, you can manage the config files, that you want to share with\nothers separate from your private ones. Uses git to automatically push\nand pull repositories on backup.\n\n**Current stable version is 0.2.0**\n\nInstall\n-------\n\nYou can install it with pip:\n\n``pip install npp-dotmanager``\n\nOr download the source and use:\n\n::\n\n $ git clone https://github.com/sxnwlfkk/dotmanager\n $ cd dotmanager\n $ python3 setup.py install\n\nRun\n---\n\nYou can run the program with the ``dotmanager`` command. You can explore\nthe arguments with ``dotmanager -h`` help function.\n\nIf you don't have root permission, you can use the\n``dotmanager_noroot.py`` script after cloning the repository. In the\nroot dir of the project call:\n\n``python3 scripts/dotmanager_noroot.py -h``\n\nConfiguration\n-------------\n\nDotmanager needs a configuration file to run, and checks first in\n``~/.dotfile``. You can specify a config file from another directory\nwith calling:\n\n``dotmanager -d ~/path/to/alternative/dotfile``\n\nConfiguration file\n~~~~~~~~~~~~~~~~~~\n\nThe configuration file needs to be formatted in YAML, in the following\nfashion:\n\n::\n\n repositories:\n private:\n dir: /home/user/path/to/backup/directory\n url: https://example@bitbucket.org/configs.git\n public:\n dir: /home/user/path/to/public/respitory\n url: https://github.com/example/configs.git\n\n backup-folders:\n scripts:\n target: ~/bin/\n public:\n - first_script\n - second_script\n private:\n - third_script\n home:\n target: ~/\n public:\n - .vimrc\n - .tmux.conf\n - [.newsbeuterrc, ~/.newsbeuter/config/.newsbeuterrc]\n private:\n - .zshrc\n - .dotfile\n - .netrc\n - [ranger.conf, ~/.config/ranger/rc.conf]\n\n*This example config file is available in the source repositories.*\n\nThe ``repositories`` and ``backup-folders`` are mandatory levels.\nRepositories needs to have at least a private level, where the ``dir``\nneeds to be set to the backup folder, and the ``url`` is only needed, if\nyou want to use the Git functionality.\n\nThe keys in the ``backup-folders`` are the name of the directories\ninside your backup folder **(at the moment you need at least one, and\nit's also a good idea to structure your backup files)**. The ``target``\nkey determines the working directory, where most of the dotfiles will be\nsymlinked.\n\nPublic and Private modes\n~~~~~~~~~~~~~~~~~~~~~~~~\n\nThe files under the ``public`` key will be treated the same as the\nprivate ones, -- symlinked to the target directory -- with the exception\nthat they will be copied additionally to the public directory, if you\nspecified one.\n\nStoring files with alternative name\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nIf you want to store your config files with different name than it needs\nto be in the target directory for whatever reason, you can do that. For\nexample, you want to store ``ranger``'s config file (``rc.conf``) as\n``ranger.conf`` in your backup directory. For this to work, you need to\nspecify the alternative name first, then the path to the target file:\n\n``- [ranger.conf, ~/.config/ranger/rc.conf]``\n\nAlternate target path\n~~~~~~~~~~~~~~~~~~~~~\n\nIf your file needs to be in other directory than the rest of your files\nin your backup dir, you can specify the alternate path with the above\nmethod.\n\nSetup\n-----\n\nSetup is one of the main modes of work if ``dotmanager``. You can call\nit with public or private. Setup symlinks in both cases both public and\nprivate files to their destination. However public tries to clone the\npublic ``git`` repository, if provided. Else, it makes the directory (if\nit doesnt exists), and copies the public files to their position.\nOptimally you'll need to use this once an install.\n\nPrivate\n~~~~~~~\n\n``dotmanager --setup --private``\n\nPublic\n~~~~~~\n\n``dotmanager --setup --public``\n\nBackup\n------\n\nBackup is the function to call, if you want to migrate your backups to\ntheir git servers. If called with the ``--private`` flag, it just\ncommits the changes in your backup directory, and pushes it to current\nbranch. Called with the ``--public`` flag, it commits and pushes the\nprivate directory, then copies the current state of the public files to\nthe public dir. After that the public repository is also committed and\npushed to the current dir.\n\nPrivate\n~~~~~~~\n\n``dotmanager --backup --private``\n\nPublic\n~~~~~~\n\n``dotmanager --backup --public``\n\nThe ``--no_git`` flag\n---------------------\n\nThe ``--no_git`` flag inhibits every git functionality of the program,\nif you want to use other hosting or version control.\n\nLicense\n-------\n\n::\n\n Copyright (C) 2017, Saxon Wolfkok \n\n This program is free software: you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation, either version 3 of the License, or\n (at your option) any later version.\n\n This program is distributed in the hope that it will be useful,\n but WITHOUT ANY WARRANTY; without even the implied warranty of\n MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n GNU General Public License for more details.\n\n You should have received a copy of the GNU General Public License\n along with this program. If not, see .", "description_content_type": null, "docs_url": null, "download_url": null, "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/sxnwlfkk/dotmanager", "keywords": "configuration setuptools dotmanager linux unix dotfile dotfiles", "license": "GPL", "maintainer": null, "maintainer_email": null, "name": "npp-dotmanager", "package_url": "https://pypi.org/project/npp-dotmanager/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/npp-dotmanager/", "project_urls": { "Homepage": "https://github.com/sxnwlfkk/dotmanager" }, "release_url": "https://pypi.org/project/npp-dotmanager/0.2.0/", "requires_dist": null, "requires_python": null, "summary": "N+1th dotfiles manager with public and private repository and git support", "version": "0.2.0" }, "last_serial": 2863860, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "f77043077eb2dde2dad15028128c7924", "sha256": "c052b819909fb0485ad2caf4deb55ffa1a5865acb4b10aaad5804e9c923c7848" }, "downloads": -1, "filename": "npp_dotmanager-0.1.5.tar.gz", "has_sig": false, "md5_digest": "f77043077eb2dde2dad15028128c7924", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 19180, "upload_time": "2017-03-17T08:58:48", "url": "https://files.pythonhosted.org/packages/3d/54/951b5972cedb5235fdcaee6104382d9ef09428b79ac557f9899a6ffbac6f/npp_dotmanager-0.1.5.tar.gz" } ], "0.1.5": [], "0.1.6": [ { "comment_text": "", "digests": { "md5": "ca3935d8fcda085bbb8fb9259622650f", "sha256": "4e845c5715dc4cb344a196905e8b792e1a625bde7fe18e209e6a53fc6fcaba67" }, "downloads": -1, "filename": "npp_dotmanager-0.2.0.tar.gz", "has_sig": false, "md5_digest": "ca3935d8fcda085bbb8fb9259622650f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22807, "upload_time": "2017-03-17T11:48:12", "url": "https://files.pythonhosted.org/packages/b9/83/c0fa3dbc602578cb770c85575fb38de95f78633daccc5be3c13cb02a8252/npp_dotmanager-0.2.0.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "69aebee86ef36c393ff4ee7fd4753973", "sha256": "b32ecf7ef1bb259edf8967f0e2aea4ead6ba8bfac10c1c67070ccc1b54206ee4" }, "downloads": -1, "filename": "npp_dotmanager-0.2.2-py3-none-any.whl", "has_sig": false, "md5_digest": "69aebee86ef36c393ff4ee7fd4753973", "packagetype": "bdist_wheel", "python_version": "3.5", "requires_python": null, "size": 18513, "upload_time": "2017-05-10T09:16:03", "url": "https://files.pythonhosted.org/packages/83/56/bf237114f9485f1f2a9e2c908c151e15b7a0e8070dce21f1be7ac6a469bf/npp_dotmanager-0.2.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e78268209ea9f748b62c111434e7a910", "sha256": "f07b8ef2076e350354c796ad2cfb0da35bec6fd1641a5f0421006d961cd63053" }, "downloads": -1, "filename": "npp_dotmanager-0.2.3-py3-none-any.whl", "has_sig": false, "md5_digest": "e78268209ea9f748b62c111434e7a910", "packagetype": "bdist_wheel", "python_version": "3.5", "requires_python": null, "size": 18514, "upload_time": "2017-05-10T09:21:34", "url": "https://files.pythonhosted.org/packages/11/ac/cde66a39d4181c561d2435b04f00019f57e0969560f7bf66d98a92437793/npp_dotmanager-0.2.3-py3-none-any.whl" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "69aebee86ef36c393ff4ee7fd4753973", "sha256": "b32ecf7ef1bb259edf8967f0e2aea4ead6ba8bfac10c1c67070ccc1b54206ee4" }, "downloads": -1, "filename": "npp_dotmanager-0.2.2-py3-none-any.whl", "has_sig": false, "md5_digest": "69aebee86ef36c393ff4ee7fd4753973", "packagetype": "bdist_wheel", "python_version": "3.5", "requires_python": null, "size": 18513, "upload_time": "2017-05-10T09:16:03", "url": "https://files.pythonhosted.org/packages/83/56/bf237114f9485f1f2a9e2c908c151e15b7a0e8070dce21f1be7ac6a469bf/npp_dotmanager-0.2.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e78268209ea9f748b62c111434e7a910", "sha256": "f07b8ef2076e350354c796ad2cfb0da35bec6fd1641a5f0421006d961cd63053" }, "downloads": -1, "filename": "npp_dotmanager-0.2.3-py3-none-any.whl", "has_sig": false, "md5_digest": "e78268209ea9f748b62c111434e7a910", "packagetype": "bdist_wheel", "python_version": "3.5", "requires_python": null, "size": 18514, "upload_time": "2017-05-10T09:21:34", "url": "https://files.pythonhosted.org/packages/11/ac/cde66a39d4181c561d2435b04f00019f57e0969560f7bf66d98a92437793/npp_dotmanager-0.2.3-py3-none-any.whl" } ] }