tell: avoid errors produced by empty tellee

Co-authored-by: Florian Strzelecki <[email protected]>

bot: properly deprecate `search_url_callbacks()` method

plugin: add capability.__str__ for better logs

Co-authored-by: bronzeguy <[email protected]>
Co-authored-by: dgw <dg...

plugin: `require_bot_privilege()` implies `require_chanmsg()`

If the bot needs a channel privilege for a given callable, it probably
wants to do something rel...

That decorator is the only thing wot *might* actually get people to
notice that they're still us...

wikipedia: fix urlparse usage

Co-authored-by: dgw <[email protected]>

Co-authored-by: dgw <[email protected]>
Co-authored-by: Florian Strzelecki <florian.strzelecki@...

make: run flake8 on specific directories

docs: FAQ entry on logging + some minor clarification

It is relative to the config's `homedir`, which is the config's parent
folder by default but can...

There is always a log format and a log date format because those options
in the core section hav...

docs: install and running instance documentation

* explain how to install Sopel in the doc
* explain how to manage plugins
* explain how to use s...

coretasks: fix SASL EXTERNAL without password set

docs: set `maxdepth` or `titlesonly` on overly-long TOCs

Pointed to the "convenient" way of handling overlength messages via
optional arguments to `bot.s...

Just fixing a couple more Sphinx warnings. If only the warnings from
Sphinx always looking for "...

We have the choice of two not-great situations:

1. Concise `datetime` imports with broken cross...

This is a supposedly "experimental" option that was added in Sphinx 4.0,
but here we are using S...

Without doing this, we get some very ugly Sphinx output for the class,
and a few cryptic warning...

Didn't touch the toctree in `run.rst` because the PR expanding Sphinx
install/run documentation ...

plugin: type-hint `priority` argument as `Literal[]`

irc, bot, builtins: add & use `AbstractBot.make_identifier_memory()` helper

coretasks, docs: fix auto-saving `.blocks add host`; improve "Ignoring Users" docs & x-refs

This will flag any use of unrecognized values for the callable priority.
It makes a good interme...

privileges, plugin, tools.target, docs: channel privileges as IntFlag

Eliminated the link (to a webpage we're probably going to delete) in
favor of directly specifyin...

Maybe still not perfect, but there's at least a way to find out what
might make a callable "bloc...

This is a convenience method for people who just want default behavior
matching what Sopel itsel...

plugin: clean up redundant in-docstring parameter type annotations

memories: test/fix interactions between `SopelIdentifierMemory` ↔ `dict`

Since the whole point of this type is to have a thread-safe version of
`collections.defaultdict`...

Comparing two `SopelIdentifierMemory` instances using `==` already
worked, but if one side of th...

Comes with a slight bonus refactoring to share the argument-processing
code previously inlined i...

New `|` / `|=` operators added in Python 3.9 for dicts. However, because
we're now defining thei...

Prior to some of the recent work done on this class, calling `.clear()`
on a `SopelIdentifierMem...

Constructing a `SopelMemory` by passing kwargs as key-value pairs is not
currently supported. Th...

I'm timid about changing the actual method signature for `__init__()`,
but could be talked into ...

Co-authored-by: SnoopJ <[email protected]>

Co-authored-by: SnoopJ <[email protected]>

Calling `.copy()` on a `SopelIdentifierMemory` now returns the correct
type of object (`SopelIde...

Resolves `KeyError` currently raised if the `key` parameter (`str`)
doesn't match the internal (...

test: explicitly specify `testpaths`

plugins: avoid crash on broken symlink

tools, tools.calculation: docs/type-hint improvements, API fixes, better test coverage

Nasty assertions on exception args... Really need to refactor that silly
ExpressionEvaluator.Err...

Contrary to its parameter descriptions, `pow_complexity()` was NOT able
to handle `float` inputs...

Co-authored-by: dgw <[email protected]>

The appearance of `Any` in the docs for plugin decorators bugged me so I
worked on the type anno...

I've definitely gone a little beyond that exact description in the name
of improving consistency...

Super-duper deemphasized that privileges are integer values. Removed the
actual values from code...

I figure getting "rewrite sopel/privileges.py (97%)" is the most
justified I'll ever be in my li...

The history and brief overview of how IRC privileges work is not part of
the module/class docume...

dice: bugfixes, type hints, and additional tests

calc: improve help output, test coverage (now 100%)

config: space before zone in `default_time_format`'s default

contrib: add tox data directory to gitignore

As Exirel pointed out, 0 isn't a negative number, and who knows? The
plugin's behavior could sta...

Matching on the dice expression pattern only once is more efficient, and
it simplifies the code....

Not that these docstrings are visible anywhere, but it still feels good.

One particularly trick...

There are still 3 missed lines (2 partial branches) that I don't believe
are possible to test us...

We still have uncovered lines/missed branches, and this rewrite actually
takes the file coverage...

A selection of rolled dice can pass the equation evaluator's complexity
checks but still yield a...

Raise an exception if something goes wrong. Let the caller take care of
sending output to IRC ba...

The equation evaluator has been taking care of this since 2013, when the
`addition` argument was...

Python 3.5 changed `compile()` (which `eval_equation()` uses, far down
the call stack) to raise ...

Stops the bot replying with an error *and also* outputting a result.
Only one or the other shoul...

These additional cases (and a new error handler) cover as much of the
`tools.calculation` submod...

Add Python 3.12 support

Oops! All Error Cases!

...were not covered by the test suite. That was the easiest 100% ever.