Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Support tab completion in Jupyter by inserting aliases into the method signature #1282

Merged
merged 14 commits into from
Jun 16, 2021
Merged
Prev Previous commit
Next Next commit
Use insert_alias for all functions with use_alias
  • Loading branch information
maxrjones committed May 22, 2021
commit d3a046e2d1750aa03ed138dcfca9a9c633abd95f
2 changes: 2 additions & 0 deletions pygmt/figure.py
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@
from pygmt.helpers import (
build_arg_string,
fmt_docstring,
insert_alias,
kwargs_to_strings,
launch_external_viewer,
unique_name,
Expand Down Expand Up @@ -124,6 +125,7 @@ def region(self):
return wesn

@fmt_docstring
@insert_alias
@use_alias(
A="crop",
C="gs_option",
Expand Down
2 changes: 2 additions & 0 deletions pygmt/src/basemap.py
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,14 @@
args_in_kwargs,
build_arg_string,
fmt_docstring,
insert_alias,
kwargs_to_strings,
use_alias,
)


@fmt_docstring
@insert_alias
@use_alias(
R="region",
J="projection",
Expand Down
2 changes: 2 additions & 0 deletions pygmt/src/coast.py
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,14 @@
args_in_kwargs,
build_arg_string,
fmt_docstring,
insert_alias,
kwargs_to_strings,
use_alias,
)


@fmt_docstring
@insert_alias
@use_alias(
R="region",
J="projection",
Expand Down
9 changes: 8 additions & 1 deletion pygmt/src/colorbar.py
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,17 @@
"""

from pygmt.clib import Session
from pygmt.helpers import build_arg_string, fmt_docstring, kwargs_to_strings, use_alias
from pygmt.helpers import (
build_arg_string,
fmt_docstring,
insert_alias,
kwargs_to_strings,
use_alias,
)


@fmt_docstring
@insert_alias
@use_alias(
R="region",
J="projection",
Expand Down
2 changes: 2 additions & 0 deletions pygmt/src/contour.py
Original file line number Diff line number Diff line change
Expand Up @@ -9,12 +9,14 @@
data_kind,
dummy_context,
fmt_docstring,
insert_alias,
kwargs_to_strings,
use_alias,
)


@fmt_docstring
@insert_alias
@use_alias(
A="annotation",
B="frame",
Expand Down
9 changes: 8 additions & 1 deletion pygmt/src/grd2cpt.py
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,17 @@

from pygmt.clib import Session
from pygmt.exceptions import GMTInvalidInput
from pygmt.helpers import build_arg_string, fmt_docstring, kwargs_to_strings, use_alias
from pygmt.helpers import (
build_arg_string,
fmt_docstring,
insert_alias,
kwargs_to_strings,
use_alias,
)


@fmt_docstring
@insert_alias
@use_alias(
A="transparency",
C="cmap",
Expand Down
2 changes: 2 additions & 0 deletions pygmt/src/grdclip.py
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,14 @@
GMTTempFile,
build_arg_string,
fmt_docstring,
insert_alias,
kwargs_to_strings,
use_alias,
)


@fmt_docstring
@insert_alias
@use_alias(
G="outgrid",
R="region",
Expand Down
9 changes: 8 additions & 1 deletion pygmt/src/grdcontour.py
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,17 @@
grdcontour - Plot a contour figure.
"""
from pygmt.clib import Session
from pygmt.helpers import build_arg_string, fmt_docstring, kwargs_to_strings, use_alias
from pygmt.helpers import (
build_arg_string,
fmt_docstring,
insert_alias,
kwargs_to_strings,
use_alias,
)


@fmt_docstring
@insert_alias
@use_alias(
A="annotation",
B="frame",
Expand Down
2 changes: 2 additions & 0 deletions pygmt/src/grdcut.py
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,14 @@
GMTTempFile,
build_arg_string,
fmt_docstring,
insert_alias,
kwargs_to_strings,
use_alias,
)


@fmt_docstring
@insert_alias
@use_alias(
G="outgrid",
R="region",
Expand Down
2 changes: 2 additions & 0 deletions pygmt/src/grdfill.py
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,14 @@
GMTTempFile,
build_arg_string,
fmt_docstring,
insert_alias,
kwargs_to_strings,
use_alias,
)


@fmt_docstring
@insert_alias
@use_alias(
A="mode",
G="outgrid",
Expand Down
2 changes: 2 additions & 0 deletions pygmt/src/grdfilter.py
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,14 @@
GMTTempFile,
build_arg_string,
fmt_docstring,
insert_alias,
kwargs_to_strings,
use_alias,
)


@fmt_docstring
@insert_alias
@use_alias(
D="distance",
F="filter",
Expand Down
9 changes: 8 additions & 1 deletion pygmt/src/grdimage.py
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,17 @@
grdimage - Plot grids or images.
"""
from pygmt.clib import Session
from pygmt.helpers import build_arg_string, fmt_docstring, kwargs_to_strings, use_alias
from pygmt.helpers import (
build_arg_string,
fmt_docstring,
insert_alias,
kwargs_to_strings,
use_alias,
)


@fmt_docstring
@insert_alias
@use_alias(
A="img_out",
B="frame",
Expand Down
2 changes: 2 additions & 0 deletions pygmt/src/grdinfo.py
Original file line number Diff line number Diff line change
Expand Up @@ -6,12 +6,14 @@
GMTTempFile,
build_arg_string,
fmt_docstring,
insert_alias,
kwargs_to_strings,
use_alias,
)


@fmt_docstring
@insert_alias
@use_alias(
C="per_column",
D="tiles",
Expand Down
2 changes: 2 additions & 0 deletions pygmt/src/grdtrack.py
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,13 @@
build_arg_string,
data_kind,
fmt_docstring,
insert_alias,
use_alias,
)


@fmt_docstring
@insert_alias
@use_alias(V="verbose", f="coltypes", n="interpolation")
def grdtrack(points, grid, newcolname=None, outfile=None, **kwargs):
"""
Expand Down
2 changes: 2 additions & 0 deletions pygmt/src/grdview.py
Original file line number Diff line number Diff line change
Expand Up @@ -9,12 +9,14 @@
build_arg_string,
data_kind,
fmt_docstring,
insert_alias,
kwargs_to_strings,
use_alias,
)


@fmt_docstring
@insert_alias
@use_alias(
R="region",
J="projection",
Expand Down
9 changes: 8 additions & 1 deletion pygmt/src/histogram.py
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,17 @@
Histogram - Create a histogram
"""
from pygmt.clib import Session
from pygmt.helpers import build_arg_string, fmt_docstring, kwargs_to_strings, use_alias
from pygmt.helpers import (
build_arg_string,
fmt_docstring,
insert_alias,
kwargs_to_strings,
use_alias,
)


@fmt_docstring
@insert_alias
@use_alias(
A="horizontal",
B="frame",
Expand Down
9 changes: 8 additions & 1 deletion pygmt/src/image.py
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,17 @@
image - Plot an image.
"""
from pygmt.clib import Session
from pygmt.helpers import build_arg_string, fmt_docstring, kwargs_to_strings, use_alias
from pygmt.helpers import (
build_arg_string,
fmt_docstring,
insert_alias,
kwargs_to_strings,
use_alias,
)


@fmt_docstring
@insert_alias
@use_alias(
R="region",
J="projection",
Expand Down
2 changes: 2 additions & 0 deletions pygmt/src/info.py
Original file line number Diff line number Diff line change
Expand Up @@ -7,12 +7,14 @@
GMTTempFile,
build_arg_string,
fmt_docstring,
insert_alias,
kwargs_to_strings,
use_alias,
)


@fmt_docstring
@insert_alias
@use_alias(
C="per_column",
I="spacing",
Expand Down
9 changes: 8 additions & 1 deletion pygmt/src/inset.py
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,18 @@
import contextlib

from pygmt.clib import Session
from pygmt.helpers import build_arg_string, fmt_docstring, kwargs_to_strings, use_alias
from pygmt.helpers import (
build_arg_string,
fmt_docstring,
insert_alias,
kwargs_to_strings,
use_alias,
)


@fmt_docstring
@contextlib.contextmanager
@insert_alias
@use_alias(D="position", F="box", M="margin", N="no_clip", V="verbose")
@kwargs_to_strings(D="sequence", M="sequence")
def inset(self, **kwargs):
Expand Down
2 changes: 2 additions & 0 deletions pygmt/src/legend.py
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,14 @@
build_arg_string,
data_kind,
fmt_docstring,
insert_alias,
kwargs_to_strings,
use_alias,
)


@fmt_docstring
@insert_alias
@use_alias(
R="region",
J="projection",
Expand Down
9 changes: 8 additions & 1 deletion pygmt/src/logo.py
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,17 @@
"""

from pygmt.clib import Session
from pygmt.helpers import build_arg_string, fmt_docstring, kwargs_to_strings, use_alias
from pygmt.helpers import (
build_arg_string,
fmt_docstring,
insert_alias,
kwargs_to_strings,
use_alias,
)


@fmt_docstring
@insert_alias
@use_alias(
R="region",
J="projection",
Expand Down
9 changes: 8 additions & 1 deletion pygmt/src/makecpt.py
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,17 @@
"""
from pygmt.clib import Session
from pygmt.exceptions import GMTInvalidInput
from pygmt.helpers import build_arg_string, fmt_docstring, kwargs_to_strings, use_alias
from pygmt.helpers import (
build_arg_string,
fmt_docstring,
insert_alias,
kwargs_to_strings,
use_alias,
)


@fmt_docstring
@insert_alias
@use_alias(
A="transparency",
C="cmap",
Expand Down
2 changes: 2 additions & 0 deletions pygmt/src/meca.py
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@
data_kind,
dummy_context,
fmt_docstring,
insert_alias,
kwargs_to_strings,
use_alias,
)
Expand Down Expand Up @@ -95,6 +96,7 @@ def data_format_code(convention, component="full"):


@fmt_docstring
@insert_alias
@use_alias(
R="region",
J="projection",
Expand Down
2 changes: 2 additions & 0 deletions pygmt/src/plot.py
Original file line number Diff line number Diff line change
Expand Up @@ -8,13 +8,15 @@
data_kind,
deprecate_parameter,
fmt_docstring,
insert_alias,
is_nonstr_iter,
kwargs_to_strings,
use_alias,
)


@fmt_docstring
@insert_alias
@use_alias(
A="straight_line",
B="frame",
Expand Down