{"id":13557331,"url":"https://github.com/chubin/pyphoon","last_synced_at":"2025-04-08T09:10:41.320Z","repository":{"id":44058034,"uuid":"53212116","full_name":"chubin/pyphoon","owner":"chubin","description":":waning_gibbous_moon:  ASCII Art Phase of the Moon (Python version)","archived":false,"fork":false,"pushed_at":"2023-10-09T17:38:18.000Z","size":108,"stargazers_count":1379,"open_issues_count":11,"forks_count":95,"subscribers_count":32,"default_branch":"master","last_synced_at":"2025-04-01T08:36:51.914Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://wttr.in/Moon","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chubin.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":"2016-03-05T16:54:27.000Z","updated_at":"2025-03-30T23:12:51.000Z","dependencies_parsed_at":"2024-10-14T10:21:53.962Z","dependency_job_id":null,"html_url":"https://github.com/chubin/pyphoon","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/chubin%2Fpyphoon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chubin%2Fpyphoon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chubin%2Fpyphoon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chubin%2Fpyphoon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chubin","download_url":"https://codeload.github.com/chubin/pyphoon/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247809964,"owners_count":20999816,"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-08-01T12:04:17.091Z","updated_at":"2025-04-08T09:10:41.293Z","avatar_url":"https://github.com/chubin.png","language":"Python","readme":"[![pyphoon](https://snapcraft.io/pyphoon/badge.svg)](https://snapcraft.io/pyphoon)\n\n\n# pyphoon\nASCII Art Phase of the Moon (Python version)\n\n![Screenshots](http://igor.chub.in/pyphoon/screenshot.png)\n\nBased on the original version of Jef Poskanzer \u003cjef@mail.acme.com\u003e (Twitter: @jef_poskanzer) \nwritten in Pascal in 1979 (and later translated by himself into C, and now by me into Python).\n\n# Installation via snap\n\n~~~\n$ sudo snap install pyphoon --edge\n\n~~~\n\n# Usage\n\n~~~~\n$ pyphoon --help\nusage: pyphoon [-h] [-n LINES] [-x] [-l [LANGUAGE]]\n               [-s {north,south} | -S {north,south}]\n               [date]\n\nShow Phase of the Moon\n\npositional arguments:\n  date                  Date for that the phase of the Moon must be shown.\n                        Today by default\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -n LINES, --lines LINES\n                        Number of lines to display (size of the moon)\n  -x, --notext          Print no additional information, just the moon\n  -l [LANGUAGE], --language [LANGUAGE]\n                        locale for that the phase of the Moon must be shown.\n                        English by default\n  -s {north,south}, --hemisphere {north,south}\n                        Earth hemisphere from which to observe the Moon. North \n\t\t\t\t\t\tby default\n  -S {north,south}, --hemispherewarning {north,south}\n                        The same as -s and --hemisphere, but shows an\n                        hemisphere reminder under the phase text.\n~~~~\n\nBy default the number of lines is 30 and the date is today.\n\nPyphoon only displays the [near side](https://en.wikipedia.org/wiki/Near_side_of_the_Moon) of the Moon\nbecause the [far side](https://en.wikipedia.org/wiki/Far_side_of_the_Moon) is never visible from Earth.\nThis said, the near side either shows North pole up\n(for people living in northern Earth hemisphere)\nor South pole up\n(for people living in southern Earth hemisphere).\nThis in turn changes the direction of the observable crescent:\n*e.g.* 🌒 or 🌘 for the first quarter.\nTo accomodate this, pyphoon draws the moon as seen from either hemisphere on request,\ndefaulting to `-s north`ern hemisphere.\nIf you happen to live in equatorial zones,\nthen the Moon shows either pole up\ndepending on [how you rotate your feet](https://www.unicode.org/L2/L2017/17304-moon-var.pdf),\nso you only need to pick the one you like most. \n\nSupported dateformats:\n\n* 2016-Mar-01\n* 2016-03-01\n* 03-01-2016\n* 03/01/2016\n* etc.\n\nDisplayed information:\n\n* time after the previous state (-)\n* time to the next state (+)\n* Hemisphere from which the moon is observed (with `-S` switch on).\n\n# Own changes\n\nThere are several changes in PyPhoon that were not present in the original Jef Pokazner's version of 1979:\n\n* Localization: pyphoon is translated into many languages; language is configured using the system locale (`$LANG`)\n* Hemisphere: pyphoon can show the moon as seen from the north or south hemisphere (south hemisphere is upside-down, waxes and wanes in the opposite direction).\n\n# Dependencies\n\n* dateutil\n\n# Installation\n\n**Latest version:**\n\n`pip install git+https://github.com/chubin/pyphoon.git`. \n\nAppend `--upgrade` if you have an older version.\n\n\n**Longer way:**\n\nAssuming that **git**, **python** and **pip** are already installed,\ninstall pyphoon with the following commands in your O.S. terminal (bash, command prompt, powershell, etc):\n\n```\ngit clone https://github.com/chubin/pyphoon\ncd pyphoon\npip install -r requirements.txt\npython setup.py install\n```\n\n\n\nafter that you can simply call `pyphoon` from your terminal.\n\nIf you don't have git installed to use `git clone`, it's possible to [download](https://github.com/chubin/pyphoon/archive/master.zip) this repository and unzip it instead.\n\nDepending on your O.S. it may be needed to prepend `sudo` to `python setup.py install`, \nor even change `python` to `python3` and `pip` to `pip3`. \n","funding_links":[],"categories":["Python","others"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchubin%2Fpyphoon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchubin%2Fpyphoon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchubin%2Fpyphoon/lists"}