============
hyperdiary
============
.. image:: https://img.shields.io/pypi/v/hyperdiary.svg
:target: https://pypi.python.org/pypi/hyperdiary
.. image:: https://github.com/luphord/hyperdiary/actions/workflows/lint-test.yml/badge.svg
:target: https://github.com/luphord/hyperdiary/actions
.. image:: https://readthedocs.org/projects/hyperdiary/badge/?version=latest
:target: https://hyperdiary.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
A command line tool for writing diaries with hyperlinks. Free software, licensed under MIT license.
Installation
------------
hyperdiary requires Python version 3.8 or later. Once you have Python and [pipx](https://pipx.pypa.io/stable/) installed on your machine (and available in your path), you can install hyperdiary by executing
.. code-block:: console
pipx install hyperdiary
Setup
-----
A project file *hyperdiary.json* is required to setup your diary. It should be of this form:
.. code-block:: json
{
"sources": [
"2024/05.yaml",
"2024/06.yaml"
],
"expected": [
{"start": "2024-05-01", "end": "2024-05-01"},
{"start": "2024-06-09", "end": "2024-06-10"}
],
"localization": {
"months": ["Jan", "Feb", "Mar", "Apr", "May", "Jun",
"Jul", "Aug", "Sep", "Oct", "Nov", "Dec"],
"date_fmt": "%-d.%-m.%Y"
}
}
You diary content itself is entered in yaml files like this (*2024/06.yaml*):
.. code-block:: yaml
2024-06-09:
- Some entry goes here with a $special_identity|link
- This entry is +surprise tagged +mytag +nexttag
- This entry contains nothing new
2024-06-10:
- Same $special_identity|link again and $New_Identity|NewIdentity
- $test +mytag
Use *$target|linktext* to create a hyperlink to *target* showing text *linktext*. Use *+mytag* to add tag *mytag*.
Usage
-----
.. code-block:: console
usage: hyperdiary [-h]
{check,stats,html,htmlfolder,hugo,tiddlers,tiddlywiki,view}
...
The hyperdiary main command line interface.
optional arguments:
-h, --help show this help message and exit
subcommands:
{check,stats,html,htmlfolder,hugo,tiddlers,tiddlywiki,view}
Available subcommands
check Check entire diary for integrity up-to-dateness
stats Calculate impressive diary statistics
html Export diary to html
htmlfolder Export diary to html in folders
hugo Export diary to hugo static site format
tiddlers Export diary to tiddlywiki tiddlers format
tiddlywiki Export diary to tiddlywiki
view View entries on command line
=======
History
=======
0.7.0 (2024-05-02)
------------------
* fix issue with tiddlywiki export (as the tiddlywiki file format has changed)
* add support for Python 3.9 - 3.12
* drop support for Python versions prior to 3.8
* upgrade dependencies and dev dependencies
* reformat code with black
* migrate to github actions
0.6.1 (2020-10-21)
------------------
* add support for Python 3.8
* upgrade to flake8 3.8.4 and fix linter issues
* replace deprecated test command
* move to travis-ci.com
0.6.0 (2019-11-29)
------------------
* promote status to alpha
* introduced localization using hyperdiary.json; date format and month names so far
* added tiddlers for month (calendar) and year overview with hyperlinks
* Diary supports iteration by year/month
* make docs work
0.5.0 (2019-11-06)
------------------
* removed EntryType, refactored iteration, primarily passing Diary instances around
* fix bug when an ID is followed by a bracket )
* only line entries are allowed, no more dicts
0.4.0 (2019-10-30)
------------------
* full type annotations added for package
* linting and type checking in CI
* EntryTypes Dict and DictLine are deprecated and will be removed in 0.5 (check issues a warning)
0.3.2 (2019-10-17)
------------------
* fix linter configuration (and activate it)
* make all hyperdiary source files PEP8 conform
* set up bumpversion config
0.3.1 (2019-07-03)
------------------
* open date ranges iterate until yesterday, not today
* fix loading hyperdiary.json without expected field
0.3.0 (2019-06-19)
------------------
* Expected date ranges for check subcommand can be specified
* subcommand for export to tiddlywiki
* Tests for various output formats
0.2.0 (2019-06-12)
------------------
* stats subcommand can be invoked for all entries
* Rename `tiddlywiki` subcommand to `tiddlers` for different future usage
* Integrate Travis CI for automated testing
* Add basic tests
* Refactor diary/entry passing to subcommands
0.1.2 (2019-06-11)
------------------
* Fix htmlfolder subcommand by packaging picnic.min.css
* Fix view subcommand by using correct relative import
* Avoid deprecation warning in stats subcommand by using yaml.SafeLoader
0.1.1 (2019-04-29)
------------------
* Fix setup
0.1.0 (2019-04-28)
------------------
* First release on PyPI
* Import from fossil
Raw data
{
"_id": null,
"home_page": "https://github.com/luphord/hyperdiary",
"name": "hyperdiary",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "hyperdiary",
"author": "luphord",
"author_email": "luphord@protonmail.com",
"download_url": "https://files.pythonhosted.org/packages/28/43/0130a7125c524e228e8835e77597e3f19cdc4b8888b4c5cac2e66e061e8f/hyperdiary-0.7.0.tar.gz",
"platform": null,
"description": "============\nhyperdiary\n============\n\n.. image:: https://img.shields.io/pypi/v/hyperdiary.svg\n :target: https://pypi.python.org/pypi/hyperdiary\n\n.. image:: https://github.com/luphord/hyperdiary/actions/workflows/lint-test.yml/badge.svg\n :target: https://github.com/luphord/hyperdiary/actions\n\n.. image:: https://readthedocs.org/projects/hyperdiary/badge/?version=latest\n :target: https://hyperdiary.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n\nA command line tool for writing diaries with hyperlinks. Free software, licensed under MIT license.\n\nInstallation\n------------\n\nhyperdiary requires Python version 3.8 or later. Once you have Python and [pipx](https://pipx.pypa.io/stable/) installed on your machine (and available in your path), you can install hyperdiary by executing\n\n.. code-block:: console\n\n pipx install hyperdiary\n\nSetup\n-----\n\nA project file *hyperdiary.json* is required to setup your diary. It should be of this form:\n\n.. code-block:: json\n\n {\n \"sources\": [\n \"2024/05.yaml\",\n \"2024/06.yaml\"\n ],\n \"expected\": [\n {\"start\": \"2024-05-01\", \"end\": \"2024-05-01\"},\n {\"start\": \"2024-06-09\", \"end\": \"2024-06-10\"}\n ],\n \"localization\": {\n \"months\": [\"Jan\", \"Feb\", \"Mar\", \"Apr\", \"May\", \"Jun\",\n \"Jul\", \"Aug\", \"Sep\", \"Oct\", \"Nov\", \"Dec\"],\n \"date_fmt\": \"%-d.%-m.%Y\"\n }\n }\n\nYou diary content itself is entered in yaml files like this (*2024/06.yaml*):\n\n.. code-block:: yaml\n\n 2024-06-09:\n - Some entry goes here with a $special_identity|link\n - This entry is +surprise tagged +mytag +nexttag\n - This entry contains nothing new\n 2024-06-10:\n - Same $special_identity|link again and $New_Identity|NewIdentity\n - $test +mytag\n\nUse *$target|linktext* to create a hyperlink to *target* showing text *linktext*. Use *+mytag* to add tag *mytag*.\n\nUsage\n-----\n\n.. code-block:: console\n\n usage: hyperdiary [-h]\n {check,stats,html,htmlfolder,hugo,tiddlers,tiddlywiki,view}\n ...\n\n The hyperdiary main command line interface.\n\n optional arguments:\n -h, --help show this help message and exit\n\n subcommands:\n {check,stats,html,htmlfolder,hugo,tiddlers,tiddlywiki,view}\n Available subcommands\n check Check entire diary for integrity up-to-dateness\n stats Calculate impressive diary statistics\n html Export diary to html\n htmlfolder Export diary to html in folders\n hugo Export diary to hugo static site format\n tiddlers Export diary to tiddlywiki tiddlers format\n tiddlywiki Export diary to tiddlywiki\n view View entries on command line\n\n=======\nHistory\n=======\n\n0.7.0 (2024-05-02)\n------------------\n* fix issue with tiddlywiki export (as the tiddlywiki file format has changed)\n* add support for Python 3.9 - 3.12\n* drop support for Python versions prior to 3.8\n* upgrade dependencies and dev dependencies\n* reformat code with black\n* migrate to github actions\n\n0.6.1 (2020-10-21)\n------------------\n\n* add support for Python 3.8\n* upgrade to flake8 3.8.4 and fix linter issues\n* replace deprecated test command\n* move to travis-ci.com\n\n0.6.0 (2019-11-29)\n------------------\n\n* promote status to alpha\n* introduced localization using hyperdiary.json; date format and month names so far\n* added tiddlers for month (calendar) and year overview with hyperlinks\n* Diary supports iteration by year/month\n* make docs work\n\n0.5.0 (2019-11-06)\n------------------\n\n* removed EntryType, refactored iteration, primarily passing Diary instances around\n* fix bug when an ID is followed by a bracket )\n* only line entries are allowed, no more dicts\n\n0.4.0 (2019-10-30)\n------------------\n\n* full type annotations added for package\n* linting and type checking in CI\n* EntryTypes Dict and DictLine are deprecated and will be removed in 0.5 (check issues a warning)\n\n0.3.2 (2019-10-17)\n------------------\n\n* fix linter configuration (and activate it)\n* make all hyperdiary source files PEP8 conform\n* set up bumpversion config\n\n0.3.1 (2019-07-03)\n------------------\n\n* open date ranges iterate until yesterday, not today\n* fix loading hyperdiary.json without expected field\n\n0.3.0 (2019-06-19)\n------------------\n\n* Expected date ranges for check subcommand can be specified\n* subcommand for export to tiddlywiki\n* Tests for various output formats\n\n0.2.0 (2019-06-12)\n------------------\n\n* stats subcommand can be invoked for all entries\n* Rename `tiddlywiki` subcommand to `tiddlers` for different future usage\n* Integrate Travis CI for automated testing\n* Add basic tests\n* Refactor diary/entry passing to subcommands\n\n0.1.2 (2019-06-11)\n------------------\n\n* Fix htmlfolder subcommand by packaging picnic.min.css\n* Fix view subcommand by using correct relative import\n* Avoid deprecation warning in stats subcommand by using yaml.SafeLoader\n\n0.1.1 (2019-04-29)\n------------------\n\n* Fix setup\n\n0.1.0 (2019-04-28)\n------------------\n\n* First release on PyPI\n* Import from fossil\n",
"bugtrack_url": null,
"license": "MIT license",
"summary": "A command line tool for my image processing needs.",
"version": "0.7.0",
"project_urls": {
"Homepage": "https://github.com/luphord/hyperdiary"
},
"split_keywords": [
"hyperdiary"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "fab20a977ff4107658ef7a529b710710246aac3deb987c1c43c72e634543c5f9",
"md5": "47c1b33690fb297e6fdabb1eff30ffb8",
"sha256": "e93bb11c32eb5b684ef92ecc019f97d10a75cfdb035ac8516b59c0996dc89736"
},
"downloads": -1,
"filename": "hyperdiary-0.7.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "47c1b33690fb297e6fdabb1eff30ffb8",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 37616,
"upload_time": "2024-05-02T20:34:18",
"upload_time_iso_8601": "2024-05-02T20:34:18.269981Z",
"url": "https://files.pythonhosted.org/packages/fa/b2/0a977ff4107658ef7a529b710710246aac3deb987c1c43c72e634543c5f9/hyperdiary-0.7.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "28430130a7125c524e228e8835e77597e3f19cdc4b8888b4c5cac2e66e061e8f",
"md5": "98b8662bb53ea7f6bf1dbefa2cc59b0d",
"sha256": "6c907c9aae29220d255589c0e31c321921355da7ebabf7f4d5f85776d8875b43"
},
"downloads": -1,
"filename": "hyperdiary-0.7.0.tar.gz",
"has_sig": false,
"md5_digest": "98b8662bb53ea7f6bf1dbefa2cc59b0d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 34462,
"upload_time": "2024-05-02T20:34:20",
"upload_time_iso_8601": "2024-05-02T20:34:20.107695Z",
"url": "https://files.pythonhosted.org/packages/28/43/0130a7125c524e228e8835e77597e3f19cdc4b8888b4c5cac2e66e061e8f/hyperdiary-0.7.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-02 20:34:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "luphord",
"github_project": "hyperdiary",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "hyperdiary"
}
JSON
