v2.0.0a3

2.0.0a3 - 2021-09-10

Added

• Add always_float keyword argument to with_float_slash_option.
• SlashContext.options mapping plus a resolvable option type to allow for more easily getting slash command options without relying on passed keyword arguments.
• Automatic type injector special casing for components and commands within a command context.
• Split up tanjun.commands.SlashCommand.add_option into specific methods.
• Add pass_as_kwarg keyword argument to with slash option decorators with True default.

Changed

• Renamed Client.__init__ "shard" arg to "shards".
• Annotate implimation functions/properties which return collections as returning collections.abc.Collection instead of their implemation specific subclass of Collcetion.
• Standard checks now have the same defaults as their with_* counterparts.

Fixed

• Bug around checks not being respected if they returned False.
• Client level check errors not being caught during execution.
• Don't erroneously dispatch message command not found callbacks when a component's execution returns true
• Don't fall back to normal command search in "strict" components and message command groups.
• Edit the command if command_id is passed to declare_slash_command instead of creating a new command.
• Missing call to checks in interaction request handler logic.

Removed

• Client.check_message_context and Component.check_message_context.
• tanjun.commands.SlashCommand.add_option.

v2.0.0a2

Added

• Float slash command option type.
• Component add and remove client callbacks.
• Event listeners are now loaded into Client by Components and support dependency injection.
• Add/with and remove listener methods had to be added to the Client to support this.
• Exported the parsing, commands and utilities modules on a top level (thus also adding them to the generated docs).
• Allow for overriding the standard client's context builders.
• Add default_permission argument to slash command types.
• Dependency injection support to client callbacks.
• Injection type special casing is more granular on a context to context basis now rather than top level hardcoded.
• Injection.Descriptor, TypeDescriptor and CallbackDescriptor replaced the Getter and InjectableValue classes

Changed

• Component.listeners and Client.listeners now return Mapping[type[Event], Collection[Callback]].
• Dependency injection on a lower level has been restructured to remove any reliance on tanjun.abc.Context.
  This means introducing an abstract injection context and implementing it with the standard context and a more basic impl.
• More strictly use properties instead of public instance variables in injection implementation.
• Dependency injection now caches the results of callbacks within the scope of an execution context.
• Renamed the InjectedValue classes to InjectedCallbacks.
• Return CallbackDescriptors from InjectionClient.get_type_dependency and get_callback_override instead of pure callbacks.
• Use Optional instead of UndefinedOr in injecting module where possible (e.g. the Injected callback and type fields).
• Process injected callbacks when they're first handled (passed to CallbackDescriptor) than when they're first called
  This lowers the amount of external caching needed.

Deprecated

• InjectionClient/Client .add_type_dependency and add_callback_override have been deprecated in favour of set_type_dependency and set_callback_override and are scheduled to be removed a month after v2.0.0a2 is released.

Removed

• injecting.Getter and injecting.InjectableValue.
• set_injector methods as the injection client is now passed around as part of a context.
• injection.resolve_getters (this logic is now on the descriptors).

Fixed

• Now handle when Discord doesn't include boolean options in interaction payloads because they were passed as False and weight reduction bro.
• Doc typo and export fixes.
• Fix handling of ctx.content and ctx.triggering_nameand in MessageCommandGroup to account for doubly nested command groups.
• Fix double-calling command group checks instead of calling the command group checks then the sub-command's check.

v2.0.0a1

2.0.0a1 - 2021-08-30

Added

• For a TLDR of how Tanjun's interface looks after these changes see the examples.
• Full slash command functionality, this includes new decorators for setting slash command specific options and slash command + command group declaration and execution. Some examples of this may be found here.
• Dependency injection, this feature is in it's early days and under documented but is still partially documented by the examples here. For now this only covers command callback, check (on both commands and components) and converter execution plus calls to the prefix getter functions (since it's limited to calls which take a Context for the initial implementation).
• Increased test and documentation coverage.
• Add the ability to set a custom prefix getter function.
• Switched over to pdoc from pdoc3 for doc generation.
• Added more extensive examples .
• Add rest fallbacks to the standard converters where possible.
• Fix some bugs with the standard checks.
• Introduce a flag for setting which message commands the standard client should accept for execution.
• Add client callback functions to allow for better integration between hikari's RESTBot and GatewayBot plus collecting
  runtime metadata.
• Added proxy methods and properties to the Context abcs to allow for calls when using the base Context abc.
• Add state tracking to Context to allow for similar functionality between the slash and message command flows when it comes to dealing with responses (e.g. initial and last response logic).
• Introduced a proper nox framework for running checks and CI tasks.
• Switched over to just importing the top level hikari module when possible to simplify imports.
• Replaced MYPY with pyright as the standard type checker.
• Switch over to relative imports.
• Switched away from setuptools to pep 621 with flit for defining the library and it's metadata (including requirements).
• Moved the project metadata duner properties direcltly to tanjun (from tanjun.about.py).

Changed

• Dropped support for python 3.8 in-order to switch over to using collection.abc generic classes due to this being more forward compatible.
• Move away from enforcing subclassing behaviour in-favour of builder objects you can still use subclassing behaviour in places but don't tell anybody I told you that.
• Consistency fix by ensuring functions are always called "callback".
• Add error_message and half_execution arguments to the standard checks to allow commands to more granularly define the behaviour for when they fail plus default them to having them send an error message when they fail if they were added to a command through a decorator call as this works better with the slash command flow and is better UX (a response explaining why it didn't work is better than no response).
• Renamed tanjun.traits to tanjun.abc.
• Replaced strategy of inferring other hikari client traits from the first arg parsed to Client.__init__ with having the init explicitly take in each trait it needs as a separate argument while having shortcut from_gateway_bot and from_rest_bot classmethods for building the standard client from hikari's "bot" traits.
• Only default to setting set_human_only(True) in Client.from_gateway_bot.
• API overhall around commands and context, this involved making a lot of classes and type hints generic to allow for the slash context and message context to be interchaingable under the right circumstances.
• Made the callback signatures more generic for commands and converters to allow for implementations to introduce features like dependency injection.

Removed

• Removed a lot of impl specific setting and with methods from the abstract interfaces to avoid

Last release before 2.0.0

This is just bug fixes, optimisations and dependency bumps.

Bump to hikari 3.0.0.dev100

Changes

• Rename dispatch_service to event_service.
• Add service properties to context protocol.

1.0.1a3

Bump hikari version to 2.0.0.dev99.

1.0.1.a2

First proper release: https://pypi.org/project/hikari-tanjun/1.0.1a2/