https://github.com/kevinvitale/anyservice
https://github.com/kevinvitale/anyservice
json rest-api restful swift
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/kevinvitale/anyservice
- Owner: KevinVitale
- Created: 2017-04-10T20:05:36.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2017-08-08T04:16:07.000Z (almost 9 years ago)
- Last Synced: 2025-03-26T18:51:57.252Z (over 1 year ago)
- Topics: json, rest-api, restful, swift
- Language: Swift
- Size: 3.91 KB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Define JSON clients with literal strings
The most easy-to-use JSON library ever.
## Creating clients
Create your JSON clients with just a string to the base URL.
### JSON Placeholder
```swift
let service: AnyService = "https://jsonplaceholder.typicode.com"
```
### Guild Wars 2
```swift
let gw2: AnyService = "https://api.guildwars2.com/v2"
```
## Fetching results
The callback returns _a throwable block, that returns a tuple_.
Simply invoke this throwable block, and then you can then inspect
either the JSON object returned, the `URLRequest`, or handle any errors.
### Fetch Example
```swift
let task = try gw2.fetch(endpoint: "items", "30694") { request in
do {
print("\(try request().0)")
} catch {
print("\(error)")
}
PlaygroundPage.current.finishExecution()
}
task.resume()
```
## Project Scope
My motivation was to create the simplest, most lightweight
JSON Swift client around. I limited the code to 80% of
what many developers need to fetch JSON.
Swift's powerful typing system could easily allow for a more
featureful, robust framework in the future. For example, I'd
like to explore defining services as a function of their type.
This could lead to something that looks like:
- `AnyService`
- `AnyService`
- etc.
### License
Copyright **2017** — Kevin Vitale
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.