fair-cli 0.9.5__tar.gz → 0.9.7__tar.gz

{fair_cli-0.9.5 → fair_cli-0.9.7}/CITATION.cff

@@ -26,7 +26,7 @@ authors:
   affiliation: University of Glasgow
   orcid: https://orcid.org/0000-0002-4424-9890
 
-date-released: 2023-09-07
+date-released: 2025-04-08
 keywords:
 - FAIR Data Pipeline
 - FAIR
@@ -36,4 +36,4 @@ license: BSD-2-Clause
 message: If you use this software, please cite it using these metadata.
 repository-code: https://github.com/FAIRDataPipeline/FAIR-CLI/
 title: "The FAIR Data Pipeline command line tool"
-version: 0.9.4
+version: 0.9.7

{fair_cli-0.9.5 → fair_cli-0.9.7}/PKG-INFO

@@ -1,13 +1,12 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.3
 Name: fair-cli
-Version: 0.9.5
+Version: 0.9.7
 Summary: Synchronization interface for the SCRC FAIR Data Pipeline registry
-Home-page: https://www.fairdatapipeline.org/
 License: BSD-2-Clause
 Keywords: FAIR Data Pipeline,FAIR,Data Management,Provenance
 Author: Richard Reeve
 Author-email: richard.reeve@glasgow.ac.uk
-Requires-Python: >=3.8.0,<4.0.0
+Requires-Python: >=3.9.0,<4.0.0
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Science/Research
@@ -16,11 +15,11 @@ Classifier: Operating System :: MacOS
 Classifier: Operating System :: OS Independent
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 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: Topic :: Database :: Front-Ends
 Classifier: Topic :: Scientific/Engineering
 Provides-Extra: all
@@ -39,6 +38,7 @@ Requires-Dist: simplejson (>=3.17.5,<4.0.0)
 Requires-Dist: toml (>=0.10.2,<0.11.0)
 Requires-Dist: validators (>=0.18.2,<0.19.0)
 Project-URL: Documentation, https://www.fairdatapipeline.org/docs/interface/fdp/
+Project-URL: Homepage, https://www.fairdatapipeline.org/
 Project-URL: Issue Tracker, https://github.com/FAIRDataPipeline/FAIR-CLI/issues
 Project-URL: Repository, https://github.com/FAIRDataPipeline/FAIR-CLI
 Description-Content-Type: text/markdown

{fair_cli-0.9.5 → fair_cli-0.9.7}/fair/cli.py

@@ -60,7 +60,7 @@ def complete_data_products(ctx, param, incomplete) -> typing.List[str]:
     _staging_file = fdp_com.staging_cache(os.getcwd())
     if not os.path.exists(_staging_file):
         return []
-    _staging_data = yaml.safe_load(open(_staging_file, encoding='utf-8'))
+    _staging_data = yaml.safe_load(open(_staging_file, encoding="utf-8"))
     _candidates = list(_staging_data["data_product"].keys())
     return [
         click.shell_completion.CompletionItem(c)
@@ -90,47 +90,49 @@ def cli(ctx):
     """Welcome to FAIR-CLI, the FAIR data pipeline command-line interface."""
     pass
 
+
 @cli.command()
 @click.argument("file_path")
-@click.option("--remote", help="Show Remote Code Runs", default= "origin")
+@click.option("--remote", help="Show Remote Code Runs", default="origin")
 @click.option("--debug/--no-debug", help="Run in debug mode", default=False)
 @click.option(
     "--local/--no-local",
     help="init without a remote registry - useful for closed systems",
     default=False,
 )
-def identify(file_path: str, remote:str, debug, local:bool) -> None:
+def identify(file_path: str, remote: str, debug, local: bool) -> None:
     """
     list details of a file
-    
+
     Usage: fair identify /path/to/file [remote]
     """
     try:
         with fdp_session.FAIR(
             os.getcwd(), debug=debug, server_mode=fdp_svr.SwitchMode.CLI, local=local
         ) as fair_session:
-            fair_session.get_details(file_path, remote = "")
+            fair_session.get_details(file_path, remote="")
             if not local:
-                fair_session.get_details(file_path, remote = remote)
+                fair_session.get_details(file_path, remote=remote)
     except fdp_exc.FAIRCLIException as e:
         e.err_print()
         if e.level.lower() == "error":
             sys.exit(e.exit_code)
 
+
 @cli.command()
 @click.argument("data_product")
-@click.option("--remote", help="Show Remote Code Runs", default= "origin")
+@click.option("--remote", help="Show Remote Code Runs", default="origin")
 @click.option("--debug/--no-debug", help="Run in debug mode", default=False)
 @click.option(
     "--local/--no-local",
     help="init without a remote registry - useful for closed systems",
     default=False,
 )
-def find(data_product: str, remote: str, debug:bool, local:bool) -> None:
+def find(data_product: str, remote: str, debug: bool, local: bool) -> None:
     """
     Shows where a data product is located
-    
-    Data Products should be formatted: 
+
+    Data Products should be formatted:
     <namespace>:<data product name>@v<version>
     eg:
     PSU:SEIRS_model/parameters@v1.0.0
@@ -149,6 +151,7 @@ def find(data_product: str, remote: str, debug:bool, local:bool) -> None:
         if e.level.lower() == "error":
             sys.exit(e.exit_code)
 
+
 @cli.command()
 @click.option("--verbose/--not-verbose", help="Display URLs", default=False)
 @click.option("--debug/--no-debug", help="Run in debug mode", default=False)
@@ -165,60 +168,62 @@ def status(verbose, debug) -> None:
         if e.level.lower() == "error":
             sys.exit(e.exit_code)
 
+
 @cli.group(invoke_without_command=True)
 @click.option("--debug/--no-debug", help="Run in debug mode", default=False)
-@click.option("--remote", help="Show Remote Code Runs", default= "")
+@click.option("--remote", help="Show Remote Code Runs", default="")
 @click.pass_context
 def list(ctx, debug, remote) -> None:
     """Commands to list data_product(s) and code_run(s)"""
     if ctx.obj is None:
         ctx.obj = {}
-    ctx.obj['DEBUG'] = debug
-    ctx.obj['REMOTE'] = remote
+    ctx.obj["DEBUG"] = debug
+    ctx.obj["REMOTE"] = remote
     _current_args = " ".join(sys.argv)
     if not ("data-products" in _current_args or "code-runs" in _current_args):
         ctx.invoke(data_products)
         ctx.invoke(code_runs)
 
+
 @list.command()
 @click.pass_context
 def data_products(ctx) -> None:
-    debug = ctx.obj['DEBUG']
-    remote = ctx.obj['REMOTE']
+    debug = ctx.obj["DEBUG"]
+    remote = ctx.obj["REMOTE"]
     try:
         with fdp_session.FAIR(
             os.getcwd(), debug=debug, server_mode=fdp_svr.SwitchMode.CLI
         ) as fair_session:
-            fair_session.show_all_data_products(remote = remote)
+            fair_session.show_all_data_products(remote=remote)
     except fdp_exc.FAIRCLIException as e:
         e.err_print()
         if e.level.lower() == "error":
             sys.exit(e.exit_code)
 
+
 @list.command()
 @click.pass_context
 def code_runs(ctx) -> None:
-    debug = ctx.obj['DEBUG']
-    remote = ctx.obj['REMOTE']
+    debug = ctx.obj["DEBUG"]
+    remote = ctx.obj["REMOTE"]
     try:
         with fdp_session.FAIR(
             os.getcwd(), debug=debug, server_mode=fdp_svr.SwitchMode.CLI
         ) as fair_session:
-            fair_session.show_all_code_runs(remote = remote)
+            fair_session.show_all_code_runs(remote=remote)
     except fdp_exc.FAIRCLIException as e:
         e.err_print()
         if e.level.lower() == "error":
             sys.exit(e.exit_code)
 
+
 @cli.command()
 @click.option("--debug/--no-debug", help="Run in debug mode", default=False)
 @click.argument("output", nargs=-1)
 def create(debug, output: str) -> None:
     """Generate a new FAIR repository user YAML config file"""
     output = (
-        output[0]
-        if output
-        else os.path.join(os.getcwd(), fdp_com.USER_CONFIG_FILE)
+        output[0] if output else os.path.join(os.getcwd(), fdp_com.USER_CONFIG_FILE)
     )
     click.echo(f"Generating new user configuration file '{output}'")
     with fdp_session.FAIR(os.getcwd(), debug=debug) as fair_session:
@@ -264,9 +269,7 @@ def reset(debug: bool) -> None:
     default=False,
 )
 @click.option("--debug/--no-debug", help="Run in debug mode", default=False)
-@click.option(
-    "--export", help="Export the CLI configuration to a file", default=""
-)
+@click.option("--export", help="Export the CLI configuration to a file", default="")
 @click.option(
     "--local/--no-local",
     help="init without a remote registry - useful for closed systems",
@@ -293,7 +296,7 @@ def init(
                         f"Cannot load CLI configuration from file '{using}', "
                         "file does not exist."
                     )
-                _use_dict = yaml.safe_load(open(using, encoding='utf-8'))
+                _use_dict = yaml.safe_load(open(using, encoding="utf-8"))
 
             fair_session.initialise(
                 using=_use_dict,
@@ -308,6 +311,7 @@ def init(
         if e.level.lower() == "error":
             sys.exit(e.exit_code)
 
+
 @cli.command()
 @click.option(
     "glob",
@@ -343,8 +347,7 @@ def purge(glob: bool, debug: bool, yes: bool, data: bool, all: bool) -> None:
         )
     else:
         _purge = click.confirm(
-            "Are you sure you want to reset FAIR tracking, "
-            "this is not reversible?"
+            "Are you sure you want to reset FAIR tracking, " "this is not reversible?"
         )
         if data:
             data = click.confirm(
@@ -425,7 +428,7 @@ def start(debug: bool, port: int, address: str) -> None:
             server_mode=fdp_svr.SwitchMode.USER_START,
             debug=debug,
             server_port=port,
-            server_address=address
+            server_address=address,
         )
     except fdp_exc.FAIRCLIException as e:
         e.err_print()
@@ -438,11 +441,7 @@ def start(debug: bool, port: int, address: str) -> None:
 @click.option("--debug/--no-debug", help="Run in debug mode", default=False)
 def stop(force: bool, debug: bool) -> None:
     """Stop the local registry server"""
-    _mode = (
-        fdp_svr.SwitchMode.FORCE_STOP
-        if force
-        else fdp_svr.SwitchMode.USER_STOP
-    )
+    _mode = fdp_svr.SwitchMode.FORCE_STOP if force else fdp_svr.SwitchMode.USER_STOP
     try:
         fdp_session.FAIR(os.getcwd(), server_mode=_mode, debug=debug)
     except fdp_exc.FAIRCLIException as e:
@@ -519,7 +518,7 @@ def add(identifier: str, debug: bool) -> None:
     """
     Add a data product or coderun to staging
 
-    Data Products should be formatted: 
+    Data Products should be formatted:
     <namespace>:<data product name>@v<version>
     eg:
     PSU:SEIRS_model/parameters@v1.0.0
@@ -527,16 +526,14 @@ def add(identifier: str, debug: bool) -> None:
     Code Runs should be specified by code run uuid
 
     Use `fair list` to view Data Products and Code Runs
-    
+
     """
     try:
         with fdp_session.FAIR(
             os.getcwd(),
             debug=debug,
         ) as fair_session:
-            fair_session.add_to_staging(
-                identifier
-            )
+            fair_session.add_to_staging(identifier)
     except fdp_exc.FAIRCLIException as e:
         e.err_print()
         if e.level.lower() == "error":
@@ -551,9 +548,7 @@ def add(identifier: str, debug: bool) -> None:
     default=False,
     help="remove from tracking but do not delete from file system",
 )
-def rm(
-    job_ids: typing.List[str], cached: bool = False, debug: bool = False
-) -> None:
+def rm(job_ids: typing.List[str], cached: bool = False, debug: bool = False) -> None:
     """Removes jobs from system or just tracking"""
     pass
 
@@ -581,9 +576,7 @@ def rm(
     help="init without a remote registry - useful for closed systems",
     default=False,
 )
-def run(
-    config: str, script: str, debug: bool, ci: bool, dirty: bool, local: bool
-):
+def run(config: str, script: str, debug: bool, ci: bool, dirty: bool, local: bool):
     """Initialises a job with the option to specify a bash command"""
     # Allow no config to be specified, if that is the case use default local
     click.echo("Running run please wait")
@@ -597,9 +590,7 @@ def run(
             allow_dirty=dirty,
             local=local,
         ) as fair_session:
-            _hash = fair_session.run(
-                script, passive=ci, allow_dirty=dirty, local=local
-            )
+            _hash = fair_session.run(script, passive=ci, allow_dirty=dirty, local=local)
             if ci:
                 click.echo(fdp_run.get_job_dir(_hash))
     except fdp_exc.FAIRCLIException as e:

{fair_cli-0.9.5 → fair_cli-0.9.7}/fair/common.py

@@ -59,9 +59,7 @@ FAIR_REGISTRY_REPO = "https://github.com/FAIRDataPipeline/data-registry.git"
 DEFAULT_REGISTRY_DOMAIN = "https://data.fairdatapipeline.org/"
 REGISTRY_INSTALL_URL = "https://data.fairdatapipeline.org/static/localregistry.sh"
 
-DEFAULT_REGISTRY_LOCATION = os.path.join(
-    pathlib.Path().home(), FAIR_FOLDER, "registry"
-)
+DEFAULT_REGISTRY_LOCATION = os.path.join(pathlib.Path().home(), FAIR_FOLDER, "registry")
 
 DEFAULT_LOCAL_REGISTRY_URL = "http://127.0.0.1:8000/api/"
 
@@ -79,7 +77,7 @@ def registry_home() -> str:
             return os.environ["FAIR_REGISTRY_DIR"]
         else:
             return DEFAULT_REGISTRY_LOCATION
-    _glob_conf = yaml.safe_load(open(global_fdpconfig(), encoding='utf-8'))
+    _glob_conf = yaml.safe_load(open(global_fdpconfig(), encoding="utf-8"))
     if not _glob_conf:
         return DEFAULT_REGISTRY_LOCATION
     if "registries" not in _glob_conf:
@@ -149,6 +147,7 @@ def registry_session_port_file(registry_dir: str = None) -> str:
         registry_dir = registry_home()
     return os.path.join(registry_dir, "session_port.log")
 
+
 def registry_session_address_file(registry_dir: str = None) -> str:
     """Retrieve the location of the registry session port file
 
@@ -183,7 +182,10 @@ def registry_session_port(registry_dir: str = None) -> int:
     int
         current/most recent port used to launch the registry
     """
-    return int(open(registry_session_port_file(registry_dir), encoding='utf-8').read().strip())
+    return int(
+        open(registry_session_port_file(registry_dir), encoding="utf-8").read().strip()
+    )
+
 
 def registry_session_address(registry_dir: str = None) -> str:
     """Retrieve the registry session address
@@ -202,11 +204,17 @@ def registry_session_address(registry_dir: str = None) -> str:
         current/most recent address used to launch the registry
     """
     if not os.path.exists(registry_session_address_file(registry_dir)):
-        _logger.warning("Session Address file not found, please make sure your registry is up-to-date")
+        _logger.warning(
+            "Session Address file not found, please make sure your registry is up-to-date"
+        )
         _logger.info("Using 127.0.0.1")
         return "127.0.0.1"
 
-    _address = open(registry_session_address_file(registry_dir), encoding='utf-8').read().strip()
+    _address = (
+        open(registry_session_address_file(registry_dir), encoding="utf-8")
+        .read()
+        .strip()
+    )
     if _address != "0.0.0.0":
         return _address
     else:
@@ -226,15 +234,13 @@ def default_data_dir(location: str = "local") -> str:
         raise fdp_exc.InternalError(
             f"Failed to read CLI global config file '{global_fdpconfig()}'"
         )
-    _glob_conf = yaml.safe_load(open(global_fdpconfig(), encoding='utf-8'))
+    _glob_conf = yaml.safe_load(open(global_fdpconfig(), encoding="utf-8"))
     if "data_store" in _glob_conf["registries"][location]:
         return _glob_conf["registries"][location]["data_store"]
     if location == "local":
         return os.path.join(USER_FAIR_DIR, f"data{os.path.sep}")
     else:
-        raise fdp_exc.UserConfigError(
-            "Cannot guess remote data store location"
-        )
+        raise fdp_exc.UserConfigError("Cannot guess remote data store location")
 
 
 def local_fdpconfig(user_loc: str = os.getcwd()) -> str:
@@ -291,16 +297,18 @@ def find_git_root(start_directory: str = os.getcwd()) -> str:
 
     return _repository.git.rev_parse("--show-toplevel").strip()
 
+
 def set_file_permissions(path: str):
     for root, dirs, files in os.walk(path, topdown=False):
-        for dir in [os.path.join(root,d) for d in dirs]:
+        for dir in [os.path.join(root, d) for d in dirs]:
             os.chmod(dir, stat.S_IRWXU | stat.S_IRWXG | stat.S_IRWXO)
         for file in [os.path.join(root, f) for f in files]:
             os.chmod(file, stat.S_IRWXU | stat.S_IRWXG | stat.S_IRWXO)
 
+
 def remove_readonly(fn, path, excinfo):
     try:
         os.chmod(path, stat.S_IWRITE)
         fn(path)
     except Exception as exc:
-        print("Skipped:", path, "because:\n", exc)
+        print("Skipped:", path, "because:\n", exc)