Compare commits
No commits in common. "5452814501d7563bc3faebfe4030c63701e082a9" and "031145db01a0f860351822b4fda54773814489d7" have entirely different histories.
5452814501
...
031145db01
2 changed files with 11 additions and 40 deletions
48
README.md
48
README.md
|
@ -1,34 +1,15 @@
|
||||||
# habitmove
|
# habit-migrate
|
||||||
|
|
||||||
Takes habit in one habit-tracking application and transforms them ready to use for another.
|
Can take an export of nomie habits in json format and convert it to be importable in Loop Habit Tracker.
|
||||||
|
|
||||||
Currently can take an export of nomie habits in json format and convert it to be importable in Loop Habit Tracker.
|
|
||||||
Plans for reverse migration are on the roadmap, and ultimately this tool ideally understands more and more habit formats to prevent app lock-in.
|
|
||||||
|
|
||||||
Confirmed working for nomie version 5.6.4 and Loop Habit Tracker version 2.0.2 and 2.0.3.
|
Confirmed working for nomie version 5.6.4 and Loop Habit Tracker version 2.0.2 and 2.0.3.
|
||||||
Presumably works for other nomie 5.x versions and other Loop 2.x versions as well,
|
Presumably works for other nomie 5.x versions and other Loop 2.x versions as well,
|
||||||
but that is untested.
|
but that is untested.
|
||||||
|
|
||||||
## Installation
|
|
||||||
|
|
||||||
Installation can be accomplished through *pip*:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
pip install habitmove
|
|
||||||
```
|
|
||||||
|
|
||||||
Requirements:
|
|
||||||
|
|
||||||
`habitmove` requires at least Python 3.7.
|
|
||||||
It has only been tested on GNU/Linux (amd64) though it should work on other platforms.
|
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
Run as a cli utility `habitmove` currently takes a single argument: the nomie database `.json` file to import habits from.
|
Run as a commandline utility habit migrate currently takes a single argument, the nomie database `.json` file.
|
||||||
|
The output as importable Loop Habit Tracker database will be written to `output.db` in present working directory.
|
||||||
Invoked like: `habitmove nomie-export.json`.
|
|
||||||
|
|
||||||
The output as a Loop Habit Tracker database will be written to `output.db` in the present working directory.
|
|
||||||
|
|
||||||
Can also take an existing Loop Habit database (exported from the application),
|
Can also take an existing Loop Habit database (exported from the application),
|
||||||
and add the nomie exported habits and checkmarks to it.
|
and add the nomie exported habits and checkmarks to it.
|
||||||
|
@ -37,24 +18,17 @@ it will not (should not™️) overwrite anything.
|
||||||
If there are any duplicated habits however,
|
If there are any duplicated habits however,
|
||||||
it will add duplications of the existing repetitions into the database.
|
it will add duplications of the existing repetitions into the database.
|
||||||
|
|
||||||
## Development
|
Invoked like: `python run.py nomie-export.json`.
|
||||||
|
Note, however, that -- until a packaged version is released -- you will need to have some packages in your environment.
|
||||||
|
If you wish to run it un-packaged, install [poetry](https://python-poetry.org/) and let it do all dependency management by doing:
|
||||||
|
|
||||||
To enable easy development on the app,
|
```
|
||||||
install [poetry](https://python-poetry.org/) and let it do all dependency management for you by doing:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
poetry install
|
poetry install
|
||||||
poetry run habitmove <nomie-json>
|
poetry run habitmove <nomie-json>
|
||||||
```
|
```
|
||||||
|
|
||||||
To see a set up more closely resembling the final cli environment,
|
In the future there might be an easier road to using this package but that's the way it is for now.
|
||||||
with its libraries loaded as environmental dependencies enter the poetry shell:
|
|
||||||
|
|
||||||
```bash
|
The package can also be used as a library to load nomie data
|
||||||
poetry shell
|
or move data into Loop Habit Tracker.
|
||||||
```
|
|
||||||
|
|
||||||
The package can eventually also be used as a library to load nomie data to work with in Python,
|
|
||||||
or to move data into Loop Habit Tracker.
|
|
||||||
Take a look at the `Parser` and `Transformer` interfaces respectively.
|
|
||||||
|
|
||||||
|
|
|
@ -2,9 +2,6 @@
|
||||||
name = "habitmove"
|
name = "habitmove"
|
||||||
version = "0.4.0"
|
version = "0.4.0"
|
||||||
description = "migrate nomie data to loop habits tracker"
|
description = "migrate nomie data to loop habits tracker"
|
||||||
license="GPL-3.0-only"
|
|
||||||
readme="README.md"
|
|
||||||
repository="https://git.martyoeh.me/Marty/habit-migrate"
|
|
||||||
authors = ["Marty Oehme <marty.oehme@gmail.com>"]
|
authors = ["Marty Oehme <marty.oehme@gmail.com>"]
|
||||||
packages = [
|
packages = [
|
||||||
{ include = "habitmove", from = "src"},
|
{ include = "habitmove", from = "src"},
|
||||||
|
|
Loading…
Reference in a new issue