Repository navigation
Description
This is the list of everything deprecated in cijoe, complete up to and including 0.9.67. Everything on it is scheduled for removal with the v1.0 release, and is still in cijoe until then, as each entry's mark says. Each section names the version that deprecated what it lists, oldest first, so if you are on an older cijoe, the sections after your version are what stands between you and the latest one.
Updating is expected to be done by a coding agent, not by hand: give it this issue and the project that uses cijoe, and have it change the project for the version it updates to. Each entry names the old spelling exactly, and what replaces it, so the agent can find every use in the project's configs (*.toml), tasks (*.yaml) and scripts (*.py) and rewrite it.
Most old spellings still work until then, but not all of them say so. Each entry is marked with what happens when it is used with the latest cijoe:
- warns: it works, and prints a warning on stderr, so running the project's tasks shows what is left to change;
- logged: it works, and its warning is in the log only, seen with
-l; - silent: it works, and nothing says it is deprecated, so only the search finds it;
- no longer works: it already stopped working, without a fallback, before v1.0, so the project must change before it updates.
When something new is deprecated, add a section for its version, mark each entry, and move the version in the first sentence. Whoever then updates a project only has to read from the version they are on.
0.9.17: script entry points
worklet_entryandscript_entry, nowmain(Script.NAMING_CONVENTION); silent
0.9.59: workflow, superseded by task
workflows/package subdirectories, nowtasks/(Collector.LEGACY_CATEGORIES); logged-w/--workflowon the CLI, now the task as a positional argument; warnsCIJOE_DEFAULT_WORKFLOW, nowCIJOE_DEFAULT_TASK; warnscijoe-workflow.yamlas the default task file, nowcijoe-task.yaml; logged[cijoe.workflow] fail_fast, now[cijoe.task] fail_fast; loggedworkflow.stateread as a fallback fortask.state(cli.pyandprocessing.py); silentprocess_workflow_output, nowprocess_task_output; silentWorkflowimported fromcijoe.core.resources, nowTask; silent- the
example_workflow_prefix accepted bycijoe -e; silent - task files with the
.workflowsuffix, now.yaml; no longer works: they are not collected as tasks, and the.workflowglob inpackage-dataand the yamlfmt hook is all that is left of them
0.9.61: report options
-n/--no-report, now--report-skip; warns-p/--produce-report, now--report-only; warns-s/--skip-report, accepted and ignored, as the report is no longer opened unless asked for; warns
0.9.65: the linux package, and building QEMU from source (#226), to be removed at v1.0 with no replacement
linux.null_blkandcijoe.linux.null_blk; warnslinux.build_kdebs; warnslinux.sysinfo, nowcore.facts_gather; warns- the linux examples,
example_task_build_kdebsandexample_task_null_blk, and their configs; warns, through the scripts they run qemu.buildandqemu.install, and theirexample_task_build/example_config_build; warns
0.9.66: transport, superseded by target (#225), each warns
[cijoe.transport.<name>], now[cijoe.targets.<name>.ssh]transport_name=onrun(),put(),get(),close()andset_output_ident(), nowtarget=Cijoe.transports, nowCijoe.targetscore.wait_for_transportand itstransport_name, nowcore.wait_for_targetwith the step'starget:transportforcore.cmdrunner,core.putandcore.get, now the step'starget:target_nameforcore.facts_gatherandcore.tools_check, now the step'starget:transport.SSH(config, output_path, <name>), now given the target's[cijoe.targets.<name>.ssh]table
0.9.67: fact gathering moved to cijoe.core.facts (#227)
- the OS parsers (
linux_nvme(),linux_pci(),freebsd_nvme()and the like) imported fromcijoe.core.scripts.facts_gather, now fromcijoe.core.facts.gathering; no longer works (gatherandSECTIONSstill import from the script, silent; their place iscijoe.core.facts)
Before v1.0, separately (#236): the logged entries should warn through cijoe.core.misc.deprecated(), which prints to stderr once per spelling, and the silent ones should warn at all, so that every deprecation has had a visible warning for at least one release before it is removed.
Activity
[-]Remove deprecated spellings at v1.0[/-][+]Deprecated, for removal with the v1.0 release[/+]