mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2026-11-08 19:56:53 +00:00
kevinveenbirkenbachandClaude Opus 5
7bc12e55f3
aceb5295efmoved Cosmos, Quick Setup and Credits out of the committed role READMEs and into the documentation build's own scratch checkout, so a committed copy can no longer go stale when the metadata moves. Merging feature/designer (ebad39422c) took origin/main's side of those files, which still carries them, and reinstated all 290 along with the cosmos make target and its i8cos alias. tests/lint/ansible/roles/test_readme.py hard-fails on a committed copy, and the reinstated Credits block credited one person with two URLs, which tripped the credits-attribution lint as well. Stripped with the repository's own fence-aware parser against MANAGED_SECTIONS, not with a line filter: the Cosmos block holds a mermaid fence a naive filter would cut through. The result is byte-identical toaceb5295effor every README that carries no prose change since. The cosmos target wrote the forbidden section straight back into the checkout, so it goes with them. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
39 lines
1.6 KiB
Markdown
39 lines
1.6 KiB
Markdown
# Python Development Utilities
|
||
|
||
## Description
|
||
|
||
This Ansible role sets up a Python development environment on Arch Linux. It includes Python itself, the `pip` package manager, and builds on the general developer persona to support scripting, application development, data science, and more.
|
||
|
||
Learn more at the [Python Official Site](https://www.python.org/), the [Arch Wiki - Python](https://wiki.archlinux.org/title/Python), and [Wikipedia – Python](https://en.wikipedia.org/wiki/Python_(programming_language)).
|
||
|
||
## Overview
|
||
|
||
This role provides the essential tooling for Python developers, enabling immediate use of `python` and `pip` from the command line. It supports both general-purpose scripting and advanced software engineering workflows.
|
||
|
||
## Purpose
|
||
|
||
To simplify and standardize the provisioning of Python-ready environments for developers, students, data scientists, and automation engineers.
|
||
|
||
## Features
|
||
|
||
- **Installs Python and Pip:** Ensures the interpreter and package manager are available.
|
||
- **Prefers Python 3.11+:** Installs Python 3.11+ where available and makes it the default via `/usr/local/bin/python3` and `/usr/local/bin/pip3`.
|
||
- **Persona Integration:** Extends `dev-core` with Python-specific tools.
|
||
- **Foundation for Further Stacks:** Ideal starting point for Flask, Django, scientific computing, and automation.
|
||
|
||
Supported distro families in the installer script:
|
||
|
||
- Arch Linux
|
||
- Debian
|
||
- Ubuntu
|
||
- Fedora
|
||
- CentOS / RHEL
|
||
|
||
## Customization
|
||
|
||
Easily extend this role with:
|
||
|
||
- Python virtualenv tools (`python-virtualenv`, `pyenv`)
|
||
- Popular libraries (`numpy`, `requests`, `flask`)
|
||
- Framework-specific roles (e.g., `dev-python-django`)
|