deprecate file_set_contents{,_full}

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

tools: replace_file, make options not an option...

CreateOptions::new() creates an all-None option set anyway

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

tools: introduce replace_file

nicer api with CreateOptions
see doc-comments for more info

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

drop derive-builder dependency

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

remove old router macro documentation

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: remove now-unnecessary PropertySchema type

Schemas can now generally refer to an externally defined
schema.

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: generalized '{ schema: PATH }' schemas

allow 'schema: PATH' outside object property context

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: support 'async fn' with new async api method

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

implement ApiHandler::Async

api: update url crate to 2.1

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

update bytes to 0.5

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

formatting fixup

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

updates for hyper 0.13 release

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

proxmox-api/src/cli.rs: simplify cli setup using generics.

proxmox-api/src/cli/format.rs - generate_nested_usage: fix formating with empty prefix

api: add 'router' and 'cli' features

Move API types into the router module and make router and
cli optional.

This way the 'router' module is the only thing with a
dependency on 'hyper', allowing the use of the schema alone
without pulling in the entire hyper stack.

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api: use http::{Parts,Response,Method}

hyper just reexports them

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

more clippy fixups

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

clippy fixups

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

formatting fixup

please run `make` to check formatting before committing

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

formatting fixup

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: allow methods without return types

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: don't return Null without return schema

serde_json turns () into Null anyway, so there's no need to
check this!

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: get enum description from doc comments

instead of:
    #[api(description: "Some description.")]
    pub enum { ... }

support:
    #[api]
    /// Some description.
    pub enum { ... }

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: move doc-comment reading to util

The function attribute reader doesn't read any other
attributes anymore, so make it reusable!

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api: let ConstRegexPattern deref to Regex

This way we can just use `SOME_REGEX.is_match()` again
without having to explicitly call `(SOME_REGEX.regex_obj)()`
first.

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: rename SimpleIdent to FieldName

Initially it was a wrapper around Ident to avoid some
copies, but now it's what we use to allow hyphenated names
for fields in objects (as `syn::Ident` doesn't allow that at
all), so give it a more fitting name.

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: support hyphenated parameter names

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: drop ToTokens for SimpleIdent

The user must be explicit about whether the ident or string
is required.

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: drop Deref of SimpleIdent

The user must always be explicit about whether the Ident or
the String is required, since they may differ.

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: fixup idents in SimpleIdent

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: remove Into<Ident> for SimpleIdent

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: allow referencing external schemas in properties

Reference a predefined BACKUP_ARCHIVE_NAME StringSchema like
this:
    #[api(
        input: {
            properties: {
                archive: {
                    optional: true,
                    schema: BACKUP_ARCHIVE_NAME,
                },
            }
        }
    )]
    fn get_archive(archive: String) -> Result<(), Error> {
        ...
    }

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

proxmox_api/src/format.rs - get_property_description: fix paragraph indention

proxmox-api/src/format.rs: improve docs

proxmox-api/src/format.rs: add missing docs

proxmox-api/src/cli/shellword.rs: re-export Quote from rustyline

proxmox-api/src/cli/completion.rs: add more tests

proxmox-api/src/cli/completion.rs: add help completion tests

proxmox_api: add cli submodule (copied from proxmox-backup)

api-macro: allow inferring some types automatically

non-optional boolean, string and integer types can be
inferred from the function

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: test optional value invocation

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: allow skipping `input` schema

when there are no parameters

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: add test with no parameters

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: allow 'bool' and rust int types

in place of Boolean and Integer

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: make return schema optional

and support returning () from methods

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

proxmox-api: fix text_wrap() - use join instead of concat (separate by newlines)

api-macro: some more test code

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: fixup

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: cleanup

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: parse serde(rename) on enums

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: experimental enum support

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: support defining schemas for structs

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: support external types

See the test example:

assuming a `pub struct Foo` which implements `Serialize` and
`Deserialize`, we also expect it to provide a
`pub const Foo::API_SCHEMA: &Schema` like so:

    #[derive(Deserialize, Serialize)]
    pub struct StrongString(String);
    impl StrongString {
        pub const API_SCHEMA: &'static Schema =
            &StringSchema::new("Some generic string")
                .format(&ApiStringFormat::Enum(&["a", "b"]))
                .schema();
    }

Then we can use:

    #[api(
        input: {
            properties: {
                arg: { type: StrongString },
            }
        },
        ...
    )]
    fn my_api_func(arg: StrongString) -> Result<...> {
        ...
    }

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: tests: remove #![allow(dead_code)]

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: match the item type early

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: move method handling to api/method.rs

We may want to add the ability to declare a Schema for
structs, so factorize function handling into its own file.

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: update tests, cleanup some macro generated paths

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: convert function output to a json value

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: minor improvements

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: reduce code output a little

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: start actually extracting parameters

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: begin and explain the parameter mapping strategy

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: start looking at function parameter types

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: start checking some function signature parts

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: parse properties as attributes to #[api]

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-amcro: expose JSONObject::parse_inner as Parser

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: JSONValue to bool shortcut

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: factor out inner parser of JSONObject

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: test: add 'protected' attribute

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

sortable-macro: fixup handle_error

Error cases need to include the original code in order for
the compiler to properly show the problematic code pointed
to by the Spans used in the compile_error!() output macro.

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: refactoring: split api macro function

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: move json part to util module

The json value type is more of an intermediate step between
the TokenStream and the Schema type and should stay somewhat
independent of it. We may want to reuse it for the router?

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: remove old unused files

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: fix section iteration

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: understand a 'Returns:' section in function doc comments

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: correctly concatenate doc macros

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: make type optional in some cases

Objects and arrays are now optionally identified by their
'properties' or 'items' property if their 'type' is left
out.

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: trim doc-comment when used as description

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api-macro: rename elements to properties

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

replace builder-pattern api macro parser with json

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

run 'cargo fmt -- --check' in check target

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

formatting fixup

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

proxmox_api: improve ApiStringFormat docs

proxmox-api: rename ApiStringFormat::Complex into ApiStringFormat::PropertyString

proxmox-api: improve schema docs

proxmox-api: improve schema docs

proxmox-api: further doc improvements

proxmox-api: improve router docs

proxmox-api - improve Router docs

proxmox-api: move impl ApiMethod to lib.rs

const_regex: fixup for previous commit

proxmox-api: further cleanups

- improve docs
- move  ConstRegexPattern to const_regex.rs

proxmox-api/src/lib.rs: hide modules with inlined docs

proxmox_api - ApiHandler: rename Async into AsyncHttp

And improve docs.

import a first draft of api macros

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api: simplify ApiAsyncHandlerFn

api: add format module

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api: fully qualify types in exported macros

and move const_regex macro into a separate module

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>

api: move ApiMethod from router to top level

Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com>