https://github.com/zgoda/devlog

My dev log
https://github.com/zgoda/devlog

devlog flask flask-app flask-blog polish polish-language polski

Last synced: 6 days ago
JSON representation

My dev log

• Host: GitHub
• URL: https://github.com/zgoda/devlog
• Owner: zgoda
• License: mit
• Created: 2019-02-20T22:31:01.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2023-10-26T20:40:51.000Z (over 2 years ago)
• Last Synced: 2025-08-20T09:56:54.831Z (11 months ago)
• Topics: devlog, flask, flask-app, flask-blog, polish, polish-language, polski
• Language: Python
• Homepage: http://devlog.zgodowie.org
• Size: 4.32 MB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Devlog

![Tests](https://github.com/zgoda/devlog/workflows/Tests/badge.svg?branch=master) [![CodeFactor](https://www.codefactor.io/repository/github/zgoda/devlog/badge)](https://www.codefactor.io/repository/github/zgoda/devlog) [![Coverage Status](https://coveralls.io/repos/github/zgoda/devlog/badge.svg?branch=master)](https://coveralls.io/github/zgoda/devlog?branch=master)

My dev log and other logs.

A very simple blogging engine that I often use to test some ideas wrt web programming (and general programming) in Python.

## Development

### Grab the source

```console

git clone https://github.com/zgoda/devlog.git

```

### Set up local Python runtime

Python 3.8 or newer is required. In Ubuntu 22.04 default is Python 3.10 so you should be good to go. It's best to update installation tools upfront.

```console

/usr/bin/python3 -m venv venv

source venv/bin/activate

pip install -U pip setuptools

```

With activated virtualenv you now may install Devlog in dev mode.

```console

pip install -U -e .[dev]

```

Now copy `.env.example` to `.env` and modify it to suit your environment. Some JS tools are required so run `npm i`. I tested it with Node 18 but it may work with older versions. This will install `cleancss-cli` tool, you will need an implementation of SASS too. Either download `dart-sass` and put it in `PATH` (eg `~/.local/bin` on Ubuntu) or install JS version with `npm i -D sass`.

Once installed Devlog provides CLI for basic management. 1st thing is to initialise database.

```console

devlog db init

```

Now you may launch your local instance. By default it listens on port 5000 and it's bound only to 127.0.0.1. This is fine if you want to access it only from emulator running on the same machine (use 10.0.2.2:5000 as host name), otherwise you may specify host and port using `-h` and `-p` parameters.

```console

devlog run

```

There's a lot of command line options, consult `--help` to learn more.