nix-community/noogle
1
1
Fork 0
mirror of https://github.com/nix-community/noogle.git synced 2024-11-25 23:02:21 +03:00
Code Issues Packages Projects Releases Wiki Activity
https://noogle.dev - nix function exploring.
523 Commits 26 Branches 1 Tag 4.6 MiB
Nix 53%
TypeScript 29.2%
Rust 15.5%
MDX 1.5%
CSS 0.5%
Other 0.3%
e873b68ed8
Go to file
h7x4 e873b68ed8
builtins.types: fix a bunch of types (#369) 
* builtins.types: lowercase `any`

* builtins.types: use `String` for attr keys in `attrNames`

* builtins.types: fix typo in `catAttrs`

* builtins.types: more accurate type for `concatLists`

* builtins.types: fix `concatMap`

* builtins.types: use more accurate type for `filter`

* builtins.types: use `String` for attr keys in `mapAttrs`

* builtins.types: use more accurate type for `partition`

* builtins.types: use `String` for attr keys in `removeAttrs`

* builtins.types: lowercase `storePath`

* builtins.types: remove trailing space in `toFile`

* builtins.types: use normal attrset annotation for `fromTOML`

* builtins.types: mirror types for `abort` and `throw`

* builtins.types: use more accurate type for `parseDrvName`
2024-10-13 11:00:03 +02:00
.github add automerge label to automatic updates 2024-01-31 22:47:42 +07:00
codemod Fix: avoid /doc removed from nixpkgs source 2024-08-01 10:52:15 +02:00
pasta website: add update date for docs 2024-03-25 13:16:18 +01:00
pesto Improve reference handling and fallbacks (#348) 2024-09-20 10:53:29 +02:00
salt builtins.types: fix a bunch of types (#369) 2024-10-13 11:00:03 +02:00
tests update: main 2023-09-21 08:40:02 +02:00
website Website: fixup keep autolinked local references 2024-09-20 22:21:36 +02:00
.envrc INIT: first prototype of frontend 2022-11-26 10:36:08 +01:00
.gitattributes add vendor about test_assets 2024-01-07 17:20:35 +01:00
.gitignore use flake modules 2023-11-23 12:31:33 +01:00
.mergify.yml Update .mergify.yml 2024-01-31 22:57:13 +07:00
devShell.nix add alias tracking and bulk tests 2023-11-28 17:28:51 +01:00
flake.lock flake.lock: Update 2024-10-13 00:48:49 +00:00
flake.nix remove deprecated submodules 2024-04-29 21:18:47 +00:00
LICENSE Create LICENSE 2023-01-25 16:23:32 +01:00
preCommit.nix hook legacy data in ui build 2023-11-29 21:37:07 +01:00
projects.toml Feature/monorepo (#24) 2023-02-25 13:14:40 +01:00
README.md Patch 1 (#346) 2024-09-19 11:31:45 +02:00
treefmt.toml hook legacy data in ui build 2023-11-29 21:37:07 +01:00

README.md

Noogle

Website GitHub top language GitHub Workflow Status

Noogle is a simple Nix API search engine. It lets you search Nix functions.

Current Features

  • Beginners-friendly search for Nix and Nix-related functions.
    • Render documentation comments optimized for readability.
    • Search optimized for English language and Nix function-names.
  • Filter by type signatures.
    • Function types are parsed and interpreted.
  • Noogle also knows stuff that is not (yet) officially documented.
    • Types of builtins (including builtins.derivation).
    • Can be extended via markdown contributions to Noogle.
    • Always shows the latest docs based on the main branch of Nixpkgs.
  • Outputs pre-rendered static HTML that is indexable by other search engines.
  • Wasm based performant search.

Available data

There are the following subsets of Nix and Nixpkgs functions available.

Recursively indexed:

  • lib
  • pkgs.rustPackages

Recursively means all deeply nested sub-attributes.

Normally indexed:

  • builtins
  • pkgs.stdenv
  • pkgs.dockerTools
  • pkgs.writers
  • pkgs.pythonPackages
  • pkgs.haskell.lib
  • pkgs.haskell.lib

Off the tree functions

Some function are not part of the evaluation value of default.nix in Nixpkgs. They must be imported individually.

  • make-disk-image

All Indexing is done via the pasta module. PRs welcome!

Contribute

Contributions are very welcome just file a PR or issue. Indexed data can be added very easily in ./pasta/src/eval.nix.

Note: Indexed data must evaluate!

Build this page

nix build .#ui

This page generates static HTML pages. One page per API function.

It automatically includes meta tags for other search engines like Google or Bing.

Searching within the page is done via pagefind which is only available in the production build.

Develop

nix develop

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