Skip to main content

Some utility functions on top of pandas.

Project description

Pandas Extras

Code check, Test and Coverage, Build and deploy codecov Documentation Status

Some functions on top of pandas.

Install Environment

For local development:

  • Run python -m pip install -U pip and pip install -U pip poetry
  • Run poetry install. If you are facing issues installing mysqlclient or psycopg2 on Ubuntu, it's because you are missing some libraries. Please check their pages. Usually for psycopg2, it's libpq-dev and for mysqlclient, it's python3-dev default-libmysqlclient-dev build-essential. Check the pages for more specific and accurate commands.

Testing

Run docker compose up then tox. Obviously you need docker and tox installed.

Generate Documentation Source Files

You should not have to do this but in case you want to generate the source ReStructuredText files yourself, here is how. Skip to the next section to simply generate html documentation locally.

Change to docs directory cd docs/. Run sphinx-quickstart. Choose y when it asks to seperate build and source directories.

Change to docs/source directory. In conf.py, add the following lines at the start of the script.

import os
import sys

sys.path.insert(0, os.path.abspath("../.."))

and save it. Add "sphinx.ext.autodoc", to the extensions list. Run python -m pip install -U sphinx_rtd_theme and set html_theme = "sphinx_rtd_theme" (or whatever theme you want).

In index.rst, add modules to toctree. The structure should look like this:

.. toctree::
:maxdepth: 2
:caption: Contents:

modules

Run the following to generate the source files.

poetry install --with docs
poetry run sphinx-apidoc -f -o source/ ../ ../tests/

Generating HTML Documentation

Change to docs/ using cd .. then run .\make clean and .\make html. Output should be built with no errors or warnings. You will get the html documenation in docs/build/html directory. Open index.html.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pd_extras-5.0.4.tar.gz (10.6 kB view hashes)

Uploaded Source

Built Distribution

pd_extras-5.0.4-py3-none-any.whl (12.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page