offpunk 2.4__tar.gz → 2.6__tar.gz

{offpunk-2.4 → offpunk-2.6}/CHANGELOG

@@ -1,5 +1,37 @@
 # Offpunk History
 
+## 2.6 - February 24th 2025
+FOR PACKAGERS: dependency to python-pil (or pillow) has been dropped
+- NEW BEHAVIOUR: not rendered ressources (like PDF) are not opened automatically.
+The user is prompted to type "open" to see the ressource. This allows the ressource
+to be part of history, be bookmarked, etc…
+Offpunk:
+- new "--command" command-line argument to immediately launch one or multiple commands
+- "add" now accepts link number as a second argument (suggested by JMCS)
+- "url" now accepts link number as an argument (suggested by JMCS)
+- "url" can be piped to any shell command: "url|" or "url 121|" (suggestion of Stephen)
+Ansicat and rendering:
+- new "preformat_wrap" option available to wrap even <pre>
+- PlainText rendering has been vastly improved with wrap, margin and link detection
+- fix wrong wraping in gophermap (patch by JMCS)
+Opnk and opening files:
+note: "opnk" will be renamed "openk" in 3.0
+- "opnk" now supports following link like in "opnk $URL XX" where XX is a link number.
+- "opnk" is now reading the offpunrc file to use predefined handlers
+- "handler" with now automatically add "%s" at the end of the command if not present
+- "handler" now supports file exension or full mimetype
+Deprecation and removal:
+- removed support for chafa < 1.10, as announced in 2.4. python-pil is not used anymore. 
+- removed the "cat" command as it has no purpose (you can use "!cat" instead) and there was a potential crash (reported by Stephen)
+- new "feed" command to replace the "view feed" (which is deprecated)
+
+## 2.5 - January 30th 2025
+- "abbrevs" has been replaced by "alias"
+- "alias" now allows custom command to be aliased
+- PEP8-ification by Vincent Jousse
+- changing "datetime.UTC" to "datetime.timezone.utc" for retrocompatibility with python < 3.11
+- checking if "grep" supports "--color=auto" to supports OpenBSD (reported by Dylan D’Silva)
+
 ## 2.4 - November 21st 2024
 NEW WEBSITE: Official homepage is now https://offpunk.net (or gemini://offpunk.net). Sources are in the /tutorial/ folder and contributions are welcome.
 NEW FEATURE: This release includes work by Bert Livens to add gemini client-side certificates (see "help certs"). This means you can browse gemini capsule while being identified (such as astrobotany)

{offpunk-2.4 → offpunk-2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: offpunk
-Version: 2.4
+Version: 2.6
 Dynamic: Summary
 Project-URL: Homepage, https://offpunk.net/
 Project-URL: Source, https://git.sr.ht/~lioploum/offpunk
@@ -702,8 +702,8 @@ A command-line and offline-first smolnet browser/feed reader for Gemini, Gopher,
 
 The goal of Offpunk is to be able to synchronise your content once (a day, a week, a month) and then browse/organise it while staying disconnected.
 
-Official page : https://offpunk.net
-Development (repository/mailing lists) : https://sr.ht/~lioploum/offpunk/
+Official page : [Offpunk.net](https://offpunk.net)
+Development (repository/mailing lists) : [sr.ht](https://sr.ht/~lioploum/offpunk/)
 
 ![Screenshot HTML page with picture](screenshots/1.png)
 ![Screenshot Gemini page](screenshots/2.png)
@@ -712,115 +712,88 @@ Offpunk is a fork of the original [AV-98](https://tildegit.org/solderpunk/AV-98)
 
 ## How to use
 
-Offpunk is a set of python files. Installation is optional, you can simply git clone the project and run "./offpunk.py" or "python3 offpunk.py" in a terminal.
+Offpunk is a set of python files. Installation is optional, you can simply git clone the project and run "./offpunk.py" or "python3 offpunk.py" in a terminal. You can also a packaged version:
 
-You use the `go` command to visit a URL, e.g. `go gemini.circumlunar.space`. (gemini:// is assumed if no protocol is specified. Supported protocols are gemini, gopher, finger, http, https, mailto, spartan and file. Default protocol is configurable).
+- [List of existing Offpunk packages (Repology)](https://repology.org/project/offpunk/versions)
+- Please contribute packages for other systems, there’s a [mailing-list dedicated to packaging](https://lists.sr.ht/~lioploum/offpunk-packagers).
 
-Links in pages are assigned numerical indices.  Just type an index to follow that link. If page is too long to fit on your screen, the content is displayed in the less pager. Type `q` to quit and go back to Offpunk prompt. Type `view` or `v` to display it again. (`view full` or `v full` allows to see the full html page instead of the article view. `v feed` try to display the linked RSS feed and `v feeds` displays a list of available feeds. This only applies to html pages. `v source` allows you to see the source code of a page and `v normal` to go back to normal view)
+To get started, launch offpunk then type "tutorial".
 
-Use `add` to add a page to your bookmarks and `bookmarks` or `bm` to show your bookmarks (you can create multiple bookmarks lists, edit and remove them. See the `list` manual with `help list`).
+You can also consults it online: [Offpunk tutorial](https://offpunk.net/firststeps.html)
 
-Use `offline` to only browse cached content and `online` to go back online. While offline, the `reload` command will force a re-fetch during the next synchronisation.
-
-Use the `help` command to learn about additional commands. Some abreviations are available. See `abbrevs`.
-
-When launched with the "--sync" option, offpunk will run non-interactively and fetch content from your bookmarks, lists and ressources tentatively accessed while offline. New content found in your subscriptions (see `help subscribe`) will be automatically added to your tour (use `tour ls` to see your current tour, `tour` without argument to access the next item and `tour X` where X is a link number to add the content of a link to your tour).
-
-With "--sync", one could specify a "--cache validity" in seconds. This option will not refresh content if a cache exists and is less than the specified amount of seconds old.
-
-For example, running
-
-`offpunk --sync --cache-validity 43200`
-
-will refresh your bookmarks if those are at least 12h old. If cache-validity is not set or set to 0, any cache is considered good and only content never cached before will be fetched. `--assume-yes` will automatically accept SSL certificates with errors instead of refusing them.
-
-Sync can be applied to only a subset of list.
-
-`offpunk --sync bookmarks tour to_fetch --cache-validity 3600`
-
-Offpunk can also be configured as a browser by other tool. If you want to use offpunk directly with a given URL, simply type:
-
-`offpunk URL`
-
-To have offpunk fetch the URL at next sync and close immediately, run:
-
-`offpunk --fetch-later URL`
+At any point, you can use "help" to get the list of commands and "help command" to get a small help about "command".
 
 ## More
 
-Important news and releases will be announced on the offpunk-devel mailing list 
-=> https://lists.sr.ht/~lioploum/offpunk-devel
+Important news and releases will be announced on the [offpunk-devel mailing list](https://lists.sr.ht/~lioploum/offpunk-devel)
 
-Questions can be asked on the users mailing list:
-=> https://lists.sr.ht/~lioploum/offpunk-users
+Questions can be asked on [the users mailing](list https://lists.sr.ht/~lioploum/offpunk-users)
 
 ## Dependencies
 
 Offpunk has few "strict dependencies", i.e. it should run and work without anything
-else beyond the Python standard library and the "less" pager.  However, it will "opportunistically
-import" a few other libraries if they are available to offer an improved
-experience or some other features such as HTTP/HTML or image support. 
+else beyond the Python standard library and the "less" pager. However, it will "opportunistically import" a few other libraries if they are available to offer an improved
+experience or some other features such as HTTP/HTML or image support.
 
 To avoid using unstable or too recent libraries, the rule of thumb is that a library should be packaged in Debian/Ubuntu. Keep in mind that Offpunk is mainly tested will all libraries installed. If you encounter a crash without one optional dependencies, please report it. Patches and contributions to remove dependencies or support alternatives are highly appreciated.
 
-* [List of existing Offpunk packages (Repology)](https://repology.org/project/offpunk/versions)
-* PIP: [requirements file to install dependencies with pip](requirements.txt)
-* Ubuntu/Debian: [command to install dependencies  on Ubuntu/Debian without pip](ubuntu_dependencies.txt)
-* Please contribute packages for other systems, there’s a [mailing-list dedicated to packaging](https://lists.sr.ht/~lioploum/offpunk-packagers).
+- PIP: [requirements file to install dependencies with pip](requirements.txt)
+- Ubuntu/Debian: [command to install dependencies on Ubuntu/Debian without pip](ubuntu_dependencies.txt)
 
 Run command `version` in offpunk to see if you are missing some dependencies.
 
 Mandatory or highly recommended (packagers should probably make those mandatory):
-* [less](http://www.greenwoodsoftware.com/less/): mandatory but is probably already on your system
-* [file](https://www.darwinsys.com/file/) is used to get the MIME type of cached objects. Should already be on your system.
-* [xdg-utils](https://www.freedesktop.org/wiki/Software/xdg-utils/) provides xdg-open which is highly recommended to open files without a renderer or a handler. It is also used for mailto: command.
-* The [cryptography library](https://pypi.org/project/cryptography/) will provide a better and slightly more secure experience when using the default TOFU certificate validation mode and is recommended (apt-get install python3-cryptography).
+
+- [less](http://www.greenwoodsoftware.com/less/): mandatory but is probably already on your system
+- [file](https://www.darwinsys.com/file/) is used to get the MIME type of cached objects. Should already be on your system.
+- [xdg-utils](https://www.freedesktop.org/wiki/Software/xdg-utils/) provides xdg-open which is highly recommended to open files without a renderer or a handler. It is also used for mailto: command.
+- The [cryptography library](https://pypi.org/project/cryptography/) will provide a better and slightly more secure experience when using the default TOFU certificate validation mode and is recommended (apt-get install python3-cryptography).
 
 Dependencies to enable web browsing (packagers may put those in an offpunk-web meta-package but it is recommended to have it for a better offpunk experience)
-* [Python-requests](http://python-requests.org) is needed to handle http/https requests natively (apt-get install python3-requests). Without it, http links will be opened in an external browser
-* [BeautifulSoup4](https://www.crummy.com/software/BeautifulSoup) and [Readability](https://github.com/buriy/python-readability) are both needed to render HTML. Without them, HTML will not be rendered or be sent to an external parser like Lynx. (apt-get install python3-bs4 python3-readability or pip3 install readability-lxml)
-* [Python-feedparser](https://github.com/kurtmckee/feedparser) will allow parsing of RSS/Atom feeds and thus subscriptions to them. (apt-get install python3-feedparser)
-* [Chafa](https://hpjansson.org/chafa/) allows to display pictures in your console. Install it and browse to an HTML page with picture to see the magic.
+
+- [Python-requests](http://python-requests.org) is needed to handle http/https requests natively (apt-get install python3-requests). Without it, http links will be opened in an external browser
+- [BeautifulSoup4](https://www.crummy.com/software/BeautifulSoup) is needed to render HTML. Without it, HTML will not be rendered or be sent to an external parser like Lynx. (apt-get install python3-bs4)
+- [Readability](https://github.com/buriy/python-readability) is highly suggested to trim useless part of most html pages (apt-get install python3-readability or pip3 install readability-lxml)
+- [Python-feedparser](https://github.com/kurtmckee/feedparser) will allow parsing of RSS/Atom feeds and thus subscriptions to them. (apt-get install python3-feedparser)
+- [Chafa](https://hpjansson.org/chafa/) allows to display pictures in your console. Install it and browse to an HTML page with picture to see the magic.
 
 Gopher dependencies:
-* [Python-chardet](https://github.com/chardet/chardet) is used to detect the character encoding on Gopher (and may be used more in the future)
 
-Older dependencies which are only needed on older systems (where chafa < 1.10)
-* [Timg](https://github.com/hzeller/timg) is a slower alternative to chafa for inline images. Might be deprecated in the future. 
-* [Python-pil](http://python-pillow.github.io/) is required to only display the first frame of animated gif with chafa if chafa version is lower than 1.10. Might be deprecated in the future.
+- [Python-chardet](https://github.com/chardet/chardet) is used to detect the character encoding on Gopher (and may be used more in the future)
 
 Nice to have (packagers should may make those optional):
-* [Xsel](http://www.vergenet.net/~conrad/software/xsel/) allows to `go` to the URL copied in the clipboard without having to paste it (both X and traditional clipboards are supported). Also needed to use the `copy` command. (apt-get install xsel). Xclip can be used too.
-* [Wl-clipboard](https://github.com/bugaevc/wl-clipboard) allows the same feature than xsel but under Wayland 
-* [Python-setproctitle](https://github.com/dvarrazzo/py-setproctitle) will change the process name from "python" to "offpunk". Useful to kill it without killing every python service.
+
+- [Xsel](http://www.vergenet.net/~conrad/software/xsel/) allows to `go` to the URL copied in the clipboard without having to paste it (both X and traditional clipboards are supported). Also needed to use the `copy` command. (apt-get install xsel). Xclip can be used too.
+- [Wl-clipboard](https://github.com/bugaevc/wl-clipboard) allows the same feature than xsel but under Wayland
+- [Python-setproctitle](https://github.com/dvarrazzo/py-setproctitle) will change the process name from "python" to "offpunk". Useful to kill it without killing every python service.
 
 ## Features
 
-* Browse https/gemini/gopher without leaving your keyboard and without distractions
-* Customize your experience with the `theme` command.
-* Built-in documentation: type `help` to get the list of command or a specific help about a command.
-* Offline mode to browse cached content without a connection. Requested elements are automatically fetched during the next synchronization and are added to your tour.
-* HTML pages are prettified to focus on content. Read without being disturbed or see the full page with `view full`.
-* RSS/Atom feeds are automatically discovered by `subscribe` and rendered as gemlogs. They can be explored with `view feed` and `view feeds`.
-* Support "subscriptions" to a page. New content seen in subscribed pages are automatically added to your next tour.
-* Complex bookmarks management through multiple lists, built-in edition, subscribing/freezing lists and archiving content.
-* Advanced navigation tools like `tour` and `mark` (as per VF-1). Unlike AV-98, tour is saved on disk accross sessions. 
-* Ability to specify external handler programs for different MIME types (use `handler`)
-* Enhanced privacy with `redirect` which allows to block a http domain or to redirect all request to a privacy friendly frontent (such as nitter for twitter).
-* Non-interactive cache-building with configurable depth through the --sync command. The cache can easily be used by other software. 
-* `netcache`, a standalone CLI tool to retrieve the cached version of a network ressource.
-* `ansicat`, a standalone CLI tool to render HTML/Gemtext/image in a terminal.
-* `opnk`, a standalone CLI tool to open any kind of ressources (local or network) and display it in your terminal or, if not possible, fallback to `xdg-open`.
+- Browse https/gemini/gopher without leaving your keyboard and without distractions
+- Customize your experience with the `theme` command.
+- Built-in documentation: type `help` to get the list of command or a specific help about a command.
+- Offline mode to browse cached content without a connection. Requested elements are automatically fetched during the next synchronization and are added to your tour.
+- HTML pages are prettified to focus on content. Read without being disturbed or see the full page with `view full`.
+- RSS/Atom feeds are automatically discovered by `subscribe` and rendered as gemlogs. They can be explored with `view feed` and `view feeds`.
+- Support "subscriptions" to a page. New content seen in subscribed pages are automatically added to your next tour.
+- Complex bookmarks management through multiple lists, built-in edition, subscribing/freezing lists and archiving content.
+- Advanced navigation tools like `tour` and `mark` (as per VF-1). Unlike AV-98, tour is saved on disk accross sessions.
+- Ability to specify external handler programs for different MIME types (use `handler`)
+- Enhanced privacy with `redirect` which allows to block a http domain or to redirect all request to a privacy friendly frontent (such as nitter for twitter).
+- Non-interactive cache-building with configurable depth through the --sync command. The cache can easily be used by other software.
+- `netcache`, a standalone CLI tool to retrieve the cached version of a network ressource.
+- `ansicat`, a standalone CLI tool to render HTML/Gemtext/image in a terminal.
+- `opnk`, a standalone CLI tool to open any kind of ressources (local or network) and display it in your terminal or, if not possible, fallback to `xdg-open`.
 
 ## RC files
 
 You can use an RC file to automatically run any sequence of valid Offpunk
-commands upon start up.  This can be used to make settings controlled with the
-`set`, `handler` or `themes` commands persistent.  You can also put a `go` command in
+commands upon start up. This can be used to make settings controlled with the
+`set`, `handler` or `themes` commands persistent. You can also put a `go` command in
 your RC file to visit a "homepage" automatically on startup, or to pre-prepare
 a `tour` of your favourite Gemini sites or `offline` to go offline by default.
 
-The RC file should be called `offpunkrc` and goes in $XDG_CONFIG_DIR/offpunk (or .config/offpunk or .offpunk if xdg not available). In that file, simply write one command per line, just like you would type them in offpunk. 
+The RC file should be called `offpunkrc` and goes in $XDG_CONFIG_DIR/offpunk (or .config/offpunk or .offpunk if xdg not available). In that file, simply write one command per line, just like you would type them in offpunk.
 
 ## Cache design
 
@@ -830,3 +803,10 @@ The cache can be accessed/built with the `netcache` tool. See `netcache -h` for
 
 There’s no feature to automatically trim the cache. But any part of the cache can safely be removed manually as there are no databases or complex synchronisation.
 
+## Tests
+
+Be sure to install the dev requirements (`pytest` and `pytest-mock`) with:
+
+    pip install -r requirements-dev.txt
+
+And then run the test suite using `pytest`.

offpunk-2.6/README.md

@@ -0,0 +1,114 @@
+# OFFPUNK
+
+A command-line and offline-first smolnet browser/feed reader for Gemini, Gopher, Spartan and Web by [Ploum](https://ploum.net).
+
+The goal of Offpunk is to be able to synchronise your content once (a day, a week, a month) and then browse/organise it while staying disconnected.
+
+Official page : [Offpunk.net](https://offpunk.net)
+Development (repository/mailing lists) : [sr.ht](https://sr.ht/~lioploum/offpunk/)
+
+![Screenshot HTML page with picture](screenshots/1.png)
+![Screenshot Gemini page](screenshots/2.png)
+
+Offpunk is a fork of the original [AV-98](https://tildegit.org/solderpunk/AV-98) by Solderpunk and was originally called AV-98-offline as an experimental branch.
+
+## How to use
+
+Offpunk is a set of python files. Installation is optional, you can simply git clone the project and run "./offpunk.py" or "python3 offpunk.py" in a terminal. You can also a packaged version:
+
+- [List of existing Offpunk packages (Repology)](https://repology.org/project/offpunk/versions)
+- Please contribute packages for other systems, there’s a [mailing-list dedicated to packaging](https://lists.sr.ht/~lioploum/offpunk-packagers).
+
+To get started, launch offpunk then type "tutorial".
+
+You can also consults it online: [Offpunk tutorial](https://offpunk.net/firststeps.html)
+
+At any point, you can use "help" to get the list of commands and "help command" to get a small help about "command".
+
+## More
+
+Important news and releases will be announced on the [offpunk-devel mailing list](https://lists.sr.ht/~lioploum/offpunk-devel)
+
+Questions can be asked on [the users mailing](list https://lists.sr.ht/~lioploum/offpunk-users)
+
+## Dependencies
+
+Offpunk has few "strict dependencies", i.e. it should run and work without anything
+else beyond the Python standard library and the "less" pager. However, it will "opportunistically import" a few other libraries if they are available to offer an improved
+experience or some other features such as HTTP/HTML or image support.
+
+To avoid using unstable or too recent libraries, the rule of thumb is that a library should be packaged in Debian/Ubuntu. Keep in mind that Offpunk is mainly tested will all libraries installed. If you encounter a crash without one optional dependencies, please report it. Patches and contributions to remove dependencies or support alternatives are highly appreciated.
+
+- PIP: [requirements file to install dependencies with pip](requirements.txt)
+- Ubuntu/Debian: [command to install dependencies on Ubuntu/Debian without pip](ubuntu_dependencies.txt)
+
+Run command `version` in offpunk to see if you are missing some dependencies.
+
+Mandatory or highly recommended (packagers should probably make those mandatory):
+
+- [less](http://www.greenwoodsoftware.com/less/): mandatory but is probably already on your system
+- [file](https://www.darwinsys.com/file/) is used to get the MIME type of cached objects. Should already be on your system.
+- [xdg-utils](https://www.freedesktop.org/wiki/Software/xdg-utils/) provides xdg-open which is highly recommended to open files without a renderer or a handler. It is also used for mailto: command.
+- The [cryptography library](https://pypi.org/project/cryptography/) will provide a better and slightly more secure experience when using the default TOFU certificate validation mode and is recommended (apt-get install python3-cryptography).
+
+Dependencies to enable web browsing (packagers may put those in an offpunk-web meta-package but it is recommended to have it for a better offpunk experience)
+
+- [Python-requests](http://python-requests.org) is needed to handle http/https requests natively (apt-get install python3-requests). Without it, http links will be opened in an external browser
+- [BeautifulSoup4](https://www.crummy.com/software/BeautifulSoup) is needed to render HTML. Without it, HTML will not be rendered or be sent to an external parser like Lynx. (apt-get install python3-bs4)
+- [Readability](https://github.com/buriy/python-readability) is highly suggested to trim useless part of most html pages (apt-get install python3-readability or pip3 install readability-lxml)
+- [Python-feedparser](https://github.com/kurtmckee/feedparser) will allow parsing of RSS/Atom feeds and thus subscriptions to them. (apt-get install python3-feedparser)
+- [Chafa](https://hpjansson.org/chafa/) allows to display pictures in your console. Install it and browse to an HTML page with picture to see the magic.
+
+Gopher dependencies:
+
+- [Python-chardet](https://github.com/chardet/chardet) is used to detect the character encoding on Gopher (and may be used more in the future)
+
+Nice to have (packagers should may make those optional):
+
+- [Xsel](http://www.vergenet.net/~conrad/software/xsel/) allows to `go` to the URL copied in the clipboard without having to paste it (both X and traditional clipboards are supported). Also needed to use the `copy` command. (apt-get install xsel). Xclip can be used too.
+- [Wl-clipboard](https://github.com/bugaevc/wl-clipboard) allows the same feature than xsel but under Wayland
+- [Python-setproctitle](https://github.com/dvarrazzo/py-setproctitle) will change the process name from "python" to "offpunk". Useful to kill it without killing every python service.
+
+## Features
+
+- Browse https/gemini/gopher without leaving your keyboard and without distractions
+- Customize your experience with the `theme` command.
+- Built-in documentation: type `help` to get the list of command or a specific help about a command.
+- Offline mode to browse cached content without a connection. Requested elements are automatically fetched during the next synchronization and are added to your tour.
+- HTML pages are prettified to focus on content. Read without being disturbed or see the full page with `view full`.
+- RSS/Atom feeds are automatically discovered by `subscribe` and rendered as gemlogs. They can be explored with `view feed` and `view feeds`.
+- Support "subscriptions" to a page. New content seen in subscribed pages are automatically added to your next tour.
+- Complex bookmarks management through multiple lists, built-in edition, subscribing/freezing lists and archiving content.
+- Advanced navigation tools like `tour` and `mark` (as per VF-1). Unlike AV-98, tour is saved on disk accross sessions.
+- Ability to specify external handler programs for different MIME types (use `handler`)
+- Enhanced privacy with `redirect` which allows to block a http domain or to redirect all request to a privacy friendly frontent (such as nitter for twitter).
+- Non-interactive cache-building with configurable depth through the --sync command. The cache can easily be used by other software.
+- `netcache`, a standalone CLI tool to retrieve the cached version of a network ressource.
+- `ansicat`, a standalone CLI tool to render HTML/Gemtext/image in a terminal.
+- `opnk`, a standalone CLI tool to open any kind of ressources (local or network) and display it in your terminal or, if not possible, fallback to `xdg-open`.
+
+## RC files
+
+You can use an RC file to automatically run any sequence of valid Offpunk
+commands upon start up. This can be used to make settings controlled with the
+`set`, `handler` or `themes` commands persistent. You can also put a `go` command in
+your RC file to visit a "homepage" automatically on startup, or to pre-prepare
+a `tour` of your favourite Gemini sites or `offline` to go offline by default.
+
+The RC file should be called `offpunkrc` and goes in $XDG_CONFIG_DIR/offpunk (or .config/offpunk or .offpunk if xdg not available). In that file, simply write one command per line, just like you would type them in offpunk.
+
+## Cache design
+
+The offline content is stored in ~/.cache/offpunk/ as plain .gmi/.html files. The structure of the Gemini-space is tentatively recreated. One key element of the design is to avoid any database. The cache can thus be modified by hand, content can be removed, used or added by software other than offpunk.
+
+The cache can be accessed/built with the `netcache` tool. See `netcache -h` for more informations.
+
+There’s no feature to automatically trim the cache. But any part of the cache can safely be removed manually as there are no databases or complex synchronisation.
+
+## Tests
+
+Be sure to install the dev requirements (`pytest` and `pytest-mock`) with:
+
+    pip install -r requirements-dev.txt
+
+And then run the test suite using `pytest`.

offpunk-2.6/TODO

@@ -0,0 +1,34 @@
+TODO
+
+## Refactoring of redirections is needed
+
+bug #34: redirections are not kept while offline
+https://todo.sr.ht/~lioploum/offpunk/34
+bug #41:  Redirects should be handled in netcache, not offpunk 
+https://todo.sr.ht/~lioploum/offpunk/41
+
+## Refactoring of errors is needed
+
+bug #30:  Netcache: gemini status 4 and 5 should not emit a full traceback 
+https://todo.sr.ht/~lioploum/offpunk/30
+bug #3: Error pages are stored in the cache  
+https://todo.sr.ht/~lioploum/offpunk/3
+
+
+## Cache Triming
+
+We need work on a model that keep the cache within certain limit by removing older, inaccessed elements which are not linked to anything in lists.
+
+## HTML rendering
+
+Better rendering of tables using ASCII tables
+
+
+## Misc:
+
+bug #42: IDN handling 
+https://todo.sr.ht/~lioploum/offpunk/42
+
+
+
+