# hauntsaninja/pyp

Easily run Python at the shell! Magical, but never mysterious.

Repository: https://github.com/hauntsaninja/pyp
Canonical: https://ross.abutalabs.com/products/pyp
Language: Python
License: MIT
License Family: permissive
Topics: python, shell, awk, cli, command-line
Last push: 2026-01-04T22:43:42+00:00

## Health v2 (maintenance only)
Score: 50/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 60, release rhythm 8, longevity 100
- inputs: {"age_days": 2333, "days_push": 241, "days_rel": 615, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1529, forks 46 (observed 2026-08-28T04:04:58.774507+00:00)

## What it is
pyp is a command-line tool that lets you run Python one-liners in the shell, replacing common utilities like awk, sed, cut, and jq. It statically analyzes your code to detect undefined variables and transforms the AST to automatically handle input lines, imports, and printing.

## Use cases
- process each line of shell input with python
- replace awk with python one-liners
- parse  from curl in the shell
- filter lines with python regex
- sum numbers from stdin with python
- add line numbers to file output
- run python snippets in shell pipelines

## When to choose
- you want python's expressiveness in shell pipelines instead of awk/sed
- you need quick one-off text or  transformations at the command line
- you want automatic imports and printing without boilerplate

## When to avoid
- you need maximum performance for large data processing jobs
- your team only knows shell scripting and not python
- you need a full scripting environment rather than one-liners

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, developer-tools, parser, interpreter
- domain: developer-tools
- platform: cli, windows, cross-platform, python
- tags: shell-scripting, python-one-liners, awk-replacement, sed-replacement, pipe-processing, ast-transformation, command-line, automation, linux, macos

## Member repositories
- hauntsaninja/pyp (main) score 50

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:58.774507+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:31:28.115105+00:00, confidence not recorded.
  - readme: https://github.com/hauntsaninja/pyp (fetched 2026-08-28T04:04:58.774507+00:00, sha 0b3fffca8d15)
- Data as of 2026-08-30T08:39:29.467469+00:00.
