Add a helper function to check if a parameter is given or not

[Chuan1937]

Replace #4439
close #4355

[seisman]

@Chuan1937 I wonder if you would like to continue with this PR?

[Chuan1937]

@Chuan1937 I wonder if you would like to continue with this PR?

of course

[Copilot]

Pull request overview

This pull request introduces a centralized is_given() helper for determining whether a PyGMT parameter should be treated as “provided” (i.e., not None and not False), and refactors multiple modules to use it for clearer and more consistent option/validation logic.

Changes:

• Add pygmt.helpers.utils.is_given() (re-exported via pygmt.helpers) and use it in build_arg_list/args_in_kwargs.
• Refactor parameter conflict checks across several pygmt.src.* wrappers to use is_given.
• Update Alias string conversion and BaseParam.__repr__ to use the shared “given” predicate.

Reviewed changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
pygmt/helpers/utils.py	Adds is_given() and updates argument-building utilities to use it.
pygmt/helpers/init.py	Re-exports is_given from helpers for convenient imports.
pygmt/alias.py	Uses is_given to normalize None/False handling during alias string conversion.
pygmt/src/_common.py	Uses is_given in _parse_position conflict checking.
pygmt/params/base.py	Uses is_given to filter fields included in BaseParam.__repr__.
pygmt/src/basemap.py	Refactors deprecation-parameter checks to use is_given.
pygmt/src/colorbar.py	Refactors _build_frame “old frame” and axis detection logic to use is_given.
pygmt/src/grdfill.py	Uses is_given to count mutually exclusive “at least one” parameters.
pygmt/src/grdfilter.py	Uses is_given for old-syntax conflict detection.
pygmt/src/grdgradient.py	Uses is_given for old-syntax conflict detection.
pygmt/src/grdproject.py	Uses is_given for unit/scaling mutual exclusion validation.
pygmt/src/grdview.py	Uses is_given for old-syntax conflict detection.
pygmt/src/subplot.py	Uses is_given in autolabel/tag conflict checks and tag_box validation.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[seisman]

Looks good to me.