rcdb 2.2.7__tar.gz → 2.2.8__tar.gz

{rcdb-2.2.7/rcdb.egg-info → rcdb-2.2.8}/PKG-INFO

@@ -1,17 +1,19 @@
 Metadata-Version: 2.4
 Name: rcdb
-Version: 2.2.7
+Version: 2.2.8
 Summary: RCDB - Run Conditions DataBase
 Author-email: Dmitry Romanov <romanov@jlab.org>
 License-Expression: MIT
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Scientific/Engineering :: Physics
 Classifier: Topic :: Database

{rcdb-2.2.7 → rcdb-2.2.8}/pyproject.toml

@@ -19,14 +19,16 @@ authors = [
     { name="Dmitry Romanov", email="romanov@jlab.org" }
 ]
 classifiers = [
-    "Development Status :: 4 - Beta",
+    "Development Status :: 5 - Production/Stable",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: Implementation :: CPython",
     "Intended Audience :: Science/Research",
+    "Intended Audience :: Developers",
     "Operating System :: OS Independent",
     "Topic :: Scientific/Engineering :: Physics",
     "Topic :: Database"

{rcdb-2.2.7 → rcdb-2.2.8}/rcdb/cli/app.py

@@ -7,12 +7,14 @@ from click import Command
 from rcdb.app_context import RcdbApplicationContext, parse_run_range
 from rcdb import RCDBProvider
 from rcdb.model import ConfigurationFile
+from rcdb.version import version as rcdb_version
 
-from .ls import ls as ls_cmd
-from .repair import repair as repair_grp
-from .db import db as db_grp
-from .rp import rp as rp_grp
-from .web import web as web_cmd
+from .ls import ls_command
+from .repair import repair_command
+from .db import db_command
+from .rp import rp_command
+from .web import web_command
+from .info import info_command
 
 
 pass_rcdb_context = click.make_pass_decorator(RcdbApplicationContext)
@@ -23,14 +25,11 @@ def get_default_config_path():
 
 
 @click.group(invoke_without_command=True)
-@click.option('--user-config', envvar='RCDB_USER_CONFIG', default=get_default_config_path,
-              metavar='PATH', help='Changes the user config location.')
-@click.option('--connection', '-c', envvar='RCDB_CONNECTION', help='Database connection string',
-              default=None, required=False)
-@click.option('--config', nargs=2, multiple=True,
-              metavar='KEY VALUE', help='Overrides a config key/value pair.')
+@click.option('--user-config', envvar='RCDB_USER_CONFIG', default=get_default_config_path, metavar='PATH', help='Changes the user config location.')
+@click.option('--connection', '-c', envvar='RCDB_CONNECTION', help='Database connection string', default=None, required=False)
+@click.option('--config', nargs=2, multiple=True, metavar='KEY VALUE', help='Overrides a config key/value pair.')
 @click.option('--verbose', '-v', is_flag=True, help='Enables verbose mode.')
-@click.version_option('1.0')
+@click.version_option(rcdb_version)
 @click.pass_context
 def rcdb_cli(ctx, user_config, connection, config, verbose):
     """'rcdb' is a RCDB (run conditions database) command line tool
@@ -57,50 +56,11 @@ def rcdb_cli(ctx, user_config, connection, config, verbose):
         click.echo(ctx.get_help())
 
 
-# Add ls command
-# noinspection PyTypeChecker
-rcdb_cli.add_command(ls_cmd)
-
-# Add 'repair' group of commands
-# noinspection PyTypeChecker
-rcdb_cli.add_command(repair_grp)
-
-# Add 'db' group of commands
-# noinspection PyTypeChecker
-rcdb_cli.add_command(db_grp)
-
-# Add 'rp' group of commands
-# noinspection PyTypeChecker
-rcdb_cli.add_command(rp_grp)
-
-# Add 'web' group of commands
-# noinspection PyTypeChecker
-rcdb_cli.add_command(web_cmd)
-
-
-@rcdb_cli.command()
-@pass_rcdb_context
-@click.argument('run', required=True)
-@click.option('--long', '-l', 'is_long', is_flag=True, help='Prints condition full information')
-def files(context, run, is_long):
-    """
-    Shows files stored for a current run:
-
-    RUN: Run number to show files for
-    """
-    db = context.db
-    assert isinstance(db, RCDBProvider)
-
-    run = db.get_run(int(run))
-
-    for file in run.files:
-        assert isinstance(file, ConfigurationFile)
-        click.echo(file.path)
-
-
-def cat():
-    pass
-
-def dump():
-    pass
+# Add commands to application
+rcdb_cli.add_command(ls_command)
+rcdb_cli.add_command(repair_command)
+rcdb_cli.add_command(db_command)
+rcdb_cli.add_command(rp_command)
+rcdb_cli.add_command(web_command)
+rcdb_cli.add_command(info_command)
 

{rcdb-2.2.7 → rcdb-2.2.8}/rcdb/cli/db.py

@@ -10,9 +10,9 @@ from rcdb.cli.context import pass_rcdb_context
 from rcdb.provider import stamp_schema_version
 
 
-@click.group(invoke_without_command=True)
+@click.group(name="db", invoke_without_command=True)
 @click.pass_context
-def db(ctx):
+def db_command(ctx):
     """Database management commands."""
     if ctx.invoked_subcommand is None:
         connection_str = ctx.obj.connection_str
@@ -29,7 +29,7 @@ def db(ctx):
         print("Schema version: {} - '{}'".format(schema_version.version, schema_version.comment))
 
 
-@db.command()
+@db_command.command()
 @pass_rcdb_context
 def update(context):
     provider = RCDBProvider(context.connection_str, check_version=False)
@@ -102,7 +102,7 @@ def update(context):
     print("Stamped schema version: {} - '{}'".format(version.version, version.comment))
 
 
-@db.command()
+@db_command.command()
 @click.option('--no-defaults', is_flag=True, help="Don't create default condition types")
 @click.option('--drop-all', is_flag=True, help='Drops existing RCDB data if exists')
 @click.option('--confirm', is_flag=True, help='For CI automation and tests')

rcdb-2.2.8/rcdb/cli/info.py

@@ -0,0 +1,53 @@
+import click
+import datetime
+from .context import pass_rcdb_context
+from rcdb.model import Condition, Run, ConfigurationFile, RunPeriod
+
+
+@click.command("info", help="Prints summary info about RCDB contents")
+@pass_rcdb_context
+def info_command(context):
+    """
+    Shows various summary information about the RCDB database contents.
+    """
+    db = context.db
+
+    # Number of conditions
+    cnd_count = db.session.query(Condition).count()
+
+    # Date-time of the last condition added:
+    last_cnd = db.session.query(Condition).order_by(Condition.id.desc()).first()
+    cnd_last_time = last_cnd.created if (last_cnd and hasattr(last_cnd, 'created')) else None
+
+    # Number of runs saved
+    run_count = db.session.query(Run).count()
+
+    # Number of files saved
+    file_count = db.session.query(ConfigurationFile).count()
+
+    # The last 5 runs saved (by run_number DESC)
+    last_5_runs = db.session.query(Run).order_by(Run.number.desc()).limit(5).all()
+
+    # The number of run periods saved
+    rp_count = db.session.query(RunPeriod).count()
+
+    # 6. The last run period (by ID DESC, or whichever logic you prefer)
+    last_rp = db.session.query(RunPeriod).order_by(RunPeriod.id.desc()).first()
+
+    # Print it all
+    click.echo(f"Number of conditions: {cnd_count}")
+    click.echo(f"Last condition date/time: {cnd_last_time}")
+    click.echo(f"Number of runs: {run_count}")
+    click.echo(f"Number of files: {file_count}")
+    click.echo("Last 5 runs saved: " +
+               ", ".join(str(r.number) for r in last_5_runs) if last_5_runs else "No runs")
+    click.echo(f"Number of run periods: {rp_count}")
+    if last_rp:
+        click.echo(f"Last run period: {last_rp.name} (ID={last_rp.id})")
+    else:
+        click.echo("No run periods found.")
+
+    # Finally, show all possible commands (help):
+    ctx = click.get_current_context()
+    click.echo("\n==== Available commands ====")
+    click.echo(ctx.parent.get_help())

{rcdb-2.2.7 → rcdb-2.2.8}/rcdb/cli/ls.py

@@ -4,12 +4,12 @@ from rcdb.provider import RCDBProvider
 from .context import pass_rcdb_context
 
 
-@click.command()
+@click.command(name="ls")
 @click.argument('search', required=False)
 @click.option('--long', '-l', 'is_long', is_flag=True, help='Prints condition full information')
 @pass_rcdb_context
-def ls(context, search, is_long):
-    """Lists conditions"""
+def ls_command(context, search, is_long):
+    """List conditions"""
 
     db = context.db
     assert isinstance(db, RCDBProvider)

rcdb-2.2.8/rcdb/cli/repair/__init__.py

@@ -0,0 +1,12 @@
+import click
+from .evio_files import evio_files_command
+
+
+@click.group(name="repair")
+def repair_command():
+    """ Group of commands that help repair and consolidate RCDB """
+    pass
+
+
+repair_command.add_command(evio_files_command)
+

{rcdb-2.2.7 → rcdb-2.2.8}/rcdb/cli/repair/evio_files.py

@@ -48,14 +48,14 @@ def read_run_directories(mask, run_min, run_max):
 
     return run_files
 
-@click.command()
+@click.command(name="evio-files")
 @click.option('--run-range', required=False, default=None)
 @click.option('--mask', required=False, default="/gluex/data/rawdata/all/Run*111*")
 @click.option('--save-list', required=False, default=None, help="Save found evio files to json file with this name")
 @click.option('--load-list', required=False, default=None, help="Instead of scanning, load eviofiles from a list")
 @click.option('--execute', is_flag=True, required=False, default=False, help="Instead of scanning, load eviofiles from a list")
 @pass_rcdb_context
-def evio_files(ctx, run_range, mask, save_list, load_list, execute):
+def evio_files_command(ctx, run_range, mask, save_list, load_list, execute):
     """ 
     Example of usage: 
       # search /mss and save evio files to a json file list

{rcdb-2.2.7 → rcdb-2.2.8}/rcdb/cli/rp.py

@@ -9,9 +9,10 @@ from rcdb import RCDBProvider
 from rcdb.model import RunPeriod
 from rcdb.cli.context import pass_rcdb_context
 
-@click.group(invoke_without_command=True)
+
+@click.group(name="rp", invoke_without_command=True)
 @click.pass_context
-def rp(context):
+def rp_command(context):
     """
     Run Periods management commands.
 
@@ -38,7 +39,7 @@ def rp(context):
     print_run_periods(run_periods)
 
 
-@rp.command()
+@rp_command.command()
 @click.option('--name', required=True, help="Name of the run period, e.g. RunPeriod-2025-01.")
 @click.option('--description', default='', help="Description of the run period.")
 @click.option('--run-min', 'run_min', required=True, type=int, help="Minimum run number in the period.")
@@ -90,7 +91,8 @@ def add(context, name, description, run_min, run_max, start_date, end_date):
 
     print(f"Added new run period: {new_period}")
 
-@rp.command()
+
+@rp_command.command()
 @click.argument('period_id', type=int)
 @click.option('--yes', is_flag=True, help="Skip prompt confirmation and remove directly.")
 @pass_rcdb_context
@@ -122,7 +124,8 @@ def rm(context, period_id, yes):
     session.commit()
     print(f"Removed run period ID={period_id} ({rp_item.name}).")
 
-@rp.command()
+
+@rp_command.command()
 @click.argument('period_id', type=int)
 @click.option('--name', default=None, help="New name of the run period.")
 @click.option('--description', default=None, help="New description of the run period.")
@@ -166,6 +169,7 @@ def update(context, period_id, name, description, run_min, run_max, start_date,
     session.commit()
     print(f"Updated run period ID={period_id}: {rp_item}")
 
+
 def print_run_periods(run_periods):
     # 1) Gather data strings and compute column widths
     # ------------------------------------------------

{rcdb-2.2.7 → rcdb-2.2.8}/rcdb/cli/web.py

@@ -7,7 +7,7 @@ from .context import pass_rcdb_context
 
 @click.command("web")
 @pass_rcdb_context
-def web(context):
+def web_command(context):
     """
     Runs the local RCDB web application using the connection string from
     either the CLI context or the RCDB_CONNECTION environment variable.

{rcdb-2.2.7 → rcdb-2.2.8}/rcdb/version.py

@@ -1,5 +1,5 @@
 # String version. Used both for setup.py and for internal code
-version = '2.2.7'
+version = '2.2.8'
 
 # version as the tuple of ints
 version_tuple = tuple(int(val) for val in version.split('.'))

{rcdb-2.2.7 → rcdb-2.2.8/rcdb.egg-info}/PKG-INFO

@@ -1,17 +1,19 @@
 Metadata-Version: 2.4
 Name: rcdb
-Version: 2.2.7
+Version: 2.2.8
 Summary: RCDB - Run Conditions DataBase
 Author-email: Dmitry Romanov <romanov@jlab.org>
 License-Expression: MIT
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Scientific/Engineering :: Physics
 Classifier: Topic :: Database

{rcdb-2.2.7 → rcdb-2.2.8}/rcdb.egg-info/SOURCES.txt

@@ -4,7 +4,6 @@ pyproject.toml
 ../README.md
 rcdb/__init__.py
 rcdb/__main__.py
-rcdb/admin_cmd.py
 rcdb/alias.py
 rcdb/app_context.py
 rcdb/coda_parser.py
@@ -32,8 +31,8 @@ rcdb/cli/__main__.py
 rcdb/cli/app.py
 rcdb/cli/context.py
 rcdb/cli/db.py
+rcdb/cli/info.py
 rcdb/cli/ls.py
-rcdb/cli/mkdb.py
 rcdb/cli/rp.py
 rcdb/cli/run.py
 rcdb/cli/select.py

rcdb-2.2.7/rcdb/admin_cmd.py

@@ -1,83 +0,0 @@
-import os
-import sys
-import posixpath
-
-import click
-
-from rcdb.app_context import RcdbApplicationContext, parse_run_range
-from rcdb import RCDBProvider
-
-pass_rcdb_context = click.make_pass_decorator(RcdbApplicationContext)
-
-
-def get_default_config_path():
-    return os.path.join(os.path.expanduser('~'), '.rcdb_user')
-
-
-@click.group()
-@click.option('--user-config', envvar='RCDB_USER_CONFIG', default=get_default_config_path, metavar='PATH', help='Changes the user config location.')
-@click.option('--connection', '-c', envvar='RCDB_CONNECTION', help='Database connection string', default=None, required=True)
-@click.option('--config', nargs=2, multiple=True, metavar='KEY VALUE', help='Overrides a config key/value pair.')
-@click.option('--verbose', '-v', is_flag=True, help='Enables verbose mode.')
-@click.version_option('1.0')
-@click.pass_context
-def cli(ctx, user_config, connection, config, verbose):
-    """'rcdb' is a RCDB (run conditions database) command line tool
-
-    This tool allows to select runs and get values as well as manage RCDB values
-    """
-
-    # Create a rcdb_app_context object and remember it as as the context object.  From
-    # this point onwards other commands can refer to it by using the
-    # @pass_rcdb_context decorator.
-    ctx.obj = RcdbApplicationContext(os.path.abspath(user_config), connection)
-    ctx.obj.verbose = verbose
-    for key, value in config:
-        ctx.obj.set_config(key, value)
-
-
-@cli.command(help="")
-@click.argument('search', required=False)
-@click.option('--long', '-l', 'is_long', is_flag=True, help='Prints condition full information')
-@pass_rcdb_context
-def walk(context, search, is_long):
-    """Lists condition
-
-
-    """
-    db = context.db
-    assert isinstance(db, RCDBProvider)
-    cnd_types = db.get_condition_types_by_name()
-    names = sorted(cnd_types.keys())
-    if search:
-        names = [n for n in names if search in n]
-
-    longest_len = len(max(names, key=len))
-    for name in names:
-        cnd_type = cnd_types[name]
-        click.echo("{0:<{1}}   {2}".format(name, longest_len, cnd_type.description))
-
-@cli.command()
-@click.argument('search', required=False)
-@click.option('--long', '-l', 'is_long', is_flag=True, help='Prints condition full information')
-@pass_rcdb_context
-def ls(context, search, is_long):
-    """Lists condition
-
-
-    """
-    db = context.db
-    assert isinstance(db, RCDBProvider)
-    cnd_types = db.get_condition_types_by_name()
-    names = sorted(cnd_types.keys())
-    if search:
-        names = [n for n in names if search in n]
-
-    longest_len = len(max(names, key=len))
-    for name in names:
-        cnd_type = cnd_types[name]
-        click.echo("{0:<{1}}   {2}".format(name, longest_len, cnd_type.description))
-
-
-if __name__ == '__main__':
-    cli(prog_name="rcdb")

rcdb-2.2.7/rcdb/cli/mkdb.py

@@ -1,27 +0,0 @@
-import click
-
-from rcdb.provider import RCDBProvider
-from .context import pass_rcdb_context
-
-
-@click.command()
-@click.argument('search', required=False)
-@click.option('--long', '-l', 'is_long', is_flag=True, help='Prints condition full information')
-@pass_rcdb_context
-def mkdb(context, search, is_long):
-    """Lists conditions"""
-
-    print(context)
-    exit(0)
-
-    db = context.db
-    assert isinstance(db, RCDBProvider)
-    cnd_types = db.get_condition_types_by_name()
-    names = sorted(cnd_types.keys())
-    if search:
-        names = [n for n in names if search in n]
-
-    longest_len = len(max(names, key=len))
-    for name in names:
-        cnd_type = cnd_types[name]
-        click.echo("{0:<{1}}   {2}".format(name, longest_len, cnd_type.description))

rcdb-2.2.7/rcdb/cli/repair/__init__.py

@@ -1,13 +0,0 @@
-import click
-from . import evio_files
-
-@click.group()
-def repair():
-    """
-    Group of commands that help repair and consolidate RCDB
-    """
-    pass
-
-
-repair.add_command(evio_files.evio_files)
-