96 lines
3.5 KiB
Org Mode
96 lines
3.5 KiB
Org Mode
# TODO hmm, preamble?
|
|
# TODO hci??
|
|
[[https://circleci.com/gh/karlicoss/my/tree/master][https://circleci.com/gh/karlicoss/my/tree/master.svg?style=svg]]
|
|
|
|
|
|
* Setting up
|
|
** =mycfg= package for private paths/repositories (optional)
|
|
If you're not planning to use private configuration (some modules don't need it) you can skip straight to the next step. Still, I'd recommend you to read anyway.
|
|
|
|
First you need to tell the package where to look for your data and external repositories, which is done though a separate (private) package named ~mycfg~.
|
|
|
|
You can see example in ~mycfg_template~. You can copy it somewhere else and modify to your needs.
|
|
|
|
Some explanations:
|
|
|
|
#+begin_src bash :exports results :results output
|
|
for x in $(find mycfg_template/ | grep -v -E 'mypy_cache|.git|__pycache__|scignore'); do
|
|
if [[ -L "$x" ]]; then
|
|
echo "l $x -> $(readlink $x)"
|
|
elif [[ -d "$x" ]]; then
|
|
echo "d $x"
|
|
else
|
|
echo "f $x"
|
|
(echo "---"; cat "$x"; echo "---" ) | sed 's/^/ /'
|
|
fi
|
|
done
|
|
#+end_src
|
|
|
|
#+RESULTS:
|
|
#+begin_example
|
|
d mycfg_template/
|
|
d mycfg_template/mycfg
|
|
f mycfg_template/mycfg/__init__.py
|
|
---
|
|
class paths:
|
|
"""
|
|
Feel free to remove this if you don't need it/add your own custom settings and use them
|
|
"""
|
|
class hypothesis:
|
|
export_path = '/tmp/my_demo/backups/hypothesis'
|
|
---
|
|
d mycfg_template/mycfg/repos
|
|
l mycfg_template/mycfg/repos/hypexport -> /tmp/my_demo/hypothesis_repo
|
|
#+end_example
|
|
|
|
As you can see, generally you specify fixed paths (e.g. to backup directory) in ~__init__.py~.
|
|
Feel free to add other files as well though to organize better, it's a real python package after all!
|
|
|
|
Some things (e.g. links to external packages like [[https://github.com/karlicoss/hypexport][hypexport]]) are specified as normal symlinks in ~repos~ directory.
|
|
That way you get easy imports (e.g. =import mycfg.repos.hypexport.model=) and proper IDE integration.
|
|
|
|
# TODO link to post about exports?
|
|
** =with_my= helper script
|
|
Next, point =with_my= script to your private configuration:
|
|
|
|
#+begin_src bash
|
|
cp with_my.example with_my
|
|
vim with_my # specify path to your mycfg (if you want to use it)
|
|
#+end_src
|
|
|
|
It's also convenient to put =with_my= somewhere in your system path so you can run it from anywhere.
|
|
|
|
** Dependencies
|
|
Dependencies are different for specific modules you're planning to use, so it's hard to specify.
|
|
Generally you can just try using the module and then install missing packages via ~pip install --user~, should be fairly straightforward.
|
|
|
|
* Usage examples
|
|
If you run your script with ~with_my~ wrapper, you'd have ~my~ in ~PYTHONPATH~ which gives you access to your data from within the script.
|
|
|
|
- accessing Kobo books
|
|
|
|
#+begin_src bash
|
|
with_my python3 -c 'import my.books.kobo as kobo; print(kobo.get_todos())'
|
|
#+end_src
|
|
|
|
- if you have [[https://github.com/karlicoss/orger][orger]] installed, you can use its modules to get Org-mode representations of your data. For instance, rendering [[https://github.com/burtonator/polar-bookshelf][Polar]] highlights as org-mode file as easy as:
|
|
#+begin_src bash
|
|
with_my orger/modules/polar.py --to polar.org
|
|
#+end_src
|
|
|
|
- read/run [[./demo.py][demo.py]] for a full demonstration of setting up Hypothesis (it uses public annotations data from Github)
|
|
|
|
|
|
* Linting
|
|
|
|
#+begin_src bash
|
|
# see https://github.com/python/mypy/issues/1645 for --namespace-packages explanation
|
|
with_my mypy --namespace-packages my
|
|
#+end_src
|
|
|
|
or, set up as ~mypy.ini~ file:
|
|
|
|
#+begin_src
|
|
[mypy]
|
|
mypy_path=/path/to/mycfg_dir
|
|
#+end_src
|