netcache — local Internet cache handler for offpunk

       Lionel Dricot (Ploum) <offpunk2atploum.eu>

Debian                                          November 25, 2024                                    NETCACHE(1)

       Netcache  is  a  command-line tool to retrieve, cache and access networked content.  By default, netcache
       will returns a cached version of a given URL, downloading it only if a cache version  doesn't  exist.   A
       validity  duration,  in seconds, can also be given so netcache downloads the content only if the existing
       cache is older than the validity.

       Netcache can be forced into offline mode, in  order  to  only  fetch  resources  from  the  local  cache,
       otherwise  it would always refresh it from the version available online.  It is also useful for mapping a
       given URL to its location in the cache, independently of whether it has been downloaded first.

   PositionalargumentsURL     download the URL and output the content.

   Keywordarguments-h, --help
                     show a help message and exit.

             --path  output the path to the cache instead of the content of the URL.

             --ids   return a list of id's for the gemini-site instead of the content of the cache.

             --offline
                     do not attempt to download, return the cached version instead, or error if absent from  the
                     cache.

             --max-sizeMAX_SIZE
                     cancel download of items above that size.  The value is expressed in megabytes.

             --timeoutTIMEOUT
                     time to wait before cancelling connection.  The value is expressed in seconds.

             --cache-validity-CACHE_VALIDITY
                     Maximum age (in second) of the cached version before redownloading a new version.

       Set OFFPUNK_CACHE_PATH environment variable to use another location.

       OFFPUNK_CACHE_PATH=/home/ploum/custom-cache netcache.py gemini://some.url

       The netcache utility exits 0 on success, and >0 if an error occurs.

       Default cache path is ~/.cache/offpunk.

       netcache — local Internet cache handler for offpunk

ansicat(1), migrate-offpunk-cache(1), offpunk(1), opnk(1), https://offpunk.net/

netcache [--path] [--ids] [--offline] [--max-sizeMAX_SIZE] [--timeoutTIMEOUT] [URL...]
       netcache-h | --help