{ "info": { "author": "Niels Serup", "author_email": "ns@metanohi.org", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "Intended Audience :: End Users/Desktop", "License :: DFSG approved", "License :: OSI Approved :: GNU General Public License (GPL)", "Operating System :: OS Independent", "Operating System :: POSIX", "Operating System :: Unix", "Programming Language :: Python", "Topic :: Utilities" ], "description": "=======\nkvigall\n=======\n\nkvigall is a calendar program capable of showing calendars created\nfrom scripts that you create. If there's a site that you often check\nfor upcoming events, you can create a script that crawls and parses\nthis site. By converting your resulted data into a format\nunderstandable by kvigall, you can then view the info in a calendar.\n\nkvigall currently has two calendars:\n\n* one using curses (default)\n* one just printing to the terminal (called 'text')\n\nkvigall caches events to make loading faster and easier. This also\nmakes it possible to read events from a script that depends on a\nconnection to the internet even if there is no connection.\n\nLicense\n=======\n\nkvigall is free software under the terms of the GNU General Public\nLicense version 3 (or any later version). The author of kvigall is\nNiels Serup, contactable at ns@metanohi.org. This is version 0.1.0 of\nthe program.\n\nExternal libraries included with kvigall are GPL-compatible.\n\nInstalling\n==========\n\nWay #1\n------\nJust run this (requires that you have python-setuptools installed)::\n\n $ sudo easy_install kvigall\n\nWay #2\n------\nGet the newest version of kvigall at\nhttp://metanohi.org/projects/kvigall/ or at\nhttp://pypi.python.org/pypi/kvigall\n\nExtract the downloaded file and run this in a terminal::\n\n $ sudo python setup.py install\n\nDependencies\n============\nPython 2.5+ is probably a requirement.\n\nOptional extras\n---------------\nIf present, kvigall will use these Python modules:\n\n``qvikconfig``\n + Web address: http://pypi.python.org/pypi/qvikconfig/\n + License: GPLv3+\n + Installing: ``$ sudo easy_install qvikconfig``\n + Author: Niels Serup\n\n``termcolor``\n + Web address: http://pypi.python.org/pypi/termcolor/\n + License: GPLv3+\n + Installing: ``$ sudo easy_install termcolor``\n + Author: Konstantin Lepa \n\n``htmlentitiesdecode``\n + Web address: http://pypi.python.org/pypi/htmlentitiesdecode/\n + License: WTFPL 2.0+\n + Installing: ``$ sudo easy_install htmlentitiesdecode``\n + Author: Niels Serup\n\n(Copies of ``qvikconfig``, ``termcolor`` and ``htmlentitiesdecode``\nare included in the kvigall distribution, so you'll be fine without\ndownloading them yourselves.)\n\n``setproctitle``\n + Web address: http://pypi.python.org/pypi/setproctitle/\n + License: New BSD License\n + Installing: ``$ sudo easy_install setproctitle``\n + Author: Daniele Varrazzo \n\n\nUsing\n=====\n\nTo use kvigall after installation, run ``kvigall``. To get an\nimpression of its options, run ``kvigall --help``.\n\nkvigall works by using mods. These mods are ordinary Python\nprograms. Every mod must have a ``Connector`` class with a\n``get_kvigall_events`` function returning a list of kvigall events (by\nimporting ``Event`` from ``kvigall.various``). If you create a script\ncalled ``simple_mod.py`` and place it in your scripts directory\n($HOME/.kvigall by default), you can call it from kvigall by running\n``kvigall simple_mod``.\n\nThis distribution includes a basic ``simple_mod.py``, which can be\nused as a base when developing new mods. Other mods are available on\nthe internet; see http://metanohi.org/projects/kvigall/mods/ for a\nlist of some of the downloadable and usable mods in existence.\n\nkvigall can use config files instead of just command line options. All\nof these options can be overridden on the command line. It is possible\nto have several config files, using different ones for different\npurposes. Run ``kvigall --help`` for available config file options and\ntheir equivalent command line options. A config file might look like\nthis::\n\n default scripts = simple_mod # Using simple_mod.py\n frontend = curses:navigate # Use the default frontend, but make it\n # begin in navigate-mode instead of command-mode\n #frontend = text # I want the plain text frontend\n #styling = false # *really* plain text\n date format = '%A, %m/%d-%Y' # e.g. Friday, 08/27-2010\n start date = ++0 # If today has no events, search for an eventful date\n # in the future\n #update after = 1d # I want a longer-lasting cache\n #start date = 2010, 01, 01 # instead of today\n #start empty = true # nah, don't show anything at startup\n #verbose = false # I hate errors, don't print 'em\n #color errors = false # no colored errors\n\nYour main config file should be called \"kvigall.config\" and saved in\nthe same directory as your scripts. All text after the '#' character\nis comment-matter.\n\nBuilt-in frontends\n------------------\n\nkvigall comes with two frontends: a text-based one and a curses-based\none. To get an impression on how these frontends work, enter \"help\"\nwhen running either of them. This command will display a help message.\n\n\nDeveloping\n==========\n\nkvigall is written in Python and uses Git for branches. To get the\nlatest branch, get it from gitorious.org like this::\n\n $ git clone git://gitorious.org/kvigall/kvigall.git\n\nA number of kvigall mods can be fetched using git as well::\n\n $ git clone git://gitorious.org/kvigall/kvigall-mods.git\n\n\nThe future/TODOs\n================\n\nThis is an incomplete list of what isn't perfect yet.\n\n* The current way of saving caches is crude. It uses too many\n files and should be improved.\n* There is no support for user-created frontends. This should be\n fixed.\n\n\nThe logo\n========\nThe logo of kvigall, found in the \"logo\" directory, is available\nunder the terms of the Creative Commons Attribution-ShareAlike 3.0 (or\nany later version) Unported license. A copy of this license is\navailable at http://creativecommons.org/licenses/by-sa/3.0/\n\n\nThis document\n=============\nCopyright (C) 2010 Niels Serup\n\nCopying and distribution of this file, with or without modification,\nare permitted in any medium without royalty provided the copyright\nnotice and this notice are preserved. This file is offered as-is,\nwithout any warranty.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://metanohi.org/projects/kvigall/", "keywords": null, "license": "GPLv3+", "maintainer": null, "maintainer_email": null, "name": "kvigall", "package_url": "https://pypi.org/project/kvigall/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/kvigall/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://metanohi.org/projects/kvigall/" }, "release_url": "https://pypi.org/project/kvigall/0.1.0/", "requires_dist": null, "requires_python": null, "summary": "A customizable calendar program meant for use in terminals", "version": "0.1.0" }, "last_serial": 794029, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "87ba99900afa71b93fa0e07c77d567aa", "sha256": "9bd605e2cad378af3076cc0516dd728c144770813121475598241d69453546c6" }, "downloads": -1, "filename": "kvigall-0.1.0.tar.gz", "has_sig": false, "md5_digest": "87ba99900afa71b93fa0e07c77d567aa", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 72449, "upload_time": "2010-09-10T20:23:21", "url": "https://files.pythonhosted.org/packages/67/ed/4f7e296c008b4145e8a3cab48f127250303a999acf78839eec29f108f917/kvigall-0.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "87ba99900afa71b93fa0e07c77d567aa", "sha256": "9bd605e2cad378af3076cc0516dd728c144770813121475598241d69453546c6" }, "downloads": -1, "filename": "kvigall-0.1.0.tar.gz", "has_sig": false, "md5_digest": "87ba99900afa71b93fa0e07c77d567aa", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 72449, "upload_time": "2010-09-10T20:23:21", "url": "https://files.pythonhosted.org/packages/67/ed/4f7e296c008b4145e8a3cab48f127250303a999acf78839eec29f108f917/kvigall-0.1.0.tar.gz" } ] }