The Scriptage field guide

Your first useful automation

Go from a downloaded script to a result you understand.

Choose one small task

Pick something you can check: count files in a folder, clean a short text file, or summarize a sample CSV. Read the language, requirements, and “What this script changes” note before downloading.

For a first run, choose a beginner Python recipe with no additional packages and included sample files.

Make a small workspace

Create a folder for the project. Download its ZIP and extract all of it there. Keep the README, script, and sample files together. Open a terminal in that folder so relative input paths point to the supplied examples.

Check your runtime

A runtime is the program that reads the script. For Python examples use Python 3.12 or later. Check with python --version or python3 --version. PowerShell recipes use PowerShell 7 unless stated otherwise. Bash recipes need the tools listed on their own pages.

Run the exact example

Copy the command from the recipe. Start with its supplied sample input. A command such as python example.py --input sample.csv --output result.csv means: use Python to run example.py, read sample.csv, and create result.csv. Use the actual filename and flags from your chosen guide.

Inspect the result

Compare your output with “What to expect.” Open generated text or CSV files and check a few rows manually. An empty report can be correct when a script is looking for issues and finds none. When a report already exists, use a different output name.

Change one thing

Try a new threshold, a different sample row, or another output filename. Predict what should change, run the script, and compare. Write down which setting controls the behavior. That is the beginning of learning to program through a useful project.

Put it into practice

Choose one small task from the library, run its example, and change one thing you understand.

Find a beginner script ↗