abstreet/rustdoc/abstio/index.html
2021-08-16 23:14:58 +00:00

38 lines
14 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="A/B Street organizes data files in a particular way. This crate implements methods to find files and (mostly) treat them the same way on native and web."><meta name="keywords" content="rust, rustlang, rust-lang, abstio"><title>abstio - Rust</title><link rel="stylesheet" type="text/css" href="../normalize.css"><link rel="stylesheet" type="text/css" href="../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../light.css" id="themeStyle"><link rel="stylesheet" type="text/css" href="../dark.css" disabled ><link rel="stylesheet" type="text/css" href="../ayu.css" disabled ><script id="default-settings"></script><script src="../storage.js"></script><script src="../crates.js"></script><noscript><link rel="stylesheet" href="../noscript.css"></noscript><link rel="icon" type="image/svg+xml" href="../favicon.svg">
<link rel="alternate icon" type="image/png" href="../favicon-16x16.png">
<link rel="alternate icon" type="image/png" href="../favicon-32x32.png"><style type="text/css">#crate-search{background-image:url("../down-arrow.svg");}</style></head><body class="rustdoc mod crate"><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu" role="button">&#9776;</div><a href='../abstio/index.html'><div class='logo-container rust-logo'><img src='../rust-logo.png' alt='logo'></div></a><h2 class="location">Crate abstio</h2><div class="block version"><p>Version 0.1.0</p></div><div class="sidebar-elems"><a id="all-types" href="all.html"><p>See all abstio's items</p></a><div class="block items"><ul><li><a href="#modules">Modules</a></li><li><a href="#structs">Structs</a></li><li><a href="#functions">Functions</a></li></ul></div><div id="sidebar-vars" data-name="abstio" data-ty="mod" data-relpath=""></div><script defer src="sidebar-items.js"></script></div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!" aria-haspopup="menu" title="themes"><img src="../brush.svg" width="18" height="18" alt="Pick another theme!"></button><div id="theme-choices" role="menu"></div></div><nav class="sub"><form class="search-form"><div class="search-container"><div><select id="crate-search"><option value="All crates">All crates</option></select><input class="search-input" name="search" disabled autocomplete="off" spellcheck="false" placeholder="Click or press S to search, ? for more options…" type="search"></div><button type="button" id="help-button" title="help">?</button><a id="settings-menu" href="../settings.html" title="settings"><img src="../wheel.svg" width="18" height="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><h1 class="fqn"><span class="in-band">Crate <a class="mod" href="#">abstio</a><button id="copy-path" onclick="copy_path(this)" title="copy path"><img src="../clipboard.svg" width="19" height="18" alt="Copy item import" title="Copy item import to clipboard"></button></span><span class="out-of-band"><span id="render-detail"><a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">[<span class="inner">&#x2212;</span>]</a></span><a class="srclink" href="../src/abstio/lib.rs.html#1-40" title="goto source code">[src]</a></span></h1><details class="rustdoc-toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>A/B Street organizes data files <a href="https://a-b-street.github.io/docs/tech/dev/data.html">in a particular
way</a>. This crate implements methods to
find files and (mostly) treat them the same way on native and web.</p>
</div></details><h2 id="modules" class="section-header"><a href="#modules">Modules</a></h2>
<table><tr class="module-item"><td><a class="mod" href="abst_data/index.html" title="abstio::abst_data mod">abst_data</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="mod" href="abst_paths/index.html" title="abstio::abst_paths mod">abst_paths</a></td><td class="docblock-short"><p>Generate paths for different A/B Street files</p>
</td></tr><tr class="module-item"><td><a class="mod" href="download/index.html" title="abstio::download mod">download</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="mod" href="http/index.html" title="abstio::http mod">http</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="mod" href="io/index.html" title="abstio::io mod">io</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="mod" href="io_native/index.html" title="abstio::io_native mod">io_native</a></td><td class="docblock-short"><p>Normal file IO using the filesystem</p>
</td></tr></table><h2 id="structs" class="section-header"><a href="#structs">Structs</a></h2>
<table><tr class="module-item"><td><a class="struct" href="struct.CityName.html" title="abstio::CityName struct">CityName</a></td><td class="docblock-short"><p>A single city is identified using this.</p>
</td></tr><tr class="module-item"><td><a class="struct" href="struct.DataPacks.html" title="abstio::DataPacks struct">DataPacks</a></td><td class="docblock-short"><p>Player-chosen groups of files to opt into downloading</p>
</td></tr><tr class="module-item"><td><a class="struct" href="struct.Entry.html" title="abstio::Entry struct">Entry</a></td><td class="docblock-short"><p>A single file</p>
</td></tr><tr class="module-item"><td><a class="struct" href="struct.FileWithProgress.html" title="abstio::FileWithProgress struct">FileWithProgress</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="struct" href="struct.Manifest.html" title="abstio::Manifest struct">Manifest</a></td><td class="docblock-short"><p>A list of all canonical data files for A/B Street thatre uploaded somewhere. The file formats
are tied to the latest version of the git repo. Players use the updater crate to sync these
files with local copies.</p>
</td></tr><tr class="module-item"><td><a class="struct" href="struct.MapName.html" title="abstio::MapName struct">MapName</a></td><td class="docblock-short"><p>A single map is identified using this.</p>
</td></tr></table><h2 id="functions" class="section-header"><a href="#functions">Functions</a></h2>
<table><tr class="module-item"><td><a class="fn" href="fn.delete_file.html" title="abstio::delete_file fn">delete_file</a></td><td class="docblock-short"><p>Idempotent</p>
</td></tr><tr class="module-item"><td><a class="fn" href="fn.download_bytes.html" title="abstio::download_bytes fn">download_bytes</a></td><td class="docblock-short"><p>Downloads bytes from a URL. This must be called with a tokio runtime somewhere. The caller
creates an mpsc channel pair and provides the sender. Progress will be described through it.</p>
</td></tr><tr class="module-item"><td><a class="fn" href="fn.download_to_file.html" title="abstio::download_to_file fn">download_to_file</a></td><td class="docblock-short"><p>Download a file from a URL. This must be called with a tokio runtime somewhere. Progress will
be printed to STDOUT.</p>
</td></tr><tr class="module-item"><td><a class="fn" href="fn.file_exists.html" title="abstio::file_exists fn">file_exists</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="fn" href="fn.find_next_file.html" title="abstio::find_next_file fn">find_next_file</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="fn" href="fn.find_prev_file.html" title="abstio::find_prev_file fn">find_prev_file</a></td><td class="docblock-short"><p>Keeps file extensions</p>
</td></tr><tr class="module-item"><td><a class="fn" href="fn.http_get.html" title="abstio::http_get fn">http_get</a></td><td class="docblock-short"><p>Performs an HTTP GET request and returns the raw response. Unlike the variations in
download.rs, no progress but it works on native and web.</p>
</td></tr><tr class="module-item"><td><a class="fn" href="fn.http_post.html" title="abstio::http_post fn">http_post</a></td><td class="docblock-short"><p>Performs an HTTP POST request and returns the response.</p>
</td></tr><tr class="module-item"><td><a class="fn" href="fn.list_all_objects.html" title="abstio::list_all_objects fn">list_all_objects</a></td><td class="docblock-short"><p>Just list all things from a directory, return sorted by name, with file extension removed.</p>
</td></tr><tr class="module-item"><td><a class="fn" href="fn.list_dir.html" title="abstio::list_dir fn">list_dir</a></td><td class="docblock-short"><p>Returns full paths</p>
</td></tr><tr class="module-item"><td><a class="fn" href="fn.load_all_objects.html" title="abstio::load_all_objects fn">load_all_objects</a></td><td class="docblock-short"><p>Load all serialized things from a directory, return sorted by name, with file extension removed.
Detects JSON or binary. Filters out broken files.</p>
</td></tr><tr class="module-item"><td><a class="fn" href="fn.maybe_read_binary.html" title="abstio::maybe_read_binary fn">maybe_read_binary</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="fn" href="fn.maybe_read_json.html" title="abstio::maybe_read_json fn">maybe_read_json</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="fn" href="fn.must_read_object.html" title="abstio::must_read_object fn">must_read_object</a></td><td class="docblock-short"><p>May be a JSON or binary file. Panics on failure.</p>
</td></tr><tr class="module-item"><td><a class="fn" href="fn.parse_scenario_path.html" title="abstio::parse_scenario_path fn">parse_scenario_path</a></td><td class="docblock-short"><p>Extract the map and scenario name from a path. Crashes if the input is strange.</p>
</td></tr><tr class="module-item"><td><a class="fn" href="fn.path.html" title="abstio::path fn">path</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="fn" href="fn.path_all_edits.html" title="abstio::path_all_edits fn">path_all_edits</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="fn" href="fn.path_all_saves.html" title="abstio::path_all_saves fn">path_all_saves</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="fn" href="fn.path_all_scenarios.html" title="abstio::path_all_scenarios fn">path_all_scenarios</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="fn" href="fn.path_camera_state.html" title="abstio::path_camera_state fn">path_camera_state</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="fn" href="fn.path_edits.html" title="abstio::path_edits fn">path_edits</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="fn" href="fn.path_player.html" title="abstio::path_player fn">path_player</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="fn" href="fn.path_popdat.html" title="abstio::path_popdat fn">path_popdat</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="fn" href="fn.path_prebaked_results.html" title="abstio::path_prebaked_results fn">path_prebaked_results</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="fn" href="fn.path_raw_map.html" title="abstio::path_raw_map fn">path_raw_map</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="fn" href="fn.path_save.html" title="abstio::path_save fn">path_save</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="fn" href="fn.path_scenario.html" title="abstio::path_scenario fn">path_scenario</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="fn" href="fn.path_shared_input.html" title="abstio::path_shared_input fn">path_shared_input</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="fn" href="fn.print_download_progress.html" title="abstio::print_download_progress fn">print_download_progress</a></td><td class="docblock-short"><p>Print download progress to STDOUT. Pass this the receiver, then call download_to_file or
download_bytes with the sender.</p>
</td></tr><tr class="module-item"><td><a class="fn" href="fn.read_binary.html" title="abstio::read_binary fn">read_binary</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="fn" href="fn.read_json.html" title="abstio::read_json fn">read_json</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="fn" href="fn.read_object.html" title="abstio::read_object fn">read_object</a></td><td class="docblock-short"><p>May be a JSON or binary file</p>
</td></tr><tr class="module-item"><td><a class="fn" href="fn.slurp_bytes.html" title="abstio::slurp_bytes fn">slurp_bytes</a></td><td class="docblock-short"><p>An adapter for widgetry::Settings::read_svg to read SVGs using this crates methods for finding
and reading files in different environments.</p>
</td></tr><tr class="module-item"><td><a class="fn" href="fn.slurp_file.html" title="abstio::slurp_file fn">slurp_file</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="fn" href="fn.write_binary.html" title="abstio::write_binary fn">write_binary</a></td><td class="docblock-short"></td></tr><tr class="module-item"><td><a class="fn" href="fn.write_json.html" title="abstio::write_json fn">write_json</a></td><td class="docblock-short"></td></tr></table></section><section id="search" class="content hidden"></section><div id="rustdoc-vars" data-root-path="../" data-current-crate="abstio" data-search-index-js="../search-index.js" data-search-js="../search.js"></div><script src="../main.js"></script></body></html>