Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/toolforge/python-toolforge

Mirror of https://gitlab.wikimedia.org/toolforge-repos/python-toolforge
https://github.com/toolforge/python-toolforge

Last synced: 2 months ago
JSON representation

Mirror of https://gitlab.wikimedia.org/toolforge-repos/python-toolforge

Awesome Lists containing this project

README

        

Toolforge python helper library
===============================

``toolforge`` is a Python library that contains helper functions for some
common tasks that Toolforge_ users might encounter.

Installation
------------

Use ``pip`` to install the latest stable version of ``toolforge``:

.. code-block:: bash

python3 -m pip install --upgrade toolforge

The current development version is available on gitlab.wikimedia.org_, and can
be installed directly from the git repository:

.. code-block:: bash

python3 -m pip install --upgrade git+https://gitlab.wikimedia.org/toolforge-repos/python-toolforge.git

Usage
-----

See the `API reference and user guide`_ for usage instructions.

Contributing
------------

See CONTRIBUTING.rst_ for guidelines on contributing to ``toolforge``.

Bug reports
-----------

Please report bugs and feature requests at https://phabricator.wikimedia.org/tag/tool-python-toolforge/.

License
-------

Licensed under the `GPL-3.0-or-later`_ license. See COPYING_ for the full
license.

.. _Toolforge: https://wikitech.wikimedia.org/wiki/Portal:Toolforge
.. _gitlab.wikimedia.org: https://gitlab.wikimedia.org/toolforge-repos/python-toolforge
.. _API reference and user guide: https://python-toolforge.readthedocs.io/
.. _CONTRIBUTING.rst: https://gitlab.wikimedia.org/toolforge-repos/python-toolforge/-/blob/main/CONTRIBUTING.rst
.. _GPL-3.0-or-later: https://www.gnu.org/licenses/gpl-3.0.html
.. _COPYING: https://gitlab.wikimedia.org/toolforge-repos/python-toolforge/-/blob/main/COPYING