Add basic functionality to read indexed FASTA files (continued) (#214)

* Cherry pick the pull request for faidx

#165 (review)

* Cargo formatting

* Update faidx documentation for clarification

* Implement faidx_open test

* Run actions on faidx branch

* Remove faidx from github actions

* Activate CI for faidx branch

* update osx bindings with faidx support

* update linux bindings for faidx

* Drop faidx branch from CI actions

As requested by @brainstorm (see #214 (comment))

* Migrate faidx to use thiserror instead of snafu (#214 (comment))

* Use i64 in faidx and return byte array

Internal C method faidx_fetch_seq64 uses i64 as type to index into large FASTA
sequences.
The fetch function now returns a byte array instead of a String to be more
efficient.
A new method was added to automatically convert to a String for convenience.

* Formatting using cargo fmt

* Use usize-type for position paramter in faidx

The return type of the faidx functions is changed to a Result
capturing a potential failure in converting the usize
into a i64 (hts_pos_t in the C API).

* Correct typo in faidx-error: to -> too

Co-authored-by: Patrick Marks <pmarks@gmail.com>
Co-authored-by: Patrick Marks <patrick@10xgenomics.com>
Co-authored-by: Roman Valls Guimera <brainstorm@users.noreply.github.com>

Author: 3 people

.github/workflows/rust.yml

@@ -104,4 +104,4 @@ jobs:
         with:
           use-cross: true  
           command: build
-          args: --target x86_64-unknown-linux-musl --all-features
+          args: --target x86_64-unknown-linux-musl --all-features

hts-sys/linux_prebuilt_bindings.rs

@@ -11239,6 +11239,158 @@ fn bindgen_test_layout_kbitset_iter_t() {
         )
     );
 }
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct __faidx_t {
+    _unused: [u8; 0],
+}
+pub type faidx_t = __faidx_t;
+pub const fai_format_options_FAI_NONE: fai_format_options = 0;
+pub const fai_format_options_FAI_FASTA: fai_format_options = 1;
+pub const fai_format_options_FAI_FASTQ: fai_format_options = 2;
+pub type fai_format_options = u32;
+extern "C" {
+    pub fn fai_build3(
+        fn_: *const ::std::os::raw::c_char,
+        fnfai: *const ::std::os::raw::c_char,
+        fngzi: *const ::std::os::raw::c_char,
+    ) -> ::std::os::raw::c_int;
+}
+extern "C" {
+    pub fn fai_build(fn_: *const ::std::os::raw::c_char) -> ::std::os::raw::c_int;
+}
+extern "C" {
+    pub fn fai_destroy(fai: *mut faidx_t);
+}
+pub const fai_load_options_FAI_CREATE: fai_load_options = 1;
+pub type fai_load_options = u32;
+extern "C" {
+    pub fn fai_load3(
+        fn_: *const ::std::os::raw::c_char,
+        fnfai: *const ::std::os::raw::c_char,
+        fngzi: *const ::std::os::raw::c_char,
+        flags: ::std::os::raw::c_int,
+    ) -> *mut faidx_t;
+}
+extern "C" {
+    pub fn fai_load(fn_: *const ::std::os::raw::c_char) -> *mut faidx_t;
+}
+extern "C" {
+    pub fn fai_load3_format(
+        fn_: *const ::std::os::raw::c_char,
+        fnfai: *const ::std::os::raw::c_char,
+        fngzi: *const ::std::os::raw::c_char,
+        flags: ::std::os::raw::c_int,
+        format: fai_format_options,
+    ) -> *mut faidx_t;
+}
+extern "C" {
+    pub fn fai_load_format(
+        fn_: *const ::std::os::raw::c_char,
+        format: fai_format_options,
+    ) -> *mut faidx_t;
+}
+extern "C" {
+    pub fn fai_fetch(
+        fai: *const faidx_t,
+        reg: *const ::std::os::raw::c_char,
+        len: *mut ::std::os::raw::c_int,
+    ) -> *mut ::std::os::raw::c_char;
+}
+extern "C" {
+    pub fn fai_fetch64(
+        fai: *const faidx_t,
+        reg: *const ::std::os::raw::c_char,
+        len: *mut hts_pos_t,
+    ) -> *mut ::std::os::raw::c_char;
+}
+extern "C" {
+    pub fn fai_fetchqual(
+        fai: *const faidx_t,
+        reg: *const ::std::os::raw::c_char,
+        len: *mut ::std::os::raw::c_int,
+    ) -> *mut ::std::os::raw::c_char;
+}
+extern "C" {
+    pub fn fai_fetchqual64(
+        fai: *const faidx_t,
+        reg: *const ::std::os::raw::c_char,
+        len: *mut hts_pos_t,
+    ) -> *mut ::std::os::raw::c_char;
+}
+extern "C" {
+    pub fn faidx_fetch_nseq(fai: *const faidx_t) -> ::std::os::raw::c_int;
+}
+extern "C" {
+    pub fn faidx_fetch_seq(
+        fai: *const faidx_t,
+        c_name: *const ::std::os::raw::c_char,
+        p_beg_i: ::std::os::raw::c_int,
+        p_end_i: ::std::os::raw::c_int,
+        len: *mut ::std::os::raw::c_int,
+    ) -> *mut ::std::os::raw::c_char;
+}
+extern "C" {
+    pub fn faidx_fetch_seq64(
+        fai: *const faidx_t,
+        c_name: *const ::std::os::raw::c_char,
+        p_beg_i: hts_pos_t,
+        p_end_i: hts_pos_t,
+        len: *mut hts_pos_t,
+    ) -> *mut ::std::os::raw::c_char;
+}
+extern "C" {
+    pub fn faidx_fetch_qual(
+        fai: *const faidx_t,
+        c_name: *const ::std::os::raw::c_char,
+        p_beg_i: ::std::os::raw::c_int,
+        p_end_i: ::std::os::raw::c_int,
+        len: *mut ::std::os::raw::c_int,
+    ) -> *mut ::std::os::raw::c_char;
+}
+extern "C" {
+    pub fn faidx_fetch_qual64(
+        fai: *const faidx_t,
+        c_name: *const ::std::os::raw::c_char,
+        p_beg_i: hts_pos_t,
+        p_end_i: hts_pos_t,
+        len: *mut hts_pos_t,
+    ) -> *mut ::std::os::raw::c_char;
+}
+extern "C" {
+    pub fn faidx_has_seq(
+        fai: *const faidx_t,
+        seq: *const ::std::os::raw::c_char,
+    ) -> ::std::os::raw::c_int;
+}
+extern "C" {
+    pub fn faidx_nseq(fai: *const faidx_t) -> ::std::os::raw::c_int;
+}
+extern "C" {
+    pub fn faidx_iseq(
+        fai: *const faidx_t,
+        i: ::std::os::raw::c_int,
+    ) -> *const ::std::os::raw::c_char;
+}
+extern "C" {
+    pub fn faidx_seq_len(
+        fai: *const faidx_t,
+        seq: *const ::std::os::raw::c_char,
+    ) -> ::std::os::raw::c_int;
+}
+extern "C" {
+    pub fn fai_parse_region(
+        fai: *const faidx_t,
+        s: *const ::std::os::raw::c_char,
+        tid: *mut ::std::os::raw::c_int,
+        beg: *mut hts_pos_t,
+        end: *mut hts_pos_t,
+        flags: ::std::os::raw::c_int,
+    ) -> *const ::std::os::raw::c_char;
+}
+extern "C" {
+    pub fn fai_set_cache_size(fai: *mut faidx_t, cache_size: ::std::os::raw::c_int);
+}
 extern "C" {
     #[link_name = "\u{1}wrap_kbs_init2"]
     pub fn kbs_init2(ni: size_t, fill: ::std::os::raw::c_int) -> *mut kbitset_t;