We continue to clean up Param's API ([734](https://github.com/holoviz/param/pull/734), [#751](https://github.com/holoviz/param/pull/751), [#768](https://github.com/holoviz/param/pull/768), [#797](https://github.com/holoviz/param/pull/797), [#834](https://github.com/holoviz/param/pull/834), [#838](https://github.com/holoviz/param/pull/838)) but have decided to do it in a gentle way, emitting deprecation warnings for a period of time before proceeding with removals. You will find below the complete list of deprecation warnings added in Param 2.0.
- Parameter signature:
- Instantiating most parameters with positional arguments beyond `default` is deprecated:
- `String('prefix-test', '^prefix')`: deprecated!
- `String('prefix-test', regex='^prefix')`: OK
- `String(default='prefix-test', regex='^prefix')`: OK
- For `Selector` parameters that accept `objects` as first positional argument, and `ClassSelector` parameters that accept `class_` as first positional argument, passing any argument by position is deprecated:
- `Selector([1, 2])`: deprecated!
- `Selector(objects=[1, 2])`: OK
- `ClassSelector((str, int))`: deprecated!
- `ClassSelector(class_=(str, int))`: OK
- It's possible that in the future the signature of these two parameters will be aligned with the other parameters to accept `default` as first and only positional argument, but for now please use an explicit keyword so that your code will be compatible with all versions.
- Parameter slots:
- `List._class`: use instead `item_type`.
- `Number.set_hook`: no replacement
- `param.__init__` module:
- `param.produce_value`: no replacement
- `param.as_unicode`: no replacement
- `param.is_ordered_dict`: no replacement
- `param.is_ordered_dict`: no replacement
- `param.hashable`: no replacement
- `param.named_objs`: no replacement
- `param.normalize_path`: no replacement
- `param.abbreviate_paths`: no replacement
- `param.parameterized` module:
- `param.parameterized.all_equal`: no replacement
- `param.parameterized.add_metaclass`: no replacement
- `param.parameterized.batch_watch`: use instead `batch_call_watchers`
- `param.parameterized.recursive_repr`: no replacement
- `param.parameterized.overridable_property`: no replacement
- Parameterized `.param` namespace; many of these methods have been deprecated since version 1.12.0, however, this was just announced in the release notes and we realised many users missed them, sometimes even us included! They now all emit deprecation warnings when executed and are clearly marked as deprecated in the API reference:
- `.param.set_default`: use instead `for k,v in p.param.objects().items(): print(f"{p.__class__.name}.{k}={repr(v.default)}")`
- `.param._add_parameter`: use instead `.param.add_parameter`
- `.param.params`: use instead `.param.values()` or `.param['param']`
- `.param.set_param`: use instead `.param.update`
- `.param.get_param_values`: use instead `.param.values().items()` (or `.param.values()` for the common case of `dict(....param.get_param_values())`)
- `.param.params_depended_on`: use instead `.param.method_dependencies`
- `.param.defaults`: use instead `{k:v.default for k,v in p.param.objects().items()}`
- `.param.print_param_defaults`: use instead `for k,v in p.param.objects().items(): print(f"{p.__class__.name}.{k}={repr(v.default)}")`
- `.param.print_param_values`: use instead `for k,v in p.param.objects().items(): print(f"{p.__class__.name}.{k}={repr(v.default)}")`
- `.param.message`: use instead `.param.log(param.MESSAGE, ...)`
- `.param.verbose`: use instead `.param.log(param.VERBOSE, ...)`
- `.param.debug`: use instead `.param.log(param.DEBUG, ...)`
- Running unsafe operations **during Parameterized instance initialization**, instead run these operations after having called `super().__init__(**params)`:
- `instance.param.objects(instance=True)`
- `instance.param.trigger("<param_name>")`
- `instance.param.watch(callback, "<param_name>")`
- Parameterized namespace:
- `instance._param_watchers` (getter and setter): use instead the property `inst.param.watchers`
[*Full Changelog*](https://github.com/holoviz/param/compare/v1.13.0...v2.0.0)