https://noogle.dev - like hoogle but for nix
Go to file
2023-01-21 10:15:48 +01:00
.github/workflows add nix-unstable 2022-12-03 15:36:54 +01:00
components fix: also open github org in new tab (#14) 2023-01-21 10:15:48 +01:00
models fix minor typos in trivial-builders id and category (#13) 2023-01-21 10:06:58 +01:00
pages Feature/function of the day (#9) 2023-01-20 13:08:20 +01:00
public ux: improve lists and mobile 2022-12-03 17:38:50 +01:00
queries some small fixes & refactoring 2023-01-08 16:54:23 +01:00
scripts some small fixes & refactoring 2023-01-08 16:54:23 +01:00
styles improve: mobile & dark theme 2022-12-12 14:24:16 +01:00
types chore: imroved mobile readability 2023-01-08 17:56:00 +01:00
.envrc INIT: first prototype of frontend 2022-11-26 10:36:08 +01:00
.eslintrc.json INIT: first prototype of frontend 2022-11-26 10:36:08 +01:00
.gitignore INIT: first prototype of frontend 2022-11-26 10:36:08 +01:00
createEmotionCache.ts INIT: first prototype of frontend 2022-11-26 10:36:08 +01:00
flake.lock update: flake inputs 2023-01-08 17:26:00 +01:00
flake.nix add: social actions 2022-12-18 17:31:42 +01:00
next.config.js add real nixpkgs metadata from enhanced nixdoc 2022-12-03 15:25:32 +01:00
nix_systems INIT: first prototype of frontend 2022-11-26 10:36:08 +01:00
package-lock.json Feature/function of the day (#9) 2023-01-20 13:08:20 +01:00
package.json Feature/function of the day (#9) 2023-01-20 13:08:20 +01:00
README.md Update README.md 2023-01-16 10:41:07 +01:00
tsconfig.json INIT: first prototype of frontend 2022-11-26 10:36:08 +01:00

Website GitHub top language GitHub Workflow Status

Noogle

Noogle is a Nix API search engine. It allows you to search functions based on their types and other attributes in nix projects. In nixpkgs especially the builtins and lib attributes.

  • Beginners-friendly search for nix and nix-related functions
  • Expert search with directly typing type signatures
  • Search functions based on:
    • type
    • signature
    • name
  • tree-search from one type to another

How it works

Indexers:

Data collections need to be up-to-date Those collections are then combined and dumped somewhere (db / json)

For the indexing i currently use:

  • Nixdoc (a fork) to collect nixpkgs.lib informations
  • nix __dump-builtins + builtins-types.json for the nix builtins

As some parts of nix already have nixos modules their input/output can be discovered. I still lack some tool to integrate that into noogle.

  • haskell-like types are parsed and splitted between input and ouput
  • text search, looks in all metadata fields for an exact matching word or character sequence. I dont have elastic search yet.

View the prototype here

We need your help / what is missing

  • Parsing Types: into a real type signature tree
  • Upstream missing type informations (like in /lib/attrsets.nix)
  • Write type signatures for the builtins in json
  • Add path, where each function can be imported from. e.g. lib.makeOverridable or lib.customisation.makeOverridable (it is available in both sets)
  • Website
    • improve share / social interactions
    • Add filter by tags e.g. lib.lists
    • Prepare for scaling up: Either use api or use indexedDB with WebAssembly for complete offline usage?
    • Mobile optimization for reading on the go
  • Clean up / enhance my nixdoc fork.
    • Make the sloppy parser more error resistant
    • Some valueable information can be used from the rnix AST ?

Contribute

Contributions are very welcome just file a PR or issue

Build this page

nix build .#

Develop

nix develop

This command creates the node_modules folder with all needed dependencies based on dream2nix.