From a999a42a00a5466a1db189ef6a2147ff35a21b7e Mon Sep 17 00:00:00 2001 From: rferee Date: Tue, 13 Sep 2022 19:32:23 +0300 Subject: [PATCH] Create README.md --- README.md | 87 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 87 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..dcbcc2c --- /dev/null +++ b/README.md @@ -0,0 +1,87 @@ +# Is Odd API + +*This ๐Ÿ‘ˆ is ๐Ÿ…ฑ๐Ÿ’ฐ a ๐Ÿ simple API that ๐Ÿ‘ returns ๐Ÿ’Œ whether ๐Ÿ“Š๐Ÿ“Š a ๐Ÿ”ฅ number ๐Ÿ’ฆ๐Ÿ”ข is ๐Ÿ™ˆ๐Ÿ’ฆ odd ๐Ÿคฅ or ๐Ÿ’ฐ not. โ™‚ With ๐Ÿ‘๐Ÿ‘ผ this ๐Ÿฝ๐Ÿ‘ˆ API you ๐Ÿ˜ญ๐Ÿ’„ can ๐Ÿ’๐Ÿ”ซ check โœ” if โ— a number โค is ๐Ÿ’ฆ odd ๐Ÿคฅ or not. ๐Ÿ™…*\ +*However, ๐Ÿ’ฏ there's a ๐Ÿ’ฐ๐Ÿ˜พ twist ๐Ÿ”„๐Ÿ”„...* + +Implementation in Java (v1.0): [by rferee](https://github.com/rferee/is-odd-api) + +## Features ๐Ÿ“Š + +- Even more ๐Ÿ˜ณ blazing ๐Ÿ”ฅ๐Ÿ”ฅ fast ๐Ÿƒ๐Ÿƒ! +- Even more ๐Ÿ”ฅ scalable ๐Ÿ“ˆ๐Ÿ“ˆ! +- Even more ๐ŸŽจ native ๐Ÿ‡บ๐Ÿ‡ธ๐Ÿ‡บ๐Ÿ‡ธ support ๐Ÿ‡บ๐Ÿ‡ธ๐Ÿ‡บ๐Ÿ‡ธ for ๐Ÿ‡บ๐Ÿ‡ธ๐Ÿ‡บ๐Ÿ‡ธ all ๐Ÿ‡บ๐Ÿ‡ธ๐Ÿ‡บ๐Ÿ‡ธ operating ๐Ÿ‡บ๐Ÿ‡ธ๐Ÿ‡บ๐Ÿ‡ธ systems ๐Ÿ‡บ๐Ÿ‡ธ๐Ÿ‡บ๐Ÿ‡ธ! +- More than ๐Ÿซฃ 100% ๐Ÿ“ˆ๐Ÿ“ˆ uptime ๐Ÿ“ˆ๐Ÿ“ˆ! +- More than ๐Ÿซ  100% ๐Ÿ’ฏ vegan ๐ŸŒฑ๐ŸŒฑ๐ŸŒฑ! + +*...and ๐Ÿ‘ much ๐Ÿ™ˆ๐Ÿ’ฆ more!* + +###### *This description was generated by GitHub Copilot ๐Ÿค–* + +## Requirements ๐Ÿ“‹ + +### Example ๐Ÿค” System โœŠโœŠ Configuration ๐Ÿ–ฅ + +We are performing tests right now. + +## Screenshots ๐Ÿ“ท + +Current usage for ๐Ÿ‘ `is-odd-api-dev` is: ๐Ÿ—ก +To be added + +## API Methods ๐Ÿ“ก + +### `/isEven/{number}` + +Can be ๐Ÿ˜ฑ๐Ÿ used to ๐Ÿ’ฆ๐Ÿ˜‚ determine ๐Ÿค” whether or ๐Ÿ…ฑ not ๐Ÿšซโ™‚ the ๐Ÿ‘๐Ÿ‘ฝ number is ๐Ÿ“ƒ even. ๐Ÿ†—๐ŸŒƒ + +**Returns:** [`ResponseNotFound`](#responsenotfound) ๐Ÿ˜ณ or [`ResponseIsEven`](#responseiseven) ๐Ÿ“Š + +### `/isOdd/{number}` + +Can ๐Ÿ”ซ๐Ÿ’ฆ be used ๐Ÿ™„๐Ÿ˜ to determine ๐Ÿง whether or ๐Ÿ”ฎ๐Ÿ’ฆ not โŒ the ๐Ÿ‘ number ๐Ÿ’ฆ๐Ÿ˜ง is odd. ๐Ÿคฅ๐Ÿ˜œ + +**Returns:** [`ResponseNotFound`](#responsenotfound) or [`ResponseIsOdd`](#responseisodd) + +### `/lastEven` + +**Returns:** last โณ indexed ๐Ÿ”Ž even ๐ŸŽญ number ๐Ÿ’ฆ๐Ÿ”ข + +### `/lastOdd` + +**Returns:** last โณ indexed ๐Ÿ”Ž odd ๐Ÿคจ number ๐Ÿ’ฆ๐Ÿ”ข + +## API Objects ๐Ÿ“ฆ + +### `ResponseIsOdd` + +Property `odd` ๐Ÿ˜œ will ๐Ÿ“ƒ be `true` if `{number}` ๐Ÿ’ฆ๐Ÿ’ฆ is ๐Ÿ˜ณ odd ๐Ÿ˜œ and ๐Ÿ—ฃ๐Ÿ‘ `false` if ๐Ÿ‘ `{number}` is ๐Ÿ™ˆ even. + +```json +{ + "odd": true +} +``` + +### `ResponseIsEven` + +Property `even` ๐Ÿ’๐ŸŒƒ will be `true` โญโ˜‘ if ๐Ÿšซ๐Ÿคฅ `{number}` ๐Ÿ”ข is even and ๐Ÿ‘๐Ÿ‘ `false` ๐Ÿ‘ณโŒ if ๐Ÿ‘ `{number}` is ๐Ÿ˜ณ odd. + +```json +{ + "even": true +} +``` + +### `ResponseNotFound` + +Returns when ๐Ÿ˜ค๐Ÿ•” the ๐Ÿ‘ฉ number wasn't indexed yet. ๐Ÿ‘Œโ— + +```json +{ + "message": "This number is not indexed yet." +} +``` + +## Liability ๐Ÿ“œ and ๐Ÿ‘ Disclaimer ๐Ÿ“œ + +This ๐Ÿ‘ฉ๐Ÿ˜ฌ is ๐Ÿ‘ a ๐Ÿ˜‚๐Ÿคก joke project. โฌ† We ๐Ÿ‘ง decided to ๐Ÿ’ฆ rent out ๐Ÿ’ฏ the ๐Ÿš€๐Ÿผ machine ๐Ÿ’ฆ with ๐Ÿ˜ฒ๐Ÿ™… more โž•๐Ÿ˜– than โฌ†๐Ÿ˜ฝ a 1 TB of ๐Ÿฒ RAM ๐Ÿ‘‹ and 96 cores of ๐Ÿฒ CPU ๐Ÿ–ฅ to ๐Ÿ‘ index ๐Ÿ“Š๐Ÿ“Š all ๐Ÿ™ˆ๐Ÿ’ฆ numbers ๐Ÿ“Š๐Ÿ“Š from 1 โ™‚๐Ÿ‘ต to ๐Ÿ‘ `long` โ™‚๐Ÿ‘ต maximum. ๐Ÿ“Š๐Ÿ“Š