Grascii
#######
About the Project
*****************
Grascii is a language used to represent Gregg Shorthand forms using the ASCII
character set (characters found on a standard keyboard). The Grascii Project,
also referred to as Grascii, encompasses the set of tools and resources
accompanying the language that facilitate the reading, writing, and study of
Gregg Shorthand at all levels.
Useful Links
************
- `Full Documentation (readthedocs) <https://grascii.readthedocs.io>`_
- `Additional Dictionaries <https://github.com/grascii/dictionaries>`_
- `grascii on HuggingFace <https://huggingface.co/grascii>`_
- `Grascii Search Space (web interface for Grascii Search) <https://huggingface.co/spaces/grascii/search>`_
- `grascii-gui (local graphical interface for Grascii Search) <https://github.com/grascii/gui>`_
Made With
*********
- Python 3
Getting Started
***************
Prerequisites
=============
- Python 3.9+
Installation
============
Install the package::
$ python -m pip install grascii[interactive]
Note: We recommend the interactive extra for the majority of users. You may
omit the interactive extra when using the package as a library to reduce
dependencies. Also see `Grascii Search Space
<https://huggingface.co/spaces/grascii/search>`_ or `grascii-gui
<https://github.com/grascii/gui>`_ for graphical Grascii Search interfaces.
Verify the installation::
$ grascii --help
If the command fails, your PATH may not contain the location of Python scripts.
You can also try::
$ python -m grascii --help
Grascii Language
****************
The Grascii Language aims to be straightforward for those who are familiar with
Gregg Shorthand. That is, Grascii represents most strokes with the letters that
match their sounds. For example, the word ``Cross`` is written as ``KROS``.
For a more detailed overview of the language, see `language
<https://grascii.readthedocs.io/en/latest/language.html>`_.
Grascii Search
**************
Grascii Search is the headline tool of the Grascii Project. It provides many
useful options for searching Grascii Dictionaries (reverse Gregg Shorthand
dictionaries).
Motivation
==========
The existence of shorthand dictionaries have aided the conversion of longhand
to shorthand. However, the reverse has remained a challenge since the
inception of Gregg Shorthand. Grascii Search solves this problem by allowing
users to identify the longhand corresponding to a shorthand form by performing
a search based on its Grascii representation.
Basic Usage
===========
Ex.::
$ grascii search -g AB
AB About
A|B Agreeable
Results: 2
Uncertainty
===========
Occassionally, a stroke is mistaken for one of similar form. Thus, Grascii
Search provides levels of uncertainty.
Ex.::
$ grascii search -g FND -u1
FND Found
FND Fund
FTH Forth
FTH Further
SND Sound
Results: 5
The ND stroke could also be an under TH or an MT/MD. The search accounts for
these possibilities with Forth and Further. F is also close to S or V,
resulting in Sound.
Interactive Mode
================
For repeated usage, we recommend running Grascii Search in interactive mode.
For more complex queries, interactive mode removes the need of using escape
sequences on the command line.
::
$ grascii search -i
Note: Requires the interactive extra
More Options
============
For more options, see `search <https://grascii.readthedocs.io/en/latest/gsearch.html>`_.
Grascii Dictionary
******************
Grascii comes with dictionaries based on the 1916 Gregg Shorthand Dictionary
and the 1924 Gregg Shorthand Phrase Book.
More dictionaries for other versions of Gregg and dictionaries including
additional entries are available for installation at the `Grascii Dictionaries repository
<https://github.com/grascii/dictionaries>`_.
You can also write, build, and install your own custom dictionaries.
For more information, see `dictionary <https://grascii.readthedocs.io/en/latest/dictionary.html>`_.
Grascii Dephrase
****************
Grascii also includes a phrase parsing tool.
It attempts to give the phrase for the most common phrase constructions in
Gregg Shorthand and provide suggestions for never before seen phrases::
$ grascii dephrase AVNBA
I HAVE NOT BEEN ABLE
For more examples and usage, see `dephrase <https://grascii.readthedocs.io/en/latest/dephrase.html>`_.
Documentation
*************
Documentation is available on `Read the Docs <https://grascii.readthedocs.io>`_.
Contributing
************
Contributions of any kind are welcome and appreciated. You can contribute by:
- Reporting bugs or unexpected behavior
- Fixing bugs and solving issues
- Helping implement new features
- Editing documentation for correctness, completeness, and clarity
- Sharing thoughts and suggestions to improve the Grascii Language
Dictionary
==========
If you find an error in any of the dictionaries, please open an issue or pull
request at the `dictionaries repository <https://github.com/grascii/dictionaries>`_.
Contributions to the dictionaries repository are also welcome to correct errors
and create more dictionaries.
License
*******
This project is under the `MIT License <https://github.com/grascii/grascii/blob/master/LICENSE>`_.
Raw data
{
"_id": null,
"home_page": "https://github.com/grascii/grascii",
"name": "grascii",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "shorthand, gregg shorthand, dictionary",
"author": "Chanic Panic",
"author_email": "dev@chanicpanic.com",
"download_url": "https://files.pythonhosted.org/packages/18/21/18e3db2c4c1d507c3894880eb5ffa38fbd1e64bd245cdf1c46783e7fee5e/grascii-0.7.0.tar.gz",
"platform": "any",
"description": "\nGrascii\n#######\n\nAbout the Project\n*****************\n\nGrascii is a language used to represent Gregg Shorthand forms using the ASCII\ncharacter set (characters found on a standard keyboard). The Grascii Project,\nalso referred to as Grascii, encompasses the set of tools and resources\naccompanying the language that facilitate the reading, writing, and study of\nGregg Shorthand at all levels.\n\nUseful Links\n************\n\n- `Full Documentation (readthedocs) <https://grascii.readthedocs.io>`_\n- `Additional Dictionaries <https://github.com/grascii/dictionaries>`_\n- `grascii on HuggingFace <https://huggingface.co/grascii>`_\n- `Grascii Search Space (web interface for Grascii Search) <https://huggingface.co/spaces/grascii/search>`_\n- `grascii-gui (local graphical interface for Grascii Search) <https://github.com/grascii/gui>`_\n\nMade With\n*********\n- Python 3\n\nGetting Started\n***************\n\nPrerequisites\n=============\n\n- Python 3.9+\n\nInstallation\n============\n\nInstall the package::\n\n $ python -m pip install grascii[interactive]\n\nNote: We recommend the interactive extra for the majority of users. You may\nomit the interactive extra when using the package as a library to reduce\ndependencies. Also see `Grascii Search Space\n<https://huggingface.co/spaces/grascii/search>`_ or `grascii-gui\n<https://github.com/grascii/gui>`_ for graphical Grascii Search interfaces.\n\n\nVerify the installation::\n\n $ grascii --help\n\nIf the command fails, your PATH may not contain the location of Python scripts.\n\nYou can also try::\n\n $ python -m grascii --help\n\nGrascii Language\n****************\n\nThe Grascii Language aims to be straightforward for those who are familiar with\nGregg Shorthand. That is, Grascii represents most strokes with the letters that\nmatch their sounds. For example, the word ``Cross`` is written as ``KROS``.\n\nFor a more detailed overview of the language, see `language\n<https://grascii.readthedocs.io/en/latest/language.html>`_.\n\nGrascii Search\n**************\n\nGrascii Search is the headline tool of the Grascii Project. It provides many\nuseful options for searching Grascii Dictionaries (reverse Gregg Shorthand\ndictionaries).\n\nMotivation\n==========\n\nThe existence of shorthand dictionaries have aided the conversion of longhand\nto shorthand. However, the reverse has remained a challenge since the\ninception of Gregg Shorthand. Grascii Search solves this problem by allowing\nusers to identify the longhand corresponding to a shorthand form by performing\na search based on its Grascii representation.\n\nBasic Usage\n===========\n\nEx.::\n\n $ grascii search -g AB\n AB About\n A|B Agreeable\n Results: 2\n\nUncertainty\n===========\n\nOccassionally, a stroke is mistaken for one of similar form. Thus, Grascii\nSearch provides levels of uncertainty.\n\nEx.::\n\n $ grascii search -g FND -u1\n FND Found\n FND Fund\n FTH Forth\n FTH Further\n SND Sound\n Results: 5\n\nThe ND stroke could also be an under TH or an MT/MD. The search accounts for\nthese possibilities with Forth and Further. F is also close to S or V,\nresulting in Sound.\n\nInteractive Mode\n================\n\nFor repeated usage, we recommend running Grascii Search in interactive mode.\nFor more complex queries, interactive mode removes the need of using escape\nsequences on the command line.\n\n::\n\n $ grascii search -i\n\nNote: Requires the interactive extra\n\nMore Options\n============\n\nFor more options, see `search <https://grascii.readthedocs.io/en/latest/gsearch.html>`_.\n\nGrascii Dictionary\n******************\n\nGrascii comes with dictionaries based on the 1916 Gregg Shorthand Dictionary\nand the 1924 Gregg Shorthand Phrase Book.\n\nMore dictionaries for other versions of Gregg and dictionaries including\nadditional entries are available for installation at the `Grascii Dictionaries repository\n<https://github.com/grascii/dictionaries>`_.\n\nYou can also write, build, and install your own custom dictionaries.\n\nFor more information, see `dictionary <https://grascii.readthedocs.io/en/latest/dictionary.html>`_.\n\nGrascii Dephrase\n****************\n\nGrascii also includes a phrase parsing tool.\n\nIt attempts to give the phrase for the most common phrase constructions in\nGregg Shorthand and provide suggestions for never before seen phrases::\n\n $ grascii dephrase AVNBA\n I HAVE NOT BEEN ABLE\n\nFor more examples and usage, see `dephrase <https://grascii.readthedocs.io/en/latest/dephrase.html>`_.\n\nDocumentation\n*************\n\nDocumentation is available on `Read the Docs <https://grascii.readthedocs.io>`_.\n\nContributing\n************\n\nContributions of any kind are welcome and appreciated. You can contribute by:\n\n- Reporting bugs or unexpected behavior\n- Fixing bugs and solving issues\n- Helping implement new features\n- Editing documentation for correctness, completeness, and clarity\n- Sharing thoughts and suggestions to improve the Grascii Language\n\nDictionary\n==========\n\nIf you find an error in any of the dictionaries, please open an issue or pull\nrequest at the `dictionaries repository <https://github.com/grascii/dictionaries>`_.\n\nContributions to the dictionaries repository are also welcome to correct errors\nand create more dictionaries.\n\nLicense\n*******\n\nThis project is under the `MIT License <https://github.com/grascii/grascii/blob/master/LICENSE>`_.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A language with tools to facilitate the study of Gregg Shorthand.",
"version": "0.7.0",
"project_urls": {
"Homepage": "https://github.com/grascii/grascii"
},
"split_keywords": [
"shorthand",
" gregg shorthand",
" dictionary"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "b113308804cc0908591dfbd6acc0c4d75333a4dc433c30c63330d9a22440c8be",
"md5": "de8df52a42ceb6c158de753575767fa5",
"sha256": "3716fe2d3b90e1d9459a19c4dd018e85c17c801d725708a6ffca5d03a2aafc97"
},
"downloads": -1,
"filename": "grascii-0.7.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "de8df52a42ceb6c158de753575767fa5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 184935,
"upload_time": "2025-07-12T23:16:40",
"upload_time_iso_8601": "2025-07-12T23:16:40.170270Z",
"url": "https://files.pythonhosted.org/packages/b1/13/308804cc0908591dfbd6acc0c4d75333a4dc433c30c63330d9a22440c8be/grascii-0.7.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "182118e3db2c4c1d507c3894880eb5ffa38fbd1e64bd245cdf1c46783e7fee5e",
"md5": "72c3cb86e2ab822d2c25c9e6968c7bd3",
"sha256": "912e0bd20003f73f11ed845c1ff258f15882382bdc27d67a5312adf87e0ebd10"
},
"downloads": -1,
"filename": "grascii-0.7.0.tar.gz",
"has_sig": false,
"md5_digest": "72c3cb86e2ab822d2c25c9e6968c7bd3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 325137,
"upload_time": "2025-07-12T23:16:41",
"upload_time_iso_8601": "2025-07-12T23:16:41.460724Z",
"url": "https://files.pythonhosted.org/packages/18/21/18e3db2c4c1d507c3894880eb5ffa38fbd1e64bd245cdf1c46783e7fee5e/grascii-0.7.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-12 23:16:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "grascii",
"github_project": "grascii",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "grascii"
}
JSON
