From mboxrd@z Thu Jan 1 00:00:00 1970 From: John Wiegley Subject: A new module for Org-mode: Org-X Date: Sun, 14 Aug 2011 02:41:07 -0500 Message-ID: Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([140.186.70.92]:47424) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QsVJr-0006ZU-5j for emacs-orgmode@gnu.org; Sun, 14 Aug 2011 03:41:16 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QsVJp-0002w7-Dq for emacs-orgmode@gnu.org; Sun, 14 Aug 2011 03:41:15 -0400 Received: from mail-gy0-f169.google.com ([209.85.160.169]:57477) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QsVJp-0002w3-94 for emacs-orgmode@gnu.org; Sun, 14 Aug 2011 03:41:13 -0400 Received: by gyg10 with SMTP id 10so2999710gyg.0 for ; Sun, 14 Aug 2011 00:41:12 -0700 (PDT) List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode@gnu.org Hello all, I've been working a new set of modules for Org to make it easy to associate Org entries with data in external systems, such as Redmine, Bugzilla, WordPress, or even your e-mail Inbox. It's called Org-X, as its meant to simplify writing linkup code for any system X. It has two parts: one for users, and one for Org programmers. The user code will: - create a new entry on the selected remote based on an Org subtree - merge changes from all remotes into a subtree - push changes from the local subtree up to the remote(s) For example, I currently use this code with Redmine to simplify creating new bugs from existing Org tasks, and to push and pull any new comments. For Org programmers, Org-X provides a data abstraction to ease working with Org data in a programmatic way. To add a tag to the current Org entry with Org-X looks like this right now: (let ((entry (org-x-parse-entry))) (org-x-add-tag entry "Hello") (org-x-replace-entry entry)) Where the value comes in for programmers is that you can "propagate" such changes to all associated external systems by just passing "t" for the propagate parameter: (let ((entry (org-x-parse-entry))) (org-x-add-tag entry "Hello" t)) Without having to know what those remote systems even are. Of course, Org itself is a backend, which is why the call to `org-x-replace-entry' is no longer needed here, since propagation will achieve the same affect. The set of applicable backends is determined by context, and the appropriate actions decided upon by each backend who "answers" for a given Org entry. Anyway, the code is still in the beginnings stages, and in rough shape, with the API undergoing fluctuations on a daily basis. But I thought I'd let people know, as maybe some would like to help flesh out the basics while it's still so unformed. My org-x branch is here: git clone git://github.com/jwiegley/org-mode.git git checkout -t origin/org-x or git remote add -f jwiegley git://github.com/jwiegley/org-mode.git git checkout -t jwiegley/org-x I'm currently working on backends for Redmine, Bugzilla and WordPress, since I have an immediate need for them; but I also have ideas for others, such as a backend that creates back-linked Org tasks for every "FIXME" comment in a source code project... Thanks, John