| Name | ephem-cli JSON |
| Version |
0.1.0
JSON |
| download |
| home_page | None |
| Summary | a minimal and configurable astrology CLI |
| upload_time | 2025-08-11 06:47:46 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.0 |
| license | None |
| keywords |
astrology
horoscope
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# ephem
**ephem** is a minimal, opinionated, and configurable horoscope CLI designed with electional astrology and premodern revivalism in mind. It aims to be a portable, terminal version of print ephemerides in widespread use among astrologers prior to personal computers and GUIs, providing a reliable offline alternative to web-based chart generators.
### Table of Contents
- [Features](#features)
- [Usage](#usage)
- [Installation](#installation)
- [Roadmap](#roadmap)
- [Contributing](#contributing)
- [License](#license)
<a name ="features"></a>
## Features
- `ephem now` shows the current chart for your location.
- `ephem asc` prints the ascendant for your location, for an efficient, scriptable clock.
- `ephem cast DATE TIME TITLE` casts a chart for a specific event, like a birth.
- `--save-config` saves default place and display settings to `ephem.ini`
- Accommodates incomplete information by defaulting to UTC noon or Null Island (0,0) for hypothetical charts.
- Default ANSI coloring following Hellenistic planetary sect along with sign-based element and modality themes.
<a name="usage"></a>
## Usage
Show chart of the moment for your location:
```sh
ephem now
```
Cast an event or birth chart:
```sh
ephem cast 1998-08-26 8:20 "Jeon Soyeon" --lat 37.49 --lng 127.0855
```
```sh
ephem cast 1993-08-16 13:05 "Debian Linux"
```
<a name="installation"></a>
## Installation
### PyPI
```sh
pip install ephem
```
### From source
Clone this repo:
```sh
git clone https://codeberg.org/sailorfe/ephem.git
```
Create a venv:
```sh
python -m venv venv
source venv/bin/activate
```
Install dependencies:
```sh
pip install -r requirements.txt
```
Install locally:
```sh
pip install .
```
<a name="roadmap"></a>
## Roadmap
- [ ] Save, list, and view chart data from a SQLite database
- [ ] Conversion from local time to UTC and vice versa
- [ ] Pseudo "wheel" text output option in the style of Astrolog
- [x] Alternate ANSI color schemes by sign triplicity or quadruplicity
- [x] Integrate shell scriptable clock from [ascendant](https://codeberg.org/sailorfe/ascendant)
- [x] `config.ini` with configparser!
- [x] Option to hide coordinates from printing.
<a name="contributing"></a>
## Contributing
This is my self-taught Python bootcamp project, so very much a work in progress as I learn. I welcome early testers and feedback but plan to keep development mostly solo for now.
<a name="license"></a>
## License
Per the original [Swiss Ephemeris C library](https://www.astro.com/swisseph/swephinfo_e.htm), this software is licensed under the AGPL.
Raw data
{
"_id": null,
"home_page": null,
"name": "ephem-cli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.0",
"maintainer_email": null,
"keywords": "astrology, horoscope",
"author": null,
"author_email": "sailorfe <sailorf@proton.me>",
"download_url": "https://files.pythonhosted.org/packages/fb/b9/3034188b214964e0f40915340dcc89464ffe27d6aaf1e4a69693eb6c631b/ephem_cli-0.1.0.tar.gz",
"platform": null,
"description": "# ephem\n\n**ephem** is a minimal, opinionated, and configurable horoscope CLI designed with electional astrology and premodern revivalism in mind. It aims to be a portable, terminal version of print ephemerides in widespread use among astrologers prior to personal computers and GUIs, providing a reliable offline alternative to web-based chart generators.\n\n### Table of Contents\n\n- [Features](#features)\n- [Usage](#usage)\n- [Installation](#installation)\n- [Roadmap](#roadmap)\n- [Contributing](#contributing)\n- [License](#license)\n\n<a name =\"features\"></a>\n## Features\n\n- `ephem now` shows the current chart for your location.\n- `ephem asc` prints the ascendant for your location, for an efficient, scriptable clock.\n- `ephem cast DATE TIME TITLE` casts a chart for a specific event, like a birth.\n- `--save-config` saves default place and display settings to `ephem.ini`\n- Accommodates incomplete information by defaulting to UTC noon or Null Island (0,0) for hypothetical charts.\n- Default ANSI coloring following Hellenistic planetary sect along with sign-based element and modality themes.\n\n<a name=\"usage\"></a>\n## Usage\n\nShow chart of the moment for your location:\n\n```sh\nephem now\n```\n\nCast an event or birth chart:\n\n```sh\nephem cast 1998-08-26 8:20 \"Jeon Soyeon\" --lat 37.49 --lng 127.0855\n```\n\n```sh\nephem cast 1993-08-16 13:05 \"Debian Linux\"\n```\n\n<a name=\"installation\"></a>\n## Installation\n\n### PyPI\n\n```sh\npip install ephem\n```\n\n### From source\nClone this repo:\n\n```sh\ngit clone https://codeberg.org/sailorfe/ephem.git\n```\n\nCreate a venv:\n\n```sh\npython -m venv venv\nsource venv/bin/activate\n```\n\nInstall dependencies:\n\n```sh\npip install -r requirements.txt\n```\n\nInstall locally:\n\n```sh\npip install .\n```\n\n<a name=\"roadmap\"></a>\n## Roadmap\n\n- [ ] Save, list, and view chart data from a SQLite database\n- [ ] Conversion from local time to UTC and vice versa\n- [ ] Pseudo \"wheel\" text output option in the style of Astrolog\n- [x] Alternate ANSI color schemes by sign triplicity or quadruplicity\n- [x] Integrate shell scriptable clock from [ascendant](https://codeberg.org/sailorfe/ascendant)\n- [x] `config.ini` with configparser!\n- [x] Option to hide coordinates from printing.\n\n<a name=\"contributing\"></a>\n## Contributing\n\nThis is my self-taught Python bootcamp project, so very much a work in progress as I learn. I welcome early testers and feedback but plan to keep development mostly solo for now.\n\n<a name=\"license\"></a>\n## License\n\nPer the original [Swiss Ephemeris C library](https://www.astro.com/swisseph/swephinfo_e.htm), this software is licensed under the AGPL.\n",
"bugtrack_url": null,
"license": null,
"summary": "a minimal and configurable astrology CLI",
"version": "0.1.0",
"project_urls": {
"Repository": "https://codeberg.org/sailorfe/ephem"
},
"split_keywords": [
"astrology",
" horoscope"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "5beab1dca2dc63d1e8e364b032fcdcd61ebdd30bf0130c315ae581ffb2510c4f",
"md5": "eac021f9d45af9e185ee122b3bfc49cf",
"sha256": "60409892a786d74626b4b13df02a4005495393928f45f6e9caaf04ec7ad1d4a4"
},
"downloads": -1,
"filename": "ephem_cli-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "eac021f9d45af9e185ee122b3bfc49cf",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.0",
"size": 25702,
"upload_time": "2025-08-11T06:47:45",
"upload_time_iso_8601": "2025-08-11T06:47:45.838669Z",
"url": "https://files.pythonhosted.org/packages/5b/ea/b1dca2dc63d1e8e364b032fcdcd61ebdd30bf0130c315ae581ffb2510c4f/ephem_cli-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "fbb93034188b214964e0f40915340dcc89464ffe27d6aaf1e4a69693eb6c631b",
"md5": "fc413be1c019003d7ccb84f2b07a1170",
"sha256": "c374b22ecd6e027d3f651f909e8a47ee0456bfe1032b534f12154474aec81ecf"
},
"downloads": -1,
"filename": "ephem_cli-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "fc413be1c019003d7ccb84f2b07a1170",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.0",
"size": 24318,
"upload_time": "2025-08-11T06:47:46",
"upload_time_iso_8601": "2025-08-11T06:47:46.863425Z",
"url": "https://files.pythonhosted.org/packages/fb/b9/3034188b214964e0f40915340dcc89464ffe27d6aaf1e4a69693eb6c631b/ephem_cli-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-11 06:47:46",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": true,
"codeberg_user": "sailorfe",
"codeberg_project": "ephem",
"lcname": "ephem-cli"
}
