Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Toolkit for easy searching and manipulation of python source code using redbaron.

Project Description

Toolkit for easy searching and manipulation of python source code using redbaron.


pip install baroness




You can search through python code using the redbaron API on the commandline. By default baroness will search through all python files from the current directory down recursively. The search pattern is just regular python code that would work with redbaron. The top level node is called root.

For example to search for all name nodes with a value of bar:

baroness search 'root("name", value="bar")'

search is the default subcommand so you can write the same with:

baroness 'root("name", value="bar")'

For full usage look at baroness search --help:

usage: baroness search [-h] [--no-cache] [--parents PARENTS] [--no-color]
                       pattern [files [files ...]]

positional arguments:
  pattern            Python redbaron code to search where `root` is the
                     variable holding the tree
  files              File names and/or glob pattern. Default to recursive
                     search of python all files.

optional arguments:
  -h, --help         show this help message and exit
  --no-cache         Do no use the cache in `.baroness` even if it exists
  --parents PARENTS  Number of parents to go up on matched nodes.
  --no-color         Do not color the output.
  --no-linenos       Do not output the linenumbers.


Parsing python files to a baron fst can be time consuming for large code bases. Baroness can cache the baron fst as json files to save time when searching. By default caching isn’t enabled, but will be used if baroness finds a .baroness directory.

Saving/Initialising Cache

To enable caching (and initially create cache) you can use:

baroness cache save

For full usage look at baroness cache save --help:

usage: baroness cache save [-h] [--force] [FILE [FILE ...]]

Save given files (all tree) to disk

positional arguments:
  FILE        Files to save to cache.

optional arguments:
  -h, --help  show this help message and exit
  --force     Save over already existing cache files.

Clearing the Cache

To delete all .baroness directories recursively use:

baroness cache delete

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(8.4 kB) Copy SHA256 Hash SHA256
Wheel py2.py3 Dec 18, 2017
(5.5 kB) Copy SHA256 Hash SHA256
Source None Dec 18, 2017

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting