Skip to content
This repository has been archived by the owner on Jan 26, 2022. It is now read-only.
/ Typed-Flags Public archive

A Typehint based flags system for discord.py

Notifications You must be signed in to change notification settings

MenuDocs/Typed-Flags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Typed Flags

A Typehint based system for including flag input in your discord.py commands.

Why bother with numerous decorators and patched commands when you just typehint your input to receive command flags?

Examples


Usage is as simple as typehinting the entire input argument string to TypedFlags, this in turn will convert everything and will return this argument as a dict of key:value pairs where each key is the flag, and the value is the value for that flag

from typed_flags import TypedFlags

@bot.command()
async def test(ctx, *, args: TypedFlags):
    # Send all of command args
    await ctx.send(args)

An example calling the above code: %test this "Lol ez" --try:=test string --hard:=This is kinda cool

args = {'argless': ['this', 'Lol ez'], 'try': 'test string', 'hard': 'This is kinda cool'}

A further example: %test --try:=test string --hard:=lol This is kinda cool

args = {'try': 'test string', 'hard': 'lol This is kinda cool'}

Note: Since we have no argless arguments, it is not in the returned data

Customization


You can customize two things, the string to preceed any flag values as well as the string to split up between the flag and its value. Both of these are keyword arguments when initializing TypedFlags

  • start: str -> The string to preceed any flags (Defaults to --)
  • delim: str -> What to split flags with to get the key:value split (Defaults to :=)
  • suppress_reserved_keyword: boolean -> Whether to suppress errors on reserved keywords (Defaults to False)
    • Currently argless is reserved
    • By default, if the user provides a flag called argless it raises ReservedKeyword
    • If you set this to True it will overwrite argless, this does mean you lose any arguments without a flag

You do not have to provide these values. There are defaults in place. It is only for customization purposes

Important Notes


This package works in-line with how discord.py handles command parsing and consumption. That is to say the argument Hello world will be two variables, where as the argument "Hello world" will be parsed as one argument. This is something important to understand otherwise you will experience unexpected behaviour.

However, this only applies to 'argless' arguments. Values between flags are considered to be all part of said flag (See examples)


Any arguments not associated with a flag will be added to the dictionary under the key argless. The value for this key is a list containing all of the arguments found that do not corrospond to a given flag.

It is also important to note that if no argless values are detected then this key will not be in the dictionary. You should check for this in your code.


Any arguments in argless are ordered according to the order they were received.

About

A Typehint based flags system for discord.py

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages