Backup repository for imag-pim.org / imag https://imag-pim.org
Find a file
Matthias Beyer d7cfab797f Revert "Implement pipe magic in libimagrt"
This reverts commit ce0bd9298a.

Pipe magic is removed with this patch.

We remove pipe magic because its implementation in libimagstore is too
complicated and the benefits are too small.
Having this functionality would be really nice, but the cost-benefit
ratio would still be too high.
The implementation in the store would require a rewrite of the internal
caching functionality in the store, plus some functionality to serialize
and deserialize the cache. This is theoretically possible, but as the
store only knows about "StoreEntry" objects, and only the backend knows
of "Entry" (which would be simply de/serializeable), the complexity
increases a _lot_.

Hence, we drop this feature-idea here.

Maybe, at some later point, this functionality will be in imag. The
history of development of this feature is in the history, we just don't
have it merged.

Signed-off-by: Matthias Beyer <mail@beyermatthias.de>
2018-04-16 13:30:59 +02:00
bin Remove feature to generate commandline completion scripts 2018-04-14 14:35:28 +02:00
doc Add changelog entry or "imag view -I" 2018-04-06 15:41:22 +02:00
lib Revert "Implement pipe magic in libimagrt" 2018-04-16 13:30:59 +02:00
scripts Only build doc(sets) for lib crates 2018-04-14 00:46:06 +02:00
.editorconfig Remove Makefile/html config, set {md,yaml,nix} indent to 4 spaces 2017-09-08 16:28:21 +02:00
.gitignore Ignore Intellij-IDEA dotfiles 2018-01-29 09:38:32 +01:00
.travis.yml Move scripted checks to own CI job 2018-04-14 00:46:06 +02:00
build.rs Use "::std" instead of "std" 2018-04-14 14:19:28 +02:00
Cargo.toml Remove libimagentrylist 2018-02-20 15:02:46 +01:00
CHANGELOG.md Add changelog 2017-09-01 14:25:00 +02:00
CONTRIBUTING.md Move contributing guidelines to documentation 2017-08-11 09:11:12 +00:00
default.nix Add libtool in default.nix 2018-01-13 01:23:08 +01:00
imagrc.toml Add support for viewing multiple entries 2018-04-06 15:30:12 +02:00
LICENSE Add LICENSE file 2015-11-08 17:35:49 +01:00
README.md Update README 2018-01-29 09:38:32 +01:00

imag - imag-pim.org

imag is a commandline personal information management suite.

Build Status Issue Stats Issue Stats license Tokei

This application is in early development. There are some things that work, but we do not consider anything stable or usable at this moment. Feel free to play around anyways.

Goal / What is imag?

Our (long-term) goal is to

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

Yes, imag is a rather ambitious project as it tries to reimplement functionality for several "personal information management aspects". It is a hobby project, keep that in mind. We try to use standards like vcard, icalendar and others wherever possible.

Have a look at the documentation for some more words on this.

Building/Running

Here is how to try imag out.

imag is a suite/collection of tools (like git, for example) and you can build them individually. All subdirectories prefixed with "libimag" are libraries. All subdirectories prefixed with "imag-" are binaries and compiling them will give you a commandline application.

Building

We use cargo for building all crates in this repository. Make sure to use a recent cargo, at least one with workspace support. Building all crates works with cargo build --all, building individual crates by cding to their directory and calling cargo build.

For building all commandline applications:

find bin -maxdepth 3 -name Cargo.toml -exec cargo build --manifest-path {} \;

For building only the core functionality

find bin/core -maxdepth 3 -name Cargo.toml -exec cargo build --manifest-path {} \;

Running

After you build the module you want to play with, you can simply call the binary itself with the --help flag, to get some help what the module is capable of.

If you installed the module, you can either call imag-<modulename> (if the install-directory is in your $PATH), or install the imag binary to call imag <modulename> (also if everything is in your $PATH).

Staying up-to-date

We have a official website for imag, where I post release notes and monthly(ish) updates what's happening in the source tree (RSS here).

We also have a mailinglist where I post updates and where discussion and questions are encouraged.

Documentation

We have some documentation in the ./doc subtree which can be compiled to PDF or a website. It might not be up to date, though. Developer documentation for the last release is available on docs.rs.

Please contribute!

We are looking for contributors! Feel free to open issues for asking questions, suggesting features or other things!

Also have a look at the CONTRIBUTING.md file!

Contact

Feel free to join our new IRC channel at freenode: #imag or our mailinglist.

License

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