Rename the package to PyGMT (#265)

GMT/Python is a bad name because it can't be translated into a
repository or Python package name easily. What we have now is a
repository called `gmt-python`, a website `gmtpython`, a package `gmt`,
and a PyPI package `gmt-python`. This is madness.
Since all other GMT Python wrappers are dead, we'll rebrand as PyGMT
(repo and packages will be `pygmt`).

This renames the package and imports so that the tests pass and the docs
build. I'm sure we'll find many references to `gmt` but we can fix those
with time.

Fixes #263

Author: leouieda

.codeclimate.yml

@@ -19,7 +19,7 @@ plugins:
     enabled: true
     config:
       test_patterns:
-        - "gmt/**/tests/*.py"
+        - "pygmt/**/tests/*.py"
     checks:
       python:S3776:
         enabled: false
@@ -30,7 +30,7 @@ plugins:
 
 exclude_paths:
 - "versioneer.py"
-- "gmt/_version.py"
+- "pygmt/_version.py"
 - "doc/**/*"
-- "gmt/tests/baseline/*"
-- "gmt/tests/data/*"
+- "pygmt/tests/baseline/*"
+- "pygmt/tests/data/*"

.coveragerc

@@ -2,4 +2,4 @@
 omit =
     */tests/*
     */_version.py
-    *gmt/__init__.py
+    *pygmt/__init__.py

.gitattributes

@@ -1 +1 @@
-gmt/_version.py export-subst
+pygmt/_version.py export-subst

.github/config.yml

@@ -2,13 +2,13 @@
 ########################################################################################
 # Comment to be posted to on first time issues
 newIssueWelcomeComment: |
-  👋 Thanks for opening your first issue here! Please make sure you filled out the template with as much detail as possible. You might also want to take a look at our [contributing guidelines](https://github.com/GenericMappingTools/gmt-python/blob/master/CONTRIBUTING.md) and [code of conduct](https://github.com/GenericMappingTools/gmt-python/blob/master/CODE_OF_CONDUCT.md).
+  👋 Thanks for opening your first issue here! Please make sure you filled out the template with as much detail as possible. You might also want to take a look at our [contributing guidelines](https://github.com/GenericMappingTools/pygmt/blob/master/CONTRIBUTING.md) and [code of conduct](https://github.com/GenericMappingTools/pygmt/blob/master/CODE_OF_CONDUCT.md).
 
 # Comment to be posted to on PRs from first time contributors in your repository
 newPRWelcomeComment: |
   💖 Thanks for opening this pull request! 💖
 
-  Please make sure you read our [contributing guidelines](https://github.com/GenericMappingTools/gmt-python/blob/master/CONTRIBUTING.md) and abide by our [code of conduct](https://github.com/GenericMappingTools/gmt-python/blob/master/CODE_OF_CONDUCT.md).
+  Please make sure you read our [contributing guidelines](https://github.com/GenericMappingTools/pygmt/blob/master/CONTRIBUTING.md) and abide by our [code of conduct](https://github.com/GenericMappingTools/pygmt/blob/master/CODE_OF_CONDUCT.md).
 
   A few things to keep in mind:
 

.stickler.yml

@@ -9,4 +9,4 @@ linters:
     csslint:
         enable: false
 files:
-    ignore: ['versioneer.py', 'gmt/_version.py', 'doc/conf.py']
+    ignore: ['versioneer.py', 'pygmt/_version.py', 'doc/conf.py']

CONTRIBUTING.md

@@ -246,9 +246,9 @@ Leave a comment in the PR and we'll help you out.
 We use the [pytest-mpl](https://github.com/matplotlib/pytest-mpl) plug-in to test plot
 generating code.
 Every time the tests are run, `pytest-mpl` compares the generated plots with known
-correct ones stored in `gmt/tests/baseline`.
-If your test created a `gmt.Figure` object, you can test it by adding a *decorator* and
-returning the `gmt.Figure` object:
+correct ones stored in `pygmt/tests/baseline`.
+If your test created a `pygmt.Figure` object, you can test it by adding a *decorator* and
+returning the `pygmt.Figure` object:
 
 ```python
 @pytest.mark.mpl_image_compare
@@ -260,21 +260,21 @@ def test_my_plotting_case():
     return fig
 ```
 
-Your test function **must** return the `gmt.Figure` object and you can only
+Your test function **must** return the `pygmt.Figure` object and you can only
 test one figure per function.
 
 Before you can run your test, you'll need to generate a *baseline* (a correct
 version) of your plot.
 Run the following from the repository root:
 
 ```bash
-py.test --mpl-generate-path=baseline gmt/tests/NAME_OF_TEST_FILE.py
+py.test --mpl-generate-path=baseline pygmt/tests/NAME_OF_TEST_FILE.py
 ```
 
 This will create a `baseline` folder with all the plots generated in your test
 file.
 Visually inspect the one corresponding to your test function.
-If it's correct, copy it (and only it) to `gmt/tests/baseline`.
+If it's correct, copy it (and only it) to `pygmt/tests/baseline`.
 When you run `make test` the next time, your test should be executed and
 passing.
 

MAINTENANCE.md

@@ -81,7 +81,7 @@ There are a few steps that still must be done manually, though.
 2. Edit the changes list to remove any trivial changes (updates to the README, typo
    fixes, CI configuration, etc).
 3. Replace the PR number in the commit titles with a link to the Github PR page. In Vim,
-   use `` %s$#\([0-9]\+\)$`#\1 <https://github.com/GenericMappingTools/gmt-python/pull/\1>`__$g ``
+   use `` %s$#\([0-9]\+\)$`#\1 <https://github.com/GenericMappingTools/pygmt/pull/\1>`__$g ``
    to make the change automatically.
 4. Copy the remaining changes to `doc/changes.rst` under a new section for the
    intended release.
@@ -132,7 +132,7 @@ After Travis is done building the tag and all builds pass, we need to update the
 package.
 Unfortunately, this needs to be done manually for now.
 
-1. Fork the feedstock repository (https://github.com/conda-forge/gmt-python-feedstock) if
+1. Fork the feedstock repository (https://github.com/conda-forge/pygmt-feedstock) if
    you haven't already. If you have a fork, update it.
 2. Update the version number and sha256 hash on `recipe/meta.yaml`. You can get the hash
    from the PyPI "Download files" section.

MANIFEST.in

@@ -4,6 +4,6 @@ include CODE_OF_CONDUCT.md
 include CONTRIBUTING.md
 include AUTHORS.md
 include versioneer.py
-include gmt/_version.py
-recursive-include gmt/tests/data *
-recursive-include gmt/tests/baseline *
+include pygmt/_version.py
+recursive-include pygmt/tests/data *
+recursive-include pygmt/tests/baseline *

Makefile

@@ -1,5 +1,5 @@
 # Build, package, test, and clean
-PROJECT=gmt
+PROJECT=pygmt
 TESTDIR=tmp-test-dir-with-unique-name
 PYTEST_ARGS=--cov-config=../.coveragerc --cov-report=term-missing --cov=$(PROJECT) --doctest-modules -v --pyargs
 BLACK_FILES=$(PROJECT) setup.py doc/conf.py
@@ -24,7 +24,7 @@ test:
 	# Run a tmp folder to make sure the tests are run on the installed version
 	mkdir -p $(TESTDIR)
 	@echo ""
-	@cd $(TESTDIR); python -c "import gmt; gmt.print_clib_info()"
+	@cd $(TESTDIR); python -c "import $(PROJECT); $(PROJECT).print_clib_info()"
 	@echo ""
 	cd $(TESTDIR); pytest $(PYTEST_ARGS) $(PROJECT)
 	cp $(TESTDIR)/.coverage* .

README.rst

@@ -1,29 +1,29 @@
-GMT/Python
-==========
+PyGMT
+=====
 
     A Python interface for the Generic Mapping Tools
 
 `Documentation (development version) <https://www.gmtpython.xyz>`__ |
-`Contact <https://gitter.im/GenericMappingTools/gmt-python>`__
+`Contact <https://gitter.im/GenericMappingTools/pygmt>`__
 
-.. image:: http://img.shields.io/pypi/v/gmt-python.svg?style=flat-square
+.. image:: http://img.shields.io/pypi/v/pygmt.svg?style=flat-square
     :alt: Latest version on PyPI
-    :target: https://pypi.python.org/pypi/gmt-python
-.. image:: http://img.shields.io/travis/GenericMappingTools/gmt-python/master.svg?style=flat-square&label=Linux|Mac
+    :target: https://pypi.python.org/pypi/pygmt
+.. image:: http://img.shields.io/travis/GenericMappingTools/pygmt/master.svg?style=flat-square&label=Linux|Mac
     :alt: Travis CI build status
-    :target: https://travis-ci.org/GenericMappingTools/gmt-python
-.. image:: https://img.shields.io/codecov/c/github/GenericMappingTools/gmt-python/master.svg?style=flat-square
+    :target: https://travis-ci.org/GenericMappingTools/pygmt
+.. image:: https://img.shields.io/codecov/c/github/GenericMappingTools/pygmt/master.svg?style=flat-square
     :alt: Test coverage status
-    :target: https://codecov.io/gh/GenericMappingTools/gmt-python
+    :target: https://codecov.io/gh/GenericMappingTools/pygmt
 .. image:: https://img.shields.io/codacy/grade/e73169dcb8454b3bb0f6cc5389b228b4.svg?style=flat-square&label=codacy
     :alt: Code quality grade on codacy
-    :target: https://www.codacy.com/app/leouieda/gmt-python
-.. image:: https://img.shields.io/pypi/pyversions/gmt-python.svg?style=flat-square
+    :target: https://www.codacy.com/app/leouieda/pygmt
+.. image:: https://img.shields.io/pypi/pyversions/pygmt.svg?style=flat-square
     :alt: Compatible Python versions.
-    :target: https://pypi.python.org/pypi/gmt-python
-.. image:: https://img.shields.io/gitter/room/GenericMappingTools/gmt-python.svg?style=flat-square
+    :target: https://pypi.python.org/pypi/pygmt
+.. image:: https://img.shields.io/gitter/room/GenericMappingTools/pygmt.svg?style=flat-square
     :alt: Chat room on Gitter
-    :target: https://gitter.im/GenericMappingTools/gmt-python
+    :target: https://gitter.im/GenericMappingTools/pygmt
 
 
 .. placeholder-for-doc-index
@@ -39,14 +39,14 @@ ideas and implement new features. **This is NOT a finished product.**
 
 We welcome any feedback and ideas!
 Let us know by submitting
-`issues on Github <https://github.com/GenericMappingTools/gmt-python/issues>`__
+`issues on Github <https://github.com/GenericMappingTools/pygmt/issues>`__
 or send us a message on our
-`Gitter chatroom <https://gitter.im/GenericMappingTools/gmt-python>`__.
+`Gitter chatroom <https://gitter.im/GenericMappingTools/pygmt>`__.
 
 About
 -----
 
-GMT/Python is a library for processing geospatial and geophysical data and making
+PyGMT is a library for processing geospatial and geophysical data and making
 publication quality maps and figures. It provides a Pythonic interface for the
 `Generic Mapping Tools (GMT) <https://github.com/GenericMappingTools/gmt>`__, a
 command-line program widely used in the Earth Sciences.
@@ -72,13 +72,13 @@ Contacting Us
 -------------
 
 * Most discussion happens `on Github
-  <https://github.com/GenericMappingTools/gmt-python>`__. Feel free to `open an issue
-  <https://github.com/GenericMappingTools/gmt-python/issues/new>`__ or comment on any
+  <https://github.com/GenericMappingTools/pygmt>`__. Feel free to `open an issue
+  <https://github.com/GenericMappingTools/pygmt/issues/new>`__ or comment on any
   open issue or pull request.
-* We have a `chat room on Gitter <https://gitter.im/GenericMappingTools/gmt-python>`__
+* We have a `chat room on Gitter <https://gitter.im/GenericMappingTools/pygmt>`__
   where you can ask questions and leave comments.
 * This project is released with a `Contributor Code of Conduct
-  <https://github.com/GenericMappingTools/gmt-python/blob/master/CODE_OF_CONDUCT.md>`__.
+  <https://github.com/GenericMappingTools/pygmt/blob/master/CODE_OF_CONDUCT.md>`__.
   By participating in this project you agree to abide by its terms.
 
 
@@ -89,14 +89,14 @@ Code of conduct
 +++++++++++++++
 
 Please note that this project is released with a `Contributor Code of Conduct
-<https://github.com/GenericMappingTools/gmt-python/blob/master/CODE_OF_CONDUCT.md>`__.
+<https://github.com/GenericMappingTools/pygmt/blob/master/CODE_OF_CONDUCT.md>`__.
 By participating in this project you agree to abide by its terms.
 
 Contributing Guidelines
 +++++++++++++++++++++++
 
 Please read our `Contributing Guide
-<https://github.com/GenericMappingTools/gmt-python/blob/master/CONTRIBUTING.md>`__ to
+<https://github.com/GenericMappingTools/pygmt/blob/master/CONTRIBUTING.md>`__ to
 see how you can help and give feedback.
 
 Imposter syndrome disclaimer
@@ -140,6 +140,7 @@ Other Python wrappers for GMT:
 License
 -------
 
-GMT/Python is free software: you can redistribute it and/or modify it under the terms of
+PyGMT is free software: you can redistribute it and/or modify it under the terms of
 the **BSD 3-clause License**. A copy of this license is provided in
-`LICENSE.txt <https://github.com/GenericMappingTools/gmt-python/blob/master/LICENSE.txt>`__.
+`LICENSE.txt <https://github.com/GenericMappingTools/pygmt/blob/master/LICENSE.txt>`__.
+.