rucio-clients 35.7.0__py3-none-any.whl → 37.0.0rc2__py3-none-any.whl

rucio/cli/lifetime_exception.py

@@ -0,0 +1,33 @@
+# Copyright European Organization for Nuclear Research (CERN) since 2012
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import click
+
+from rucio.cli.bin_legacy.rucio import add_lifetime_exception
+from rucio.cli.utils import Arguments
+
+
+@click.group()
+def lifetime_exception():
+    """Interact with the lifetime exception model"""
+
+
+@lifetime_exception.command("add")
+@click.option("-f", "--input-file", help="File where the list of datasets requested to be extended are located")
+@click.option("--reason", help="The reason for the extension")
+@click.option("-x", "--expiration", help="The expiration date format YYYY-MM-DD")
+@click.pass_context
+def add_(ctx, input_file, reason, expiration):
+    """Add an exception to the lifetime model"""  # TODO description of what this does
+    args = Arguments({"inputfile": input_file, "reason": reason, "expiration": expiration})
+    add_lifetime_exception(args, ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)

rucio/cli/replica.py

@@ -0,0 +1,162 @@
+# Copyright European Organization for Nuclear Research (CERN) since 2012
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import click
+
+from rucio.cli.bin_legacy.rucio import list_dataset_replicas, list_file_replicas, list_suspicious_replicas
+from rucio.cli.bin_legacy.rucio_admin import declare_bad_file_replicas, declare_temporary_unavailable_replicas, quarantine_replicas, set_tombstone
+from rucio.cli.utils import Arguments
+
+
+@click.group()
+def replica():
+    """Manage replicas - DIDs with locations on RSEs"""
+
+
+@replica.group("list")
+def replica_list():
+    """List replicas (file or collection-types)"""
+
+
+@replica_list.command("file")
+@click.argument("dids", nargs=-1)
+@click.option("--protocols", help="Protocol used to access a replicas (i.e. https, root, srm)")
+@click.option(
+    "--all-states",
+    help="To select all replicas (including unavailable ones).\
+                Also gets information about the current state of a DID in each RSE",
+    is_flag=True,
+    default=False,
+)
+@click.option("--pfns", is_flag=True, help="Show only the PFNs", default=False)
+@click.option("--domain", default="all", type=click.Choice(["wan", "lan", "all"]), help="Force the networking domain")
+@click.option(
+    "--link",
+    help="Symlink PFNs with directory substitution.\
+                For example: rucio list-file-replicas --rse RSE_TEST --link /eos/:/eos/ scope:datasetname",
+)
+@click.option("--missing", is_flag=True, default=False, help="To list missing replicas at a RSE-Expression. Must be used with --rses option")
+@click.option("--metalink", is_flag=True, default=False, help="Output available replicas as metalink")
+@click.option("--no-resolve-archives", is_flag=True, default=False, help="Do not resolve archives which may contain the files", required=False)
+@click.option("--sort", help="Replica sort algorithm. Available options: geoip (default), random")
+@click.option("--rses", "--rse-exp", "rses", help="The RSE filter expression")
+@click.option("--human", default=True, hidden=True)
+@click.pass_context
+def list_(ctx, dids, protocols, all_states, pfns, domain, link, missing, metalink, no_resolve_archives, sort, rses, human):
+    """List the replicas of a DID and its PFNs. By default all states, even unavailable, are shown"""
+    args = {"dids": dids, "protocols": protocols, "all_states": all_states, "pfns": pfns, "domain": domain, "link": link, "missing": missing, "metalink": metalink, "no_resolve_archives": no_resolve_archives, "sort": sort, "rses": rses, "human": human}
+    list_file_replicas(Arguments(args), ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@replica_list.command("dataset")
+@click.argument("dids", nargs=-1)
+@click.option("--deep", default=False, is_flag=True, help="Make a deep check, checking the contents of datasets in datasets")
+@click.option("--csv", help="Write output to comma separated values", is_flag=True, default=False)
+@click.pass_context
+def list_dataset(ctx, dids, deep, csv):
+    """List dataset replicas"""
+    args = Arguments({"dids": dids, "deep": deep, "csv": csv})
+    list_dataset_replicas(args, ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@replica.command("remove")
+@click.argument("dids", nargs=-1)
+@click.option("--rse", "--rse-name", "rse", required=True)
+@click.pass_context
+def remove(ctx, dids, rse):
+    "Set a replica for removal by adding a tombstone which will mark the replica as ready for deletion by a reaper daemon"
+    # TODO: Fix set_tombstone to not expect a comma separated DID str
+    dids = ",".join(dids)
+    set_tombstone(Arguments({"dids": dids, "rse": rse}), ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@replica.group()
+@click.help_option("-h", "--help")
+def state():
+    """Manage the state of replicas"""
+
+
+@state.command("list")
+@click.argument("state-type", type=click.Choice(["suspicious"]))
+@click.option("--rses", "--rse-exp", help="RSE name or expression")  # TODO remap rse_expression to rses (for consistency)
+@click.option("--younger-than", help='List files that have been marked suspicious since the date "younger_than", e.g. 2021-11-29T00:00:00')  # NOQA: E501
+@click.option("--n-attempts", help="Minimum number of failed attempts to access a suspicious file")
+@click.pass_context
+def state_list(ctx, state_type, rses, younger_than, n_attempts):
+    """List replicas by state. WARNING: Only implemented for 'suspicious'"""
+
+    if state_type != "suspicious":
+        raise ValueError(f"Cannot list state by {state_type}, please choose from ('suspicious')")
+    list_suspicious_replicas(Arguments({"rse_expression": rses, "younger_than": younger_than, "nattempts": n_attempts}), ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@state.group("update")
+@click.help_option("-h", "--help")
+def state_update():
+    "Change the state of replicas"
+
+
+@state_update.command("bad")
+@click.argument("replicas", nargs=-1)
+@click.option("--reason", required=True, help="Reason")
+@click.option("--as-file", is_flag=True, default=False, help="[REPLICAS] arg is a path to a file of replicas to update")
+@click.option("--collection", is_flag=True, default=False, help="Items in the collection DID are also marked as bad")
+@click.option("--lfn", is_flag=True, default=False, help="[REPLICAS] arg is a path to a file of LFNs. Requires --rse and --scope")
+@click.option("--scope", help="Common scope for bad replicas specified with LFN list, ignored without --lfn")
+@click.option("--rse", "--rse-name", help="Common RSE for bad replicas specified with LFN list, ignored without --lfn")
+@click.pass_context
+def update_bad(ctx, replicas, reason, as_file, collection, lfn, scope, rse):
+    """Mark a replica bad"""
+    args = {"reason": reason, "allow_collection": collection, "scope": scope, "rse": rse}
+    if as_file:
+        args["inputfile"] = replicas
+    elif lfn:
+        if (scope is None) or (rse is None):
+            raise ValueError("Scope and RSE are required when using LFNs")
+        args["lfns"] = replicas
+    else:
+        args["listbadfiles"] = replicas
+    declare_bad_file_replicas(Arguments(args), ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@state_update.command("unavailable")
+@click.argument("replicas", nargs=-1)
+@click.option("--reason", required=True, help="Reason")
+@click.option("--as-file", is_flag=True, default=False, help="[REPLICAS] arg is a path to a file of names to update")
+@click.option("--duration", required=True, type=int, help="Timeout (in seconds) after which the replicas will become available again")
+@click.pass_context
+def update_unavailable(ctx, replicas, reason, as_file, duration):
+    """Declare a replica unavailable"""
+    args = {"reason": reason, "duration": duration}
+    if as_file:
+        args["inputfile"] = replicas
+    else:
+        args["listbadfiles"] = replicas
+    declare_temporary_unavailable_replicas(Arguments(args), ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@state_update.command("quarantine")
+@click.argument("replicas", nargs=-1)
+@click.option("--as-file", is_flag=True, default=False, help="[REPLICAS] arg is a path to a file of names to update")
+@click.option("--rse", "--rse-name")  # TODO What does this do?
+@click.pass_context
+def update_quarantine(ctx, replicas, as_file, rse):
+    """Quarantine a replica"""
+    args = {"rse": rse}
+    if as_file:
+        args["paths_file"] = replicas
+    else:
+        args["paths_list"] = replicas
+
+    # TODO Add a reason option
+    quarantine_replicas(Arguments(args), ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)

rucio/cli/rse.py

@@ -0,0 +1,293 @@
+# Copyright European Organization for Nuclear Research (CERN) since 2012
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import json
+
+import click
+
+from rucio.cli.bin_legacy.rucio import list_rses
+from rucio.cli.bin_legacy.rucio_admin import (
+    add_distance_rses,
+    add_protocol_rse,
+    add_qos_policy,
+    add_rse,
+    del_protocol_rse,
+    delete_attribute_rse,
+    delete_distance_rses,
+    delete_limit_rse,
+    delete_qos_policy,
+    disable_rse,
+    get_attribute_rse,
+    get_distance_rses,
+    info_rse,
+    list_qos_policies,
+    set_attribute_rse,
+    set_limit_rse,
+    update_distance_rses,
+    update_rse,
+)
+from rucio.cli.utils import Arguments
+
+
+@click.group()
+def rse():
+    """Manage Rucio Storage Elements (RSEs)"""
+
+
+@rse.command("list")
+@click.option("--rses", "--rse-exp", help="RSE Expression to use as a filter", required=False)
+@click.option("--csv", is_flag=True, default=False, help="Output list of RSEs as a csv")
+@click.pass_context
+def list_(ctx, rses, csv):
+    """List all registered Rucio Storage Elements (RSEs)"""
+    list_rses(Arguments({"rses": rses, "csv": csv}), ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@rse.command("show")
+@click.argument("rse-name")
+@click.option("--csv", is_flag=True, default=False, help="Output list of RSE property key and values as a csv")
+@click.pass_context
+def show(ctx, rse_name, csv):
+    """Usage, protocols, settings, and attributes for a given RSE"""
+    info_rse(Arguments({"rse": rse_name, "csv": csv}), ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@rse.command("add")
+@click.argument("rse-name")
+@click.option("--non-deterministic", is_flag=True, default=False, help="Create RSE in non-deterministic mode")
+@click.pass_context
+def add_(ctx, rse_name, non_deterministic):
+    """Add a new RSE"""
+    args = Arguments({"rse": rse_name, "non_deterministic": non_deterministic})
+    add_rse(args, ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@rse.command("remove")
+@click.argument("rse-name")
+@click.pass_context
+def remove(ctx, rse_name):
+    """Permanently disable an RSE. CAUTION: all information about the RSE might be lost!"""
+    disable_rse(Arguments({"rse": rse_name}), ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@rse.command("update")
+@click.argument("rse-name")
+@click.option('--key', help='Setting key', required=True)
+@click.option('--value', help='Setting value', required=True)
+@click.pass_context
+def update(ctx, rse_name, key, value):
+    """
+    Update an RSE's setting.
+
+    \b
+    Example:
+        $ rucio rse update my-rse --option availability_write True
+    """
+    args = Arguments({"rse": rse_name, "param": key, "value": value})
+    update_rse(args, ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@rse.group()
+@click.help_option("-h", "--help")
+def distance():
+    """Manage the relative distance between RSEs for transfer prioritization calculations"""
+
+
+@distance.command("show")
+@click.argument("source-rse")
+@click.argument("destination-rse")
+@click.pass_context
+def distance_show(ctx, source_rse, destination_rse):
+    """Display distance information from SOURCE-RSE to DESTINATION-RSE"""
+    get_distance_rses(Arguments({"source": source_rse, "destination": destination_rse}), ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@distance.command("add")
+@click.argument("source-rse")
+@click.argument("destination-rse")
+@click.option("--distance", default=1, type=int, help="Relative distance between RSEs")
+@click.pass_context
+def distance_add(ctx, source_rse, destination_rse, distance):
+    """Create a new link from SOURCE-RSE to DESTINATION-RSE with a distance"""
+    args = Arguments({"source": source_rse, "destination": destination_rse, "distance": distance})
+    add_distance_rses(args, ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@distance.command("remove")
+@click.argument("source-rse")
+@click.argument("destination-rse")
+@click.pass_context
+def distance_remove(ctx, source_rse, destination_rse):
+    """Un-link SOURCE-RSE from DESTINATION-RSE by removing the distance between them"""
+    args = Arguments({"source": source_rse, "destination": destination_rse})
+    delete_distance_rses(args, ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@distance.command("update")
+@click.argument("source-rse")
+@click.argument("destination-rse")
+@click.option("--distance", type=int, help="Relative distance between RSEs", required=True)
+@click.pass_context
+def distance_update(ctx, source_rse, destination_rse, distance):
+    """Update the existing distance or ranking from SOURCE-RSE to DESTINATION-RSE"""
+    args = Arguments({"source": source_rse, "destination": destination_rse, "distance": distance})
+    update_distance_rses(args, ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@rse.group()
+def attribute():
+    """Interact with RSE Attributes"""
+
+
+@attribute.command("list")
+@click.argument("rse-name")
+@click.pass_context
+def attr_list_(ctx, rse_name):
+    """List all attributes of a given RSE"""
+    get_attribute_rse(Arguments({"rse": rse_name}), ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@attribute.command("add")
+@click.argument("rse-name")
+@click.option('--key', help='Attribute key', required=True)
+@click.option('--value', help='Attribute value', required=True)
+@click.pass_context
+def attribute_add_(ctx, rse_name, key, value):
+    """Add a new attribute for an RSE
+
+    \b
+    Example:
+        $ rucio rse attribute add my-rse --key My-Attribute  --value True
+    """
+    args = Arguments({"rse": rse_name, "key": key, "value": value})
+    set_attribute_rse(args, ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+# TODO Update attribute - only overwrites existing attributes
+
+@attribute.command("remove")
+@click.argument("rse-name")
+@click.option("--attribute", help="Attribute to remove", required=True)
+@click.pass_context
+def attribute_remove(ctx, rse_name, attribute):
+    """Remove an existing attribute from an RSE"""
+    args = Arguments({"rse": rse_name, "key": attribute, "value": None})
+    delete_attribute_rse(args, ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@rse.group()
+def limit():
+    """Manage storage size limits"""
+
+
+@limit.command("add")
+@click.argument("rse-name")
+@click.option("--limit", type=(str, int), required=True, help="Name of limit and value in bytes")
+@click.pass_context
+def limit_add(ctx, rse_name, limit):
+    """Add a usage limit to an RSE
+
+    \b
+    Example, add a limit of 1KB to XRD1 named "MinFreeSpace":
+        $ rucio rse limit add XRD1 --limit MinFreeSpace 10000
+    """
+    args = Arguments({"rse": rse_name, "name": limit[0], "value": limit[1]})
+    set_limit_rse(args, ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@limit.command("remove")
+@click.argument("rse-name")
+@click.option("--limit", required=True, help="Name of limit to remove")
+@click.pass_context
+def limit_remove(ctx, rse_name, limit):
+    """Remove an existing RSE limit"""
+    args = Arguments({"rse": rse_name, "name": limit})
+    delete_limit_rse(args, ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@rse.group()
+@click.help_option("-h", "--help")
+def protocol():
+    """Manage RSE transfer protocols"""
+
+
+# TODO Better loader for json types
+@protocol.command("add")
+@click.argument("rse-name")
+@click.option("--host", "--host-name", help="Endpoint hostname", required=True)
+@click.option("--scheme", help="Endpoint URL scheme", required=True)
+@click.option("--prefix", help="Endpoint URL path prefix", required=True)
+@click.option("--space-token", help="Space token name (SRM-only)")
+@click.option("--web-service-path", help="Web service URL (SRM-only)")
+@click.option("--port", type=int, help="URL port")
+@click.option("--impl", default="rucio.rse.protocols.gfal.Default", help="Transfer protocol implementation to use")
+@click.option("--domain-json", type=json.loads, help="JSON describing the WAN / LAN setup")
+@click.option("--extended-attributes-json", type=json.loads, help="JSON describing any extended attributes")
+@click.pass_context
+def protocol_add(ctx, rse_name, host, scheme, prefix, space_token, web_service_path, port, impl, domain_json, extended_attributes_json):
+    """
+    Add a new protocol for an RSE used for transferring files
+
+    \b
+    Example, adding a default protocol hosted at jdoes.test.org to the RSE JDOE_DATADISK
+        $ rucio rse protocol add JDOE_DATADISK --host-name jdoes.test.org --scheme gsiftp --prefix '/atlasdatadisk/rucio/' --port 8443'
+
+    """
+    args = Arguments(
+        {"rse": rse_name, "hostname": host, "ext_attr_json": extended_attributes_json, "scheme": scheme, "prefix": prefix, "space_token": space_token, "web_service_path": web_service_path, "port": port, "impl": impl, "domain_json": domain_json}
+    )
+    add_protocol_rse(args, ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@protocol.command("remove")
+@click.argument("rse-name")
+@click.option("--scheme", help="Endpoint URL scheme", required=True)
+@click.option("--host-name", help="Endpoint hostname")
+@click.option("--port", type=int, help="URL port")
+@click.pass_context
+def protocol_remove(ctx, rse_name, host_name, scheme, port):
+    """Remove an existing protocol from an RSE"""
+    args = Arguments({"rse": rse_name, "scheme": scheme, "hostname": host_name, "port": port})
+    del_protocol_rse(args, ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@rse.group()
+@click.help_option("-h", "--help")
+def qos():
+    """Interact with the QoS model"""
+
+
+@qos.command("add")
+@click.argument("rse-name", nargs=1)
+@click.option("--policy", required=True)
+@click.pass_context
+def qos_add(ctx, rse_name, policy):
+    "Add a new QoS policy"
+    add_qos_policy(Arguments({"rse": rse_name, "qos_policy": policy}), ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@qos.command("remove")
+@click.argument("rse-name", nargs=1)
+@click.option("--policy", required=True)
+@click.pass_context
+def qos_remove(ctx, rse_name, policy):
+    "Remove an existing QoS policy"
+    delete_qos_policy(Arguments({"rse": rse_name, "qos_policy": policy}), ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@qos.command("list")
+@click.argument("rse-name", nargs=1)
+@click.pass_context
+def qos_list(ctx, rse_name):
+    "List the RSE's QoS policies"
+    list_qos_policies(Arguments({"rse": rse_name}), ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)

rucio/cli/rule.py

@@ -0,0 +1,158 @@
+# Copyright European Organization for Nuclear Research (CERN) since 2012
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import click
+
+from rucio.cli.bin_legacy.rucio import add_rule, delete_rule, info_rule, list_rules, list_rules_history, move_rule, update_rule
+from rucio.cli.utils import Arguments
+
+
+@click.group()
+def rule():
+    """View and define rules for creating replicas of DIDs"""
+
+
+@rule.command("add")
+@click.argument("dids", nargs=-1)
+@click.option("--copies", type=int, help="Number of copies", required=True)
+@click.option("--rses", "--rse-exp", help="Rule RSE expression", required=True)
+@click.option("--weight", help="RSE Weight")
+@click.option("--lifetime", type=str, help="Rule lifetime (in seconds). Use 'None' for no set lifetime")
+@click.option("--grouping", type=click.Choice(["DATASET", "ALL", "NONE"]), help="Rule grouping")
+@click.option("--locked", default=False, type=bool, is_flag=False, help="Rule locking")
+@click.option("--source-rses", help="RSE Expression for RSEs to be considered for source replicas")
+@click.option("--notify", type=click.Choice(["Y", "N", "C"]), help="Notification strategy : Y (Yes), N (No), C (Close)")
+@click.option("--activity", help="Activity to be used (e.g. User, Data Consolidation)")
+@click.option("--comment", help="Comment about the replication rule")
+@click.option("--ask-approval", is_flag=True, default=False, help="Ask for rule approval")
+@click.option("--asynchronous", is_flag=True, default=False, help="Create rule asynchronously")
+@click.option("--delay-injection", type=int, help="Delay (in seconds) to wait before starting applying the rule. This option implies --asynchronous.")
+@click.option("--account", help="The account owning the rule")
+@click.option("--skip-duplicates", is_flag=True, default=False, help="Skip duplicate rules")
+@click.pass_context
+def add_(ctx, dids, copies, rses, weight, asynchronous, lifetime, grouping, locked, source_rses, notify, activity, comment, ask_approval, delay_injection, account, skip_duplicates):
+    """Add replication rule to define how replicas of a list of DIDs are created on RSEs."""
+    args = Arguments(
+        {
+            "dids": dids,
+            "copies": copies,
+            "rse_expression": rses,
+            "weight": weight,
+            "lifetime": lifetime,
+            "grouping": grouping,
+            "locked": locked,
+            "notify": notify,
+            "activity": activity,
+            "comment": comment,
+            "ask_approval": ask_approval,
+            "delay_injection": delay_injection,
+            "rule_account": account,
+            "source_replica_expression": source_rses,
+            "ignore_duplicate": skip_duplicates,
+            "asynchronous": asynchronous,
+        }
+    )
+    add_rule(args, ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@rule.command("remove")
+@click.argument("rule-id-dids")
+@click.option("--purge-replicas", is_flag=True, default=False, help="Purge rule replicas")
+@click.option("--all", "_all", is_flag=True, default=False, help="Delete all the rules, even the ones that are not owned by the account")
+@click.option("--rses", "--rse-exp", help="The RSE expression. Must be specified if a DID is provided.")  # TODO mutual inclusive group
+@click.option("--account", help="The account of the rule that must be deleted")
+@click.pass_context
+def remove(ctx, rule_id_dids, _all, rses, account, purge_replicas):
+    """Remove an existing rule. Supply [rule-id] if know, or use [DID] and --rses to remove all rules for DIDs on RSEs matching the expression"""
+    args = Arguments({"purge_replicas": purge_replicas, "delete_all": _all, "rule_account": account, "rule_id": rule_id_dids, "rses": rses})
+    delete_rule(args, ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@rule.command("show")
+@click.argument("rule-id")
+@click.option("--examine", is_flag=True, default=False, help="Detailed analysis of transfer errors")
+@click.pass_context
+def show(ctx, rule_id, examine):
+    """Retrieve information about a rule"""
+    info_rule(Arguments({"rule_id": rule_id, "examine": examine}), ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@rule.command("history")
+@click.argument("did", nargs=1)
+@click.pass_context
+def history(ctx, did):
+    """Display the history of rules acting on a DID"""
+    list_rules_history(Arguments({"did": did}), ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@rule.command("move")
+@click.argument("rule_id")
+@click.option("--rses", "--rse-exp", help="RSE expression of new rule", required=True)
+@click.option("--activity", help="Update activity for moved rule", hidden=True)  # Should only do this using `update`
+@click.option("--source-rses", help="Update how replicas are sourced for the rule")
+@click.pass_context
+def move(ctx, rule_id, rses, activity, source_rses):
+    """Create a child rule on a different RSE. The parent rule is deleted once the new rule reaches `OK` status"""
+    args = Arguments({"rule_id": rule_id, "rse_expression": rses, "source_replica_expression": source_rses, "activity": activity})
+    move_rule(args, ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@rule.command("update")
+@click.argument("rule-id", nargs=1)
+@click.option("--lifetime", type=str, help="Rule lifetime (in seconds). Use 'None' for no set lifetime")
+@click.option("--locked", default=False, type=bool, is_flag=False, help="Rule locking")
+@click.option("--source-rses", help="RSE Expression for RSEs to be considered for source replicas")
+@click.option("--activity", help="Activity to be used (e.g. User, Data Consolidation)")
+@click.option("--comment", help="Comment about the replication rule")
+@click.option("--account", help="The account owning the rule")
+@click.option("--stuck", is_flag=True, default=False, help="Set state to STUCK.")
+@click.option("--activity", help="Activity of the rule.")
+@click.option("--cancel-requests", is_flag=True, default=False, help="Cancel requests when setting rules to stuck.")
+@click.option("--priority", help="Priority of the requests of the rule.")
+@click.option("--child-rule-id", help='Child rule id of the rule. Use "None" to remove an existing parent/child relationship.')
+@click.option("--boost-rule", is_flag=True, default=False, help="Quickens the transition of a rule from STUCK to REPLICATING.")
+@click.pass_context
+def update(ctx, rule_id, lifetime, locked, source_rses, activity, comment, account, stuck, cancel_requests, priority, child_rule_id, boost_rule):
+    """Update an existing rule"""
+    args = Arguments(
+        {
+            "rule_id": rule_id,
+            "lifetime": lifetime,
+            "locked": str(locked),  # update-rule wants to be able to uppercase arg
+            "rule_activity": activity,
+            "comment": comment,
+            "rule_account": account,
+            "source_replica_expression": source_rses,
+            "state_stuck": stuck,
+            "cancel_requests": cancel_requests,
+            "priority": priority,
+            "child_rule_id": child_rule_id,
+            "boost_rule": boost_rule,
+        }
+    )
+    update_rule(args, ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)
+
+
+@rule.command("list")
+@click.option("--did")
+@click.option("--id", "rule_id", help="List by rule id", hidden=True)  # TODO: Remove. This doesn't work and does the same thing as show
+@click.option("--traverse", is_flag=True, default=False, help="Traverse the did tree and search for rules affecting this did")
+@click.option("--csv", is_flag=True, default=False, help="Comma Separated Value output")
+@click.option("--file", help="Filter by file")
+@click.option("--account", help="Filter by account")
+@click.option("--subscription", help="Filter by subscription name")
+@click.pass_context
+def list_(ctx, did, rule_id, traverse, csv, file, account, subscription):
+    """List all rules impacting a given DID"""
+    args = Arguments({"did": did, "rule_id": rule_id, "traverse": traverse, "csv": csv, "file": file, "subscription": (account if account is not None else ctx.obj.client.account, subscription)})
+    list_rules(args, ctx.obj.client, ctx.obj.logger, ctx.obj.console, ctx.obj.spinner)