koordinates / sno

Sno: Distributed version-control for datasets

Installing

Upgrading to v0.5.0

See the v0.5.0 release notes for changes, upgrading, and compatibility notes.

Windows

Download the .msi installer from the release page.

💡 If Windows Defender SmartScreen says "it prevented an unrecognized app from starting" after downloading, you'll need to click "Run anyway".

macOS

Download the .pkg installer from the release page;

Or use Homebrew to install: brew cask install koordinates/sno/sno

Linux

For Debian/Ubuntu-based distributions, download the .deb package from the release page and install via dpkg -i sno_*.deb.

For RPM-based distributions, download the .rpm package from the release page and install via rpm -i sno-*.rpm.

Source

For Sno development see the Contributing Notes.

Usage

See the documentation for tutorials and reference.

💡 If you're new to git

Configure the identity you will use for Sno commits with:

$ sno config --global user.email "you@example.com"
$ sno config --global user.name "Your Name"

Quick Start

1. Export a GeoPackage from Koordinates with any combination of vector layers and tables.
2. Create a new Sno repository and import the GeoPackage (eg. kx-foo-layer.gpkg).

   $ sno init myproject --import GPKG:kx-foo-layer.gpkg
   $ cd myproject

   Use this repository as the directory to run all the other commands in. This will also create a working copy as myproject/myproject.gpkg to edit.
3. Editing the working copy in QGIS/etc:
   • will track changes in the internal .sno-* tables
   • additions/edits/deletes of features are supported
   • changing feature PKs is supported
   • schema changes should be detected, but aren't supported yet (will error).
   • Use F5 to refresh your QGIS map after changing the underlying working-copy data using sno.
4. With your working copy, sno commands should work if run from the myproject/ folder. Check --help for options, the most important ones are supported. In some cases options are passed straight through to an underlying git command:
   • sno diff diff the working copy against the repository (no index!)
   • sno commit -m {message} commit outstanding changes from the working copy
   • sno log review commit history
   • sno branch & sno checkout -b branch management
   • sno fetch fetch upstream changes.
   • sno status show working copy state.
   • sno merge merge. Supports --ff/--no-ff/--ff-only from one merge source.
   • sno switch switch to existing or new branches.
   • sno reset & sno restore discard changes in the working copy.
   • sno tag ...
   • sno remote .... Remember simple remotes can just be another local directory.
   • sno push / sno pull
   • sno clone initialise a new repository from a remote URL,

License

GPLv2 with linking exception

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License, version 2, as published by the Free Software Foundation.

In addition to the permissions in the GNU General Public License, the authors give you unlimited permission to link the compiled version of this file into combinations with other programs, and to distribute those combinations without any restriction coming from the use of this file. (The General Public License restrictions do apply in other respects; for example, they cover modification of the file, and distribution when not linked into a combined executable.)

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; see the file COPYING. If not, write to the Free Software Foundation, 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.