Skip to main content

journalist

App to write journal digitally.

PyPI version

Features

  • Write your journal using Markdown in your favorite text-editor.

  • Stores written journals in a comprehensive directory structure.

  • View the journals (Markdown rendered in HTML) in browser.

Installation

Install it using pip

pip install journalist

Usage

sumit at HAL9000 in ~
$ python3 journalist.py -h
usage: journalist.py [-h] {write,view} name

positional arguments:
  {write,view}  Task to do
  name          The name of the journal

optional arguments:
  -h, --help    show this help message and exit

Usage Examples

Writing journal

Journals are stored in the directory ~/.journalist in the following structure.

.journalist
└── journalname
     └── YYYY
        └── MM
            └── YYYY-MM-DD-Day.md

For example, an example ~/.Journalist directory may contain

sumit@HAL9000:pts/0->/home/sumit (0)
> tree .journalist
.journalist
├── personal
│   ├── 2017
│   │   └── 12
│   │       └── 2017-12-28-Thu.md
│   └── 2018
│       └── 01
└── technical
    ├── 2017
    │   └── 12
    │       ├── 2017-12-28-Thu.md
    │       └── 2017-12-29-Fri.md
    └── 2018
        └── 01
            └── 2018-01-03-Wed.md

10 directories, 4 files

To write in a the journal personal, type in the following…

sumit at HAL9000 in ~
$ python3 journalist.py write personal
  • If any journal named personal already exists, it will open up the relevant .md file corresponding to the system date (creating it if it doesn’t exist).

  • If any journal named personal doesn’t exist, it will prompt the user if they want to create a new journal. If they agree, it will do so and open the corresponding .md file as described above.

The markdown file will be opened in the editor mentioned in the config.yaml file (default is nano). If you change it to something else, make sure an file named filename.md can be opened using that editor by typing editor filename.md in the terminal.

Viewing journal

sumit at HAL9000 in ~
$ python3 journalist.py view personal
[*] Starting Journalist viewer webapp...
[*] View this journal at http://127.0.0.1:5000/journalist?name=personal
 * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)

Opening the URL http://127.0.0.1:5000/journalist?name=personal in the browser would show us the journal entries rendered in HTML.

Release files for journalist 0.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for journalist 0.0.3
File Size Uploaded
journalist-0.0.3.tar.gz 5.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for journalist 0.0.3
File Interpreter ABI Platform
journalist-0.0.3-py3-none-any.whl Python 3 none any Details

Total release size: 11.5 kB

Release files / journalist-0.0.3.tar.gz

Download URL journalist-0.0.3.tar.gz
Size 5.6 kB
Tags Source
SHA-256 checksum
How to use checksums
f0579cb7efb67f2f177b60d42315bda63fdd253eaa9d3f9f7ca61db818cf679c
BLAKE2b-256 checksum
How to use checksums
11a382daefb888e0c9938a588728b60d182b7214d03ffac44bd39e6887aa5113
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / journalist-0.0.3-py3-none-any.whl

Download URL journalist-0.0.3-py3-none-any.whl
Size 6.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cb11cc51d4c32e0c1e202d378508a4164532e46f4e7945165deb3a1c795744e1
BLAKE2b-256 checksum
How to use checksums
e3fa94070d2f1f2a27b7be69bc14cd7e597063bbe265166096b3d4c5483bf2d7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.0.3 This release

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page