Full Code of KillingSpark/zstd-rs for AI

Repository: KillingSpark/zstd-rs
Branch: master
Commit: da53f315692c
Files: 735
Total size: 5.1 MB

Directory structure:
gitextract_f9ilxv7s/

├── .github/
│   └── workflows/
│       └── ci.yml
├── .gitignore
├── Cargo.toml
├── Changelog.md
├── LICENSE
├── Readme.md
├── cli/
│   ├── Cargo.toml
│   └── src/
│       ├── main.rs
│       └── progress.rs
├── optimizations.md
└── ruzstd/
    ├── Cargo.toml
    ├── benches/
    │   └── decode_all.rs
    ├── decodecorpus_files/
    │   ├── abc.txt
    │   ├── abc.txt.zst
    │   ├── z000000
    │   ├── z000000.zst
    │   ├── z000001
    │   ├── z000001.zst
    │   ├── z000002
    │   ├── z000002.zst
    │   ├── z000003
    │   ├── z000003.zst
    │   ├── z000004
    │   ├── z000004.zst
    │   ├── z000005
    │   ├── z000005.zst
    │   ├── z000006
    │   ├── z000006.zst
    │   ├── z000007
    │   ├── z000007.zst
    │   ├── z000008
    │   ├── z000008.zst
    │   ├── z000009
    │   ├── z000009.zst
    │   ├── z000010
    │   ├── z000010.zst
    │   ├── z000011
    │   ├── z000011.zst
    │   ├── z000012
    │   ├── z000012.zst
    │   ├── z000013
    │   ├── z000013.zst
    │   ├── z000014
    │   ├── z000014.zst
    │   ├── z000015
    │   ├── z000015.zst
    │   ├── z000016
    │   ├── z000016.zst
    │   ├── z000017
    │   ├── z000017.zst
    │   ├── z000018
    │   ├── z000018.zst
    │   ├── z000019
    │   ├── z000019.zst
    │   ├── z000020
    │   ├── z000020.zst
    │   ├── z000021
    │   ├── z000021.zst
    │   ├── z000022
    │   ├── z000022.zst
    │   ├── z000023
    │   ├── z000023.zst
    │   ├── z000024
    │   ├── z000024.zst
    │   ├── z000025
    │   ├── z000025.zst
    │   ├── z000026
    │   ├── z000026.zst
    │   ├── z000027
    │   ├── z000027.zst
    │   ├── z000028
    │   ├── z000028.zst
    │   ├── z000029
    │   ├── z000029.zst
    │   ├── z000030
    │   ├── z000030.zst
    │   ├── z000031
    │   ├── z000031.zst
    │   ├── z000032
    │   ├── z000032.zst
    │   ├── z000033
    │   ├── z000033.zst
    │   ├── z000034
    │   ├── z000034.zst
    │   ├── z000035
    │   ├── z000035.zst
    │   ├── z000036
    │   ├── z000036.zst
    │   ├── z000037
    │   ├── z000037.zst
    │   ├── z000038
    │   ├── z000038.zst
    │   ├── z000039
    │   ├── z000039.zst
    │   ├── z000040
    │   ├── z000040.zst
    │   ├── z000041
    │   ├── z000041.zst
    │   ├── z000042
    │   ├── z000042.zst
    │   ├── z000043
    │   ├── z000043.zst
    │   ├── z000044
    │   ├── z000044.zst
    │   ├── z000045
    │   ├── z000045.zst
    │   ├── z000046
    │   ├── z000046.zst
    │   ├── z000047
    │   ├── z000047.zst
    │   ├── z000048
    │   ├── z000048.zst
    │   ├── z000049
    │   ├── z000049.zst
    │   ├── z000050
    │   ├── z000050.zst
    │   ├── z000051
    │   ├── z000051.zst
    │   ├── z000052
    │   ├── z000052.zst
    │   ├── z000053
    │   ├── z000053.zst
    │   ├── z000054
    │   ├── z000054.zst
    │   ├── z000055
    │   ├── z000055.zst
    │   ├── z000056
    │   ├── z000056.zst
    │   ├── z000057
    │   ├── z000057.zst
    │   ├── z000058
    │   ├── z000058.zst
    │   ├── z000059
    │   ├── z000059.zst
    │   ├── z000060
    │   ├── z000060.zst
    │   ├── z000061
    │   ├── z000061.zst
    │   ├── z000062
    │   ├── z000062.zst
    │   ├── z000063
    │   ├── z000063.zst
    │   ├── z000064
    │   ├── z000064.zst
    │   ├── z000065
    │   ├── z000065.zst
    │   ├── z000066
    │   ├── z000066.zst
    │   ├── z000067
    │   ├── z000067.zst
    │   ├── z000068
    │   ├── z000068.zst
    │   ├── z000069
    │   ├── z000069.zst
    │   ├── z000070
    │   ├── z000070.zst
    │   ├── z000071
    │   ├── z000071.zst
    │   ├── z000072
    │   ├── z000072.zst
    │   ├── z000073
    │   ├── z000073.zst
    │   ├── z000074
    │   ├── z000074.zst
    │   ├── z000075
    │   ├── z000075.zst
    │   ├── z000076
    │   ├── z000076.zst
    │   ├── z000077
    │   ├── z000077.zst
    │   ├── z000078
    │   ├── z000078.zst
    │   ├── z000079
    │   ├── z000079.zst
    │   ├── z000080
    │   ├── z000080.zst
    │   ├── z000081
    │   ├── z000081.zst
    │   ├── z000082
    │   ├── z000082.zst
    │   ├── z000083
    │   ├── z000083.zst
    │   ├── z000084
    │   ├── z000084.zst
    │   ├── z000085
    │   ├── z000085.zst
    │   ├── z000086
    │   ├── z000086.zst
    │   ├── z000087
    │   ├── z000087.zst
    │   ├── z000088
    │   ├── z000088.zst
    │   ├── z000089
    │   ├── z000089.zst
    │   ├── z000090
    │   ├── z000090.zst
    │   ├── z000091
    │   ├── z000091.zst
    │   ├── z000092
    │   ├── z000092.zst
    │   ├── z000093
    │   ├── z000093.zst
    │   ├── z000094
    │   ├── z000094.zst
    │   ├── z000095
    │   ├── z000095.zst
    │   ├── z000096
    │   ├── z000096.zst
    │   ├── z000097
    │   ├── z000097.zst
    │   ├── z000098
    │   ├── z000098.zst
    │   ├── z000099
    │   └── z000099.zst
    ├── dict_tests/
    │   ├── dictionary
    │   └── files/
    │       ├── ModemManager.service
    │       ├── ModemManager.service.zst
    │       ├── NetworkManager-dispatcher.service
    │       ├── NetworkManager-dispatcher.service.zst
    │       ├── NetworkManager-wait-online.service
    │       ├── NetworkManager-wait-online.service.zst
    │       ├── NetworkManager.service
    │       ├── NetworkManager.service.zst
    │       ├── auditd.service
    │       ├── auditd.service.zst
    │       ├── autovt@.service
    │       ├── autovt@.service.zst
    │       ├── avahi-daemon.service
    │       ├── avahi-daemon.service.zst
    │       ├── avahi-dnsconfd.service
    │       ├── avahi-dnsconfd.service.zst
    │       ├── blk-availability.service
    │       ├── blk-availability.service.zst
    │       ├── btrfs-scrub@.service
    │       ├── btrfs-scrub@.service.zst
    │       ├── canberra-system-bootup.service
    │       ├── canberra-system-bootup.service.zst
    │       ├── canberra-system-shutdown-reboot.service
    │       ├── canberra-system-shutdown-reboot.service.zst
    │       ├── canberra-system-shutdown.service
    │       ├── canberra-system-shutdown.service.zst
    │       ├── clean-mount-point@.service
    │       ├── clean-mount-point@.service.zst
    │       ├── colord.service
    │       ├── colord.service.zst
    │       ├── console-getty.service
    │       ├── console-getty.service.zst
    │       ├── container-getty@.service
    │       ├── container-getty@.service.zst
    │       ├── cpupower.service
    │       ├── cpupower.service.zst
    │       ├── dbus-org.freedesktop.hostname1.service
    │       ├── dbus-org.freedesktop.hostname1.service.zst
    │       ├── dbus-org.freedesktop.import1.service
    │       ├── dbus-org.freedesktop.import1.service.zst
    │       ├── dbus-org.freedesktop.locale1.service
    │       ├── dbus-org.freedesktop.locale1.service.zst
    │       ├── dbus-org.freedesktop.login1.service
    │       ├── dbus-org.freedesktop.login1.service.zst
    │       ├── dbus-org.freedesktop.machine1.service
    │       ├── dbus-org.freedesktop.machine1.service.zst
    │       ├── dbus-org.freedesktop.portable1.service
    │       ├── dbus-org.freedesktop.portable1.service.zst
    │       ├── dbus-org.freedesktop.timedate1.service
    │       ├── dbus-org.freedesktop.timedate1.service.zst
    │       ├── dbus.service
    │       ├── dbus.service.zst
    │       ├── debug-shell.service
    │       ├── debug-shell.service.zst
    │       ├── dhcpcd.service
    │       ├── dhcpcd.service.zst
    │       ├── dhcpcd@.service
    │       ├── dhcpcd@.service.zst
    │       ├── dm-event.service
    │       ├── dm-event.service.zst
    │       ├── dmraid.service
    │       ├── dmraid.service.zst
    │       ├── dnsmasq.service
    │       ├── dnsmasq.service.zst
    │       ├── e2scrub@.service
    │       ├── e2scrub@.service.zst
    │       ├── e2scrub_all.service
    │       ├── e2scrub_all.service.zst
    │       ├── e2scrub_fail@.service
    │       ├── e2scrub_fail@.service.zst
    │       ├── e2scrub_reap.service
    │       ├── e2scrub_reap.service.zst
    │       ├── ebtables.service
    │       ├── ebtables.service.zst
    │       ├── emergency.service
    │       ├── emergency.service.zst
    │       ├── fancontrol.service
    │       ├── fancontrol.service.zst
    │       ├── firewalld.service
    │       ├── firewalld.service.zst
    │       ├── fstrim.service
    │       ├── fstrim.service.zst
    │       ├── ftpd.service
    │       ├── ftpd.service.zst
    │       ├── getty@.service
    │       ├── getty@.service.zst
    │       ├── git-daemon@.service
    │       ├── git-daemon@.service.zst
    │       ├── gluster-ta-volume.service
    │       ├── gluster-ta-volume.service.zst
    │       ├── glusterd.service
    │       ├── glusterd.service.zst
    │       ├── glustereventsd.service
    │       ├── glustereventsd.service.zst
    │       ├── glusterfssharedstorage.service
    │       ├── glusterfssharedstorage.service.zst
    │       ├── gpm.service
    │       ├── gpm.service.zst
    │       ├── healthd.service
    │       ├── healthd.service.zst
    │       ├── hv_fcopy_daemon.service
    │       ├── hv_fcopy_daemon.service.zst
    │       ├── hv_kvp_daemon.service
    │       ├── hv_kvp_daemon.service.zst
    │       ├── hv_vss_daemon.service
    │       ├── hv_vss_daemon.service.zst
    │       ├── initrd-cleanup.service
    │       ├── initrd-cleanup.service.zst
    │       ├── initrd-parse-etc.service
    │       ├── initrd-parse-etc.service.zst
    │       ├── initrd-switch-root.service
    │       ├── initrd-switch-root.service.zst
    │       ├── initrd-udevadm-cleanup-db.service
    │       ├── initrd-udevadm-cleanup-db.service.zst
    │       ├── ip6tables.service
    │       ├── ip6tables.service.zst
    │       ├── iptables.service
    │       ├── iptables.service.zst
    │       ├── kmod-static-nodes.service
    │       ├── kmod-static-nodes.service.zst
    │       ├── krb5-kadmind.service
    │       ├── krb5-kadmind.service.zst
    │       ├── krb5-kdc.service
    │       ├── krb5-kdc.service.zst
    │       ├── krb5-kpropd.service
    │       ├── krb5-kpropd.service.zst
    │       ├── krb5-kpropd@.service
    │       ├── krb5-kpropd@.service.zst
    │       ├── ldconfig.service
    │       ├── ldconfig.service.zst
    │       ├── libvirt-guests.service
    │       ├── libvirt-guests.service.zst
    │       ├── libvirtd.service
    │       ├── libvirtd.service.zst
    │       ├── lm_sensors.service
    │       ├── lm_sensors.service.zst
    │       ├── logrotate.service
    │       ├── logrotate.service.zst
    │       ├── lvm2-lvmetad.service
    │       ├── lvm2-lvmetad.service.zst
    │       ├── lvm2-lvmpolld.service
    │       ├── lvm2-lvmpolld.service.zst
    │       ├── lvm2-monitor.service
    │       ├── lvm2-monitor.service.zst
    │       ├── lvm2-pvscan@.service
    │       ├── lvm2-pvscan@.service.zst
    │       ├── man-db.service
    │       ├── man-db.service.zst
    │       ├── mdadm-grow-continue@.service
    │       ├── mdadm-grow-continue@.service.zst
    │       ├── mdadm-last-resort@.service
    │       ├── mdadm-last-resort@.service.zst
    │       ├── mdmon@.service
    │       ├── mdmon@.service.zst
    │       ├── mdmonitor.service
    │       ├── mdmonitor.service.zst
    │       ├── mkinitcpio-generate-shutdown-ramfs.service
    │       ├── mkinitcpio-generate-shutdown-ramfs.service.zst
    │       ├── ndctl-monitor.service
    │       ├── ndctl-monitor.service.zst
    │       ├── netcf-transaction.service
    │       ├── netcf-transaction.service.zst
    │       ├── netctl-auto@.service
    │       ├── netctl-auto@.service.zst
    │       ├── netctl-ifplugd@.service
    │       ├── netctl-ifplugd@.service.zst
    │       ├── netctl-sleep.service
    │       ├── netctl-sleep.service.zst
    │       ├── netctl-wait-online.service
    │       ├── netctl-wait-online.service.zst
    │       ├── netctl.service
    │       ├── netctl.service.zst
    │       ├── netctl@.service
    │       ├── netctl@.service.zst
    │       ├── nftables.service
    │       ├── nftables.service.zst
    │       ├── ninfod.service
    │       ├── ninfod.service.zst
    │       ├── nscd.service
    │       ├── nscd.service.zst
    │       ├── openvpn-client@.service
    │       ├── openvpn-client@.service.zst
    │       ├── openvpn-server@.service
    │       ├── openvpn-server@.service.zst
    │       ├── polkit.service
    │       ├── polkit.service.zst
    │       ├── ppp@.service
    │       ├── ppp@.service.zst
    │       ├── quotaon.service
    │       ├── quotaon.service.zst
    │       ├── rarpd@.service
    │       ├── rarpd@.service.zst
    │       ├── rdisc.service
    │       ├── rdisc.service.zst
    │       ├── rescue.service
    │       ├── rescue.service.zst
    │       ├── rfkill-block@.service
    │       ├── rfkill-block@.service.zst
    │       ├── rfkill-unblock@.service
    │       ├── rfkill-unblock@.service.zst
    │       ├── rlogin@.service
    │       ├── rlogin@.service.zst
    │       ├── rpcbind.service
    │       ├── rpcbind.service.zst
    │       ├── rsh@.service
    │       ├── rsh@.service.zst
    │       ├── rtkit-daemon.service
    │       ├── rtkit-daemon.service.zst
    │       ├── sddm.service
    │       ├── sddm.service.zst
    │       ├── sensord.service
    │       ├── sensord.service.zst
    │       ├── serial-getty@.service
    │       ├── serial-getty@.service.zst
    │       ├── shadow.service
    │       ├── shadow.service.zst
    │       ├── spice-webdavd.service
    │       ├── spice-webdavd.service.zst
    │       ├── sshd.service
    │       ├── sshd.service.zst
    │       ├── sshdgenkeys.service
    │       ├── sshdgenkeys.service.zst
    │       ├── syncthing-resume.service
    │       ├── syncthing-resume.service.zst
    │       ├── syncthing@.service
    │       ├── syncthing@.service.zst
    │       ├── system-update-cleanup.service
    │       ├── system-update-cleanup.service.zst
    │       ├── systemd-ask-password-console.service
    │       ├── systemd-ask-password-console.service.zst
    │       ├── systemd-ask-password-wall.service
    │       ├── systemd-ask-password-wall.service.zst
    │       ├── systemd-backlight@.service
    │       ├── systemd-backlight@.service.zst
    │       ├── systemd-binfmt.service
    │       ├── systemd-binfmt.service.zst
    │       ├── systemd-bless-boot.service
    │       ├── systemd-bless-boot.service.zst
    │       ├── systemd-boot-check-no-failures.service
    │       ├── systemd-boot-check-no-failures.service.zst
    │       ├── systemd-boot-system-token.service
    │       ├── systemd-boot-system-token.service.zst
    │       ├── systemd-coredump@.service
    │       ├── systemd-coredump@.service.zst
    │       ├── systemd-exit.service
    │       ├── systemd-exit.service.zst
    │       ├── systemd-firstboot.service
    │       ├── systemd-firstboot.service.zst
    │       ├── systemd-fsck-root.service
    │       ├── systemd-fsck-root.service.zst
    │       ├── systemd-fsck@.service
    │       ├── systemd-fsck@.service.zst
    │       ├── systemd-halt.service
    │       ├── systemd-halt.service.zst
    │       ├── systemd-hibernate-resume@.service
    │       ├── systemd-hibernate-resume@.service.zst
    │       ├── systemd-hibernate.service
    │       ├── systemd-hibernate.service.zst
    │       ├── systemd-hostnamed.service
    │       ├── systemd-hostnamed.service.zst
    │       ├── systemd-hwdb-update.service
    │       ├── systemd-hwdb-update.service.zst
    │       ├── systemd-hybrid-sleep.service
    │       ├── systemd-hybrid-sleep.service.zst
    │       ├── systemd-importd.service
    │       ├── systemd-importd.service.zst
    │       ├── systemd-initctl.service
    │       ├── systemd-initctl.service.zst
    │       ├── systemd-journal-catalog-update.service
    │       ├── systemd-journal-catalog-update.service.zst
    │       ├── systemd-journal-flush.service
    │       ├── systemd-journal-flush.service.zst
    │       ├── systemd-journal-gatewayd.service
    │       ├── systemd-journal-gatewayd.service.zst
    │       ├── systemd-journal-remote.service
    │       ├── systemd-journal-remote.service.zst
    │       ├── systemd-journal-upload.service
    │       ├── systemd-journal-upload.service.zst
    │       ├── systemd-journald.service
    │       ├── systemd-journald.service.zst
    │       ├── systemd-kexec.service
    │       ├── systemd-kexec.service.zst
    │       ├── systemd-localed.service
    │       ├── systemd-localed.service.zst
    │       ├── systemd-logind.service
    │       ├── systemd-logind.service.zst
    │       ├── systemd-machine-id-commit.service
    │       ├── systemd-machine-id-commit.service.zst
    │       ├── systemd-machined.service
    │       ├── systemd-machined.service.zst
    │       ├── systemd-modules-load.service
    │       ├── systemd-modules-load.service.zst
    │       ├── systemd-network-generator.service
    │       ├── systemd-network-generator.service.zst
    │       ├── systemd-networkd-wait-online.service
    │       ├── systemd-networkd-wait-online.service.zst
    │       ├── systemd-networkd.service
    │       ├── systemd-networkd.service.zst
    │       ├── systemd-nspawn@.service
    │       ├── systemd-nspawn@.service.zst
    │       ├── systemd-portabled.service
    │       ├── systemd-portabled.service.zst
    │       ├── systemd-poweroff.service
    │       ├── systemd-poweroff.service.zst
    │       ├── systemd-pstore.service
    │       ├── systemd-pstore.service.zst
    │       ├── systemd-quotacheck.service
    │       ├── systemd-quotacheck.service.zst
    │       ├── systemd-random-seed.service
    │       ├── systemd-random-seed.service.zst
    │       ├── systemd-reboot.service
    │       ├── systemd-reboot.service.zst
    │       ├── systemd-remount-fs.service
    │       ├── systemd-remount-fs.service.zst
    │       ├── systemd-resolved.service
    │       ├── systemd-resolved.service.zst
    │       ├── systemd-rfkill.service
    │       ├── systemd-rfkill.service.zst
    │       ├── systemd-suspend-then-hibernate.service
    │       ├── systemd-suspend-then-hibernate.service.zst
    │       ├── systemd-suspend.service
    │       ├── systemd-suspend.service.zst
    │       ├── systemd-sysctl.service
    │       ├── systemd-sysctl.service.zst
    │       ├── systemd-sysusers.service
    │       ├── systemd-sysusers.service.zst
    │       ├── systemd-time-wait-sync.service
    │       ├── systemd-time-wait-sync.service.zst
    │       ├── systemd-timedated.service
    │       ├── systemd-timedated.service.zst
    │       ├── systemd-timesyncd.service
    │       ├── systemd-timesyncd.service.zst
    │       ├── systemd-tmpfiles-clean.service
    │       ├── systemd-tmpfiles-clean.service.zst
    │       ├── systemd-tmpfiles-setup-dev.service
    │       ├── systemd-tmpfiles-setup-dev.service.zst
    │       ├── systemd-tmpfiles-setup.service
    │       ├── systemd-tmpfiles-setup.service.zst
    │       ├── systemd-udev-settle.service
    │       ├── systemd-udev-settle.service.zst
    │       ├── systemd-udev-trigger.service
    │       ├── systemd-udev-trigger.service.zst
    │       ├── systemd-udevd.service
    │       ├── systemd-udevd.service.zst
    │       ├── systemd-update-done.service
    │       ├── systemd-update-done.service.zst
    │       ├── systemd-update-utmp.service
    │       ├── systemd-update-utmp.service.zst
    │       ├── systemd-user-sessions.service
    │       ├── systemd-user-sessions.service.zst
    │       ├── systemd-vconsole-setup.service
    │       ├── systemd-vconsole-setup.service.zst
    │       ├── systemd-volatile-root.service
    │       ├── systemd-volatile-root.service.zst
    │       ├── talk.service
    │       ├── talk.service.zst
    │       ├── teamd@.service
    │       ├── teamd@.service.zst
    │       ├── telnet@.service
    │       ├── telnet@.service.zst
    │       ├── udisks2.service
    │       ├── udisks2.service.zst
    │       ├── upower.service
    │       ├── upower.service.zst
    │       ├── usbipd.service
    │       ├── usbipd.service.zst
    │       ├── usbmuxd.service
    │       ├── usbmuxd.service.zst
    │       ├── user-runtime-dir@.service
    │       ├── user-runtime-dir@.service.zst
    │       ├── user@.service
    │       ├── user@.service.zst
    │       ├── uuidd.service
    │       ├── uuidd.service.zst
    │       ├── virtinterfaced.service
    │       ├── virtinterfaced.service.zst
    │       ├── virtlockd.service
    │       ├── virtlockd.service.zst
    │       ├── virtlogd.service
    │       ├── virtlogd.service.zst
    │       ├── virtlxcd.service
    │       ├── virtlxcd.service.zst
    │       ├── virtnetworkd.service
    │       ├── virtnetworkd.service.zst
    │       ├── virtnodedevd.service
    │       ├── virtnodedevd.service.zst
    │       ├── virtnwfilterd.service
    │       ├── virtnwfilterd.service.zst
    │       ├── virtproxyd.service
    │       ├── virtproxyd.service.zst
    │       ├── virtqemud.service
    │       ├── virtqemud.service.zst
    │       ├── virtsecretd.service
    │       ├── virtsecretd.service.zst
    │       ├── virtstoraged.service
    │       ├── virtstoraged.service.zst
    │       ├── virtvboxd.service
    │       ├── virtvboxd.service.zst
    │       ├── wpa_supplicant-nl80211@.service
    │       ├── wpa_supplicant-nl80211@.service.zst
    │       ├── wpa_supplicant-wired@.service
    │       ├── wpa_supplicant-wired@.service.zst
    │       ├── wpa_supplicant.service
    │       ├── wpa_supplicant.service.zst
    │       ├── wpa_supplicant@.service
    │       ├── wpa_supplicant@.service.zst
    │       ├── xfs_scrub@.service
    │       ├── xfs_scrub@.service.zst
    │       ├── xfs_scrub_all.service
    │       ├── xfs_scrub_all.service.zst
    │       ├── xfs_scrub_fail@.service
    │       ├── xfs_scrub_fail@.service.zst
    │       ├── zram-setup@.service
    │       └── zram-setup@.service.zst
    ├── fuzz/
    │   ├── .gitignore
    │   ├── Cargo.toml
    │   ├── artifacts/
    │   │   ├── decode/
    │   │   │   ├── crash-003e8871ae1b398af243ed3bdd895e6a9b417d09
    │   │   │   ├── crash-06be9bcd30e08d36a1231291fdc393be2286ccd1
    │   │   │   ├── crash-0b8dd1ec99c11d29f489b7ed1ea0a641b22f1c4b
    │   │   │   ├── crash-0e471543b70867a4e3d6884e281e504018f6a4e0
    │   │   │   ├── crash-13621a677af75daa6007d30f8e91a6706ce8b2b7
    │   │   │   ├── crash-1f4e23456d1aa3bcd5a13947ba1b71536c479a3a
    │   │   │   ├── crash-285afb3e50455f20ba4f19ffdd3ca2767771d67c
    │   │   │   ├── crash-2a4da82402386b074fd8be53271812ce2d8e2b18
    │   │   │   ├── crash-2ec60cbc7b68479802290177232e2472625d5e5d
    │   │   │   ├── crash-2f47b61c081dfbce296e9674cae4448f7bfa1277
    │   │   │   ├── crash-3151768e96e3ce234cc8304da8fa51c65ec2bfb6
    │   │   │   ├── crash-3d348c53c3db2c13e65f6a8ea95848fc9ddfaf01
    │   │   │   ├── crash-431e8c5fa22def362a489a04e4f9470d9409f111
    │   │   │   ├── crash-49bec46e6271a44740b1ab82e79e9b371d832b8c
    │   │   │   ├── crash-4d0dfb5fcd91a4c960619fdb17364f34d05f7310
    │   │   │   ├── crash-4fda2fa7e33a2589cc514990dd9fe7ab03bf985a
    │   │   │   ├── crash-50f1812780e355be23520eb604bcc18df1c222bb
    │   │   │   ├── crash-663779067554d3f2a8c56ffc939cc7e842ed63ec
    │   │   │   ├── crash-7eb5677508a2696ad1f778c464a38303267ab4ee
    │   │   │   ├── crash-8373dd7d83fda197b92858a7dfc101c3208c1238
    │   │   │   ├── crash-adb83ab8f58b2724f649a0cea5a5ed2004fa25c5
    │   │   │   ├── crash-b5e12760caa036f8467d9f9963606e675f913ce1
    │   │   │   ├── crash-bacc82e4bc4975593010cae0002c55d0967da6a3
    │   │   │   ├── crash-bbead0dbe38036346fb694ad1893cec85a0b8700
    │   │   │   ├── crash-bc1ef1499329fe12f4ba10998c86778a3102452d
    │   │   │   ├── crash-c11a4207fca22f987266fe797c83eb0bb2c9fbc4
    │   │   │   ├── crash-c746b132a6561becc94bbaf80f0fcd22c805ae7e
    │   │   │   ├── crash-ca663bc7ccd4c4e6e7a02651bc06236b11e20170
    │   │   │   ├── crash-cb08bdd38c7904891e88d217fe105a0c7102cf46
    │   │   │   ├── crash-cb2b9b0b711020aad1153f8a6fff1b5dfbf0e084
    │   │   │   ├── crash-cddb11de78f42d894d9b15b23bbad791b06a7c75
    │   │   │   ├── crash-d5f00d39b2b269f380d4ffc5dd40c76acf43ac13
    │   │   │   ├── crash-d7a5385da30608d3ea21916c0291e3592a627c48
    │   │   │   ├── crash-d8943dbbbf4f0a40fdaef7375207c7778b333864
    │   │   │   ├── crash-d95d11d3a0d91d39c1d5ba9added01f249b39b82
    │   │   │   ├── crash-da39a3ee5e6b4b0d3255bfef95601890afd80709
    │   │   │   ├── crash-efefea0a61c8cab9ec201ca547ec55924b51547e
    │   │   │   ├── crash-f02fdd84d0bc12c221de04a60c81993a6bb56467
    │   │   │   ├── crash-f2c779cdf7827b4827e33eb5510e9e2d3d83371f
    │   │   │   └── crash-fb4314c59f9013d610ac2b8d698c97e518fa095e
    │   │   ├── fse/
    │   │   │   ├── crash-16fdc285684fe17e4a84ff6605c7f0e362af3dfa
    │   │   │   ├── crash-da39a3ee5e6b4b0d3255bfef95601890afd80709
    │   │   │   └── crash-e587fc04ebe1b7e97d0aa916ef8d3f2cc92fb4b1
    │   │   ├── huff0/
    │   │   │   ├── crash-da39a3ee5e6b4b0d3255bfef95601890afd80709
    │   │   │   └── crash-e7d75b9bfbab3e8e4df53bb28b87a1a01ee99d3d
    │   │   └── interop/
    │   │       ├── crash-5ba93c9db0cff93f52b521d7420e43f6eda2784f
    │   │       └── crash-a9f55c479d7c420764bde5bd6c666a7997d79d26
    │   └── fuzz_targets/
    │       ├── decode.rs
    │       ├── encode.rs
    │       ├── fse.rs
    │       ├── huff0.rs
    │       └── interop.rs
    ├── src/
    │   ├── bit_io/
    │   │   ├── bit_reader.rs
    │   │   ├── bit_reader_reverse.rs
    │   │   ├── bit_writer.rs
    │   │   └── mod.rs
    │   ├── blocks/
    │   │   ├── block.rs
    │   │   ├── literals_section.rs
    │   │   ├── mod.rs
    │   │   └── sequence_section.rs
    │   ├── common/
    │   │   └── mod.rs
    │   ├── decoding/
    │   │   ├── block_decoder.rs
    │   │   ├── decode_buffer.rs
    │   │   ├── dictionary.rs
    │   │   ├── errors.rs
    │   │   ├── frame.rs
    │   │   ├── frame_decoder.rs
    │   │   ├── literals_section_decoder.rs
    │   │   ├── mod.rs
    │   │   ├── ringbuffer.rs
    │   │   ├── scratch.rs
    │   │   ├── sequence_execution.rs
    │   │   ├── sequence_section_decoder.rs
    │   │   └── streaming_decoder.rs
    │   ├── dictionary/
    │   │   ├── cover.rs
    │   │   ├── frequency.rs
    │   │   ├── mod.rs
    │   │   └── reservoir.rs
    │   ├── encoding/
    │   │   ├── block_header.rs
    │   │   ├── blocks/
    │   │   │   ├── compressed.rs
    │   │   │   └── mod.rs
    │   │   ├── frame_compressor.rs
    │   │   ├── frame_header.rs
    │   │   ├── levels/
    │   │   │   ├── fastest.rs
    │   │   │   └── mod.rs
    │   │   ├── match_generator.rs
    │   │   ├── mod.rs
    │   │   └── util.rs
    │   ├── fse/
    │   │   ├── fse_decoder.rs
    │   │   ├── fse_encoder.rs
    │   │   └── mod.rs
    │   ├── huff0/
    │   │   ├── huff0_decoder.rs
    │   │   ├── huff0_encoder.rs
    │   │   └── mod.rs
    │   ├── io_nostd.rs
    │   ├── io_std.rs
    │   ├── lib.rs
    │   └── tests/
    │       ├── bit_reader.rs
    │       ├── decode_corpus.rs
    │       ├── dict_test.rs
    │       ├── encode_corpus.rs
    │       ├── fuzz_regressions.rs
    │       └── mod.rs
    └── test_fixtures/
        └── abc.txt.zst

================================================
FILE CONTENTS
================================================

================================================
FILE: .github/workflows/ci.yml
================================================
on: [push, pull_request]

name: CI

jobs:
  tests:
      name: stable lint, test, build
      runs-on: ubuntu-latest
      steps:
        - name: Checkout sources
          uses: actions/checkout@v4

        - name: Install stable toolchain
          uses: dtolnay/rust-toolchain@stable
          with:
            components: clippy
        - name: Install cargo-hack and cargo-msrv
          uses: taiki-e/install-action@v2
          with:
            tool: cargo-hack, cargo-msrv
        - name: check
          run: cargo hack check --workspace --feature-powerset --exclude-features rustc-dep-of-std
        - name: cargo hack clippy
          run: cargo hack clippy --workspace --feature-powerset --exclude-features rustc-dep-of-std
        - name: cargo hack test
          run: cargo hack test --workspace --feature-powerset --exclude-features rustc-dep-of-std
        - name: Verify MSRV (cli)
          run: cargo msrv verify --path cli/
        - name: Verify MSRV (lib)
          run: cargo msrv verify --path ruzstd/

  nightly-stuff:
    name: nightly lint, miri
    runs-on: ubuntu-latest
    steps:
      - name: Checkout sources
        uses: actions/checkout@v4

      - name: Install nightly toolchain
        uses: dtolnay/rust-toolchain@nightly
        with:
          components: rustfmt, clippy, miri

      - run: cargo +nightly fmt --all -- --check
      - run: cargo +nightly clippy --workspace --no-default-features -- -D warnings
      - run: cargo +nightly clippy --workspace -- -D warnings
      - run: cargo +nightly miri test ringbuffer
      - run: cargo +nightly miri test short_Writer


================================================
FILE: .gitignore
================================================
/target
**/*.rs.bk
Cargo.lock
/local_corpus_files
/local_dict_corpus_files
/orig-zstd
fuzz_decodecorpus
perf.data*
fuzz/corpus
.idea


================================================
FILE: Cargo.toml
================================================
[workspace]
resolver = "3"
members = ["ruzstd", "cli"]


================================================
FILE: Changelog.md
================================================
# Changelog

This document records the changes made between versions, starting with version 0.5.0

# After 0.8.2 (Current)
* Introduce the `rust-version` field

# After 0.8.1
* The CLI has been refactored to use `clap`
* The MatchDriverGenerator has been made public so users can name it as `M` in `FrameCompressor<R,W,M>`

# After 0.8.0
* The compressor now includes a `content_checksum` when the `hash` feature is enabled
* Dictionary generation has been added

# After 0.7.3
* Add initial compression support
* **Breaking** Refactor modules to reflect that this is now also a compression library

# After 0.7.2
* Soundness fix in decoding::RingBuffer. The lengths of the diferent regions where sometimes calculated wrongly, resulting in reads of heap memory not belonging to that ringbuffer
    * Fixed by https://github.com/paolobarbolini
    * Affected versions: 0.7.0 up to and including 0.7.2

* Added convenience functions to FrameDecoder to decode multiple frames from a buffer (https://github.com/philipc)

# After 0.7.1

* Remove byteorder dependency (https://github.com/workingjubilee)
* Preparations to become a std dependency (https://github.com/workingjubilee)

# After 0.7.0
* Fix for drain_to functions into limited targets (https://github.com/michaelkirk)

# After 0.6.0
* Small fix in the zstd binary, progress tracking was slighty off for skippable frames resulting in an error only when the last frame in a file was skippable
* Small performance improvement by reorganizing code with `#[cold]` annotations
* Documentation for `StreamDecoder` mentioning the limitations around multiple frames (https://github.com/Sorseg)
* Documentation around skippable frames (https://github.com/Sorseg)
* **Breaking** `StreamDecoder` API changes to get access to the inner parts (https://github.com/ifd3f)
* Big internal documentation contribution (https://github.com/zleyyij)
* Dropped derive_more as a dependency (https://github.com/xd009642)
* Small improvement by removing the error cases from the reverse bitreader (and making sure invalid requests can't even happen)

# After 0.5.0
* Make the hashing checksum optional (thanks to [@tamird](https://github.com/tamird))
    * breaking change as the public API changes based on features
* The FrameDecoder is now Send + Sync (RingBuffer impls these traits now)


================================================
FILE: LICENSE
================================================
MIT License

Copyright (c) 2019 Moritz Borcherding

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.


================================================
FILE: Readme.md
================================================
# Ruzstd (a pure rust zstd format implementation)

[![Released API docs](https://docs.rs/ruzstd/badge.svg)](https://docs.rs/ruzstd)
[![CI](https://github.com/killingspark/zstd-rs/workflows/CI/badge.svg)](https://github.com/killingspark/zstd-rs/actions?query=workflow%3ACI)


# What is this

A pure Rust implementation of the Zstandard compression format, as defined in [RFC8878](https://www.rfc-editor.org/rfc/rfc8878.pdf).

This crate contains a fully operational implementation of the decompression portion of the standard.
It also provides a compressor which is usable, but it does not yet reach the speed, ratio or configurability of the original zstd library.

This crate is currently actively maintained.

# Current Status

## Decompression
The `decoding` module provides a complete
implementation of a Zstandard decompressor.

In terms of speed, `ruzstd` is behind the original C implementation
which has a rust binding located [here](https://github.com/gyscos/zstd-rs).

Measuring with the 'time' utility the original zstd and my decoder both
decoding the same enwik9.zst file from a ramfs, my decoder is about 3.5
times slower. Enwik9 is highly compressible, for less compressible data
(like a ubuntu installation .iso) my decoder comes close to only being
1.4 times slower.

## Compression
On the compression side:
- Support for generating compressed blocks at any compression level
  - [x] Uncompressed
  - [x] Fastest (roughly level 1)
  - [ ] Default (roughly level 3)
  - [ ] Better (roughly level 7)
  - [ ] Best (roughly level 11)
- [x] Checksums
- [ ] Dictionaries

## Dictionary Generation
When the `dict_builder` feature is enabled, the `dictionary` module
provides the ability to create new dictionaries. 

On the `github-users` sample set, our implementation benchmarks within
0.2% of the official implementation (as of commit 
`09e52d07340acdb2e13817b066e8be6e424f7258`):
```no_build
uncompressed: 100.00% (7484607 bytes)
no dict: 34.99% of original size (2618872 bytes)
reference dict: 16.16% of no dict size (2195672 bytes smaller)
our dict: 16.28% of no dict size (2192400 bytes smaller)
```

The dictionary generator only provides support for creating "raw
content" dictionaries. Tagged dictionaries are currently unsupported.

See <https://github.com/facebook/zstd/blob/dev/doc/zstd_compression_format.md#dictionary-format>
for clarification.


# How can you use it?

## Compression

The easiest is to use the provided `compress`/`compress_to_vec` functions

```rust, no_run
use ruzstd::encoding::{compress, compress_to_vec, CompressionLevel};
let data: &[u8] = todo!();
// Either
let mut compressed = Vec::new();
compress(data, &mut compressed, CompressionLevel::Fastest);
// or
let compressed = compress_to_vec(data, CompressionLevel::Fastest);
 ```

 Or you can use the `FrameDecoder` manually to compress data. This allows you to process encoded data while it is being encoded instead of collecting into a big vector.

## Decompression

Additionally to the descriptions and the docs you can have a look at the zstd / zstd_streaming binaries. They showcase how this library can be used.

### Easy

The easiest is to wrap the io::Read into a StreamingDecoder which itself implements io::Read. It will decode blocks as necessary to fulfill the read requests

```rust, no_run
use ruzstd::decoding::StreamingDecoder;
use ruzstd::io::Read;

let mut source: &[u8] = todo!("Get a reader from a File or any other source");
let mut decoder = StreamingDecoder::new(&mut source).unwrap();

let mut result = Vec::new();
decoder.read_to_end(&mut result).unwrap();
```

This might be a problem if you are accepting user provided data. Frames can be REALLY big when decoded. If this is the case you should either check how big the frame
actually is or use the memory efficient approach described below.

### Memory efficient

If memory is a concern you can decode frames partially. There are two ways to do this:

#### Streaming decoder

Use the StreamingDecoder and use a while loop to fill your buffer (see src/bin/zstd_stream.rs for an example). This is the
recommended approach.

#### Use the lower level FrameDecoder

For an example see the src/bin/zstd.rs file. Basically you can decode the frame until either a
given block count has been decoded or the decodebuffer has reached a certain size. Then you can collect no longer needed bytes from the buffer and do something with them, discard them and resume decoding the frame in a loop until the frame has been decoded completely.

## Roadmap

1. More Performance optimizations
    1. sequence_decoding and reverse_bitreader::get_bits. Those account for about 50% of the whole time used in decoding
    2. Matching suffixes. This accounts for >60% of the whole time used in encoding
2. Implement encoder features
    1. More levels
    2. Dictionaries
    3. Checksums

## Testing

Tests take two forms.

1. Tests using well-formed files that have to decode correctly and are checked against their originals
1. Tests using malformed input that have been generated by the fuzzer. These don't have to decode (they are garbage) but they must not make the decoder panic

## Fuzzing

Fuzzing has been done on

1. Random input with no initial corpus
2. The \*.zst in /fuzz_decodecorpus


### You want to help fuzz?

Use `cargo +nightly fuzz run decode` or some other fuzz target to run the fuzzer. It is seeded with files created with decodecorpus.

If the fuzzer finds a crash it will be saved to the artifacts dir by the fuzzer. Run `cargo test artifacts` to run the artifacts tests.
This will tell you where the decoder panics exactly. If you are able to fix the issue please feel free to do a pull request. If not please still submit the offending input and I will see how to fix it myself.

# Contributing

Contributions will be published under the same MIT license as this project. Please make an entry in the Changelog.md file when you make a PR.

## AI Contributions
Contributions may be created by using whatever tools you like. They must be read, verified and decided to be a value added to the project by a human (you! not a maintainer) before submitting a PR and the communication about the PR must be handled by a human and not an agent. This is meant to be more or less in the spirit of the [LLVM policy](https://llvm.org/docs/AIToolPolicy.html) adapted to a much smaller project.


================================================
FILE: cli/Cargo.toml
================================================

[package]
name = "ruzstd-cli"
version = "0.8.2"
rust-version = "1.87.0"
authors = ["Moritz Borcherding <moritz.borcherding@web.de>"]
edition = "2018"
license = "MIT"
homepage = "https://github.com/KillingSpark/zstd-rs"
repository = "https://github.com/KillingSpark/zstd-rs"
description = "A command line interface for the `ruzstd` zstd implementation"
readme = "../Readme.md"
keywords = ["zstd", "zstandard", "decompression"]
categories = ["compression"]

[dependencies]
# Used for the command line binary only
clap = { version = "4.5.46", features = ["derive"]}
color-eyre = { version = "0.6.5" }
tracing = { version = "0.1.41" }
indicatif = { version = "0.18.0" }
tracing-indicatif = { version = "0.3.13" }
console = { version = "0.16.1" }
tracing-subscriber = { version = "0.3.20" }
ruzstd = { path = "../ruzstd", features = ["std"] }

[dev-dependencies]
criterion = "0.5"
rand = { version = "0.8.5", features = ["small_rng"] }
zstd = "0.13.2"


================================================
FILE: cli/src/main.rs
================================================
extern crate ruzstd;
mod progress;
use progress::ProgressMonitor;

use std::fs::File;
use std::io::BufReader;
use std::path::Path;
use std::path::PathBuf;

use progress::fmt_size;

use clap::{Parser, Subcommand};
use color_eyre::eyre::{ContextCompat, WrapErr};
use ruzstd::encoding::CompressionLevel;
use tracing::info;
use tracing_indicatif::IndicatifLayer;
use tracing_subscriber::layer::SubscriberExt;
use tracing_subscriber::util::SubscriberInitExt;

#[derive(Parser)]
#[command(version, about)]
struct Cli {
    #[command(subcommand)]
    command: Option<Commands>,
}

// TODO: implement a dictionary creation command, and a command for benchmarking
#[derive(Subcommand)]
enum Commands {
    /// Compress a single file. If no output file is specified,
    /// output will be written to <INPUT_FILE>.zst
    Compress {
        /// File to compress
        input_file: PathBuf,
        /// Where the compressed file is written
        /// [default: <INPUT_FILE>.zst]
        output_file: Option<PathBuf>,
        /// How thoroughly the file should be compressed. A higher level will take
        /// more time to compress but result in a smaller file, and vice versa.
        ///
        /// - 0: Uncompressed
        /// - 1: Fastest
        /// - 2: Default
        /// - 3: Better
        /// - 4: Best
        #[arg(
            short,
            long,
            value_name = "COMPRESSION_LEVEL",
            default_value_t = 2,
            verbatim_doc_comment
        )]
        level: u8,
    },
    Decompress {
        /// .zst archive to decompress
        input_file: PathBuf,
        /// Where the compressed file is written
        /// [default: <ARCHIVE_NAME>]
        output_file: Option<PathBuf>,
    },
}

fn main() -> color_eyre::Result<()> {
    // Process CLI arguments
    let cli = Cli::parse();
    // Initialize logging (with indicatif integration)
    let indicatif_layer = IndicatifLayer::new();
    tracing_subscriber::registry()
        .with(
            tracing_subscriber::fmt::layer()
                .with_writer(indicatif_layer.get_stderr_writer())
                .without_time(),
        )
        .with(indicatif_layer)
        .init();

    let command: Commands = cli.command.wrap_err("no subcommand provided").unwrap();
    match command {
        Commands::Compress {
            input_file,
            output_file,
            level,
        } => {
            let output_file = output_file.unwrap_or_else(|| add_extension(&input_file, ".zst"));
            compress(input_file, output_file, level)?;
        }
        Commands::Decompress {
            input_file,
            output_file,
        } => {
            let output_file = output_file.unwrap_or(
                input_file
                    .file_stem()
                    .expect("input has a file name")
                    .into(),
            );
            decompress(input_file, output_file)?;
        }
    }
    Ok(())
}

fn compress(input: PathBuf, output: PathBuf, level: u8) -> color_eyre::Result<()> {
    info!("compressing {input:?} to {output:?}");
    let compression_level: ruzstd::encoding::CompressionLevel = match level {
        0 => CompressionLevel::Uncompressed,
        1 => CompressionLevel::Fastest,
        2 => CompressionLevel::Default,
        3 => CompressionLevel::Better,
        4 => CompressionLevel::Best,
        _ => {
            unimplemented!("unsupported compression level: {}", level);
        }
    };
    let source_file = File::open(input).wrap_err("failed to open input file")?;
    let source_size = source_file.metadata()?.len() as usize;
    let buffered_source = BufReader::new(source_file);
    let encoder_input = ProgressMonitor::new(buffered_source, source_size);
    let output: File = File::create(output).wrap_err("failed to open output file for writing")?;

    ruzstd::encoding::compress(encoder_input, &output, compression_level);
    let compressed_size = output.metadata()?.len();
    let compression_ratio = compressed_size as f64 / source_size as f64 * 100.0;
    info!(
        "{} ——> {} ({compression_ratio:.2}%)",
        fmt_size(source_size as f64),
        fmt_size(compressed_size as f64)
    );
    Ok(())
}

fn decompress(input: PathBuf, output: PathBuf) -> color_eyre::Result<()> {
    info!("extracting {input:?} to {output:?}");
    let source_file = File::open(input).wrap_err("failed to open input file")?;
    let source_size = source_file.metadata()?.len() as usize;
    let buffered_source = BufReader::new(source_file);
    let decoder_input = ProgressMonitor::new(buffered_source, source_size);
    let mut output: File =
        File::create(output).wrap_err("failed to open output file for writing")?;

    let mut decoder = ruzstd::decoding::StreamingDecoder::new(decoder_input)?;

    std::io::copy(&mut decoder, &mut output)?;

    info!(
        "inflated {} ——> {}",
        fmt_size(source_size as f64),
        fmt_size(output.metadata()?.len() as f64),
    );
    Ok(())
}

/// A temporary utility function that appends a file extension
/// to the provided path buf.
///
/// Pending removal when our MSRV reaches 1.91 so we can use
///
/// <https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.add_extension>
fn add_extension<P: AsRef<Path>>(path: &Path, extension: P) -> PathBuf {
    let mut output = path.to_path_buf().into_os_string();
    output.push(extension.as_ref().as_os_str());

    output.into()
}

#[cfg(test)]
mod tests {
    use std::path::PathBuf;

    use crate::add_extension;

    #[test]
    fn extension_added() {
        let filename = PathBuf::from("README.md");
        assert_eq!(
            add_extension(&filename, ".zst"),
            PathBuf::from("README.md.zst")
        );
    }
}


================================================
FILE: cli/src/progress.rs
================================================
// ! Utilities for displaying a progress monitor to track compression/decompression/whatever else
//!
//! This implementation relies heavily on the `indicatif` crate, see <https://docs.rs/indicatif>cargo hack check --feature-powerset --exclude-features rustc-dep-of-std

use std::{fmt::Write, io::Read, time::Duration};

use indicatif::{ProgressBar, ProgressDrawTarget, ProgressStyle};
use tracing::info;

/// A generic wrapper around a reader that keeps track of how many bytes have been read
/// from the total.
///
/// This wrapper has a lock on standard out for the lifetime of the monitor
pub struct ProgressMonitor<R: Read> {
    /// The total amount that the reader will read
    pub total: usize,
    /// Amount read so far
    pub read: usize,
    /// The internal reader
    reader: R,
    progress_bar: ProgressBar,
}

impl<R: Read> ProgressMonitor<R> {
    /// Create a new progress monitor, initialized with zero bytes read
    pub fn new(reader: R, size: usize) -> Self {
        // https://docs.rs/indicatif/latest/indicatif/index.html#templates
        let style = ProgressStyle::with_template(
            "{wide_bar} {binary_bytes}/{binary_total_bytes}  \n[est. {eta} remaining]",
        )
        .unwrap();
        let progress_bar = ProgressBar::new(size as u64).with_style(style);
        // The default is 20hz, this reduces rendering overhead
        progress_bar.set_draw_target(ProgressDrawTarget::stderr_with_hz(8));
        Self {
            reader,
            total: size,
            read: 0,
            progress_bar,
        }
    }

    /// This function is called whenever a new read is made, and is responsible for updating the UI
    fn update(&mut self, delta: u64) {
        self.progress_bar.inc(delta);
        if self.total == self.read && !self.progress_bar.is_finished() {
            self.progress_bar.finish_and_clear();
            info!(
                "processed {} in {} ({}/s avg)",
                fmt_size(self.total as f64),
                fmt_duration(self.progress_bar.elapsed()),
                fmt_size(self.total as f64 / self.progress_bar.elapsed().as_secs_f64())
            );
        }
    }
}

impl<R: Read> Read for ProgressMonitor<R> {
    fn read(&mut self, buf: &mut [u8]) -> std::io::Result<usize> {
        // Fall back on the internally stored reader, but filch the number of bytes read
        // along the way
        let out = self.reader.read(buf)?;
        self.read += out;
        self.update(out as u64);
        Ok(out)
    }
}

/// Converts a quantity in bytes to a human readable size, "GiB, MiB, KiB, etc"
pub fn fmt_size(size_in_bytes: f64) -> String {
    let units = ["B", "KiB", "MiB", "GiB", "TiB", "PiB"];
    let order_of_magnitude = (size_in_bytes).log10() as usize;
    // Overflow to the next order of magnitude if there are more than `upper_bound` figures
    // before the decimal
    let upper_bound = 3;
    let unit_index = (order_of_magnitude / upper_bound).clamp(0, units.len() - 1);
    let decimal = size_in_bytes / 2_f64.powi((unit_index * 10) as i32);
    // Only use a decimal if displaying a unit larger than a byte
    if unit_index > 0 {
        format!("{:.2}{}", decimal, units[unit_index])
    } else {
        format!("{:.0}{}", decimal, units[unit_index])
    }
}

/// Converts a [`std::time::Duration`] to a human readable format
fn fmt_duration(duration: Duration) -> String {
    let as_secs = duration.as_secs_f64();
    let as_min = (as_secs / 60.0).floor() as usize;
    // When displayed in long form, the value shown
    let secs_portion: f64 = as_secs % 60.0;
    let min_portion: usize = ((as_secs - secs_portion) as usize / 60) % 60;
    let hr_portion: usize = ((as_min - min_portion) / 60) % 60;

    let mut output = String::with_capacity(8);
    if hr_portion > 0 {
        write!(&mut output, "{hr_portion}h ").unwrap();
    }
    if min_portion > 0 {
        write!(&mut output, "{min_portion}m ").unwrap();
    }
    // Formatting for seconds is fairly manual
    // to provide a "useful" level of precision
    if as_secs > 60.0 && secs_portion != 0.0 {
        // Zero points of precision
        write!(&mut output, "{:.0}s", secs_portion.round()).unwrap();
    } else if secs_portion > 4.0 {
        // One point of precision
        write!(&mut output, "{secs_portion:.1}s").unwrap();
    } else if secs_portion > 1.0 {
        // Two points of precision
        write!(&mut output, "{secs_portion:.2}s").unwrap();
    } else if secs_portion > 0.0 {
        // Display as ms with two units of precision
        write!(&mut output, "{:.2}ms", secs_portion * 1000.0).unwrap();
    }
    output.trim().to_string()
}

#[cfg(test)]
mod tests {
    use std::time::Duration;

    use super::{fmt_duration, fmt_size};

    #[test]
    fn human_readable_filesize() {
        // Bytes
        assert_eq!(&fmt_size(100.0), "100B");
        // Kibibytes
        assert_eq!(&fmt_size(12.0 * 2.0_f64.powi(10)), "12.00KiB");
        // Mebibytes
        assert_eq!(&fmt_size(7.0 * 2.0_f64.powi(20)), "7.00MiB");
        // Gibibytes
        assert_eq!(&fmt_size(123.0 * 2.0_f64.powi(30)), "123.00GiB");
    }

    #[test]
    fn human_readable_duration() {
        assert_eq!(&fmt_duration(Duration::from_millis(7)), "7.00ms");
        assert_eq!(&fmt_duration(Duration::from_millis(1500)), "1.50s");
        assert_eq!(&fmt_duration(Duration::from_secs(30)), "30.0s");
        assert_eq!(&fmt_duration(Duration::from_secs(90)), "1m 30s");
        assert_eq!(&fmt_duration(Duration::from_secs(5 * 60)), "5m");
        assert_eq!(&fmt_duration(Duration::from_secs(3 * 60 * 60)), "3h");
        assert_eq!(
            &fmt_duration(Duration::from_secs(1 * 60 * 60 + 20 * 60 + 30)),
            "1h 20m 30s"
        );
    }
}


================================================
FILE: optimizations.md
================================================
# Optimizations
This document tracks which optimizations have been done after the initial implementation passed corpus tests and a good amount of fuzzing.

## Introducing more unsafe code:
These optimizations introduced more unsafe code. These should yield significant improvements, or else they are not really worth it.

### Optimizing bitreader with byteorder which uses ptr::copy_nonoverlapping
* Reverse bitreader_reversed::get_bits was identified by linux perf tool using about 36% of the whole time
* Benchmark: decode enwik9

* Before: about 14.7 seconds
* After: about 12.2 seconds with about 25% of the time used for get_bits()

### Optimizing decodebuffer::repeat with ptr::copy_nonoverlapping
* decodebuffer::repeate was identified by linux perf tool using about 28% of the whole time
* Benchmark: decode enwik9

* Before: about 9.9 seconds
* After: about 9.4 seconds

### Use custom ringbuffer in the decodebuffer
The decode buffer must be able to do two things efficiently
* Collect bytes from the front
* Copy bytes from the contents to the end

The stdlibs VecDequeu and Vec can each do one but not the other efficiently. So a custom implementation of a ringbuffer was written.

## Introducing NO additional unsafe code
These are just nice to have

### Even better bitreaders
Studying this material lead to a big improvement in bitreader speed
* https://fgiesen.wordpress.com/2018/02/19/reading-bits-in-far-too-many-ways-part-1/
* https://fgiesen.wordpress.com/2018/02/20/reading-bits-in-far-too-many-ways-part-2/


================================================
FILE: ruzstd/Cargo.toml
================================================
[package]
name = "ruzstd"
version = "0.8.3"
rust-version = "1.87"
authors = ["Moritz Borcherding <moritz.borcherding@web.de>"]
edition = "2018"
license = "MIT"
homepage = "https://github.com/KillingSpark/zstd-rs"
repository = "https://github.com/KillingSpark/zstd-rs"
description = "A decoder for the zstd compression format"
exclude = ["decodecorpus_files/*", "dict_tests/*", "fuzz_decodecorpus/*"]
readme = "Readme.md"
keywords = ["zstd", "zstandard", "decompression"]
categories = ["compression"]

[dependencies]
# Locked behind the `hash` feature flag
twox-hash = { version = "2.0", default-features = false, features = ["xxhash64"], optional = true }
fastrand = {version = "2.3.0", optional = true }

# Internal feature, only used when building as part of libstd, not part of the
# stable interface of this crate.
compiler_builtins = { version = "0.1.2", optional = true }
core = { version = "1.0.0", optional = true, package = "rustc-std-workspace-core" }
alloc = { version = "1.0.0", optional = true, package = "rustc-std-workspace-alloc" }

[dev-dependencies]
criterion = "0.5"
rand = { version = "0.8.5", features = ["small_rng"] }
zstd = "0.13.2"

[features]
default = ["hash", "std"]
dict_builder = ["std", "dep:fastrand"]
hash = ["dep:twox-hash"]
fuzz_exports = []
std = []

# Internal feature, only used when building as part of libstd, not part of the
# stable interface of this crate.
rustc-dep-of-std = ["dep:compiler_builtins", "dep:core", "dep:alloc"]

[[bench]]
name = "decode_all"
harness = false


================================================
FILE: ruzstd/benches/decode_all.rs
================================================
use criterion::{criterion_group, criterion_main, Criterion};
use ruzstd::decoding::FrameDecoder;

fn criterion_benchmark(c: &mut Criterion) {
    let mut fr = FrameDecoder::new();
    let target_slice = &mut vec![0u8; 1024 * 1024 * 200];
    let src = include_bytes!("../decodecorpus_files/z000033.zst");

    c.bench_function("decode_all_slice", |b| {
        b.iter(|| {
            fr.decode_all(src, target_slice).unwrap();
        })
    });
}

criterion_group!(benches, criterion_benchmark);
criterion_main!(benches);


================================================
FILE: ruzstd/decodecorpus_files/abc.txt
================================================
abcdefghijklmnopqrstuvwxy


================================================
FILE: ruzstd/decodecorpus_files/z000000
================================================
_____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+++_________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________o++<++_________________________________________________<++++_______________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+<+++M___________________________________________________+<M<++++++M++o_______________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________++<+++M<+++M<<++<_______________________________________________________________________________________________________________________________________________________________++MM++<+<^++______________________________________________________________________+<+________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________M___________________________________________________________________________________++++<+<+++M+++<M+<<+<+_____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________<++++<<+++++M+<++<+++++M<+++M++++<<+MM+M+++__________________________________________________+M<M<<<++++++<_______________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________<M<++M+++<++++++++++++<+++++<M++_______________________________+<+________________________________________________________________________________________________________________________________________________________________________________________________________________________+MM______________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+<++_____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________++++^<<+++<++^+<+<++++++++<+++^+<<++MM++++<_________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________++_________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+^++M<_________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+M++++++++<<________________________________________________________________________________________________________________________________________________________________________<<+<M^M+<+++<M++<^++<++<+<+++++<+<+++<<<+M+<___________________________________________________________________________________________________________________________________________+^<++++++<++____________________________________+++++^MM+++<<^++<+<+<+++<+<+<M+++<<^M+_____________________________<++++<+<+++<++<+<^+M++++<++<+o^+M+++++o<++<+++++<+MM++<+++M+^+++oM++^<^+o++++_______________________________________________________________________________________________________________________________________________________________________________________________<<+M+<<+<<++M<+<+Mo_______________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+<+^M+++^+++<<M+^++<+M^++++<+<o^M+++++M<<+M+<<<M+++++++++<++M++_____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+M___________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+++++_________________________________________________________________________________________________________________________________________________________________+MM+_________________________________________________________________M++++<<+++____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________++MM+++++<+++______________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+++________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________++_________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________<++<+<++<+<<++++++++++_____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+++++<+++<+M+<+<++++<+++<^++_________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________++M++++M+M+++++<+^+<++++++<M++o+_____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+++<<+++<__________________________________________________________________________________________________M+MM<___________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________++++++M++M<<+M++M++++++M+<++++++++<+<+<+<++++____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+___________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+++M<++M+++^<+++M+<<<+++M________________________________________________________________________________________________________________+<______________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+M+<+++++++________________________________________+++<<<++<+___________________________++M+<++++++++++<+<^++<+++<M<++<++<+M<MM+o<+<++++___________________________________________________________________________________________________________________________________________________________________________________________________________________________+<+++++____________________++MM+<MM+++++M____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________++++M++++++<++++++<+M+<<++++++++<<+++<++++^+o______________________________________________________________________________________________________________________________________________________++++++^M++<++++++++<<+<+++M++++___________________________________________________________+<++_______MM+________________________________________+_______________________________________________________________________________+___________________________________________________________________________________________________________________________________________________<_______________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+^+++<<___________________<++___+___________________+____^+o____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+_________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________++______________________________________________________________+_________M___<_____+<_________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________<_____________________________________________________________________________________________________________________________________________________________________________________________________+________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________<____________________________________________________________________________________________________________________________________+___________________________________________________________________________________________________________________________________________________________________________________o______________________________________________________________________________________________________________________________________<______________________________________________________________________________________________________________________________M____________________________________________________________________________________________________________________________________________________________________________________________________________________++<++________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+<+____________________________+___________________________________________________________________________________________________________________+__________________________________________<________________________________++M___________________________________________________________________________________________________________________________________________________________________________________________________________________________________+_________________________________________________________________________________________________________________________<____________+________________________________________________________________________<^+o+++________________________________________________________________________________________________________________________________________________________________________________________________________________________________<_________________________________________________________________________<____________________________________________________________________________________________________________+___________________________________________________________________________+++__________________________________________________________________________+___+++M<+_______________________________________________________________+_________________<_________________________________________________________________+___________________M________________________+_________________________________________________________________________________________________________________________________________<_________________________________________________________________________________________________________________________________+______________________________________________________________________________________________o___________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+______________________________________________________________________________________________________________<__________________________________________________________________+___________________________________________________________________________________________________________________________________________________________________________________________________________________________________+__________________________________________________________________________________________________________________________________________________________________________+_______________________________________________________________________________________________________________________________________________________________+_______________________________________+________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+________________________+_______________________________________________________________________________________+_______+++_______________________________________________________________________________________________________+____________________________________________________________________________________________________________________________________________________________________________________+_____________________________________________________+______________________________________+_________________<_______+MM_________________________________________________________________________________________________<+++______________________++M++<_____________________________________________________________________________________________________________M______________________________________________________+<+++______________+___________________________________________________________________________+___________________________________________________________________________________________________^___+_____________+__________________________+<^______________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+___________________________________________________+_________________________________________________________________________________________________________________________+___________________________________________________________________________________________________________________________+++________++<+___o______________________________________________________________________________________________+_______________________________________________________________________________________+____________________________<____++++_____________________________________+______+____________________________________________________________________________________________________________________________________________________________________________________________________________+______++M<+___________________________________________________________________<______________________________________________________+____________________________________________<_____________+______________+________________________________________+_____________________________________________________________________________________________<____________________________________+_________________________________________________________++<_______________________________________________________________________+_______________________________________________________________________+______________________________________+___________________________________________________________________________________________________________________________________________________________+_______________________________________________________________________________________________________________________________________+_____+_____+_____________________________________________________+_______________________________________________<____________________________________________________<_______________________________________________________________________++___________________________________________+_____________________________________________________________________________________________+_______________+_______________________+<+<______________+____+____________________________________________________________________+___________________________________________________<___________________________________________________________________+___________________________________________________________________<_______________________________________________________________________________________________M___________________________________________________________________________+________________________________________________________________________________________________+_________________________________________________________________________________________________+___________________________________<___________<______+____________________________________________________________________________________________________________________________________________________________________________________________________________M______+________________________________________________________________________________________________________________________________________________________+____________________________________________________<______________<__________________________________________<________________________________+__________________+______________________<_________+___________________________________________________________+__________________________________________________<______________________________________________________________________+________________________<____________________________________________________________+____________+________________________+__________________________________________________^_________________________________________________________________________+_____________________________________________________________+______________+____________________________+_________________________________________________________________________________________+___________________________________________________________________________________________________________________________+_______________+______________________________________+_________________________________________________________________________________________+______________________________<____+_________+___+_______________________________________________________________________________________________________________<___+__________________________________________________^__________________________________________________+___________________________________________________________________________________________________________________________________+___________<+___________<____________________________________M____<_________________________+_________________________________________________________________________________________________+____________________________________________________+__________________________________________________+___<____________________________________^________________^________________________<_________________________________________+_____________________________________________________+__________________+_______________________________________________________________________________________________________________________________+_______________________________________________________<___________________________________________+____________+_____________________________++___________________M_______________________________________M________________+___________________________________________+____________+_____________________+___________________+___________<____________________<+<M^_________________________________________________________________________+______________________++<++________________+++_________________________+___________^________________________+__________________________________+_______________________________________________________________________________________________________________________________________________<_______+___+___________________________+_________________________________________+_______________^____________________________________+______+____________+_______________+_______+_______________________+______________________________________________M___________________++++________+______________+_______________________________________________________________________________________________M__________________M______________+<+++<__________________________________________________________________________________________________++^M_______________+_________________________________________________________________________________________________________<________________________________^________________________________M_______________________________________________________________________________________+__________+________________________<_______________________+___________________________________________________________________________________________________________________________+______++____________________________________+_____________________________________+_____________________________+_________+_______________________________________________________________________________________________________+____________+___________<__________________+______________________+________________<____________<_________________________________<______^______+_________________________________________________+_________________________+<___<_____o___<_____________<___________+_______+__________<______o___________________________________________________________________+____________________________________________________________________________<_________________________________<________________________________________________________________________<_____________________________________________________________________________________________+_________________________________________+_____________________________________<_______________________________+_________+____________________________________+_________________________+_________+____________________________________________________________________________________________________<_______________________________________+_______________________________________________________________________________M_____________+________M________________+___________+_______________________________________<_________________________<________________________________________++<___________^______________________________+___________+__________+_________M____________+____________________________+_____________________________+____________________________+___________+____________________________<___________<+______+______________________+____<+_________________________+_________________________+______M+++++M+________________________________+________________________________+_______________________________+___________<_______+____________________+_________________________________<___________________<_____________________________________+___________________________________<<++<<<____________________+___________________________________________________________________________________________++<+<___________+________________________________________________<__________+______+___________<______________________+_____________________+______M______+_______+____+_______________________________________________+_____<_____________________________++____________________<_____________________________________+___<_________+______________________________+________________________________<_______________________<____________________________________+_____________________________+_________++____________+__________<M+___________________________________<_________M_____________________+___________o________+________________________________________________________+^______+___________________+___+___________________________________________+_______+______________+_________________+_____________________________________________________________________________________________^_____________+___________________________M_________+<__________________________________+______________________++M+_________<_____________________________+____________________++<<______________________________________+_________________________________+_______________________________M_________________________+__________M____________________________+________________________________________________________________+<++_______________+_____________________________+________________________________________________________+________________________________+_____________________+________________+____________________________+________________________________+____M____________________________________________________________+________________________________________<_______________M________________________________+_______+___________________+____________+____________________________^_______________________+_______<__________+________________________<___________________________________+________________+___<____+_____<___<_______________+____________+++___________________________________________________+____________+++++_________________+_______<________++^_________<____________________________<______+___________________________________+______________________________________+______________<________<M______________________o___________________________________________________________________+___<_______+__+____+_______________+_________________+_______+___________________________+__________________________+________________________________________<________________________________+<___+___________________<________________+______+______________<___M____________+______________________________________________________+++_____________________________________________________+__________________________________+_________+__________________________+____________________________+__________++M______________+_______________________+______________<++__________________+_____+__________<___o________________________++__________________<____M________________________________+<+________________________________________+___________________<________________<_______________+___________________________+<^_______________<__________________________________________________+__________________________<__________________+___________________+_____________________<_____+____M___+_________+_________________________________+_____<____+________+_____________+<_____+_________________+<+<_________________<___________M____<_______+_________+______________________________________<___________________________________________________+_______________+__________+______<______o_______+________________________+_______________________+_+____________________+___________________<_______<_______+_________+_________________________________________________________________________+_____________<___+___________________________________+_________+____<_____+____<_________________<___<____________________+_____________________________________<____________________+____<++________________________+___+__________________+_______+___+_____________________________________<____________+_______________________+____________________________________________________________________+___________________________________________^__________+________________________________________________++^____+__________________________________<+______________+____________<______<_________________+___M_________________________________<_____________+___________________+___________________+_______________________+___________________________o______________+____________+___________________________++_____________________________+_______________________<______________________+______+________________+_____________________________________+_________________+_________________+____M_______________+_______++______________________M_____+_____________+__________________<___<__________________________________o__________<____+_______+______+_________________________________________________<____________________________________________<____________+___________________________+______++__<_______________M___+____________<____________+_____________________________M____________________<__________________________________________________________<____________<__________________<__________+_______________+___________________+________+_____+___+___________________________________________________________________o___<____M_____________________+___^__________________________^______________________+___________________+_________o_________^________+____<__________+______++______________<_____+_______<____________________<___________________________________________________^+<+_________<____________+___M________________________<___________________M____________________________+____<______________+________________<____________________<____+___________________________<___________<<<+_____________<________<____+_______M______________________________________________+_____________________________________+____++___+_______________________________________________________M________________________+___+<_________+^_______+______+_______________M______M_______________________<_______+____+___________________M____+________+__________________________++___________+_________+________________________++____+M________<___________________________________________________+_______________________________M_____________________________+<___+_________+__________<_________________M_____<_________________+_____________+__________<___+____<_____________+___________+_____+____________<___________^M___+________________+______+_____________<_________________________________++____________________<___________<_______________+_____+_______________<_________<___________+____________________M____________<____+___________+________________+<__________+___________+_____________+____<____+____________+_______+____________o___+_____+++______M_____________+____________+____________^++<_+____o___<_________++____+________++_____o_____+___++_______________<_________<_______+++___<_______________<________+________<___^+_______+_____________++____________<____________<_________+__________________________________+_______^______________________+M___________+_______________________+___________+______++_____________________________+____________+_____________+________+___M_____________+____________<_____+________o___M+____________________+_______<______++_____+_______________<_________+___________+_________________++________+_____++______+________________________+______<_______++_________________+_______________M____________________+<___+_________+______________+___+++<_____M_______+________+______________________+___+_________+M____________+____<____+<_____________++_______+________________________+___<<___<____+<____________++___+<_______+_______+++++M++<++<M+++_______________++++M<+<+<<<^++++++++<M<+<+<M++__<________________<____<++++<M<++M^+<+<+M<+<_______+<+++______________________________________+<<_______++++<<M+++<++++<<<<oM+M+++++____________________+++++<+<++++++<+<++____+<<<+<<++++<+<<+<+++<+<+<^<<++<+++<+<M+^+++M++<<+<+<+<++++<+M<________________________________+_______++^^+______++++MM++<^<+++^M^+M+M^+<+^+MM_____<+<<++M<+<+<++__<_________++M++<M++++<______+_______<+<+++<^<M+M+M+_____________________M^+++M<M++M______+++<+M<+<+++M<+<++^<<^<+M+MM++<+M+++M<++++o+<<M<+<+<+<o<+++M+<+<<<<<___++<<+<+M+M+M++<<+M<++++<++______+<+M<Mo<^<+<MM______+<<++^<<+<<++<++++<++<+++<++_________+M++<++oM<+<+o<++<+++M+++<<+^M++<<+++M<++++<^+++<+<++<+<++<<<+++++++_______M+<<<+<^+<<M++++___+++^<o<++<+<<++<^++<+++<<++++++<+M+++++M+<+++<++++M<M<++<+M++++<+++_______+++++<+M______+<M<<<+<+++<++++M<+__________<M+___+<+<+<+M++++++++<+<++<<+<<MM+<+++<++++MM+<++<<M+M++<+^+++++<o++<++++<+++<+<+++<<+++<<__+__+<+<+^++____M+<M+++<+++<++++o<<+M+<<+M++M+++++___________++++M++++++oM++<+<+<<++M++++<++M+<+<+++MM<++<++<+++++M<++<+^<<+<<++++^++<<<++<<<++<M<++++<++++M++++++<<+M++<+__________________++_____________________________________________________________________________________________________+____+_________________________________________________________________________+___o__________________M_____________________________+_________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________<++_____________________________________________________________________________________M_________________________________________________________________________________________________________________________________________________________o_________________________+________+________________________________________________________________________________________________________________________________________________<+M______________________________________________________________________________________________________________________+<M+______________+++<_________________+______________________________________________^++___________________________________________________________________________________________^_____________________________________________+++M+<<+____________________________________________________________________+MM___________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+__+_______________________________________________________+_________________________________++<_____________________________________________________________________________________________________________________________________________+^____________________________________________________________________________________________________<+<+<+_________________________________+______________________________________________________________________________________________________________^++_______________________________________________+++_____________________<++++_______________________________________________________________________________________________________+_______________________________________________________________________________________________________________________________________________________________________________________________________++___+_______________________________+__________________________________<+<+__________________<_____________________________________________________________________________________________________________________________________________________+________________________________________________________________________________________________________________________________________________________________________________________________________+______________________________________________________________________M_________________________________++_______________++___________________________________________________________________________________+++<++<_________________________________________________________________________________________________________________________________+__________________________________________________________________________________________________________________________________M+__________________________<______________________________________________________<<+M________________<<<+_____________________________________________++__________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+_____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+_____+<_____________________________________________________________________________________________________________________________________________++<+<^+_____________________________+^M++_________________<_____________________________________________________________________________________________________________________________________________________+<___________________________________________________++_________________________________________________________________________________________________________________________________________________________________________________________________<__________________________________<<<+_________________________________________________________________________________________________________________________________+___________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________M___________M<+<________________________M++++__________________________________________________________________________________________________________________________________________________________________________________<<++___________________________________________________________________+______________________________________________________________________________________________________________________________________+______________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+<+<_______++_______________________________________________________________________________________________________________________________<<+___________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________<____________________+<^<+++_________________________________________________________________________________________<_____________________________________________________________________+++M<+________________________________________________o________________________________________________________________________________________________________________________________________________________________________________+__________________________________+____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+_______+______________________________________________________________________________________________________________++____________________________________________________________________________________________________________________________________________________+___________________________________________________________________________^++_______________________________________________________________________________________++<+++<_____________________________________________________________________________+______________________++<+__________________________________________________________________________________________________________________________________________<^+________________________________________________________________________________________________________________________________________________________________++________________M+<++____________________+_________________________________________________________________________________<<+____<<+++_________________________________________________________________________________________________________________________________________________________________________________________o______________________________+___________________________________________________________________________________________+___________________________+___________________________________________________________________________________________________M_____________________________________________++++<++++_________________________________________________________________________________________________________________________________<+___________________________<______________________________________________________________________________________________________+___________<___________________________________________________________________________________________________________________________________++M<____________________________________________________________________________________________________________________________+_____________________________________________________+M++_______________________________________<____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+<++____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________<___________________________________________________________________________________________________________________________________________________________________________________________________________________________________+++<+M+____________________________________________________+++++_______________________________________________________________________________________________________________+________________________________<____+_______________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________<______________________M_____<++_____M++______+<+________________________________________________________________________________________________________________+++++_____+__________________________+_______________________________________________________________________________________________________________+________________________________________________________________________________________________________________________________________________________________________________++++____________________________________<_____________________________________________________________________________________________________________________^_________________________________________________________________________________________________________________________________________________________________________________+++<__________++_____________________________________________________________________________________________________________________________________________________________________o__________________________________________________M___________MM__________________________________________________________________________________________________________________________________________________________________________<_______________________________________________________________________________________________________________________________________________+__________________________________________________________________________________________<__________________________________________________________________________________________________+++_________________________________________________________________________________________________________________++__<_____________________________M___________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________++++_+_____________________________________________________________________________________________________________________<_______________________________________________________________________+<+^+_________+++__________________________________________________________________________________________________________________________________________________________________+____________________________________________________________________________________________________________________________________________________________________________________________+___________________________________________________________________________+_________________________________________________________________++++_____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+_____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________<______________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________Mo_______+__________________________________________________________________________________M____________________________________________________<++___^+M+______________________________________________M______________________________________________________________________________________________________________________________________________________________________________________________________________________________+^<<+______________________________________________________________________<++<<__________________________________________________________________________________+++^<<+____________________________________________________________________________++M+____________________+<___________+___________________________________________________________________++______________________________+__+__________<_____________M__________________________________________________________________________________________________________________________________________________________________________<+++____________________________________________________________________________<_________________________+<+_________________________________________________________________________________________________+____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+<++________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+_______________________+_______________________________________________________________________________________________________^+___________________+++<___________________________________________________________________________________________________________________________________________________+___________________________________________________________________________________________________________________________________________________________________________________________+________________+_______________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+____________________________________________________________________________________+_____________________________________________________+_____<__________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+++________________________________________________________________________________________________________________________________________________________________________+____________________________<____+____________________________________________________________________________________________________________________________________M____________________________________________________________________________+__________________________+++<<++____________________________________________+________________________________+_____+<+<_____________________________________________________________________________________________________________________________________________+____________________________________________________+____________________________________________________________________________________________________________+M++____________M________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________<____________________________________________________________________________________________________________________________________________________________________________________________<______________________<^+__________________<_______________________+________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________^_________________________________________________++<__________________________________________________________________________________________________________________________________________________________________________+_______________________________________________________________________________________________________________________________________________________________+_____________________________________________________________________________________________________________________________________++________________________________________+______________________________________________________________________________________________________________________________________________________M+<________++<+_______________________________________________________________________________________________________________+_________________<________________________________________________________________________<+<<+___________________+<____________________________<+^_____________________________________________________________________________________________________________________________________________________________________________________+_____________________________________________________________________+______________________________________________________________________________________________________________________+_____________________________________________________________________________________________+<++______________+<o++_________________+M____________________________________________________________________________________________________________________________________________________________________+_______________________________________________________________________________________________________++<__________________+_+++______________________________________^____________________________________________________________+_____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+++____________________________<________+______________________________________________________________________________+_________________________________________________________M<+__________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+____________________________________________________+__________________________________________________________________________________________________________________________________________________________________________________________________++^_____________________________________________________________________________________________________________________________________________________________________________________________________________________<______________________________________________________________________________________<______________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+_________________________________________++__M__________________________________________________________________________________________________+<______________+_________M______________________________________________________________+++<___________________________________________________________________________________________________________________________________________________________________________________________+____________________________________________________________________________________________________________+++____________________________________________________+_____+________________+_______++____________+________________________________++^<^____++______________________________________________________+_____________________________________+++<<<_______________________________________________________________________++++___+++<________________________________________________________________________________________________________________________________________________________________________________________________________________________________M_______________________________________________________________________________________________________________________________________________________________+______________________________________________________________________________+_________________________________+___________________________<M<+____________________<____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+_____________________________________________________________________________________________________________________________+__________+M<+____________+________________________________________________________________________________________________________________+________________________________________________________________________<+++__________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________^MM+______________________________________________________________________________________________________________________________________________________________________________________________________________________________________+_________________________________________________________________________________________________________________+____+____________________________________________________________________________________________________+__________________________________________________________________________________________+<<+___________________________________________________________________________________________________________________________________________________________+___________________________++_____________________+____________+_______________________________________________________+_______________________<_________________________________________________________________________++<____________________________________________________________________________________________________________________________________________________________________________________________o________________________________________________+++___________________________________________________<___++______________________________________________________________________________________________________________________________________________________________________________<_______________________+___________________________<_______________________________________________________________________________________________________________________<__________+<_______________________+<____________________________________<^<<_____________+_____________________<___<___________________________________________________________________________________________________________+M<_________________________________________________+__________________________________________M^_____________________________________________________________________________________+<____________________________________________++<+______________________________________________________________________________________________________________<M<+_______________________+__________________________________________________________________________________________________________________________________________________________MM+_____________________________________________________________<++++____++<___________________________________________________________________________________________________________________________________________________________________<^+________________oM<+_________________________________________________________________________________<<M++__________________________________________________________________________________________________________________________________+__+<+____________________________M<_+___+++M______________________+____________________________________+__________________________________________________________<++^<<______________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________<____+_________________________________________________________________________________++++<+__________________________________________M++_________________________________________________________________________________________________________________________________+_____________________________________________________________________________________________________+____________________________________________________________________________________________________________________________________________________________________________________________+___________________________________________________________________________________________________________________________________________________________________________________________________________________+________________________________________________________________________________________________+__________________________________________________________________________________________++__________________+_______________________________________________________________________________________________________________________________________________M__________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________<_____________________________________________________<M<+______________________________+_____________________________________________________________________________+______________________+<<+__________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+__________+<+__________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+++_____________________________________________________________________________________________________________________________________++++<_________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+++<+______________________________________________________________________++<__+__________________________________________________________+++++_________________________________________________________________________________________________________________________________________________________________________________________________________________________________+___________________________________M+_______________________________________________________________________________________________________________________________________________________________________________________________________________________________________+________________________________________________________________________<______________________________________________________________________________________________________________________________^_____M___________________________________________________________++_________________________________________________________________________________________________________________________________________________________________________________________________________________________+_______________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________<+<++M+______________________________________________________________________++___________+_________________________________________________________+______________++______________________________________________________________________<++M_______+_______+________________________+______________________________M++_______________________________________________________________________________________________________________________________________________________________________________________________<___________________________________________________+______________________________++____________________________________________________________________________________________________<______________+_____+++_________________________________________________+__________________________________________________________________________________________________________________________________+__________________________________________________________________________________________________________________________________________________________________________________________++________________________________________________________________________________+___________++__________________________________________________________________________________<++___________________________________________________________________________________________________________________________++M______________________+______________________________________________________________________________________________________________________________________________<______++__<__________________________________________________________________________________________________________________++++__________________________________________________________________________________________________________________+___________________________________________________________<______________________________+_______________________________________________________________________________________+<______<+M_______________________________________________++M<___<<<^______________________________________________________________________________________________________________________________________________++_____________+<________________________________________________________________________________________________________________________________________________________________________________________________________________++M_____________________________________________________________________________________________________________________________________________<___________________________________________________________________________+___________________________________________________________________<+++__________________++__________________________________+________________________________________________________________________________________________________________________<____________________________________________________________________________________+++___________________________________________________________________________________________________________________________+___________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+______________________________+________________________________________________________<___________________________________________________________________________________________________________________________________________________+___________________________________________<<+_________________________+___________________________________________________________________________________________________________<___________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________^+_______________________________________________________________________________________________________________<+++__________________<<+________________________________________________________________________________________________________+_______________________________________________________________________________________________________________________________________________________________________________________<______________________________________________________________________________________________________________________________________________________________________________+___________________________________________________________________<________________________+______________________________________________________________________________________________________________________________________<_____________________________+_________M_____________________________________________________________________________________________________________________________________________________^++++______________________________________________________________________________________________________________________________________________________________<_______________+++____M____M+___________________________________________________________________________________________________+_________________________________________________________________________________________________________________________________________________+<________________________________________________________________________________________________________________________________________^+________________________________________________________________________+_________________________<__+_________________________________________________________________________++<________________________________________________________________________________________________________+++________________________________________________________________________+<+________________^___________________________________________________+________________________________________________________________<M_____________________________________________________________________________________________________________________________________________________________________________________________________________________________________++<___________________+__+<______________________+_____________________________________________________________________+__________________+___________________________________________________________________________+__________________________________________________________________________________________________+______________________________________________________________________________________________________________________________________________________________________________+_______________________________________________________________+<______________________________________________________________________________________________________________________________________________________________+_____________________________________________________________________________________________________________________________<___________________________________________________________________________________________________+________________________________________________________________________________________________________________________<______________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+______________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________++++______________________________________________________________________________________________________________________________________________________________________________________________________________________________+<<+________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+______________________________________+_____________+_____________________________________________________________________________________________________________________________________________________________________________________________________________________<___________________________________________________________________________________________________________________+++<_________________________________________________________________<__________________________________________________________M+<+________________________________________________M+<+<<<<<_____________________________________________<_________________________________________________________________________________________________________++______________________________________________^______________________________<M+______________________<_________________________________________________________________________________+_________________________________________________________________________________________________________________________________________________________________________________+++________________________________________________________________________________________________________________________________________________________________________________________________________________________________________<<________________________________________________+<____________________________________________________________________________+++____________________________________________________________________________________________________________<_____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+++++<o++<+_____________<<++______^_________________________________________________________________________________________<_______________________________________________________________________________________________________________________________________________________________+++_____M++___________++++<____________<<+<++____________________________________+<M___________________________________________________________________^++____+__________________________________________________________++<+<____M____________________o_________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________<++_______________________________________________________________________________________________________________________________________________________________________________________++<<________________________________________________+<________________<_____+____<____________________________________________________________________________________________________________________<____________________________<___________________________________________________________________________________________________________________________________________________________________________________________________<<____________________________________________________________________________________________________________________________<++++^______________________________________________________________________________________________________________________________________________________________________________________________________o________________________________________________________+<_____++<+<_________________________________+____+___________________________________________+_______++________________________________________________________M____________+_________________________________________<________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________M+<_____________________________________________________________________________________M_______+_____________________________________________________+___+_______________________________________++<________________________________________________+____________________________M_______________________________________________________________________________________+_________________________________________________________________________________________+_________________________+__________<+<_______________________<______________________________________________________<____________________________________________________________________________________________________________________________________________<_____________________________________________________________________+<+<________+++_____<__________________+______________________________________________________________________________________________________________________+______________________________________________________________________________________________________________________________________________+MM_________________________________________________________________________________+________________________________________________________________M__________________________________________________________+++_________________________________________________________________________+++<___<__________________________________________<_________________________________________________________+__<_________+___________________________________________________________________________________________________________+____________________________________+++_________________________________________________________________________________________________________________________________________________________<+<o^__________________________________________________________________________________+M+<<+___________________________________________________________________________+__________________________________________________________________________________________________________________+______________________________________________________________________<_____________________________________________________________________M___________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________<___________________________++__________________________________________+___________________________________________+___________________________________________________________<<+_________________________________________________________________________________________________________________________________________________<____________________________________________________________<_________________________________________________________________________________________________________________________________________________+____________<_________________________________++<^_____________+<++___________________________________________________<_______+______________________________________+________________________________________________________________________________+________________________________________________________________________________________________________________________________________________________________________________M_________________________________________________________________________________________________________________+M<____<_______________+_________<+++___________________________________________________________________________MM+<______M___________________________________+__________________________<_____________+______________++__<_____________________________________________________________________________________M_____________________________________________________________________________________________________________________++_____________________________________________________________+______________________________________________________________+_____________________________________________________________________________________________________________+_______________________+_____+_________________________________________________________________________+<M^________________________________________________________________________________________________________________________________________________________________________+_______________________________<<++________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+__________________________________<_____________________________________________________________________________________+<++_____________________+______________________++___________+_____________________________________________+____M+<+__________+<_____________________________+M______________________________________<___________________________________________________________________________________________________________++___________________________________________________________________________________________________________________+__________________________________________________________________<++_____________________________<^+___________________________________________________<+________________________++_________+___________________________________________________________++<_________________________________________________________________M<_______________________________________________________________________________________<______+____________________________________________________________________________________+_________________________+++_______________________________________________________________________________________________________________________________________________________________________+______________________________________M__________________________________________________________________________________________________________________________________________________________________________________++M<________________________________________________________________________________________________________________________________________________________+_______________________________________________________________________________________________________________________+________+_____________________________________+______________________________________________________________________________________________________________________________________________________________________________________________________________++<_____+________________________________________________________________________________________________________<____________________________<__________________________________________________________________________________________M+++____________________________________________________________________________________________________________________________________________________________________________________________________________________+____________________________________________________________________________________________<++++_________________________________________________________________________________________________+___________________________________+________________________________________________________________________________________________________________________________________________________________+____________________________________+_________+<++M++________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+_______________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________+__________________________________________________________________M++____________________________________________________________