@@@@
nark
@@@@
.. CXREF:
https://docs.github.com/en/actions/monitoring-and-troubleshooting-workflows/adding-a-workflow-status-badge
.. image:: https://github.com/doblabs/nark/actions/workflows/checks-unspecial.yml/badge.svg?branch=release
:target: https://github.com/doblabs/nark/actions/workflows/checks-unspecial.yml/badge.svg?branch=release
:alt: Build Status
.. CXREF: https://app.codecov.io/github.com/doblabs/nark/settings/badge
.. image:: https://codecov.io/gh/doblabs/nark/branch/release/graph/badge.svg?token=oBc5VVKaA2
:target: https://app.codecov.io/gh/doblabs/nark
:alt: Coverage Status
.. image:: https://readthedocs.org/projects/nark/badge/?version=latest
:target: https://nark.readthedocs.io/en/latest/
:alt: Documentation Status
.. image:: https://img.shields.io/github/v/release/doblabs/nark.svg?style=flat
:target: https://github.com/doblabs/nark/releases
:alt: GitHub Release Status
.. image:: https://img.shields.io/pypi/v/nark.svg
:target: https://pypi.org/project/nark/
:alt: PyPI Release Status
.. image:: https://img.shields.io/pypi/pyversions/nark.svg
:target: https://pypi.org/project/nark/
:alt: PyPI Supported Python Versions
.. image:: https://img.shields.io/github/license/doblabs/nark.svg?style=flat
:target: https://github.com/doblabs/nark/blob/release/LICENSE
:alt: License Status
|
.. |dob| replace:: ``dob``
.. _dob: https://github.com/tallybark/dob
.. |dob-rtd| replace:: dob
.. _dob-rtd: https://dob.readthedocs.io/en/latest/
.. |dobbing| replace:: *dobbing*
.. _dobbing: https://dob.readthedocs.io/en/latest/usage.html
.. |nark| replace:: ``nark``
.. _nark: https://github.com/tallybark/nark
.. |hamster-lib| replace:: ``hamster-lib``
.. _hamster-lib: https://github.com/projecthamster/hamster-lib
.. |pip| replace:: ``pip``
.. _pip: https://pip.pypa.io/en/stable/
.. |Fact| replace:: *Fact*
.. _Fact: concepts.html
nark is a Python 3 support library for (at least one) journaling,
time tracking, and personal relationship management application(s).
nark provides an API for storing, retrieving, and reporting on time interval
data, aka timesheet or journal entries.
**NOTE:** You probably want to install a *client application*,
such as |dob-rtd|_ -- nark is usually installed automatically.
But if you want, you can install nark manually with |pip|_::
pip install nark
For other setup options, read the
`installation guide <https://nark.readthedocs.io/en/latest/installation.html>`__.
#####
Story
#####
|nark|_ is inspired by
`Hamster <https://projecthamster.wordpress.com/>`__,
the esteemed time tracking application for
`GNOME <https://en.wikipedia.org/wiki/GNOME>`__.
|nark|_ is Hamster-friendly.
`Upgrade your existing database
<https://dob.readthedocs.io/en/latest/usage.html#upgrade-hamster>`__
and start |dobbing|_ today!
|nark|_ is a fork of the latent modern |hamster-lib|_ code rewrite.
The nark developers appreciate such a wonderful starting point!
|nark|_ is simply a |Fact|_ storage and reporting API, and does not
care about the database nor the user interface.
nark does one thing -- and only one thing -- and hopefully well!
|nark|_ is developed with the goal that any Python developer -- with
a few extra minutes and a sense of adventure -- would feel comfortable
banging on it when it breaks, or adding new features where they see a
need for improvement. (But hopefully you'll find that nark just works,
and that it already does what you want!)
########
Features
########
* Designed for modern Python releases (3.6, 3.7, and 3.8).
* Naturally Unicode compatible -- spice up your notes!
* Can migrate legacy Hamster databases (and fix integrity issues, too).
* Respectable coverage (to give you comfort knowing your Facts are safe).
* Decent documentation (including a live demo with inline instruction).
* Comfortable code base (focus on the feature, not on the format).
* Free and open source -- hack away!
See how you can
`contribute
<https://nark.readthedocs.io/en/latest/contributing.html>`__
to the project.
#######
Example
#######
This is a simple nark library usage example using the Python interpreter,
showing how to create a *Fact* instance from a *Factoid* string:
.. code-block:: Bash
$ python3
>>> from nark.items import Fact
>>> factoid = '08:00 to 2019-02-16 10:00: act@cat: #tag1: Hello, nark!'
>>> fact, err = Fact.create_from_factoid(factoid, time_hint='verify_both')
>>> fact
# Fact(
# pk=None,
# deleted=False,
# split_from=None,
# _start='08:00',
# _end=datetime.datetime(2019, 2, 16, 10, 0),
# _description='Hello, nark!',
# activity=Activity(
# pk=None
# deleted=False,
# _name='act',
# category=Category(
# pk=None,
# deleted=False,
# _name='cat',
# ),
# ),
# tags=[Tag(
# pk=None,
# deleted=False,
# _name='tag1',
# )],
# )
.. image:: https://raw.githubusercontent.com/tallybark/nark/release/docs/_static/images/information-cat.png
:target: https://nark.readthedocs.io/en/latest/authors.html#information-cat
:align: center
:alt: "Information Cat"
Raw data
{
"_id": null,
"home_page": "",
"name": "nark",
"maintainer": "Tally Bark LLC",
"docs_url": null,
"requires_python": ">=3.8.1,<4.0.0",
"maintainer_email": "doblabs@tallybark.com",
"keywords": "journal,diary,timesheet,timetrack,jrnl,rednotebook,todo.txt,prjct,hamster,fact",
"author": "Landon Bouma",
"author_email": "doblabs@tallybark.com",
"download_url": "https://files.pythonhosted.org/packages/fe/31/337e63da6d3c08cec6017b25454262c4e55c67a2d0e49b28845252668f2e/nark-3.2.8.tar.gz",
"platform": null,
"description": "@@@@\nnark\n@@@@\n\n.. CXREF:\n https://docs.github.com/en/actions/monitoring-and-troubleshooting-workflows/adding-a-workflow-status-badge\n\n.. image:: https://github.com/doblabs/nark/actions/workflows/checks-unspecial.yml/badge.svg?branch=release\n :target: https://github.com/doblabs/nark/actions/workflows/checks-unspecial.yml/badge.svg?branch=release\n :alt: Build Status\n\n.. CXREF: https://app.codecov.io/github.com/doblabs/nark/settings/badge\n\n.. image:: https://codecov.io/gh/doblabs/nark/branch/release/graph/badge.svg?token=oBc5VVKaA2\n :target: https://app.codecov.io/gh/doblabs/nark\n :alt: Coverage Status\n\n.. image:: https://readthedocs.org/projects/nark/badge/?version=latest\n :target: https://nark.readthedocs.io/en/latest/\n :alt: Documentation Status\n\n.. image:: https://img.shields.io/github/v/release/doblabs/nark.svg?style=flat\n :target: https://github.com/doblabs/nark/releases\n :alt: GitHub Release Status\n\n.. image:: https://img.shields.io/pypi/v/nark.svg\n :target: https://pypi.org/project/nark/\n :alt: PyPI Release Status\n\n.. image:: https://img.shields.io/pypi/pyversions/nark.svg\n :target: https://pypi.org/project/nark/\n :alt: PyPI Supported Python Versions\n\n.. image:: https://img.shields.io/github/license/doblabs/nark.svg?style=flat\n :target: https://github.com/doblabs/nark/blob/release/LICENSE\n :alt: License Status\n\n|\n\n.. |dob| replace:: ``dob``\n.. _dob: https://github.com/tallybark/dob\n\n.. |dob-rtd| replace:: dob\n.. _dob-rtd: https://dob.readthedocs.io/en/latest/\n\n.. |dobbing| replace:: *dobbing*\n.. _dobbing: https://dob.readthedocs.io/en/latest/usage.html\n\n.. |nark| replace:: ``nark``\n.. _nark: https://github.com/tallybark/nark\n\n.. |hamster-lib| replace:: ``hamster-lib``\n.. _hamster-lib: https://github.com/projecthamster/hamster-lib\n\n.. |pip| replace:: ``pip``\n.. _pip: https://pip.pypa.io/en/stable/\n\n.. |Fact| replace:: *Fact*\n.. _Fact: concepts.html\n\nnark is a Python 3 support library for (at least one) journaling,\ntime tracking, and personal relationship management application(s).\n\nnark provides an API for storing, retrieving, and reporting on time interval\ndata, aka timesheet or journal entries.\n\n**NOTE:** You probably want to install a *client application*,\nsuch as |dob-rtd|_ -- nark is usually installed automatically.\n\nBut if you want, you can install nark manually with |pip|_::\n\n pip install nark\n\nFor other setup options, read the\n`installation guide <https://nark.readthedocs.io/en/latest/installation.html>`__.\n\n#####\nStory\n#####\n\n|nark|_ is inspired by\n`Hamster <https://projecthamster.wordpress.com/>`__,\nthe esteemed time tracking application for\n`GNOME <https://en.wikipedia.org/wiki/GNOME>`__.\n\n|nark|_ is Hamster-friendly.\n`Upgrade your existing database\n<https://dob.readthedocs.io/en/latest/usage.html#upgrade-hamster>`__\nand start |dobbing|_ today!\n\n|nark|_ is a fork of the latent modern |hamster-lib|_ code rewrite.\nThe nark developers appreciate such a wonderful starting point!\n\n|nark|_ is simply a |Fact|_ storage and reporting API, and does not\ncare about the database nor the user interface.\nnark does one thing -- and only one thing -- and hopefully well!\n\n|nark|_ is developed with the goal that any Python developer -- with\na few extra minutes and a sense of adventure -- would feel comfortable\nbanging on it when it breaks, or adding new features where they see a\nneed for improvement. (But hopefully you'll find that nark just works,\nand that it already does what you want!)\n\n########\nFeatures\n########\n\n* Designed for modern Python releases (3.6, 3.7, and 3.8).\n* Naturally Unicode compatible -- spice up your notes!\n* Can migrate legacy Hamster databases (and fix integrity issues, too).\n* Respectable coverage (to give you comfort knowing your Facts are safe).\n* Decent documentation (including a live demo with inline instruction).\n* Comfortable code base (focus on the feature, not on the format).\n* Free and open source -- hack away!\n\nSee how you can\n`contribute\n<https://nark.readthedocs.io/en/latest/contributing.html>`__\nto the project.\n\n#######\nExample\n#######\n\nThis is a simple nark library usage example using the Python interpreter,\nshowing how to create a *Fact* instance from a *Factoid* string:\n\n.. code-block:: Bash\n\n $ python3\n >>> from nark.items import Fact\n >>> factoid = '08:00 to 2019-02-16 10:00: act@cat: #tag1: Hello, nark!'\n >>> fact, err = Fact.create_from_factoid(factoid, time_hint='verify_both')\n >>> fact\n # Fact(\n # pk=None,\n # deleted=False,\n # split_from=None,\n # _start='08:00',\n # _end=datetime.datetime(2019, 2, 16, 10, 0),\n # _description='Hello, nark!',\n # activity=Activity(\n # pk=None\n # deleted=False,\n # _name='act',\n # category=Category(\n # pk=None,\n # deleted=False,\n # _name='cat',\n # ),\n # ),\n # tags=[Tag(\n # pk=None,\n # deleted=False,\n # _name='tag1',\n # )],\n # )\n\n.. image:: https://raw.githubusercontent.com/tallybark/nark/release/docs/_static/images/information-cat.png\n :target: https://nark.readthedocs.io/en/latest/authors.html#information-cat\n :align: center\n :alt: \"Information Cat\"\n\n\n",
"bugtrack_url": null,
"license": "GPLv3+",
"summary": "Back end framework for journaling and time tracking apps (like `dob`!)",
"version": "3.2.8",
"project_urls": {
"documentation": "https://nark.readthedocs.io/en/latest",
"download": "https://pypi.org/project/nark/#files",
"history": "https://github.com/doblabs/nark/blob/release/HISTORY.rst",
"homepage": "https://github.com/doblabs/nark#\ud83d\udc6e",
"issues": "https://github.com/doblabs/nark/issues"
},
"split_keywords": [
"journal",
"diary",
"timesheet",
"timetrack",
"jrnl",
"rednotebook",
"todo.txt",
"prjct",
"hamster",
"fact"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "683e6d262099c361ce57a867e1eff99edc03d869eed6c78e0645609ce5d15bc8",
"md5": "e5c01a3e0036a9e8009326795a1f5f6d",
"sha256": "630e02aa24d3c4d88a26d0348ef6150733f0a5b92e763ecab56d17cca2caca16"
},
"downloads": -1,
"filename": "nark-3.2.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e5c01a3e0036a9e8009326795a1f5f6d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8.1,<4.0.0",
"size": 184511,
"upload_time": "2023-12-29T00:17:54",
"upload_time_iso_8601": "2023-12-29T00:17:54.045685Z",
"url": "https://files.pythonhosted.org/packages/68/3e/6d262099c361ce57a867e1eff99edc03d869eed6c78e0645609ce5d15bc8/nark-3.2.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fe31337e63da6d3c08cec6017b25454262c4e55c67a2d0e49b28845252668f2e",
"md5": "1fa7120f3d2b9a2b04610397afb923bf",
"sha256": "8816a93f3208cd07954b4104b70cbf24ce80a365958763ff281e16479ddba347"
},
"downloads": -1,
"filename": "nark-3.2.8.tar.gz",
"has_sig": false,
"md5_digest": "1fa7120f3d2b9a2b04610397afb923bf",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8.1,<4.0.0",
"size": 193996,
"upload_time": "2023-12-29T00:17:55",
"upload_time_iso_8601": "2023-12-29T00:17:55.513636Z",
"url": "https://files.pythonhosted.org/packages/fe/31/337e63da6d3c08cec6017b25454262c4e55c67a2d0e49b28845252668f2e/nark-3.2.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-29 00:17:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "doblabs",
"github_project": "nark",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "nark"
}
JSON
