atviriduomenys / spinta

Spinta is a framework to describe, extract and publish data (a DEP Framework).
MIT License
10 stars 4 forks source link

First release rcX versions #669

Open sirex opened 2 days ago

sirex commented 2 days ago

Currently Spinta always releasing stable versions, which are not stable, most of the time.

Instead of releasing stable versions like:

First release candidates:

In other words, release a testing version before, stable version.

Version numbers should be formatted according to Version Specifiers documentation.

Also we need to update documentation, how to install release candidate versions into an isolated version.

Link to documentation, where a new chapter should be added:

https://github.com/atviriduomenys/vadovas/blob/e2a2b793b779ded400ff7af8e84c5c8b9161f7bb/vadovas/spinta.rst?plain=1#L308-L312

New chapter should be added before "Atnaujinimas" and should be named "Testinės aplinkos diegimas".

Documentation should explain how to install release candidate version, as documented here:

Also we need to make sure, that all configuration files are isolated from stable version and documentation should recommend following isolation steps:

BASEDIR=test/0.1.64
mkdir -p $BASEDIR
python -m venv $BASEDIR/venv
source $BASEDIR/venv/bin/activate
pip install --upgrade --pre spinta
cat $BASEDIR/config.yml
cat > $BASEDIR/config.yml <<EOF
env: production
config_path: $PWD/$BASEDIR
data_path: $PWD/$BASEDIR
default_auth_client: default

keymaps:
  default:
    type: sqlalchemy
    dsn: sqlite:///$PWD/$BASEDIR/keymap.db

backends:
  default:
    type: sql
    dsn: dialect+driver://user:password@host:port/db

manifest: default
manifests:
  default:
    type: csv
    path: $PWD/$BASEDIR/manifest.csv
    backend: default
    keymap: default
    mode: internal

accesslog:
  type: file
  file: $PWD/$BASEDIR/accesslog.json
EOF
export SPINTA_CONFIG=$BASEDIR/config.yml

In order to test with all the configuration and data files copy following files:

cp -avi ~/.config/spinta $BASEDIR
cp -avi ~/.local/share/spinta $BASEDIR

This way files will be preserved.

sirex commented 2 days ago

Dokumentacija, dėl testavimo atnaujinta.

https://atviriduomenys.readthedocs.io/spinta.html#testavimas