Metadata-Version: 2.1
Name: pi-image-prep
Version: 0.1.1
Summary: Prepare Raspbian for headless install
Home-page: https://gitlab.com/rveach/pi-image-prep
Author: Ryan Veach
Author-email: rveach@gmail.com
License: MIT
Description: # pi-image-prep
        
        [![PyPI version](https://badge.fury.io/py/pi-image-prep.svg)](https://badge.fury.io/py/pi-image-prep)
        
        ```bash
        pip install pi-image-prep
        ```
        
        ## Overview
        
        This is a script I created to help prepare Rasbian image before the first boot. My goal was to set up an image with some basic features, up to the point where I could pass off control to my configuration management system.
        
        I was inspired to replicate the functionality of [PiBakery](https://www.pibakery.org/), but I wanted something simple and lightweight that would run on Linux.
        
        ## Features:
        
        - set system Locale
        - set system timezone
        - set user passwords for root and pi users
        - add authorized keys for the root and pi users
        - enable ssh
        - set hostname
        - enable wifi
        - install packages by name
        
        
        ## Usage:
        
        **On most systems, this will need to be run as root, or with sudo.** This is because the image partitions need to be mounted and unmounted, and most non-root users cannot do this by default.
        
        The full usage is below. Nothing is enabled by default, unless specified in a cli flag.
        
        The following options will enable a prompt in the script, but the values can be set via environment variables to prevent this.
        
        - `--pi-pw`: can be overridden by setting the environment variable `PI_PW`
        - `--root-pw`: can be overridden by setting the environment variable `ROOT_PW`
        - `--wifi-ssid`: This will cause a prompt for the wifi password, which can be overridden by specifing an environment variable `WIFI_PASS`.
        
        Note: I chose not to make those options available via cli flags to discourage passing sensitive information to the command line.
        
        ```
        $ pi-image-prep.py -h
        usage: pi-image-prep.py [-h] [--bypass-space-checks] [--pause]
                                [--locale LOCALE] [--timezone TIMEZONE] [--root-pw]
                                [--root-keys [ROOT_KEYS [ROOT_KEYS ...]]] [--pi-pw]
                                [--pi-keys [PI_KEYS [PI_KEYS ...]]] [--enable-ssh]
                                [--hostname HOSTNAME] [--wifi-ssid WIFI_SSID]
                                [--wifi-country WIFI_COUNTRY]
                                [--install-packages [INSTALL_PACKAGES [INSTALL_PACKAGES ...]]]
                                image_file output_file
        
        positional arguments:
          image_file
          output_file
        
        optional arguments:
          -h, --help            show this help message and exit
          --bypass-space-checks
                                If you think you're smarter than the computer, bypass
                                the disk space checks.
          --pause               Pause for inspection before closing image
          --locale LOCALE       set the system locale, example: en_US.UTF-8
          --timezone TIMEZONE   Set the timezone name, example: America/Chicago
        
        Authentication Options:
          --root-pw             Change root password
          --root-keys [ROOT_KEYS [ROOT_KEYS ...]]
                                Authorized key files for the root user
          --pi-pw               Change the pi user password
          --pi-keys [PI_KEYS [PI_KEYS ...]]
                                Authorized key files for the pi user
        
        SSH Options:
          --enable-ssh          enable ssh on first boot
        
        Network Options:
          --hostname HOSTNAME   raspberry pi hostname
        
        WiFi Options:
          --wifi-ssid WIFI_SSID
                                wifi ssid
          --wifi-country WIFI_COUNTRY
                                2 letter ISO 3166-1 country code for wifi.
        
        Configuration Options:
          --install-packages [INSTALL_PACKAGES [INSTALL_PACKAGES ...]]
                                packages to install on first boot
        ```
        
        ## A Note on Sudo and Virtual Environments
        
        If installed into a virtual environment, a `sudo pi-image-prep.py` call will mostly likely fail, since the root user would not have sourced the activate file. The easiest way to bypass this is to either install into the system python install or call the executable by full path.
        
        ## Wishlist
        
        These are features I think would be great additions to the script. I may or may not have time to add them, so contributions are always welcome:
        
        - SSH Host key management: either copy pre-existing keys or generate new then display an authorized_keys compabile entry to stdout.
        - Windows Compatibility: I won't use it, but I'd entertain cross compatbility features
        - Remove password for pi user
        - Use sudo with the mount/umount commands
        
Keywords: Raspberry,Pi,Raspbian
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Internet
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.5
Description-Content-Type: text/markdown
