Skip to content

Read and write intersphinx `objects.inv` from node or the command line.

License

Notifications You must be signed in to change notification settings

continuous-foundation/intersphinx

Repository files navigation

intersphinx

intersphinx on npm MIT License CI

Read and write intersphinx objects.inv from node or the command line.

To use from the command line, use the -g to create a global install.

npm install -g intersphinx

From the command line

Commands available:

parse: download or unpack a local file into a json or yaml file.

intersphinx parse https://docs.python.org/3.7 output.yml

list: list the contents of an objects.inv

intersphinx list https://docs.python.org/3.7 --summary
intersphinx list https://docs.python.org/3.7 --domain std
intersphinx list https://docs.python.org/3.7 --domain std:doc --includes abc
intersphinx list https://docs.python.org/3.7 --domain std:doc --includes abc --limit 5

Reading an invintory in Node

import { Inventory } from 'intersphinx';

const inv = new Inventory({ id: 'python', path: 'https://docs.python.org/3.7' });
await inv.load();

const entry = inv.getEntry({ name: 'zipapp-specifying-the-interpreter' });
// {
//   location: https://docs.python.org/3.7/library/zipapp.html#specifying-the-interpreter,
//   display: 'Specifying the Interpreter'
// }

Write an invintory

import { Inventory, Domains } from 'intersphinx';

const inv = new Inventory({ project: 'Python', version: '3.7' });
inv.setEntry({
  type: Domains.stdLabel,
  name: 'zipapp-specifying-the-interpreter',
  location: 'library/zipapp.html#specifying-the-interpreter',
  display: 'Specifying the Interpreter',
});

inv.write('objects.inv');

As of v1.0.0 this package is ESM only.


Made with love by Continuous Science Foundation

About

Read and write intersphinx `objects.inv` from node or the command line.

Resources

License

Stars

Watchers

Forks

Packages

No packages published