{"id":17027895,"url":"https://github.com/sobjornstad/esc","last_synced_at":"2026-05-04T03:01:55.154Z","repository":{"id":26310964,"uuid":"29758980","full_name":"sobjornstad/esc","owner":"sobjornstad","description":"friendly, extensible TUI RPN calculator","archived":false,"fork":false,"pushed_at":"2019-11-11T02:22:07.000Z","size":373,"stargazers_count":9,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-26T06:51:07.472Z","etag":null,"topics":["calculator","curses","framework","math","python","rpn","rpn-calculator"],"latest_commit_sha":null,"homepage":"https://esc-calc.readthedocs.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"clong365/inspinia-1","license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sobjornstad.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-01-23T23:54:01.000Z","updated_at":"2025-03-16T16:29:59.000Z","dependencies_parsed_at":"2022-07-27T08:18:31.566Z","dependency_job_id":null,"html_url":"https://github.com/sobjornstad/esc","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sobjornstad%2Fesc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sobjornstad%2Fesc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sobjornstad%2Fesc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sobjornstad%2Fesc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sobjornstad","download_url":"https://codeload.github.com/sobjornstad/esc/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248565063,"owners_count":21125416,"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":["calculator","curses","framework","math","python","rpn","rpn-calculator"],"created_at":"2024-10-14T07:51:09.599Z","updated_at":"2026-05-04T03:01:55.141Z","avatar_url":"https://github.com/sobjornstad.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![CI](https://github.com/sobjornstad/esc/actions/workflows/ci.yml/badge.svg)](https://github.com/sobjornstad/esc/actions/workflows/ci.yml)\n[![Documentation Status](https://readthedocs.org/projects/esc-calc/badge/?version=latest)](https://esc-calc.readthedocs.io/en/latest/?badge=latest)\n\nWhat is esc?\n============\n\n**esc** (pronounced /esk/) is an Extensible Stack-based Calculator\ndesigned for efficiency and customizability.\nWhat does this mean?\n\n* esc is *stack-based*,\n  operating using a [Reverse Polish Notation][]-like syntax.\n  Rather than typing `2 + 2` and pressing an equals key,\n  you enter the two numbers `2` and `2` onto the stack,\n  then choose `+` to add them.\n  This can be slightly awkward at first,\n  but it means no parentheses are necessary,\n  and for most people it becomes faster and more elegant\n  than the standard algebraic method\n  with a small amount of practice.\n  In addition, it is considerably easier to customize and program.\n\n* esc is *extensible*.\n  If you frequently need to\n  multiply two numbers together, add five, and then divide the result by pi,\n  you can add an operation to the calculator to do this specific operation\n  using a couple of lines of Python code.\n  The extension features are simple enough to be accessible\n  even to people who do not know Python\n  or have little to no programming experience.\n\n  esc operations are arbitrary Python code, so if you want to get fancy,\n  they can get arbitrarily complicated.\n  You can even call APIs to perform calculations or get data!\n\n* esc is *fast*, *simple*, and *terminal-based*.\n  All you need is a working terminal (at least 80×24)\n  and your keyboard.\n\n[Reverse Polish Notation]: https://en.wikipedia.org/wiki/Reverse_Polish_notation\n\n![A screenshot of esc in use, taken from the esc documentation.](https://esc-calc.readthedocs.io/en/latest/_images/register-use.png)\n\nInstallation\n============\n\nesc requires Python 3.10 or greater.\nIt is lightweight and has no dependencies outside the standard library\n(except on Windows, where ``ncurses`` isn't available by default\nand the ``windows-curses`` package is transparently installed to fix that).\nThe recommended installation method is through pip:\n\n    $ pip install --user esc-calc\n\nThis will install an `esc` command to your system path which will launch esc.\n\nAfter installing esc, you may wish to install plugins\n(see the \"Plugins\" section in the [user guide](#documentation)).\nOfficial plugins can be downloaded\nfrom the `esc-plugins` folder of this repository.\n\n\nDevelopment\n-----------\n\nFor development, clone this repository and use [uv](https://docs.astral.sh/uv/):\n\n    $ git clone https://github.com/sobjornstad/esc\n    $ cd esc\n    $ uv sync --group dev --group test --group docs\n    $ uv run esc\n\n\nDocumentation\n=============\n\nThe user manual and API documentation on writing plugins for esc\nare maintained on [Read The Docs][].\n\n[Read The Docs]: https://esc-calc.readthedocs.io\n\n\nAI\n==\n\nI use AI agents to develop and maintain esc,\nbut I maintain a working understanding of and responsibility for the codebase.\n(At this time, most of the codebase was developed before AI agents existed,\nso AI contributions are fairly minimal and mostly limited to the new features in esc 1.1.0.)\n\n\nContributing\n============\n\nBug reports, suggestions, and code contributions are welcome.\n\nIn particular,\nif you write a plugin that might be useful to someone else,\nplease consider submitting it for inclusion\nin the official `esc-plugins` directory.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsobjornstad%2Fesc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsobjornstad%2Fesc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsobjornstad%2Fesc/lists"}