{ "info": { "author": "Doug Hellmann", "author_email": "doug.hellmann@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Console", "Intended Audience :: End Users/Desktop", "License :: OSI Approved :: BSD License", "Operating System :: MacOS :: MacOS X", "Programming Language :: Python", "Topic :: Communications", "Topic :: Office/Business", "Topic :: Office/Business :: Scheduling" ], "description": "==========\n ical2org\n==========\n\nical2org is a command line tool for exporting data from the Mac OS X\napplication iCal so it can be used with the emacs tool `org-mode`_.\nData transfer is one-way only (from iCal to emacs), and is intended to\nbe used to show alarms and scheduled events managed by iCal within\norg's agenda view.\n\nInstallation\n============\n\nical2org is distributed as a set of `Python`_ source files, and\nrequires that Python already be installed. The source distribution is\ncreated using `Distribute`_, which will be installed with ical2org.\n\nQuick Install\n-------------\n\nUse normal Python application steps to install ical2org::\n\n $ pip install ical2org\n\nor::\n\n $ easy_install ical2org\n\nThe other dependencies (`pytz`_ and `vobject`_) will be installed\nautomatically.\n\nFrom Source\n-----------\n\n1. Download and install the dependencies.\n\n * `pytz`_\n * `vobject`_\n\n2. Download the latest release tarball from the `project home page\n `_.\n\n3. Unpack the files::\n\n $ tar zxvf ical2org-VERSION.tar.gz\n\n4. Run the installation script::\n\n $ cd ical2org-VERSION\n $ python setup.py install\n\n .. note:: Some systems may require super-user privileges to install.\n\n\nGenerating org-mode Files\n=========================\n\nWhile ical2org supports multiple output formats, the default is an\norg-mode outline. Each calendar entry includes the summary, location,\ndate and time, and complete description (useful for searching).\n\nFor example, to extract the entries from a calendar called \"Meetup:\nPython\", you would run::\n\n $ ical2org \"Meetup: Python\"\n Starting 14 days ago at 2010-01-03 00:00:00-05:00\n Ending 30 days from now at 2010-02-17 00:00:00-05:00\n Processing: Meetup: Python\n Python Atlanta February Meetup\n # -*- coding: utf-8 -*-\n * Meetup: Python\t:clubs:\n :CATEGORY: Personal\n ** Python Atlanta February Meetup\n <2010-02-11 Thu 19:30-21:30>\n - PyAtl: Atlanta Python Programmers\n \n After an optional 6pm dinner at Figo Pasta at the corner of\n Howell Mill Road and Huff Road, we will meet as usual in the\n spacious and comfortable auditorium of the GTRI Food\n Processing Building at 7:30pm for our monthly meeting.\n \n Topics for this meeting:\n \n Brandon Rhodes will give his PyCon talk: \"Learning Hosting\n Best-Practices From WebFaction\"\n \n Atlanta, GA 30318 - USA\n \n Thursday, February 11 at 7:30 PM\n \n Photo: http://photos2.meetupstatic.com/photos/event/4/7/3/5/event_5238229.jpeg\n \n Attending: 3\n \n Details: http://www.meetup.com/python-atlanta/calendar/12325308/\n\nOutput is encoded as UTF-8, which may not work with Unix pipes and\nshell redirection. To save the output to a file instead of having it\nprinted to standard output, use the ``-o`` option.\n\nBy default, ical2org processes all of the calendars which are\ndisplayed in iCal. Hidden calendars are ignored unless you give their\nname on the command line.\n\nGenerating Diary Files\n======================\n\nThe default output format uses org's outline structure. If you would\nrather use emacs' diary-mode, use ``-f diary`` to switch modes. The\ndiary entries do not include the full text of the event.\n\nRecommended Use\n===============\n\nThe recommended way to use ical2org is to export your iCal data at\nleast every day. That gives you a moving window of fresh data, since\nthe date range for export is limited. Save the output to a file\n(e.g., ``~/Documents/Notes/calendar.org``) and add the file to org's\nlist of inputs for building agenda views.\n\nIf you use org-mode for taking notes in meetings, refile each event as\nyou make notes to avoid overwriting it the next time your calendars\nare exported.\n\nFor example, you might run a command like::\n\n $ ical2org -o ~/Documents/Notes/calendar.org -b 30 -e 30\n\nto export the data starting 30 days ago and ending 30 days from today\nto the file ``calendar.org``.\n\nRecurring Events\n================\n\nRecurring events in iCal are \"exploded\" to create separate entries in\nthe output. This makes it easy to refile an event when you add notes,\nwithout having the notes from one meeting occurance appear on the\nwrong date.\n\nCommand Line Options\n====================\n\n-h show this help message and exit\n-c CONFIG_FILENAME, --config=CONFIG_FILENAME\n Configuration file name. Defaults to ~/.ical2org\n-b DAYS_AGO, --begin=DAYS_AGO, --days-ago=DAYS_AGO\n Number of days back in time to search. Defaults to 14.\n-e DAYS_AHEAD, --end=DAYS_AHEAD, --days-ahead=DAYS_AHEAD\n Number of days forward in time to search. Defaults to\n 30.\n-v, --verbose Increase verbose level\n-q, --quiet Turn off verbose output\n-o OUTPUT_FILE_NAME, --output-file=OUTPUT_FILE_NAME\n Write the output to the named file instead of stdout\n--all Include all calendars, not just active.\n--input-directory=INPUT_DIRECTORY\n Directory containing calendars. Defaults to\n ~/Library/Calendars.\n-f FORMAT, --format=FORMAT\n Output format. One of ['org', 'diary']. Defaults to\n \"diary\".\n--opt=OPT, --formatter-option=OPT\n Formatter-specific option name=value\n--help Verbose help\n\n.. _org-mode: http://orgmode.org/\n\n.. _Python: http://www.python.org/\n\n.. _Distribute: http://packages.python.org/distribute/\n\n.. _pytz: http://pytz.sourceforge.net/\n\n.. _vobject: http://vobject.skyhouseconsulting.com/\n\nHistory\n=======\n\n1.2\n\n - Fix bug with event spans due to mis-interpretation of iCalendar\n standard.\n\n1.1\n\n - Fix DST handling for recurring events.\n\n1.0.3\n\n - Patches from KANEUCHI Tetsuya to fix problems with unicode console\n output and empty descriptions\n\n1.0.2\n\n - Updated installation instructions.\n\n1.0.1\n\n - Fixed some installation annoyances.\n\n1.0\n\n - First public release.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://www.doughellmann.com/projects/ical2org/", "keywords": null, "license": "UNKNOWN", "maintainer": null, "maintainer_email": null, "name": "ical2org", "package_url": "https://pypi.org/project/ical2org/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/ical2org/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://www.doughellmann.com/projects/ical2org/" }, "release_url": "https://pypi.org/project/ical2org/1.2/", "requires_dist": null, "requires_python": null, "summary": "Convert iCal files to emacs org-mode data", "version": "1.2" }, "last_serial": 803017, "releases": { "1.0": [], "1.0.1": [], "1.0.2": [], "1.0.3": [], "1.2": [ { "comment_text": "", "digests": { "md5": "79891521a644b244c8840c8fadd65fdd", "sha256": "71e17de1283b8d163bc05ad7ac41a90d7d032832e7f837d1462e07815e396976" }, "downloads": -1, "filename": "ical2org-1.2.tar.gz", "has_sig": false, "md5_digest": "79891521a644b244c8840c8fadd65fdd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14825, "upload_time": "2011-04-24T18:16:47", "url": "https://files.pythonhosted.org/packages/6e/e6/147e920ebbefd0c0ecc9be32201ccdb254ce0ac19d80f17aeb64682807bb/ical2org-1.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "79891521a644b244c8840c8fadd65fdd", "sha256": "71e17de1283b8d163bc05ad7ac41a90d7d032832e7f837d1462e07815e396976" }, "downloads": -1, "filename": "ical2org-1.2.tar.gz", "has_sig": false, "md5_digest": "79891521a644b244c8840c8fadd65fdd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14825, "upload_time": "2011-04-24T18:16:47", "url": "https://files.pythonhosted.org/packages/6e/e6/147e920ebbefd0c0ecc9be32201ccdb254ce0ac19d80f17aeb64682807bb/ical2org-1.2.tar.gz" } ] }