Backup repository for imag-pim.org / imag https://imag-pim.org
Find a file
2016-04-14 18:34:10 +02:00
bin Add ascii-art logo 2016-02-01 22:36:46 +01:00
doc Add initial proposal for notes module 2016-03-25 16:30:12 +01:00
imag-counter Move logger initialization to earliest possible point 2016-03-26 15:29:24 +01:00
imag-link Add missing level of unpacking in cli helpers 2016-04-12 22:02:28 +02:00
imag-notes Add option to edit after creating 2016-03-26 16:43:33 +01:00
imag-store Move logger initialization to earliest possible point 2016-03-26 15:29:24 +01:00
imag-tag Move logger initialization to earliest possible point 2016-03-26 15:29:24 +01:00
imag-view Move logger initialization to earliest possible point 2016-03-26 15:29:24 +01:00
libimagcounter Add README for libimagcounter 2016-03-25 15:56:42 +01:00
libimagentryfilter Merge pull request #291 from matthiasbeyer/libimagentryfilter/update-clap 2016-03-26 13:57:25 +01:00
libimagentrylist Add lister helper function 2016-04-06 11:49:03 +02:00
libimaginteraction Implement ask_select_from_list() 2016-04-12 16:40:41 +02:00
libimaglink Rewrite process_rw_result() 2016-04-12 22:00:40 +02:00
libimagnotes impl Deref for Note 2016-03-26 19:52:30 +01:00
libimagrt Merge pull request #322 from matthiasbeyer/libimagrt/debug-log-line-and-file 2016-04-06 16:58:22 +02:00
libimagstore Enhance store config errors by printing (println) 2016-03-26 15:28:35 +01:00
libimagstorestdhook Add module for flock() hook 2016-04-14 18:34:10 +02:00
libimagtag Merge pull request #281 from matthiasbeyer/per-crate-readme 2016-03-26 13:56:47 +01:00
libimagutil Merge pull request #270 from matthiasbeyer/libimagutil/trace-newline 2016-03-26 15:29:56 +01:00
.editorconfig Add editorconfig configuration file 2016-01-11 19:47:51 +01:00
.gitignore Add Cargo.lock to .gitignore 2016-01-22 20:14:54 +01:00
.travis.yml Rewrite travis.yml to build all the things 2016-02-15 14:19:18 +01:00
CONTRIBUTING.md Update {README,CONTRIBUTING}.md to contain more detailed information 2016-03-10 12:40:04 +01:00
default.nix Move to rust stable (1.4 atm) so we can use clap 2015-12-05 10:45:33 +01:00
LICENSE Add LICENSE file 2015-11-08 17:35:49 +01:00
README.md add Section about Building/Running imag 2016-04-13 18:56:19 +02:00

imag

Imag is a CLI PIM suite with a nice API-ish commandline interface, so you can integrate it in your tools of coice (Editor, MUA, RSS reader, etc etc).

Goal

Our goal is to

Create a fast, reliable, forwards/backwards compatible commandline personal information management suite which covers all aspects of personal information management, consists of reusable parts and integrates well with known commandline tools.

We try to accomplish these requirements:

  • "fast": We use the awesome, fast and safe programming language "Rust"
  • "reliable": We try to test every aspect of our software. Our build process ensures that the build breaks whenever a library interface changes and the modules which use the library are not updated.
  • "forwards/backwards compatible:" Our (plain text) on-disk data format and storage library both ensure that incompatibilities are captured and resolved (using semver)
  • "commandline": We ensure that everything can be done by commandline calls, for some modules there might be a curses-like UI, but there are no graphical clients and there never will be any within this codebase. We use clap for commandline-interface building and we try to keep the interface easy and consistent between modules.
  • "personal": We store everything as plain text in a store inside the users $HOME directory. There will be a version-control (most surely git) hook integrated to sync between several machines. There are no multi-user features included or planned at the time of writing.
  • "information management": We want to give the user the possibility to put every single information about their personal lives into the store and we try hard to provide a sane interface to query and retrieve data from this database.
  • "covers all the aspects of personal information management": We want to provide modules for:
    • contact management
    • calendar
    • diary
    • notes
    • personal wiki
    • news (rss)
    • passwords
    • images
    • music
    • movies
    • personal project management
    • podcast management
    • ledger
    • mail
    • bibliography management
    • ... and many, many more.
  • "constists of reusable parts": Every functionality is implemented as library. The binaries we ship are just commandline-interace-to-library-interface translators
  • "integrates well with known commandline tools": We do not re-invent the wheel. We do not implement "yet another password manager", but use the standard unix password manager, do not implement a news reader, but use newsbeuter, do not reimplement a mail reader, etc etc. We do not copy images, movies or other data to the store but "link" them into the store, so you can use imag tools to query and access this data, but still live with your beloved commandline apps. We do not want to duplicate work but reuse as much as possible. You don't like one of the applications we use (for example pass as password manager)? Sure, feel free to submit patches so the user is able to switch the used tool, as long as it doesn't break the workflow. We will happily merge them!

Current state of development

This application is in really early development.

We have implemented the very core of the system: the store library. There's also some progress on utility libraries for linking entries, tagging and the hook system of the store is in progress as well. There is also one commandline application: "imag-store" (the "store" subcommand) available by now, but this is meant for developers and debugging purposes as it provides direct core-level store access.

Though, the very core of the system is stable and nothing prevents you from contributing and implementing a module, though some convenience is not yet provided (as the libraries are work-in-progress).

Building/Running

Building

To build a single module:

$> cd <imag-proj-dir>/imag-<module>
$> cargo build

It may be tiresome to build all the modules by hand, but one can do something like this:

$> for dir in \
>$(find ./ -maxdepth 1 -path "./imag-*" -name "imag-*" -type d)
>do
>pushd $dir; cargo build; popd
>done

Running

To run imag, simply call ./bin/imag. This script has a function to search for modules, which utilizes an environment variable called IMAG_IS_THE_SHIT. To run imag with all components:

$> IMAG_IS_THE_SHIT=$(pwd) ./bin/imag

assuming you are currently in the imag source directory. Otherwise it is

$>IMAG_IS_THE_SHIT=$IMAG_SRC $IMAG_SRC/bin/imag

if $IMAG_SOURCE points to the imag source directory.

To test, simply add --help to one of the above commands. Imag should now be able to find the available commands.

Documentation

For detailed information, please read the documentation (You can either read the Markdown files or compile it to HTML/PDF using pandoc).

License

We chose to distribute this software under terms of GNU LGPLv2.1.

This decision was made to ensure everyone can write applications which use the imag core functionality which is distributed with the imag source distribution.