mirror of
https://github.com/GothenburgBitFactory/timewarrior.git
synced 2025-07-27 21:23:26 +02:00
5276a9f4bd
The import command lets the user import time tracking data as produced by the export command, i.e. a JSON array of interval objects. Data can be either provided as one or more files, or via stdin. The latter enables synchronization between remote machines via ssh: timew export | ssh <server> 'timew import' Signed-off-by: Thomas Lauf <thomas.lauf@tngtech.com>
57 lines
1.4 KiB
Text
57 lines
1.4 KiB
Text
= timew-import(1)
|
|
|
|
== NAME
|
|
timew-import - import time-tracking data from files
|
|
|
|
== SYNOPSIS
|
|
[verse]
|
|
*timew import* [_<file>_**...**]
|
|
|
|
== DESCRIPTION
|
|
Import tracked time from `file`.
|
|
If no files are specified, the command will read from standard input.
|
|
|
|
The data to import has to be in JSON format, as exported by **timew-export**(1), i.e. a single array with interval objects.
|
|
|
|
When importing, the intervals are checked for overlaps with existing intervals.
|
|
If an overlap is found, the import will abort at the first overlap and no more intervals are imported, unless the `:adjust` hint is specified.
|
|
|
|
In general, it is recommended to create a backup of your data before importing.
|
|
|
|
== HINTS
|
|
|
|
**:adjust**::
|
|
When given, the imported interval will overwrite any existing intervals that it overlaps with.
|
|
|
|
== EXAMPLES
|
|
|
|
*Import intervals from a file*::
|
|
+
|
|
Import intervals from a single file:
|
|
+
|
|
[source]
|
|
----
|
|
timew import intervals.json
|
|
----
|
|
+
|
|
Any file path that does not start with a `/` is interpreted as relative to the current working directory.
|
|
|
|
*Import intervals from multiple files*::
|
|
+
|
|
One can also use shell wildcards and absolute paths:
|
|
+
|
|
[source]
|
|
----
|
|
timew import /path/to/intervals/*.json
|
|
----
|
|
|
|
*Import intervals from standard input*::
|
|
+
|
|
Import intervals from stdin:
|
|
+
|
|
[source]
|
|
----
|
|
timew export | ssh <server> 'timew import'
|
|
----
|
|
This is especially useful for synchronizing intervals between different machines.
|
|
+
|