git-ls-date
git-ls-date is git sub command shows first and last commit date.
Examples
Basic
default option is
date = short
format = “{fd} {fh} {ld} {lh} {f}”
$ git ls-date 2013-11-05 7ab1b16 2013-11-05 7ab1b16 README.rst 2013-11-07 342ad26 2013-11-10 2826492 git_ls_date.py
How long ago?
git ls-date --date relative --format "first commit is {fd: <20} | {f}"
first commit is 6 days ago | .gitignore
first commit is 3 days ago | .python-version
first commit is 3 days ago | LICENSE
first commit is 77 minutes ago | MANIFEST.in
first commit is 6 days ago | README.rst
first commit is 3 days ago | git_ls_date.py
first commit is 3 days ago | setup.py
first commit is 3 days ago | test_git_ls_date.py
first commit is 30 hours ago | testfiles/testdirectory/testfile4
first commit is 30 hours ago | testfiles/testfile1
first commit is 30 hours ago | testfiles/testfile2
first commit is 30 hours ago | testfiles/testfile3
first commit is 3 days ago | tox.ini
Only show commit hash
$ git ls-date --format="{lh} {f}
7ab1b16 README.rst
2826492 git_ls_date.py
Sort files by last commit date
$ git ls-date --date iso --format "{ld} {f}" | sort
2013-11-05 04:40:11 +0900 .gitignore
2013-11-05 04:40:11 +0900 README.rst
2013-11-07 23:22:29 +0900 setup.py
2013-11-07 23:34:59 +0900 LICENSE
2013-11-08 15:36:16 +0900 .python-version
2013-11-09 15:07:06 +0900 testfiles/testdirectory/testfile4
2013-11-09 19:11:38 +0900 testfiles/testfile2
2013-11-09 19:11:38 +0900 testfiles/testfile3
2013-11-09 21:03:55 +0900 testfiles/testfile1
2013-11-09 22:22:38 +0900 tox.ini
2013-11-10 15:32:19 +0900 test_git_ls_date.py
2013-11-10 18:28:24 +0900 git_ls_date.py
2013-11-10 19:45:40 +0900 MANIFEST.in
Requirements
Python 2.6 / 2.7 / 3.2 / 3.3 or higher
I’m testing with 2.6.8, 2.7.5, 3.2.5, 3.3.2.
Installation
Install from pypi
easy_install git-ls-date
or
pip install git-ls-date
Install from github
git clone https://github.com/ton1517/git-ls-date.git cd git-ls-date python setup.py install
Manual setup
Copy git_ls_date.py to a directory that is in your PATH.
Rename it to git-ls-date.
Change it to executable.
cd ~/bin wget https://raw.github.com/ton1517/git-ls-date/master/git_ls_date.py -O git-ls-date chmod +x git-ls-date
Usage
- Usage:
git ls-date [--date=<option>] [--format=<format>] [<path>]... git ls-date -h | --help git ls-date -v | --version
- Options:
-h --help Show help. -v --version Show version. -d --date=(relative|local|default|iso|rfc|short|raw) Date option.(default: short) -f --format=<format> Show-format option. See SHOW FORMAT.(default: "{fd} {fh} {ld} {lh} {f}")- SHOW FORMAT:
format option allows you to specify which information you want to show.
- placeholders:
{ld}: last commit date
{fd}: first commit date
{lh}: last commit hash
{fh}: first commit hash
{f}: filename
- for example:
$ git ls-date --date=local --format="{fd} {fh} {ld} {lh} {f}" ./README.rst Tue Nov 5 04:40:11 2013 7ab1b16 Tue Nov 5 04:40:11 2013 7ab1b16 README.rst
You can see more format spec to http://docs.python.org/3/library/string.html?highlight=string.format#formatspec
Gitconfig
You can write option in .gitconfig
- for example:
[git-ls-date] date = relative format = {lh} {ld: <25} {f}$ git ls-date 7ab1b16 6 days ago README.rst 2826492 2 hours ago git_ls_date.py
Metadata
Release files for git-ls-date 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| git-ls-date-0.1.1.tar.gz | 5.9 kB | Without provenance | Details |
Release files / git-ls-date-0.1.1.tar.gz
| Download URL | git-ls-date-0.1.1.tar.gz |
|---|---|
| Size | 5.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d1d09ae313a4b1162422ae7c8c628304c798aecd8232c711051a680a320b30b9
|
|
BLAKE2b-256 checksum How to use checksums |
2eb3400778d110b6b6dff3d4c1ad07a0f07765d84f3f92d879fbac3dcbcdf009
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for git-ls-date 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.