Create and open notes in your favourite editor.
Project description
Take Note
Create and open notes in your favourite editor.
Features
- Open notes files for specified week using the
code
command line for VS Code.- --thisWeek, --lastWeek and --nextWeek are supported.
- Organises notes in a date based folder structure from your root notes folder, e.g. 2023/08
- set the root notes folder using --notesFolder
- Choose which editor to use with --editor
- Specify a VS Code workspace to open along with the note file with --workspace
- This will override the --editor setting to
code
- This will override the --editor setting to
- Specify a template file relative to the root notes folder to use when a new file is created using --template. This also performs a simple replacement of the text HEADER_DATE with the date formatted as "%A %d %B %Y" to use in the document title.
Future features
- Support for daily notes options.
- Support for batch creation of files in advance. This is useful if you use a device where you can edit files, but can't easily create them.
- Test on older versions of Python and release for 3.8+.
Installation
pipx
The recommended way to install the pubished package is through pipx.
# from PyPI
pipx install take-note
# direct from github
pipx install git+https://github.com/wsinned/take-note
Virtual Environment
python -m venv venv
source venv/bin/activate
venv/bin/pip install -r requirements.txt
# install with tests as editable src
venv/bin/pip install -e .
Usage
Specify a folder using the --notesFolder option, otherwise $HOME/Notes will be used A week option must be supplied from --thisWeek, --lastWeek or --nextWeek
venv/bin/take-note --notesFolder=$HOME/MyNotes --thisWeek
A note will be created in the under the MyNotes/YYYY/mm folder named with the date of the Monday of this week, e.g. 2023-08-07-Weekly-log.md
Development
Nix & NixOS
The supplied shell.nix definition provides support for entering a nix-shell directly in the repository with all dependencies.
nix-shell --run zsh # ensure using zsh over default bash session
# only needed once, or to recreate the virtual environment
python -m venv venv
source venv/bin/activate
# install with tests as editable src
venv/bin/pip install -e '.[test]'
# run the tests
pytest
# close the virtual environment and exit the shell when done
deactivate
exit
Other Linux or MacOS
# only needed once, or to recreate the virtual environment
python -m venv venv
source venv/bin/activate
venv/bin/pip install -r requirements.txt -r requirements.dev.txt
# install with tests as editable src
venv/bin/pip install -e '.[test]'
# run the tests
venv/bin/pytest
# close the virtual environment when done
deactivate
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
take-note-cli-1.0.0.tar.gz
(5.5 kB
view hashes)
Built Distribution
Close
Hashes for take_note_cli-1.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a8a092e0d9c3ad25bfee37d12b481985dbbefd0df1f6c7d8cbba9d1d76dc9f10 |
|
MD5 | a68835b78b8473f57ccf702978371b35 |
|
BLAKE2b-256 | 3ff632f31accf4e9bc982bea22abb6879d1c87b1a62828e2b6c4349791ad14bf |