API: add aliases to shorthand names e.g. `contour` for `con`
@sadielbartholomew is already working on this.
Since Apr 3, 2025.
- Dominant language
- Python
- Stars
- 21
- Forks
- 11
- Avg merge
- 7h 11m
- Merged PRs (30d)
- 1
Description
There are method names which are shorthand for words descriptive of the nature of the method, where the full word is not available as a method, for example con is the name for the contour plot method and not contour, which is not defined - likewise vect and vector. Whilst having a shorthand name is useful to save typing, it is natural to guess/try the full descriptor for a method name, therefore I think it is also important and more transparent to have the longer name available. So I suggest we have aliases to cover both the long and short versions.
Ideally the shorthand would be the alias and the longhand the canonical defined method, but since in the majority of cases (see lists below) and notably for the core user-facing plot-producing methods con, vect and traj we already have the latter, we can start by doing the opposite and in a future version perhaps switch these over - which would be transparent to the user but under-the-hood a significant code change.
So far cases I have identified where we should create an alias are, noting that due to GB/US English differences we may even want two aliases due to the use of color/colour:
contourforconvectorforvecttrajectoryfortrajcolourbarandcolorbarforcbarcolourscaleandcolourscaleforcscalelevelsforlevsgpositionforgpos
and as for the converse, where there are no shorthands, perhaps:
stipforstipplelpforlineplot
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.