{"id":17609882,"url":"https://github.com/emmiegit/days-until","last_synced_at":"2025-10-06T01:43:21.455Z","repository":{"id":144515751,"uuid":"47386412","full_name":"emmiegit/days-until","owner":"emmiegit","description":"A CLI program to give you the number of days until or since certain events.","archived":false,"fork":false,"pushed_at":"2016-09-18T23:57:45.000Z","size":20,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-05T01:26:44.281Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://gitlab.com/ammongit/days-until","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/emmiegit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-12-04T06:39:01.000Z","updated_at":"2021-01-13T19:48:14.000Z","dependencies_parsed_at":null,"dependency_job_id":"b1bf1bde-a298-4df9-af1c-b010caaa4aed","html_url":"https://github.com/emmiegit/days-until","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emmiegit%2Fdays-until","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emmiegit%2Fdays-until/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emmiegit%2Fdays-until/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emmiegit%2Fdays-until/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/emmiegit","download_url":"https://codeload.github.com/emmiegit/days-until/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246258863,"owners_count":20748573,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-22T17:10:28.163Z","updated_at":"2025-10-06T01:43:16.432Z","avatar_url":"https://github.com/emmiegit.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# days-until\nA CLI program to give you the number of days until or since certain events.\n\nThis program reads one or more files and lists all events in the file by the number of days until (or since) the specified the event. The order of entries in the file does not matter, as the program will internally order all events by when they occurred/will occur.\n\n### Usage\n```\nusage: days_until.py [-h] [-d DELTA] [-D RDELTA] [-r] [-n] [-N]\n                     [-t [{none,simple,categories,both}]] [-c] [-T] [-C]\n                     input-file [input-file ...]\n\nList events by days since/until they happen(ed).\n\npositional arguments:\n  input-file            Specify input file(s).\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -d DELTA, --delta DELTA\n                        Only print events whose days since/until is less than\n                        this argument. (0 for no limits)\n  -D RDELTA, --reverse-delta RDELTA\n                        Only print events whose days since/until is greater\n                        than or equal to this argument. (default is 0)\n  -r, --reverse         Print the events in reverse order.\n  -n, --nopast          Don't print any events that have already happened.\n  -N, --nofuture        Don't print any events that haven't happened yet.\n  -t [{none,simple,categories,both}], --totals-style [{none,simple,categories,both}]\n                        Specify how you want days_until.py to print event\n                        totals. (default is 'none')\n  -c, --total-only      Print only the event totals; do not print any events.\n  -T, --total-all       When displaying totals, print them for all events in\n                        all files, not just the ones that were printed.\n  -C, --commas          Add commas whenever printing numbers.\n```\n\nThe different choices available for `-t` are explained below:\n  * none       - Do not print an event count. This is the default behavior.\n  * simple     - Print one number that denotes the total number of events printed by the program.\n  * categories - Print two numbers: one for the number of past events printed and another for future ones.\n  * both       - Use both the 'simple' and 'categories' options.\n\nHere are some examples:\n* `python days_until.py -` will take standard input and print all events found.\n* `python days_until.py file1 file2` will print all events in both `file1` and `file2`.\n* `python days_until.py -nd 30` will print all events that are going to happen within 30 days.\n* `python days_until.py -Nr` will print all past events from most to least recent.\n* `python days_until.py -Nd 365` will print all events that happened at least a year ago.\n* `python days_until.py -n -d 7 -D 14` will print all events that are going to happen next week.\n\n### Installation\nIf you want this program somewhere on your `$PATH`, create a copy of the binary to a suitable location, such as `/usr/local/bin`.\n\nTo do so, in the top-level directory of this repo, invoke `make install`. Be sure you sufficient privileges to install the file.\n\n### Event List File Format\nAll entries in the input file must be in the exact form `[3-Month] [2-Day] [4-Year] [Event name or description].` As an example, the following would be an appropriately-formatted event: `Jan 01 2000 Y2K happens`.\n\nThe entries must be *exactly* in the specified format, and even minor deviations will not be recognized by the program. For example, the following, while similar, are invalid:\n* `January 01 2000 Y2K`\n* `Jan 1 2000 Y2K`\n* `Jan 01 00 Y2K`\n* `01 01 2000 Y2K`\n\nYou may also specify recurring events like Christmas by replacing the 'year' field with dashes. For example:\n* `Dec 25 ---- Christmas Day`\n* `Feb 14 ---- Valentine's Day`\n\u003cbr\u003e Like noted above, the format is very strict, so the year field must contain exactly four dashes.\n\n*Why is the format so unforgiving?* \u003cbr\u003e\nBecause I'm using `datetime.strptime`, which takes formatted time in a certain format. Also, this way it looks nicer if you view your `eventlist.txt` with a monospaced font.\n\n### Known Issues\n* Events that occurred before 1 AD or after 9999 AD will not be accepted.\n* The program does not accept passsing `--` as a flag to specify the end of command-line arguments.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femmiegit%2Fdays-until","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Femmiegit%2Fdays-until","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femmiegit%2Fdays-until/lists"}