contexere 1.2.0

Installation

The module contexere can be installed from PyPi:

pip install contexere

Usage

The project provides the command line tool nxt:

usage: nxt [-h] [--version] [-g GROUP] [-k KEYWORDS [KEYWORDS ...]] [-l] [-p] [-r [REFERENCE]] [-s] [-u] [-v] [-vv] [target]

Suggest name for research artefact

positional arguments:
  target                Either a project identifier, filename, or folder

options:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  -g, --group GROUP     Project identifier for which the next research artefact GROUP will be suggested
  -k, --keywords KEYWORDS [KEYWORDS ...]
                        Optional argument for --clone adding one or more keywords to the filename
  -l, --local           Inspect files in current working dir only
  -p, --project         Create new project directory structure
  -r, --reference [REFERENCE]
                        Optional argument indicating reference of cloned file if used without arguments or accepting comma
                        separated list of references.
  -s, --summary         Summarise files following the naming convention
  -u, --utc             Generate timestamp with respect to UTC (default is local timezone)
  -v, --verbose         set loglevel to INFO
  -vv, --very-verbose   set loglevel to DEBUG

Calling the tool without any arguments in an empty directory returns the date abbreviation of today appended by the first daily counter (a):

$ nxt
26s6a

The date abbreviation indicates that the nxt command in this example was called on 6 May 2026. The following examples assume that all following commands of nxt were also called on 6 May 2026.

Calling the nxt command at the root of a directory structure, which contains files following the naming scheme, finds the latest research artefact group (RAG) and uses the respective project identifier to suggest a new RAG:

$ nxt --project  # Followed by a dialog specifying the new project ERP (Example Research Project)
$ cd ERP
$ nxt
ERP26s6b

The suggested RAG ERP26s6b is the second RAG (b) of 9 May 2026, because nxt --project creates template files starting with ERP26s6a like notebooks/ERP26s6a__template_notebook.ipynb.

An overview of the existing files associated with RAGs gives the command nxt --summary, which provides a tabular output of all RAGs in the directory hierarchy:

$ nxt --summary
Project RAGs Files Latest
ERP        1     4  26s6a
KM         1     1  26oOa

Let’s assume that ERP project has been put under git revision control and we want to create a clone of the Jupyter notebook template:

$ nxt notebooks/ERP26s6a__template_notebook.ipynb --keywords poc
[main .......] Cloned from ERP26s6a__template_notebook.ipynb
 1 file changed, 54 insertions(+)
 create mode 100755 notebooks ERP2RP26s6b_poc.ipynb
Added cloned file ERP2RP26s6b_poc.ipynb to the git repository.

The cloned file is added automatically to the git repository of the project such that all edits can be tracked systematically.

Let’s assume that we want to follow-up with a visualisation of data or results generated by ERP26s6b__poc.ipynb. In this case, we might want to continue from the configuration provided in ERP26s6b__poc.ipynb. The command:

$ nxt notebooks/ERP26s6b__poc.ipynb --reference --keywords visualisation

Creates a copy of ERP26s6b__poc.ipynb in directory notebooks named:

ERP26s6c_b__visualisation.ipynb

Note, that the cloned RAG references the original RAG but abbreviates the reference. In another rapid development cycle, we might want to continue from ERP26s6b, but this time using additional data provided by a completely different project DS25zAa. The commands:

$ cd notebooks
$ nxt ERP26s6b__poc.ipynb --reference s6b,DS25zAa --keywords simulation

Create a fourth notebook named:

ERP26s6d_b_DS25zAa__simulation.ipynb

Again providing an efficient referencing of the input RAGs and thus creating a directed graph of RAGs. Note, that the provided reference s6b is an abbreviation of ERP26s6b.

[1] Andreas W. Kempa-Liehr. Contexere—Systematic Tracking and Referencing of Digital Artefacts for Postgraduate Students and Early Career Researchers. In: Data 11.6 (2026). DOI: 10.3390/data11060140