snose

Hex Artifact Content
Login

Artifact 949fc80542ec274440c1faeb4fb8271dd8e06f56be51db0e17cde8b222e1c7b2:


0000: 23 20 53 4e 6f 73 65 20 2d 20 53 69 6d 70 6c 65  # SNose - Simple
0010: 6e 6f 74 65 20 4f 62 6a 65 63 74 20 53 79 6e 63  note Object Sync
0020: 68 72 6f 6e 69 73 61 74 69 6f 6e 20 28 45 78 70  hronisation (Exp
0030: 6c 69 63 69 74 29 0a 0a 41 20 63 6f 6d 6d 61 6e  licit)..A comman
0040: 64 20 6c 69 6e 65 20 63 6c 69 65 6e 74 20 2f 20  d line client / 
0050: 70 79 74 68 6f 6e 20 73 63 72 69 70 74 20 75 73  python script us
0060: 69 6e 67 20 74 68 65 20 5b 53 69 6d 70 6c 65 6e  ing the [Simplen
0070: 6f 74 65 2e 70 79 5d 28 68 74 74 70 73 3a 2f 2f  ote.py](https://
0080: 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 72 74 61 7a  github.com/mrtaz
0090: 7a 2f 73 69 6d 70 6c 65 6e 6f 74 65 2e 70 79 29  z/simplenote.py)
00a0: 20 6d 6f 64 75 6c 65 20 66 72 6f 6d 20 5b 6d 72   module from [mr
00b0: 74 61 7a 7a 20 28 44 61 6e 69 65 6c 20 53 63 68  tazz (Daniel Sch
00c0: 61 75 65 6e 62 65 72 67 29 5d 28 68 74 74 70 73  auenberg)](https
00d0: 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 72  ://github.com/mr
00e0: 74 61 7a 7a 29 20 74 68 61 74 20 61 6c 6c 6f 77  tazz) that allow
00f0: 73 20 79 6f 75 20 74 6f 20 73 79 6e 63 68 72 6f  s you to synchro
0100: 6e 69 73 65 20 6a 75 73 74 20 74 68 65 20 28 74  nise just the (t
0110: 65 78 74 29 20 66 69 6c 65 73 20 79 6f 75 20 73  ext) files you s
0120: 70 65 63 69 66 79 20 77 69 74 68 69 6e 20 61 20  pecify within a 
0130: 64 69 72 65 63 74 6f 72 79 20 61 63 72 6f 73 73  directory across
0140: 20 6d 75 6c 74 69 70 6c 65 20 6d 61 63 68 69 6e   multiple machin
0150: 65 73 2e 0a 0a 23 23 20 46 41 51 0a 0a 31 2e 20  es...## FAQ..1. 
0160: 59 6f 75 20 74 68 6f 75 67 68 74 20 6f 66 20 74  You thought of t
0170: 68 65 20 6e 61 6d 65 20 22 73 6e 6f 73 65 22 20  he name "snose" 
0180: 66 69 72 73 74 20 61 6e 64 20 74 68 65 6e 20 74  first and then t
0190: 72 69 65 64 20 74 6f 20 77 61 6e 67 6c 65 20 69  ried to wangle i
01a0: 6e 20 73 6f 6d 65 74 68 69 6e 67 20 74 6f 20 6d  n something to m
01b0: 61 6b 65 20 69 74 20 61 6e 20 61 63 72 6f 6e 79  ake it an acrony
01c0: 6d 2c 20 64 69 64 6e 27 74 20 79 6f 75 3f 20 2a  m, didn't you? *
01d0: 59 65 73 2e 2a 0a 0a 0a 23 23 20 49 6e 73 70 69  Yes.*...## Inspi
01e0: 72 61 74 69 6f 6e 0a 0a 42 61 73 69 63 61 6c 6c  ration..Basicall
01f0: 79 20 49 20 77 61 6e 74 65 64 20 61 20 77 61 79  y I wanted a way
0200: 20 74 6f 20 73 79 6e 63 68 72 6f 6e 69 73 65 20   to synchronise 
0210: 61 72 62 69 74 72 61 72 79 20 22 64 6f 74 66 69  arbitrary "dotfi
0220: 6c 65 73 22 20 77 69 74 68 6f 75 74 20 74 68 65  les" without the
0230: 20 22 65 78 70 65 6e 73 65 22 20 6f 66 20 61 20   "expense" of a 
0240: 47 69 74 20 72 65 70 6f 73 69 74 6f 72 79 3a 0a  Git repository:.
0250: 0a 2d 20 47 69 74 20 73 65 65 6d 73 20 61 20 62  .- Git seems a b
0260: 69 74 20 6f 76 65 72 6b 69 6c 6c 0a 2d 20 49 27  it overkill.- I'
0270: 6d 20 6e 6f 74 20 72 65 61 6c 6c 79 20 62 6f 74  m not really bot
0280: 68 65 72 65 64 20 61 62 6f 75 74 20 76 65 72 73  hered about vers
0290: 69 6f 6e 69 6e 67 2c 20 6a 75 73 74 20 73 79 6e  ioning, just syn
02a0: 63 68 72 6f 6e 69 73 61 74 69 6f 6e 0a 2d 20 49  chronisation.- I
02b0: 20 6a 75 73 74 20 77 61 6e 74 20 74 6f 20 73 79   just want to sy
02c0: 6e 63 68 72 6f 6e 69 73 65 20 2a 73 6f 6d 65 2a  nchronise *some*
02d0: 20 66 69 6c 65 73 20 77 69 74 68 69 6e 20 61 20   files within a 
02e0: 64 69 72 65 63 74 6f 72 79 2c 20 6e 6f 74 20 61  directory, not a
02f0: 6c 6c 20 6f 66 20 74 68 65 6d 20 28 6a 75 73 74  ll of them (just
0300: 20 69 6d 61 67 69 6e 65 20 74 68 65 20 60 2e 67   imagine the `.g
0310: 69 74 69 67 6e 6f 72 65 60 21 29 0a 0a 23 23 20  itignore`!)..## 
0320: 48 6f 77 20 74 6f 20 75 73 65 0a 0a 57 69 6c 6c  How to use..Will
0330: 20 70 72 6f 62 61 62 6c 79 20 77 6f 72 6b 20 69   probably work i
0340: 6e 20 50 79 74 68 6f 6e 20 32 20 61 6e 64 20 33  n Python 2 and 3
0350: 20 28 61 6e 64 20 77 61 73 20 69 6e 69 74 69 61   (and was initia
0360: 6c 6c 79 20 64 65 76 65 6c 6f 70 65 64 20 75 6e  lly developed un
0370: 64 65 72 20 50 79 74 68 6f 6e 20 32 29 2c 20 62  der Python 2), b
0380: 75 74 20 49 27 76 65 20 74 61 6b 65 6e 20 74 6f  ut I've taken to
0390: 20 75 73 69 6e 67 20 33 20 61 73 20 6d 75 63 68   using 3 as much
03a0: 20 61 73 20 49 20 63 61 6e 20 64 61 79 20 74 6f   as I can day to
03b0: 20 64 61 79 20 73 6f 20 49 20 77 6f 6e 27 74 20   day so I won't 
03c0: 62 65 20 63 61 74 63 68 69 6e 67 20 62 75 67 73  be catching bugs
03d0: 20 66 6f 72 20 32 2e 0a 0a 23 23 23 20 49 6e 20   for 2...### In 
03e0: 67 65 6e 65 72 61 6c 20 2d 20 41 75 74 68 65 6e  general - Authen
03f0: 74 69 63 61 74 69 6f 6e 0a 0a 50 72 6f 62 61 62  tication..Probab
0400: 6c 79 20 74 68 65 20 62 65 73 74 20 77 61 79 20  ly the best way 
0410: 69 73 20 74 6f 20 73 74 6f 72 65 20 79 6f 75 72  is to store your
0420: 20 63 72 65 64 65 6e 74 69 61 6c 73 20 69 6e 20   credentials in 
0430: 60 2e 6e 65 74 72 63 60 20 77 69 74 68 20 61 20  `.netrc` with a 
0440: 60 6d 61 63 68 69 6e 65 60 20 6f 66 20 68 6f 73  `machine` of hos
0450: 74 20 22 73 69 6d 70 6c 65 2d 6e 6f 74 65 2e 61  t "simple-note.a
0460: 70 70 73 70 6f 74 2e 63 6f 6d 22 20 61 6e 64 20  ppspot.com" and 
0470: 75 73 69 6e 67 20 74 68 65 20 60 6c 6f 67 69 6e  using the `login
0480: 60 20 61 6e 64 20 60 70 61 73 73 77 6f 72 64 60  ` and `password`
0490: 20 65 6e 74 72 69 65 73 2e 20 42 75 74 20 79 6f   entries. But yo
04a0: 75 20 63 61 6e 20 61 6c 73 6f 20 70 72 6f 76 69  u can also provi
04b0: 64 65 20 74 68 65 20 75 73 65 72 6e 61 6d 65 20  de the username 
04c0: 61 6e 64 20 70 61 73 73 77 6f 72 64 20 6f 6e 20  and password on 
04d0: 74 68 65 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65  the command line
04e0: 20 6c 69 6b 65 20 73 6f 3a 0a 0a 20 20 20 20 70   like so:..    p
04f0: 79 74 68 6f 6e 20 73 6e 6f 73 65 2e 70 79 20 2d  ython snose.py -
0500: 2d 75 73 65 72 6e 61 6d 65 3d 6d 65 40 65 6d 61  -username=me@ema
0510: 69 6c 2e 63 6f 6d 20 2d 2d 70 61 73 73 77 6f 72  il.com --passwor
0520: 64 3d 6d 79 70 61 73 73 77 6f 72 64 0a 0a 41 20  d=mypassword..A 
0530: 74 6f 6b 65 6e 20 62 61 73 65 64 20 61 70 70 72  token based appr
0540: 6f 61 63 68 20 77 6f 75 6c 64 20 62 65 20 6e 69  oach would be ni
0550: 63 65 2c 20 62 75 74 20 66 6f 72 20 74 68 61 74  ce, but for that
0560: 20 49 27 64 20 6e 65 65 64 20 74 6f 20 6d 6f 64   I'd need to mod
0570: 69 66 79 20 73 69 6d 70 6c 65 6e 6f 74 65 2e 70  ify simplenote.p
0580: 79 2e 0a 0a 23 23 23 20 53 6e 6f 72 74 20 2d 20  y...### Snort - 
0590: 49 6d 70 6f 72 74 69 6e 67 20 61 20 6e 65 77 20  Importing a new 
05a0: 66 69 6c 65 0a 0a 54 61 6b 65 20 61 20 66 69 6c  file..Take a fil
05b0: 65 20 66 72 6f 6d 20 74 68 65 20 63 75 72 72 65  e from the curre
05c0: 6e 74 20 64 69 72 65 63 74 6f 72 79 20 61 6e 64  nt directory and
05d0: 20 69 6d 70 6f 72 74 20 69 6e 74 6f 20 53 69 6d   import into Sim
05e0: 70 6c 65 6e 6f 74 65 20 61 73 20 61 20 6e 65 77  plenote as a new
05f0: 20 6e 6f 74 65 3a 0a 0a 20 20 20 20 70 79 74 68   note:..    pyth
0600: 6f 6e 20 73 6e 6f 73 65 2e 70 79 20 2d 2d 75 73  on snose.py --us
0610: 65 72 6e 61 6d 65 3d 3c 6d 65 40 65 6d 61 69 6c  ername=<me@email
0620: 2e 63 6f 6d 3e 20 2d 2d 70 61 73 73 77 6f 72 64  .com> --password
0630: 3d 3c 6d 79 70 61 73 73 77 6f 72 64 3e 20 2d 2d  =<mypassword> --
0640: 73 6e 6f 72 74 20 2d 2d 66 69 6c 65 3d 3c 66 69  snort --file=<fi
0650: 6c 65 6e 61 6d 65 2e 65 78 74 3e 0a 0a 4e 6f 74  lename.ext>..Not
0660: 65 20 74 68 61 74 20 73 6e 6f 73 65 20 77 6f 72  e that snose wor
0670: 6b 73 20 77 69 74 68 20 77 69 74 68 20 66 69 6c  ks with with fil
0680: 65 73 20 69 6e 20 73 75 62 64 69 72 65 63 74 6f  es in subdirecto
0690: 72 69 65 73 20 61 73 20 77 65 6c 6c 2c 20 65 74  ries as well, et
06a0: 63 2e 20 54 68 65 20 6f 6e 6c 79 20 69 73 73 75  c. The only issu
06b0: 65 20 49 20 63 6f 75 6c 64 20 73 65 65 20 74 68  e I could see th
06c0: 65 72 65 20 77 6f 75 6c 64 20 62 65 20 63 72 6f  ere would be cro
06d0: 73 73 2d 70 6c 61 74 66 6f 72 6d 2e 20 49 2e 65  ss-platform. I.e
06e0: 2e 20 70 61 74 68 20 64 69 66 66 65 72 65 6e 63  . path differenc
06f0: 65 73 20 62 65 74 77 65 65 6e 20 57 69 6e 64 6f  es between Windo
0700: 77 73 20 61 6e 64 20 5c 2a 4e 69 78 2e 0a 0a 23  ws and \*Nix...#
0710: 23 23 20 53 6e 69 66 66 20 2d 20 49 6d 70 6f 72  ## Sniff - Impor
0720: 74 69 6e 67 20 61 6e 20 65 78 69 73 74 69 6e 67  ting an existing
0730: 20 66 69 6c 65 0a 0a 54 61 6b 65 20 61 20 66 69   file..Take a fi
0740: 6c 65 20 66 72 6f 6d 20 74 68 65 20 63 75 72 72  le from the curr
0750: 65 6e 74 20 64 69 72 65 63 74 6f 72 79 20 61 6e  ent directory an
0760: 64 20 22 6d 61 74 63 68 22 20 69 74 20 74 6f 20  d "match" it to 
0770: 61 6e 20 65 78 69 73 74 69 6e 67 20 6e 6f 74 65  an existing note
0780: 20 77 69 74 68 69 6e 20 53 69 6d 70 6c 65 6e 6f   within Simpleno
0790: 74 65 0a 0a 20 20 20 20 70 79 74 68 6f 6e 20 73  te..    python s
07a0: 6e 6f 73 65 2e 70 79 20 20 2d 2d 75 73 65 72 6e  nose.py  --usern
07b0: 61 6d 65 3d 3c 6d 65 40 65 6d 61 69 6c 2e 63 6f  ame=<me@email.co
07c0: 6d 3e 20 2d 2d 70 61 73 73 77 6f 72 64 3d 3c 6d  m> --password=<m
07d0: 79 70 61 73 73 77 6f 72 64 3e 20 2d 2d 73 6e 69  ypassword> --sni
07e0: 66 66 3d 3c 6b 65 79 3e 20 2d 2d 66 69 6c 65 3d  ff=<key> --file=
07f0: 3c 66 69 6c 65 6e 61 6d 65 2e 65 78 74 3e 0a 0a  <filename.ext>..
0800: 57 68 65 72 65 20 6b 65 79 20 69 73 20 74 68 65  Where key is the
0810: 20 69 64 20 75 73 65 64 20 62 79 20 53 69 6d 70   id used by Simp
0820: 6c 65 6e 6f 74 65 20 74 6f 20 69 64 65 6e 74 69  lenote to identi
0830: 66 79 20 74 68 65 20 6e 6f 74 65 2e 20 53 6f 20  fy the note. So 
0840: 74 68 65 20 62 65 73 74 20 77 61 79 20 74 6f 20  the best way to 
0850: 66 69 6e 64 20 74 68 69 73 20 69 73 20 74 6f 20  find this is to 
0860: 6d 61 6b 65 20 73 75 72 65 20 74 68 65 20 6e 6f  make sure the no
0870: 74 65 64 20 69 73 20 74 61 67 67 65 64 20 61 73  ted is tagged as
0880: 20 22 73 6e 6f 73 65 22 20 69 6e 20 53 69 6d 70   "snose" in Simp
0890: 6c 65 6e 6f 74 65 20 61 6e 64 20 74 68 65 6e 20  lenote and then 
08a0: 79 6f 75 20 63 61 6e 20 75 73 65 20 60 73 6e 6f  you can use `sno
08b0: 73 65 2e 70 79 20 2d 2d 73 6e 6f 74 60 20 74 6f  se.py --snot` to
08c0: 20 66 69 6e 64 20 74 68 65 20 6b 65 79 2e 0a 0a   find the key...
08d0: 23 23 23 20 53 6e 65 65 7a 65 20 2d 20 45 78 70  ### Sneeze - Exp
08e0: 6f 72 74 20 61 6e 20 65 78 69 73 74 69 6e 67 20  ort an existing 
08f0: 66 69 6c 65 0a 0a 45 78 70 6f 72 74 20 61 20 66  file..Export a f
0900: 69 6c 65 20 66 72 6f 6d 20 53 69 6d 70 6c 65 6e  ile from Simplen
0910: 6f 74 65 20 74 6f 20 74 68 65 20 63 75 72 72 65  ote to the curre
0920: 6e 74 20 64 69 72 65 63 74 6f 72 79 2e 0a 0a 20  nt directory... 
0930: 20 20 20 70 79 74 68 6f 6e 20 73 6e 6f 73 65 2e     python snose.
0940: 70 79 20 20 2d 2d 75 73 65 72 6e 61 6d 65 3d 3c  py  --username=<
0950: 6d 65 40 65 6d 61 69 6c 2e 63 6f 6d 3e 20 2d 2d  me@email.com> --
0960: 70 61 73 73 77 6f 72 64 3d 3c 6d 79 70 61 73 73  password=<mypass
0970: 77 6f 72 64 3e 20 2d 2d 73 6e 65 65 7a 65 3d 3c  word> --sneeze=<
0980: 6b 65 79 3e 20 2d 2d 66 69 6c 65 3d 3c 66 69 6c  key> --file=<fil
0990: 65 6e 61 6d 65 2e 65 78 74 3e 0a 0a 41 6c 74 65  ename.ext>..Alte
09a0: 72 6e 61 74 69 76 65 6c 79 20 53 6e 6f 73 65 20  rnatively Snose 
09b0: 63 61 6e 20 74 72 79 20 74 6f 20 62 65 20 63 6c  can try to be cl
09c0: 65 76 65 72 3a 20 49 66 20 79 6f 75 20 68 61 76  ever: If you hav
09d0: 65 20 60 66 69 6c 65 3a 66 69 6c 65 6e 61 6d 65  e `file:filename
09e0: 2e 74 78 74 60 20 69 6e 20 74 68 65 20 66 69 72  .txt` in the fir
09f0: 73 74 20 74 68 72 65 65 20 6c 69 6e 65 73 20 6f  st three lines o
0a00: 66 20 74 68 65 20 66 69 6c 65 20 28 69 6e 20 61  f the file (in a
0a10: 20 63 6f 6d 6d 65 6e 74 2c 20 65 74 63 29 20 74   comment, etc) t
0a20: 68 65 6e 20 79 6f 75 20 63 61 6e 20 64 6f 3a 0a  hen you can do:.
0a30: 0a 20 20 20 20 70 79 74 68 6f 6e 20 73 6e 6f 73  .    python snos
0a40: 65 2e 70 79 20 20 2d 2d 75 73 65 72 6e 61 6d 65  e.py  --username
0a50: 3d 3c 6d 65 40 65 6d 61 69 6c 2e 63 6f 6d 3e 20  =<me@email.com> 
0a60: 2d 2d 70 61 73 73 77 6f 72 64 3d 3c 6d 79 70 61  --password=<mypa
0a70: 73 73 77 6f 72 64 3e 20 2d 2d 73 6e 65 65 7a 65  ssword> --sneeze
0a80: 3d 3c 6b 65 79 3e 0a 0a 41 6e 64 20 69 74 27 6c  =<key>..And it'l
0a90: 6c 20 74 72 79 20 61 6e 64 20 66 69 67 75 72 65  l try and figure
0aa0: 20 6f 75 74 20 74 68 65 20 66 69 6c 65 6e 61 6d   out the filenam
0ab0: 65 20 69 74 20 73 68 6f 75 6c 64 20 62 65 20 65  e it should be e
0ac0: 78 70 6f 72 74 65 64 20 61 73 2e 0a 0a 23 23 23  xported as...###
0ad0: 20 53 79 6e 63 20 2d 20 53 79 6e 63 68 72 6f 6e   Sync - Synchron
0ae0: 69 73 65 20 66 69 6c 65 73 0a 0a 52 65 61 64 73  ise files..Reads
0af0: 20 66 69 6c 65 73 20 69 6e 20 74 68 65 20 60 2e   files in the `.
0b00: 73 6e 6f 73 65 60 20 69 6e 64 65 78 20 66 69 6c  snose` index fil
0b10: 65 20 61 6e 64 20 73 79 6e 63 68 72 6f 6e 69 73  e and synchronis
0b20: 65 73 20 74 68 65 6d 20 77 69 74 68 20 53 69 6d  es them with Sim
0b30: 70 6c 65 6e 6f 74 65 2e 20 0a 0a 20 20 20 20 70  plenote. ..    p
0b40: 79 74 68 6f 6e 20 73 6e 6f 73 65 2e 70 79 20 20  ython snose.py  
0b50: 2d 2d 75 73 65 72 6e 61 6d 65 3d 3c 6d 65 40 65  --username=<me@e
0b60: 6d 61 69 6c 2e 63 6f 6d 3e 20 2d 2d 70 61 73 73  mail.com> --pass
0b70: 77 6f 72 64 3d 3c 6d 79 70 61 73 73 77 6f 72 64  word=<mypassword
0b80: 3e 20 2d 2d 73 79 6e 63 0a 0a 59 6f 75 20 63 61  > --sync..You ca
0b90: 6e 20 70 61 73 73 20 74 68 65 20 6f 70 74 69 6f  n pass the optio
0ba0: 6e 61 6c 20 60 2d 2d 68 61 6e 6b 79 60 20 66 6c  nal `--hanky` fl
0bb0: 61 67 20 61 74 20 74 68 65 20 73 61 6d 65 20 74  ag at the same t
0bc0: 69 6d 65 20 74 6f 20 70 65 72 66 6f 72 6d 20 61  ime to perform a
0bd0: 20 64 72 79 20 72 75 6e 3b 20 61 6c 74 68 6f 75   dry run; althou
0be0: 67 68 20 74 68 65 20 64 72 79 20 72 75 6e 20 63  gh the dry run c
0bf0: 61 6e 27 74 20 69 6e 64 69 63 61 74 65 20 77 68  an't indicate wh
0c00: 65 6e 20 6d 65 72 67 69 6e 67 20 77 69 6c 6c 20  en merging will 
0c10: 6f 63 63 75 72 2c 20 6f 6e 6c 79 20 74 68 65 20  occur, only the 
0c20: 75 6c 74 69 6d 61 74 65 20 64 69 72 65 63 74 69  ultimate directi
0c30: 6f 6e 20 6f 66 20 74 68 65 20 75 70 64 61 74 65  on of the update
0c40: 2e 0a 0a 20 20 20 20 70 79 74 68 6f 6e 20 73 6e  ...    python sn
0c50: 6f 73 65 2e 70 79 20 20 2d 2d 75 73 65 72 6e 61  ose.py  --userna
0c60: 6d 65 3d 3c 6d 65 40 65 6d 61 69 6c 2e 63 6f 6d  me=<me@email.com
0c70: 3e 20 2d 2d 70 61 73 73 77 6f 72 64 3d 3c 6d 79  > --password=<my
0c80: 70 61 73 73 77 6f 72 64 3e 20 2d 2d 73 79 6e 63  password> --sync
0c90: 20 2d 2d 68 61 6e 6b 79 0a 0a 0a 23 23 23 20 53   --hanky...### S
0ca0: 6e 6f 74 20 2d 20 4c 69 73 74 20 66 69 6c 65 73  not - List files
0cb0: 20 61 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 73   available for s
0cc0: 79 6e 63 68 72 6f 6e 69 73 61 74 69 6f 6e 20 77  ynchronisation w
0cd0: 69 74 68 20 53 4e 6f 73 65 0a 0a 4c 69 73 74 73  ith SNose..Lists
0ce0: 20 61 6c 6c 20 66 69 6c 65 73 20 6f 6e 20 53 69   all files on Si
0cf0: 6d 70 6c 65 6e 6f 74 65 20 74 61 67 67 65 64 20  mplenote tagged 
0d00: 22 73 6e 6f 73 65 22 3a 0a 0a 20 20 20 20 70 79  "snose":..    py
0d10: 74 68 6f 6e 20 73 6e 6f 73 65 2e 70 79 20 20 2d  thon snose.py  -
0d20: 2d 75 73 65 72 6e 61 6d 65 3d 3c 6d 65 40 65 6d  -username=<me@em
0d30: 61 69 6c 2e 63 6f 6d 3e 20 2d 2d 70 61 73 73 77  ail.com> --passw
0d40: 6f 72 64 3d 3c 6d 79 70 61 73 73 77 6f 72 64 3e  ord=<mypassword>
0d50: 20 2d 2d 73 6e 6f 74 0a 0a 49 20 63 6f 75 6c 64   --snot..I could
0d60: 20 64 6f 20 77 69 74 68 20 6d 61 6b 69 6e 67 20   do with making 
0d70: 74 68 69 73 20 61 6c 73 6f 20 6c 69 73 74 20 77  this also list w
0d80: 68 61 74 20 69 73 20 63 75 72 72 65 6e 74 6c 79  hat is currently
0d90: 20 62 65 69 6e 67 20 73 79 6e 63 68 72 6f 6e 69   being synchroni
0da0: 73 65 64 20 62 61 73 65 64 20 6f 6e 20 74 68 65  sed based on the
0db0: 20 69 6e 64 65 78 2e 20 54 6f 20 6d 61 6b 65 20   index. To make 
0dc0: 74 68 69 73 20 6d 6f 73 74 20 75 73 65 66 75 6c  this most useful
0dd0: 20 49 20 73 75 67 67 65 73 74 20 69 6e 63 6c 75   I suggest inclu
0de0: 64 69 6e 67 20 74 68 65 20 6e 61 6d 65 20 6f 66  ding the name of
0df0: 20 74 68 65 20 66 69 6c 65 20 61 73 20 61 20 63   the file as a c
0e00: 6f 6d 6d 65 6e 74 20 69 6e 20 74 68 65 20 66 69  omment in the fi
0e10: 72 73 74 20 6c 69 6e 65 20 6f 66 20 74 68 65 20  rst line of the 
0e20: 66 69 6c 65 2e 20 49 74 27 73 20 70 72 65 74 74  file. It's prett
0e30: 79 20 73 6c 6f 77 2e 0a 0a 23 23 23 20 42 6c 6f  y slow...### Blo
0e40: 77 20 2d 20 52 6f 6c 6c 62 61 63 6b 20 74 6f 20  w - Rollback to 
0e50: 74 68 65 20 70 72 65 76 69 6f 75 73 20 76 65 72  the previous ver
0e60: 73 69 6f 6e 20 6f 66 20 61 20 6e 6f 74 65 0a 0a  sion of a note..
0e70: 28 59 65 61 68 2c 20 74 68 65 20 63 6f 6d 6d 61  (Yeah, the comma
0e80: 6e 64 20 6e 61 6d 65 73 20 61 72 65 20 67 65 74  nd names are get
0e90: 74 69 6e 67 20 61 20 62 69 74 20 72 75 62 62 69  ting a bit rubbi
0ea0: 73 68 20 6e 6f 77 29 0a 0a 52 6f 6c 6c 73 20 62  sh now)..Rolls b
0eb0: 61 63 6b 20 61 20 6e 6f 74 65 20 62 6f 74 68 20  ack a note both 
0ec0: 6c 6f 63 61 6c 6c 79 20 61 6e 64 20 72 65 6d 6f  locally and remo
0ed0: 74 65 6c 79 20 74 6f 20 74 68 65 20 70 72 65 76  tely to the prev
0ee0: 69 6f 75 73 20 76 65 72 73 69 6f 6e 2e 20 0a 0a  ious version. ..
0ef0: 20 20 20 20 70 79 74 68 6f 6e 20 73 6e 6f 73 65      python snose
0f00: 2e 70 79 20 2d 2d 75 73 65 72 6e 61 6d 65 3d 3c  .py --username=<
0f10: 6d 65 40 65 6d 61 69 6c 2e 63 6f 6d 3e 20 2d 2d  me@email.com> --
0f20: 70 61 73 73 77 6f 72 64 3d 3c 6d 79 70 61 73 73  password=<mypass
0f30: 77 6f 72 64 3e 20 2d 2d 62 6c 6f 77 3d 3c 6b 65  word> --blow=<ke
0f40: 79 3e 0a 0a 54 68 65 20 60 62 6c 6f 77 60 20 63  y>..The `blow` c
0f50: 6f 6d 6d 61 6e 64 20 72 65 71 75 69 72 65 73 20  ommand requires 
0f60: 53 69 6d 70 6c 65 6e 6f 74 65 2e 70 79 20 74 6f  Simplenote.py to
0f70: 20 62 65 20 61 74 20 5b 74 68 69 73 20 63 6f 6d   be at [this com
0f80: 6d 69 74 5d 28 68 74 74 70 73 3a 2f 2f 67 69 74  mit](https://git
0f90: 68 75 62 2e 63 6f 6d 2f 6d 72 74 61 7a 7a 2f 73  hub.com/mrtazz/s
0fa0: 69 6d 70 6c 65 6e 6f 74 65 2e 70 79 2f 63 6f 6d  implenote.py/com
0fb0: 6d 69 74 2f 35 30 65 33 64 65 39 34 37 62 37 30  mit/50e3de947b70
0fc0: 66 61 35 64 39 61 37 66 61 65 65 30 30 34 61 65  fa5d9a7faee004ae
0fd0: 32 30 62 31 36 39 61 31 35 34 37 64 29 20 61 74  20b169a1547d) at
0fe0: 20 6c 65 61 73 74 2e 0a 0a 0a 23 23 20 48 6f 77   least....## How
0ff0: 20 69 74 20 77 6f 72 6b 73 0a 0a 49 74 27 73 20   it works..It's 
1000: 72 65 61 6c 6c 79 20 71 75 69 74 65 20 73 69 6d  really quite sim
1010: 70 6c 65 20 28 61 66 74 65 72 20 61 6c 6c 2c 20  ple (after all, 
1020: 49 27 76 65 20 64 6f 6e 65 20 69 74 29 2c 20 62  I've done it), b
1030: 61 73 69 63 61 6c 6c 79 20 69 74 20 63 72 65 61  asically it crea
1040: 74 65 73 20 61 20 60 2e 73 6e 6f 73 65 60 20 66  tes a `.snose` f
1050: 69 6c 65 20 69 6e 20 74 68 65 20 63 75 72 72 65  ile in the curre
1060: 6e 74 20 64 69 72 65 63 74 6f 72 79 20 74 68 61  nt directory tha
1070: 74 20 69 73 20 6a 73 6f 6e 20 66 6f 72 6d 61 74  t is json format
1080: 74 65 64 2e 20 54 68 69 73 20 69 73 20 62 61 73  ted. This is bas
1090: 69 63 61 6c 6c 79 20 61 20 50 79 74 68 6f 6e 20  ically a Python 
10a0: 64 69 63 74 69 6f 6e 61 72 79 20 74 68 61 74 20  dictionary that 
10b0: 6d 61 70 73 20 61 20 66 69 6c 65 6e 61 6d 65 20  maps a filename 
10c0: 28 66 72 6f 6d 20 74 68 65 20 63 75 72 72 65 6e  (from the curren
10d0: 74 20 64 69 72 65 63 74 6f 72 79 29 20 74 6f 20  t directory) to 
10e0: 61 20 73 69 6d 70 6c 65 6e 6f 74 65 20 6e 6f 74  a simplenote not
10f0: 65 20 28 76 69 61 20 74 68 65 20 6b 65 79 29 20  e (via the key) 
1100: 61 6e 64 20 61 6c 73 6f 20 69 6e 63 6c 75 64 65  and also include
1110: 73 20 6f 74 68 65 72 20 73 69 6d 70 6c 65 6e 6f  s other simpleno
1120: 74 65 20 64 61 74 61 20 73 75 63 68 20 61 73 20  te data such as 
1130: 74 68 65 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e  the modification
1140: 20 64 61 74 65 2c 20 76 65 72 73 69 6f 6e 20 6e   date, version n
1150: 75 6d 62 65 72 20 61 6e 64 20 73 79 6e 63 20 6e  umber and sync n
1160: 75 6d 62 65 72 20 28 73 6f 20 69 74 20 63 61 6e  umber (so it can
1170: 20 66 69 67 75 72 65 20 6f 75 74 20 68 6f 77 20   figure out how 
1180: 74 6f 20 73 79 6e 63 29 2e 0a 0a 49 74 20 74 68  to sync)...It th
1190: 65 6e 20 6a 75 73 74 20 69 6d 70 6c 65 6d 65 6e  en just implemen
11a0: 74 73 20 74 68 65 20 53 69 6d 70 6c 65 6e 6f 74  ts the Simplenot
11b0: 65 20 72 65 63 6f 6d 6d 65 6e 64 61 74 69 6f 6e  e recommendation
11c0: 20 66 72 6f 6d 20 74 68 65 20 61 70 69 3a 0a 0a   from the api:..
11d0: 31 2e 20 49 74 65 72 61 74 65 73 20 74 68 72 6f  1. Iterates thro
11e0: 75 67 68 20 65 61 63 68 20 66 69 6c 65 20 73 74  ugh each file st
11f0: 6f 72 65 64 20 69 6e 20 74 68 65 20 60 2e 73 6e  ored in the `.sn
1200: 6f 73 65 60 20 69 6e 64 65 78 2e 0a 32 2e 20 46  ose` index..2. F
1210: 69 72 73 74 20 6f 66 20 61 6c 6c 20 6c 6f 6f 6b  irst of all look
1220: 73 20 66 6f 72 20 6c 6f 63 61 6c 20 6d 6f 64 69  s for local modi
1230: 66 69 63 61 74 69 6f 6e 73 20 28 63 6f 6d 70 61  fications (compa
1240: 72 65 73 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e  res modification
1250: 20 64 61 74 65 20 6f 66 20 74 68 65 20 66 69 6c   date of the fil
1260: 65 20 77 69 74 68 20 77 68 61 74 20 69 73 20 73  e with what is s
1270: 74 6f 72 65 64 20 69 6e 20 74 68 65 20 69 6e 64  tored in the ind
1280: 65 78 29 2e 20 0a 33 2e 20 54 68 65 6e 20 61 74  ex). .3. Then at
1290: 74 65 6d 70 74 73 20 74 6f 20 75 70 64 61 74 65  tempts to update
12a0: 20 74 68 65 20 72 65 6d 6f 74 65 20 76 65 72 73   the remote vers
12b0: 69 6f 6e 20 6f 6e 20 53 69 6d 70 6c 65 6e 6f 74  ion on Simplenot
12c0: 65 2c 20 62 75 74 20 77 69 6c 6c 20 6d 65 72 67  e, but will merg
12d0: 65 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 69 66  e the content if
12e0: 20 74 68 65 20 72 65 6d 6f 74 65 20 68 61 73 20   the remote has 
12f0: 61 6c 73 6f 20 63 68 61 6e 67 65 64 2e 20 49 66  also changed. If
1300: 20 6d 65 72 67 69 6e 67 20 6f 63 63 75 72 73 20   merging occurs 
1310: 62 6f 74 68 20 74 68 65 20 6c 6f 63 61 6c 20 61  both the local a
1320: 6e 64 20 72 65 6d 6f 74 65 20 61 72 65 20 75 70  nd remote are up
1330: 64 61 74 65 64 2e 0a 34 2e 20 54 68 65 6e 20 63  dated..4. Then c
1340: 68 65 63 6b 73 20 66 6f 72 20 72 65 6d 6f 74 65  hecks for remote
1350: 20 75 70 64 61 74 65 73 20 62 79 20 63 6f 6d 70   updates by comp
1360: 61 72 69 6e 67 20 76 65 72 73 69 6f 6e 20 6e 75  aring version nu
1370: 6d 62 65 72 73 20 61 6e 64 20 75 70 64 61 74 65  mbers and update
1380: 73 20 6c 6f 63 61 6c 20 63 6f 70 69 65 73 20 69  s local copies i
1390: 66 20 6e 65 63 65 73 73 61 72 79 2e 0a 0a 0a 23  f necessary....#
13a0: 23 20 54 6f 20 44 6f 0a 0a 2d 20 3c 73 3e 46 69  # To Do..- <s>Fi
13b0: 6c 65 73 20 69 6e 20 73 75 62 64 69 72 65 63 74  les in subdirect
13c0: 6f 72 69 65 73 2c 20 77 68 61 74 20 68 61 70 70  ories, what happ
13d0: 65 6e 73 20 74 68 65 72 65 3f 20 49 27 76 65 20  ens there? I've 
13e0: 6a 75 73 74 20 61 73 73 75 6d 65 64 20 61 6c 6c  just assumed all
13f0: 20 66 69 6c 65 73 20 69 6e 20 73 61 6d 65 20 64   files in same d
1400: 69 72 65 63 74 6f 72 79 20 61 73 20 69 6e 64 65  irectory as inde
1410: 78 3c 2f 73 3e 20 54 68 65 79 20 77 6f 72 6b 20  x</s> They work 
1420: 6a 75 73 74 20 66 69 6e 65 21 20 48 6f 77 65 76  just fine! Howev
1430: 65 72 2c 20 72 6f 62 75 73 74 20 63 72 6f 73 73  er, robust cross
1440: 2d 70 6c 61 74 66 6f 72 6d 20 73 75 70 70 6f 72  -platform suppor
1450: 74 20 77 6f 75 6c 64 20 62 65 20 6e 69 63 65 20  t would be nice 
1460: 74 6f 20 68 61 6e 64 6c 65 2f 69 6e 74 65 72 70  to handle/interp
1470: 72 65 74 20 66 69 6c 65 20 70 61 74 68 20 64 69  ret file path di
1480: 66 66 65 72 65 6e 63 65 73 20 62 65 74 77 65 65  fferences betwee
1490: 6e 20 70 6c 61 74 66 6f 72 6d 73 2e 0a 2d 20 3c  n platforms..- <
14a0: 73 3e 55 73 69 6e 67 20 74 61 67 73 20 74 6f 20  s>Using tags to 
14b0: 63 6f 6e 74 61 69 6e 20 66 69 6c 65 6e 61 6d 65  contain filename
14c0: 3a 20 22 66 69 6c 65 6e 61 6d 65 3a 70 61 6e 74  : "filename:pant
14d0: 73 2e 74 78 74 22 20 53 6f 6d 65 20 70 6f 74 65  s.txt" Some pote
14e0: 6e 74 69 61 6c 20 63 68 61 72 61 63 74 65 72 20  ntial character 
14f0: 6c 69 6d 69 74 61 74 69 6f 6e 73 20 74 68 6f 75  limitations thou
1500: 67 68 3f 20 42 75 74 20 61 6e 20 69 6e 74 65 72  gh? But an inter
1510: 65 73 74 69 6e 67 20 69 64 65 61 20 66 6f 72 20  esting idea for 
1520: 6d 65 74 61 20 64 61 74 61 2e 3c 2f 73 3e 20 2d  meta data.</s> -
1530: 20 49 20 77 65 6e 74 20 66 6f 72 20 70 75 6c 6c   I went for pull
1540: 69 6e 67 20 69 74 20 66 72 6f 6d 20 61 20 63 6f  ing it from a co
1550: 6d 6d 65 6e 74 65 64 20 6c 69 6e 65 20 69 6e 20  mmented line in 
1560: 74 68 65 20 66 69 6c 65 20 69 6e 73 74 65 61 64  the file instead
1570: 2e 0a 2d 20 41 64 64 20 61 62 69 6c 69 74 79 20  ..- Add ability 
1580: 74 6f 20 22 73 6e 6f 72 74 22 20 6d 75 6c 74 69  to "snort" multi
1590: 70 6c 65 20 66 69 6c 65 73 0a 2d 20 4c 69 73 74  ple files.- List
15a0: 20 66 69 6c 65 73 20 63 75 72 72 65 6e 74 6c 79   files currently
15b0: 20 62 65 69 6e 67 20 73 79 6e 63 68 72 6f 6e 69   being synchroni
15c0: 73 65 64 20 28 72 65 61 64 20 74 68 65 20 2e 73  sed (read the .s
15d0: 6e 6f 73 65 20 69 6e 64 65 78 29 2e 20 54 68 65  nose index). The
15e0: 20 60 2d 2d 73 6e 6f 74 60 20 6c 69 73 74 73 20   `--snot` lists 
15f0: 66 69 6c 65 73 20 74 61 67 67 65 64 20 2a 73 6e  files tagged *sn
1600: 6f 73 65 2a 20 6f 6e 20 53 69 6d 70 6c 65 6e 6f  ose* on Simpleno
1610: 74 65 20 61 6e 64 20 74 68 65 20 74 77 6f 20 6d  te and the two m
1620: 69 67 68 74 20 6e 6f 74 20 6e 65 63 65 73 73 61  ight not necessa
1630: 72 69 6c 79 20 62 65 20 74 68 65 20 73 61 6d 65  rily be the same
1640: 20 28 69 2e 65 20 79 6f 75 27 76 65 20 63 68 6f   (i.e you've cho
1650: 73 65 20 74 6f 20 73 79 6e 63 20 73 6f 6d 65 20  se to sync some 
1660: 66 69 6c 65 73 20 6f 6e 20 6f 6e 65 20 6d 61 63  files on one mac
1670: 68 69 6e 65 20 61 6e 64 20 61 20 64 69 66 66 65  hine and a diffe
1680: 72 65 6e 74 20 73 65 74 20 6f 6e 20 61 6e 6f 74  rent set on anot
1690: 68 65 72 29 2e 0a 2d 20 57 72 69 74 65 20 75 70  her)..- Write up
16a0: 64 61 74 65 64 20 69 6e 64 65 78 20 66 69 6c 65  dated index file
16b0: 20 6f 6e 63 65 20 61 66 74 65 72 20 73 79 6e 63   once after sync
16c0: 2c 20 69 6e 73 74 65 61 64 20 6f 66 20 77 72 69  , instead of wri
16d0: 74 69 6e 67 20 66 6f 72 20 65 61 63 68 20 66 69  ting for each fi
16e0: 6c 65 20 63 68 61 6e 67 65 20 28 61 6c 74 68 6f  le change (altho
16f0: 75 67 68 20 77 72 69 74 69 6e 67 20 70 65 72 20  ugh writing per 
1700: 66 69 6c 65 20 64 6f 65 73 20 68 61 76 65 20 69  file does have i
1710: 74 27 73 20 61 64 76 61 6e 74 61 67 65 20 66 72  t's advantage fr
1720: 6f 6d 20 61 6e 20 65 72 72 6f 72 20 68 61 6e 64  om an error hand
1730: 6c 69 6e 67 20 70 6f 69 6e 74 20 6f 66 20 76 69  ling point of vi
1740: 65 77 29 0a                                      ew).