appmap-python is a Python package for recording AppMaps of your code. "AppMap" is a data format which records code structure (modules, classes, and methods), code execution events (function calls and returns), and code metadata (repo name, repo URL, commit SHA, labels, etc). It's more granular than a performance profile, but it's less granular than a full debug trace. It's designed to be optimal for understanding the design intent and structure of code and key data flows.
Visit the AppMap for Python reference page on AppLand.com for a complete reference guide.
Clone the repo to begin development. Note that vendored dependencies are included as submodules.
% g clone --recurse-submodules https://github.com/applandinc/appmap-python.git Cloning into 'appmap-python'... remote: Enumerating objects: 167, done. remote: Counting objects: 100% (167/167), done. remote: Compressing objects: 100% (100/100), done. remote: Total 962 (delta 95), reused 116 (delta 61), pack-reused 795 Receiving objects: 100% (962/962), 217.31 KiB | 4.62 MiB/s, done. Resolving deltas: 100% (653/653), done. Submodule 'extern/wrapt' (https://github.com/applandinc/wrapt.git) registered for path 'vendor/wrapt' Cloning into '/private/tmp/appmap-python/vendor/wrapt'... remote: Enumerating objects: 46, done. remote: Counting objects: 100% (46/46), done. remote: Compressing objects: 100% (39/39), done. remote: Total 2537 (delta 9), reused 19 (delta 4), pack-reused 2491 Receiving objects: 100% (2537/2537), 755.94 KiB | 7.48 MiB/s, done. Resolving deltas: 100% (1643/1643), done. Submodule path 'vendor/wrapt': checked out '9bdfbe54b88a64069cba1f3c36e77edc3c1339c9' % ls appmap-python/vendor/wrapt LICENSE Makefile appveyor.yml docs src tests MANIFEST.in README.rst blog setup.py tddium.yml tox.iniAs a package intended to be installed in as many environments as possible, appmap-python needs to avoid using features of Python or the standard library that were added after the oldest version currently supported (see the supported versions).
poetry for dependency management:
% brew install poetry % cd appmap-python % poetry install --extras test pylint for linting:
% cd appmap-python % poetry run pylint appmap -------------------------------------------------------------------- Your code has been rated at 10.00/10 (previous run: 10.00/10, +0.00) [Note that the current configuration requires a 10.0 for the Travis build to pass. To make this easier to achieve, convention and refactoring checks have both been disabled. They should be reenabled as soon as possible.]
pytest for testing:
% cd appmap-python % poetry run pytest Additionally, the tox configuration provides the ability to run the tests for all supported versions of Python and djanggo.
tox requires that all the correct versions of Python to be available to create the test environments. pyenv is an easy way to manage multiple versions of Python, and the xxenv-latest plugin can help get all the latest versions.
% brew install pyenv % git clone https://github.com/momo-lab/xxenv-latest.git "$(pyenv root)"/plugins/xxenv-latest % cd appmap-python % pyenv latest local 3.{9,6,7,8} % forvin 3.{9,6,7,8};do pyenv latest install $v;done % poetry run toxcoverage for coverage:
% cd appmap-python % poetry run coverage run -m pytest % poetry run coverage html % open htmlcov/index.html