45 releases (24 breaking)

0.37.0 Feb 1, 2024
0.36.1 Dec 6, 2023
0.36.0 Nov 19, 2023
0.34.5 Jun 27, 2023
0.17.1 Nov 23, 2020

#98 in Database interfaces

Download history 88/week @ 2023-10-30 3/week @ 2023-11-06 76/week @ 2023-11-13 61/week @ 2023-11-20 167/week @ 2023-11-27 81/week @ 2023-12-04 11/week @ 2023-12-11 62/week @ 2023-12-18 105/week @ 2023-12-25 47/week @ 2024-01-01 45/week @ 2024-01-15 31/week @ 2024-01-22 213/week @ 2024-01-29 3/week @ 2024-02-05 170/week @ 2024-02-12

426 downloads per month

MIT license

435KB
9K SLoC

atomic-cli

crates.io Discord chat MIT licensed github

Status: Beta. Breaking changes are expected until 1.0.

A command-line application to create, read and interact with Atomic Data.

Designed and tested to work with atomic-server.

atomic-cli 0.23.2
Joep Meindertsma <joep@ontola.io>
Create, share, fetch and model Atomic Data!

USAGE:
    atomic-cli [SUBCOMMAND]

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

SUBCOMMANDS:
    destroy    Permanently removes a Resource.
    edit       Edit a single Atom from a Resource using your text editor.
    get        Get a Resource or Value by using Atomic Paths.
    help       Prints this message or the help of the given subcommand(s)
    list       List all bookmarks
    new        Create a Resource
    remove     Remove a single Atom from a Resource.
    set        Update a single Atom. Creates both the Resource if they don't exist. Overwrites existing.

Visit https://atomicdata.dev for more info

Installation

You can install `atomic-cli: in multiple ways:

Using Cargo

cargo install atomic-cli

Build from source

git clone git@github.com:atomicdata-dev/atomic-server.git
cd atomic/cli
# Install atomic to path
cargo install --path ./

Usage

Run atomic-cli command --help for mor information about specific commands.

The write commands (set, remove, edit, destroy) require some authentication config, which needs to match with the target atomic-server. It will read the ~/.config/atomic/config.toml file, and create one using some prompts if it is not yet present.

Features

  • A list command for showing local bookmarks (mappings)
  • A get command for finding resources and parts of data using Atomic Paths with various serialization options (JSON, JSON-AD, JSON-LD, Turtle, N-Triples, Pretty). Also supports path traversal.
  • set, remove, destroy and edit commands that send commits.
  • A new command for instantiating Atomic Classes

Config

Atomic creates a ~/.config/atomic folder, which contains a mapping.amp and a db. This folder is also used by atomic-server.

Mapping

The Mapping refers to your user specific set of shortname-URL combinations. This Mapping lives as a simple text file in ./user_mappping.amp.

person=https://atomicdata.dev/classes/Person

Dependencies

~17–30MB
~575K SLoC