Prepare pypi release

Added License, repository information and extended README.
Added installation instructions to README.
Added testing instructions to README.
This commit is contained in:
Marty Oehme 2022-01-05 12:55:30 +01:00
parent 031145db01
commit 10702f4a44
Signed by: Marty
GPG key ID: B7538B8F50A1C800
3 changed files with 51 additions and 12 deletions

View file

@ -5,7 +5,13 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project tries to adhere to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). and this project tries to adhere to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [Unreleased] <!-- ## [Unreleased] -->
## [0.4.1] - 2022-01-05
### Added
* Added pypi release publication
### Changed ### Changed

View file

@ -1,15 +1,34 @@
# habit-migrate # habitmove
Can take an export of nomie habits in json format and convert it to be importable in Loop Habit Tracker. Takes habit in one habit-tracking application and transforms them ready to use for another.
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 commandline utility habit migrate currently takes a single argument, the nomie database `.json` file. Run as a cli utility `habitmove` currently takes a single argument: the nomie database `.json` file to import habits from.
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.
@ -18,17 +37,28 @@ 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.
Invoked like: `python run.py nomie-export.json`. ## Development
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>
``` ```
In the future there might be an easier road to using this package but that's the way it is for now. To see a set up more closely resembling the final cli environment,
with its libraries loaded as environmental dependencies enter the poetry shell:
The package can also be used as a library to load nomie data ```bash
or move data into Loop Habit Tracker. poetry shell
```
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.
To run tests for the app, simply invoke `pytest` through `poetry run pytest` or from within the `poetry shell`.
To run larger scale test automation, make sure you habe nox installed and run `poetry run ` or again through the shell.
You can exclude integration tests that take longer and inspect the complete database output of the program through the parameters `-m "not e2e"` for both `pytest` and `nox` (which also does it automatically).

View file

@ -2,6 +2,9 @@
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"},