Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Index stuff and find it fast and without bloat

Project description

An awesome hack. Your friendly finding ninja.

Usage

Index and find your stuff.

Index the current directory.

finja --index

Find huhu in the index.

finja huhu

Update outdated files and find huhu in the index.

finja -u huhu

Also works from a subdirectory.

finja --index
cd subdir
finja huhu

Tip: If you are sure that your system survives till everything is indexed use eatmydata.

eatmydata finja -i

Raw mode is meant for machines, but you can replace the \0 with colons.

finja -r huhu | finjacol

Get reduplicated raw human readable output.

finja -r stuff | finjadup | finjacol

Get reduplicated raw output.

finja -r stuff | finjadup

Index git files only.

git ls-tree -r --name-only master > FINJA.lst
finja -i

Filter unwanted output by path.

finja -p spamfolder gold

Cleanup free (unused) tokens and rebuild the database.

finja --vacuum

If there are some badly formatted files that seriously cramp your style.

finja readlines for | cut -c -`tput cols`

Index stuff in read-only directories.

mkdir sysinclude
cd sysinclude
find /usr/include/ -xdev > FINJA.lst
eatmydata finja -i
finja AF_INET6

Caveat: We do not support languages that don’t do spaces nor interpunct. Hey we are not google!

Using in vim/neovim:

#!/bin/sh

finja -r "$@" | finjagrep
  • Set finjaack as ackprg
let g:ackprg = 'finjack'

Installation

pip install -U finja

Why?

Unlike many of the great alternatives to finja, finja is generic. It doesn’t know what it is indexing. Finja achieves good indexing quality by doing multiple passes with different tokenization methods and splitting character lists. Therefore it is slower and has a bigger index than non-generic indexers, but it just indexes your stuff and won’t miss any files it doesn’t know about.

Finja is doing something wrong, can I customize the settings?

We would like to keep settings to a minimum. At the moment there is only international interpunct, that can be switched on. Please open an issue on Github and describe your problem, we will try to find a generic solution. If we don’t find such a solution we might add a setting.

By ganwell@fangorn.ch and David Vogt, Stefan Heinemann, Pablo Vergés

Changes

1.1.1

  • Ignore empty lines in finjacol/finjagrep

1.1.0

  • Add finjagrep which emulates grep output for usage with ack.vim

1.0.11

  • Add workaround for VACUUM bug in python
  • Multiple version due bugs in packaging (rereleases)

1.0.8

  • Conditionally add the argparse dependancy on python 2.6 (@ganwell)

1.0.7

  • Case-insensitive highlighting (@ganwell)

1.0.6

  • Add argparse as requires for CentOS6 (@Pablo Verges)
  • Add search term coloring (@schtibe)
  • Add finja logo to help (@ganwell)

Project details


Download files

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

Files for finja, version 1.1.1
Filename, size File type Python version Upload date Hashes
Filename, size finja-1.1.1-py3-none-any.whl (23.7 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size finja-1.1.1.tar.gz (13.6 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page