Metadata-Version: 2.3
Name: dstamp
Version: 1.0.0
Summary: CLI app for generating timestamps for use in Discord chats.
License: MIT
Keywords: discord,timestamp,generator
Author: Mariusz Tang
Author-email: dev@mariusztang.com
Requires-Python: >=3.13
Classifier: License :: OSI Approved :: MIT License
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Communications :: Chat
Classifier: Environment :: Console
Requires-Dist: clipman (>=3.3.1,<4.0.0)
Requires-Dist: pydantic (>=2.11.7,<3.0.0)
Requires-Dist: typer (>=0.16.0,<0.17.0)
Project-URL: Issues, https://github.com/mariusz-tang/dstamp/issues
Project-URL: Repository, https://github.com/mariusz-tang/dstamp
Description-Content-Type: text/markdown

# dstamp

CLI app for generating timestamps for use in Discord chats.

## Example usage

```bash
# For the current time
dstamp get

# Two hours in the future
dstamp get --offset 2h

# Round to the nearest hour
dstamp get -o 2h --round --precision h

# Copy to clipboard
dstamp --copy-to-clipboard

# Show active configuration
dstamp show-config
```

For full documentation see the help messages:

```bash
dstamp --help
dstamp get --help
dstamp show-config --help
```

## Configuration

Run `show-config` with no arguments to find the default config location:

```bash
dstamp show-config
```

The config file should be in `.toml` format. The defaults are equivalent to the
following:

```toml
copy_to_clipboard = false
output_format = "relative"
round = false
rounding_precision = "10m"
```

These settings will be in effect unless overriden by CLI options.

## Contributing

If you'd like to see something added to dstamp or if you would like to add something
yourself, please see [CONTRIBUTING](./CONTRIBUTING.md)!

Please also see the above if you have a bug to report.

