A semantic search engine for source code
Python Java CSS JavaScript Ruby
Switch branches/tags
Nothing to show
Clone or download
Latest commit ee3f661 Oct 14, 2014
Permalink
Failed to load latest commit information.
bitshift Fix initing lexer. Jul 6, 2014
docs Update some documentation. May 5, 2014
parsers
static Fix sitemap URL. Oct 14, 2014
templates Embed our NYTM demo video in the about page. Sep 15, 2014
test
.gitignore parsing.jar, exclude. Jun 19, 2014
LICENSE Fix names in license. Apr 8, 2014
README.md
app.py API documentation, fixes, support not highlighting (closes #56). Jun 21, 2014
gunicorn.cfg
setup.py Rewrite much of the indexer to use GitPython. Jun 9, 2014

README.md

bitshift

bitshift is a semantic search engine for source code developed by Benjamin Attal, Ben Kurtovic, and Severyn Kozak. This README is intended for developers only. For a user overview of the project:

Branches

  • master: working, tested, version-numbered code - no direct commits; should only accept merges from develop when ready to release
  • develop: integration branch with unreleased but mostly functional code - direct commits allowed but should be minor
  • feature/*: individual components of the project with untested, likely horribly broken code - branch off from and merge into develop when done

Style

bitshift uses SASS for styling; compile the stylesheets to CSS with sass --watch static/sass/:static/css.

Documentation

To build documentation, run make html from the docs subdirectory. You can then browse from docs/build/html/index.html.

To automatically update the API documentation structure (necessary when adding new modules or packages, but not when adding functions or changing docstrings), run sphinx-apidoc -fo docs/source/api bitshift from the project root. Note that this will revert any custom changes made to the files in docs/source/api, so you might want to update them by hand instead.

Releasing

  • Update __version__ in bitshift/__init__.py, version in setup.py, and version and release in docs/conf.py.