Skip to main content

touch

A lightweight implementation of the Unix touch command for Windows, written in Python.

touch creates a file if it does not exist. If the file already exists, its timestamp is updated without modifying its contents.

Features

  • Create files from the command line
  • Update timestamps of existing files
  • Touch multiple files in a single command
  • Support file and directory paths
  • Continue processing remaining paths if one operation fails
  • Return a non-zero exit code when an operation fails
  • No runtime dependencies

Usage

Touch a single file:

touch hello.txt

Touch multiple files:

touch one.txt two.txt three.txt

Paths containing spaces can be quoted:

touch "hello world.txt"

Existing files are not overwritten. Their timestamps are updated instead.

Installation

Installation instructions will be added when the package is published to PyPI.

Development

This project uses uv for Python project and dependency management.

Clone the repository and run the command locally with:

uv run touch hello.txt

Run the help command with:

uv run touch --help

Requirements

  • Windows
  • Python 3.14 or later

Status

touch is currently in early development.

Version 0.1.0 implements the core touch functionality. Additional Unix touch options will be added in future versions.

Release files for touch 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for touch 0.1.0
File Size Uploaded
touch-0.1.0.tar.gz 1.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for touch 0.1.0
File Interpreter ABI Platform
touch-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 4.3 kB

Release files / touch-0.1.0.tar.gz

Download URL touch-0.1.0.tar.gz
Size 1.7 kB
Tags Source
SHA-256 checksum
How to use checksums
cfe5c8828bd3667e2a2aa853d871bf16db29421f07cba2ef46b55d464145000d
BLAKE2b-256 checksum
How to use checksums
6747e01c9ce1cd7544ba5f98e341ff63766ac732ad01d9a1ec3e862bfedf4628
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / touch-0.1.0-py3-none-any.whl

Download URL touch-0.1.0-py3-none-any.whl
Size 2.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0b0a3a8a37cfc0f3396f597ded0e767d97e2fa5c4f6619e45148658e0e3e4007
BLAKE2b-256 checksum
How to use checksums
a223e9293d37bca5fd075e76e4eace377ca228252548d2f8c8b67e62c3b1a349
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page