Skip to main content

Fast, easy, and automatic system configuration via a configuration file/repo

Project description

pydotfiles | Extendable Configuration-based Python Dotfile Manager

Build Status PyPI version Python 3.6+ semantic-release License

pydotfiles is an extendable and configurable dotfile manager written in python. It will configure your computer exactly the way that you want, and through the configuration system, means that people can have their own personalized environment by just editing configuration files, with no need to dive into the code to make it just work.

For Windows support, please see here

Features

  • Automatically sets up your applications, libraries, and environment the way YOU want
  • One-command installation
  • Easy configuration via forking and editing of a configuration file
  • Easy configuration options means that changes are simple and powerful
  • Enables unlimited extensions and customization, with a great baseline installation

Examples

  • Downloads a bunch of useful command-line tools (GNU tools, wget, bash v4+, vim, node, etc.)

  • [macOS only] Downloads a bunch of useful applications:

  • Secures and locks down the system via proper firewalling

  • Sets up proper dev environments (Python, Java, Ruby, Golang)

  • Sets up proper git environment with a better diff

  • [macOS only] Adds iTerm 2 shell integrations

Supported Platforms

  • macOS 10.12.x+ (High Sierra+)
  • Ubuntu 16.04 LTS

Installation

[RECOMMENDED] Opinionated Bootstrap

The following one-liner will bootstrap the system to an opinionated setup, in particular setting up pyenv for you if you don't have it yet, and setting up a new laptop-wide global python environment for day-to-day use.

Basically, if there's a completely new computer, run this:

curl -s https://raw.githubusercontent.com/JasonYao/pydotfiles/master/start-opinionated | bash -s {CONFIGURATION_REPO_GIT_LINK}
# e.g.
curl -s https://raw.githubusercontent.com/JasonYao/pydotfiles/master/start-opinionated | bash -s https://github.com/JasonYao/dotfiles.git

Non-Opinionated Bootstrap

The following one-liner won't assume the python environment that you're installing this to, and just install itself with pip.

Basically, if your computer already has the required python version/environments, run this:

curl -s https://raw.githubusercontent.com/JasonYao/pydotfiles/master/start-base | bash -s {CONFIGURATION_REPO_GIT_LINK}
# e.g.
curl -s https://raw.githubusercontent.com/JasonYao/pydotfiles/master/start-base | bash -s https://github.com/JasonYao/dotfiles.git

Usage

  • To toggle show/hiding of iTerm 2: +

  • To update + upgrade the dotfiles:

dotfiles upgrade
  • To uninstall the dotfiles:
dotfiles uninstall

License

This repo is licensed under the terms of the GNU GPL v3, of which a copy may be found here.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pydotfiles-4.2.8.tar.gz (63.5 kB view details)

Uploaded Source

Built Distribution

pydotfiles-4.2.8-py3-none-any.whl (93.8 kB view details)

Uploaded Python 3

File details

Details for the file pydotfiles-4.2.8.tar.gz.

File metadata

  • Download URL: pydotfiles-4.2.8.tar.gz
  • Upload date:
  • Size: 63.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.15

File hashes

Hashes for pydotfiles-4.2.8.tar.gz
Algorithm Hash digest
SHA256 0fc22a9f45901a2871155a496999b0b1202e1c265fa9cfb188ba67be288a077b
MD5 2f06de704dfc9564c56f9aaf6ec13db9
BLAKE2b-256 c50cb35f1512263655499e7d007b2213897168cb7fd5f7fea34d0fecc79703bb

See more details on using hashes here.

File details

Details for the file pydotfiles-4.2.8-py3-none-any.whl.

File metadata

  • Download URL: pydotfiles-4.2.8-py3-none-any.whl
  • Upload date:
  • Size: 93.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.15

File hashes

Hashes for pydotfiles-4.2.8-py3-none-any.whl
Algorithm Hash digest
SHA256 4652198825a90c19a8190d29e9b236b45207c073ce79dbd005c1157f97e00313
MD5 a3af2cbd091b869bee4d3acbce35c9dd
BLAKE2b-256 0dc53f313c9d6f974e98d3ddc70a2b795cba1e7b5cc735d3aefd8a961f433767

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page