Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tag: 0.6.1
Fetching contributors…

Octocat-spinner-32-eaf2f5

Cannot retrieve contributors at this time

file 138 lines (97 sloc) 6.356 kb
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137
This is a mirror of http://www.vim.org/scripts/script.php?script_id=4256


Basic usage
------------------------------------------------------------------------------------------

Ozzy is very straightforward to use. Once installed, you can start editing
files as always. Once you open a file Ozzy keeps track of it and from then
you can open that file with the following command:

  :Ozzy <file name>

How Ozzy knows the right file to open when there are two or more files with
the same name? Ozzy by default opens the file who has been opened more
frequently. You can customize this behavior setting the 'g:ozzy_mode' variable
to the following values:

  * 'most frequent': open the most frequently opened file.
  * 'most recent': open the most recently opened file.
  * 'context': open the closest file respect to the current working directory.

You are not limited to just file names. The 'Ozzy' command accepts even partial
paths such as 'directory/filename' and directory names such as 'directory/'.
In the latter case note the presence of a forward slash as the last character:
this cause Ozzy to open all the files contained in the directory (note that only
files tracked by Ozzy will be opened).

Command line tab completion is supported but only for file names.

Below are listed some basic available commands:


Ozzy (shortcut: O)
------------------------------------------------------------------------------------------

  Depending to the type of the value passed as argument this command
  performs different actions:

  * if a file name is given then a file in the index that match the give name is
    opened (the right file is selected depending on the current mode: most
    frequent, most recent or context). See also the option `g:ozzy_ignore_ext`.

  * if a partial path ending with a filename is given the the behavior descibed
    above is retained but there might be less potenyial conflicts.

  * if a partial path ending with a forward slash is given the all files
    contained in that directory will be opened (only those files tracked by
    Ozzy). If Ozzy has in its index two or more directories with the same name,
    the right one is selected according to the current mode:

    - 'most frequent': the directory that contains more frequently opened files is opened.
    - 'most recent': the directory that contains more recently accessed files is opened.
    - 'context': the closest directory is opened.
   
  Note however that Ozzy does not really scan the physical directory on the
  file system, but instead it will search exclusively in its database for possible
  matches. You have to open files at least once manually or with the
  OzzyAddDirectory command before Ozzy can open them.


OzzyInspect (shortcut: Oi)
------------------------------------------------------------------------------------------

  Opens the Inspector buffer. This place is where you can inspect the whole file
  index and perform some actions on single entries like increasing the access
  frequency, setting the last access time, doing various sorts, ecc.. For more
  information about available actions type `?` inside the Inspector buffer.


OzzyScope (shortcut: Oscope)
------------------------------------------------------------------------------------------

  Sets the Ozzy scope to the given path. By default the scope is global but once
  you set it to a certain `path` Ozzy will be no more able to open files that
  reside outside that `path`. Further, they will be no more indexed and
  included command line completion. Already indexed files won't be removed:
  you can still interact with them throughout the Inspector. If you want to add
  all files contained into the current working directory you can use the `.`
  shortcut instead. To add the current parent directory use the `..` argument.
  Use the `...` argument to add the project root directory (see the
  `g:ozzy_what_in_project_root` option). By default *Ozzy* assumes the project
  root directory as the one containing a `.git`, `.hg` or a `.svn` folder along
  the current working directory path.
  To restore the global scope use the command with no arguments.

  You can customize the default behavior with the following options:

  * -p <comma separated list>: override the global `g:ozzy_what_in_project_root`
    options (works only with the special argument `...`)


OzzyAddDirectory (shortcut: Oadd)
------------------------------------------------------------------------------------------

  To add all files contained into the given `path` (by default except those
  contained into hidden directories). If you want to add all files contained into
  the current working directory you can use the `.` shortcut instead. To add the
  current parent directory use the `..` argument. Use the `...` argument to add
  the project root directory (see the `g:ozzy_what_in_project_root` option). By
  default Ozzy assumes the project root directory as the one containing
  a `.git`, `.hg` or a `.svn` folder along the current working directory path.

  You can customize the default behavior with the following options:

  * -h: add files contained into hidden directories.
  * -a <comma separated list>: add only specific files. See below for allowed patterns.
  * -i <comma separated list>: ignore specific files. See below for allowed patterns.
  * -p <comma separated list>: override the global `g:ozzy_what_in_project_root`
    option (works only with the special argument `...`).

  Allowed patterns:

  * `*.<ext>`
    all file names with extension `<ext>`.
    examples: `*.py`, `*.cpp`

  * `<file name>.*`
    all files named `<file name>` regardless the extension (file names that
    exactly match `<file name>` will be considered too).
    examples: `doc.*`, `log.*`, `README.*`

  * `<file name>`
    all file names that exactly match `<file name>`.
    examples: `test.py`, `junk.txt`, `LICENSE`

  * `<partial path>/`
    all paths that contain `<path>`.
    examples: `doc/` (every file in a folder called 'doc')

------------------------------------------------------------------------------------------

For information about other available commands and settings see
the full documentation. (:help ozzy)

Get latest versions at: https://github.com/gcmt/ozzy.vim


Something went wrong with that request. Please try again.