Skip to content

Commit

Permalink
feat: release 1.0.0
Browse files Browse the repository at this point in the history
  • Loading branch information
Jakub-Vacek committed Jul 31, 2024
1 parent fad600f commit 613e1f1
Show file tree
Hide file tree
Showing 158 changed files with 16,332 additions and 2 deletions.
47 changes: 47 additions & 0 deletions .github/issue_template.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
# ! To prevent creating a duplicate, please check for previous issues before making a new one. !

## Issue Description

[To help us better understand the issue you are experiencing, please be as detailed as possible. Try to be as detailed as you can.]

## Steps to Reproduce

[Describe the steps you took to get into the issue. Bring back every step of the process, down to the last detail, including all of the inputs, outputs you anticipated, and results you achieved. This enables us to identify and solve the problem more quickly.]

1. Step 1
2. Step 2
3. ...

## Expected Behavior

[Give a detailed description of the desired behavior you aimed to achieve with the flow.]

## Actual Behavior

[Give a detailed description of the actual behavior.]

## Screenshots

[Provide us with screenshots of the faulty behavior if possible. With this, we can get a clearer picture of the issue.]

## Environment

[Please describe the environment in which the issue occurred.]

- **Operating System:**
- **Browser (if applicable):**
- **Version/Commit ID (if applicable):**

## Additional Information

[Please share any further details you may have that could lead to a solution to this problem.]

## Labels

[Mention any labels that you think are relevant to this issue, such as "bug," "enhancement," etc.]

## Assignees

[If there's a specific person or team responsible for addressing this issue, assign them here. If not, you can leave this section blank.]

---
38 changes: 38 additions & 0 deletions .github/pull_request_template.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
# !Make sure that your branch is based on the latest changes in the main/master branch before submitting the pull request.!

## Pull Request Description

[Please give us as much information as possible about the pull request you want us to approve. Please be as detailed as possible.]

## Related Issue

[Please add related issue.]

## Changes Made

[List the specific changes made in this pull request.]

- Change 1
- Change 2
- ...

## Screenshots

[If applicable, include screenshots that showcase the changes.]

# Checklist

- [ ] I have tested these changes locally.
- [ ] I have updated the documentation.
- [ ] My code follows our project's coding style.
- [ ] I have added/modified relevant tests.
- [ ] All existing tests are passing.
- [ ] I have rebased my branch on the latest main/master.

## Additional Information

[Please share any further details you may have.]

## Assignees

[If there's a specific person or team responsible for reviewing and merging this pull request, assign them here. If not, you can leave this section blank.]
12 changes: 12 additions & 0 deletions .github/workflows/test.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
name: Test SDK
on:
- push

jobs:
test:
runs-on: macos-latest
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Test
run: xcodebuild test -scheme FoxentrySdk -destination 'platform=iOS Simulator'
62 changes: 62 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
# Xcode
#
# gitignore contributors: remember to update Global/Xcode.gitignore, Objective-C.gitignore & Swift.gitignore

## User settings
xcuserdata/

## Obj-C/Swift specific
*.hmap

## App packaging
*.ipa
*.dSYM.zip
*.dSYM

## Playgrounds
timeline.xctimeline
playground.xcworkspace

# Swift Package Manager
#
# Add this line if you want to avoid checking in source code from Swift Package Manager dependencies.
# Packages/
# Package.pins
# Package.resolved
# *.xcodeproj
#
# Xcode automatically generates this directory with a .xcworkspacedata file and xcuserdata
# hence it is not needed unless you have added a package configuration file to your project
# .swiftpm

.build/

# CocoaPods
#
# We recommend against adding the Pods directory to your .gitignore. However
# you should judge for yourself, the pros and cons are mentioned at:
# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
#
# Pods/
#
# Add this line if you want to avoid checking in source code from the Xcode workspace
# *.xcworkspace

# Carthage
#
# Add this line if you want to avoid checking in source code from Carthage dependencies.
# Carthage/Checkouts

Carthage/Build/

# fastlane
#
# It is recommended to not store the screenshots in the git repo.
# Instead, use fastlane to re-generate the screenshots whenever they are needed.
# For more information about the recommended setup visit:
# https://docs.fastlane.tools/best-practices/source-control/#source-control

fastlane/report.xml
fastlane/Preview.html
fastlane/screenshots/**/*.png
fastlane/test_output
43 changes: 43 additions & 0 deletions CODE_OF_CONDUCT.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
# Contributor Covenant Code of Conduct

## Our Pledge

In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to make participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.

## Our Standards

Examples of behavior that contributes to creating a positive environment include:

- Using welcoming and inclusive language
- Being respectful of differing viewpoints and experiences
- Gracefully accepting constructive criticism
- Focusing on what is best for the community
- Showing empathy towards other community members

Examples of unacceptable behavior by participants include:

- The use of sexualized language or imagery and unwelcome sexual attention or advances
- Trolling, insulting/derogatory comments, and personal or political attacks
- Public or private harassment
- Publishing others' private information, such as a physical or electronic address, without explicit permission
- Other conduct which could reasonably be considered inappropriate in a professional setting

## Our Responsibilities

Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.

Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned with this Code of Conduct or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.

## Scope

This Code of Conduct applies within all project spaces, and it also applies when an individual is representing the project or its community in public spaces. Examples of representing a project or community include using an official project email address, posting via an official social media account, or acting as an appointed representative at an online or offline event.

## Enforcement

Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at [[email protected]](mailto:[email protected]). All complaints will be reviewed and investigated promptly and fairly.

All project team members are obligated to respect the privacy and security of the reporter of any incident.

## Attribution

This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.0, available at [https://www.contributor-covenant.org/version/2/0/code_of_conduct.html](https://www.contributor-covenant.org/version/2/0/code_of_conduct.html).
42 changes: 42 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
# Contributing to FoxentrySdk

Thank you for considering contributing to FoxentrySdk! We appreciate your efforts in helping to improve our project. Please take a moment to review this document for guidelines on how to contribute.

## Ways to Contribute

There are several ways you can contribute to this project:

- Reporting issues
- Suggesting enhancements
- Submitting pull requests for bug fixes or new features

## How to Contribute

### Reporting Issues

If you encounter any issues or bugs, please use the GitHub issue tracker to report them. When reporting issues, please provide as much detail as possible, including:

- A clear and descriptive title
- A detailed description of the issue
- Steps to reproduce the issue, if applicable
- Any relevant error messages or screenshots

### Suggesting Enhancements

If you have suggestions for enhancements or new features, please feel free to open an issue on GitHub. Please provide a clear and detailed description of your suggestion, including why you think it would be beneficial for the project.

### Submitting Pull Requests

We welcome pull requests for bug fixes, improvements, and new features. Before submitting a pull request, please ensure the following:

- Fork the repository and create a new branch for your changes.
- Make your changes, and provide clear and descriptive commit messages.
- Test your changes thoroughly.
- Ensure that your code follows the existing coding style and guidelines.
- Update any relevant documentation or examples to reflect your changes.

## Contact

If you have any further questions or need assistance, please feel free to reach out to us at [[email protected]](mailto:[email protected]).

Thank you again for your interest in contributing to FoxentrySdk
21 changes: 21 additions & 0 deletions LICENSE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
The MIT License (MIT)

Copyright (c) 2024 Foxentry

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
25 changes: 25 additions & 0 deletions Package.swift
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
// swift-tools-version:5.9
import PackageDescription

let package = Package(
name: "FoxentrySdk",
platforms: [.iOS(.v13), .macOS(.v10_15), .tvOS(.v13), .watchOS(.v6)],
products: [
.library(
name: "FoxentrySdk",
targets: ["FoxentrySdk"]
),
],
dependencies: [],
targets: [
.target(
name: "FoxentrySdk",
path: "src/FoxentrySdk"
),
.testTarget(
name: "FoxentrySdkTests",
dependencies: ["FoxentrySdk"],
path: "src/FoxentrySdkTests"
),
]
)
98 changes: 96 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,96 @@
# swift-sdk
Foxentry SDK for Swift
<div align='center' class='text-center'>
<img alt='' src='./assets/logo.webp' width='200' />
<h1 align='center' class='text-center'>FoxentrySdk</h1>
</div>

<div align='center' class='text-center'>
<a aria-label='Version' href='#'>
<img alt='' src='https://img.shields.io/badge/version-1.0.0-blue' />
</a>
<a aria-label='License' href='https://opensource.org/licenses/MIT'>
<img alt='' src='https://img.shields.io/badge/License-MIT-blue.svg' />
</a>
</div>

Welcome to our FoxentrySdk. We are committed to providing you with the best SDK services experience possible. Please use our step-by-step instructions to become familiar with how to use our SDK.

- Current API version: 2.0
- Current package version: 1.0.0

## Table of Contents

- [Requirements](#requirements)
- [Installation](#installation)
- [Usage](#usage)
- [Features](#features)
- [Contributing](#contributing)
- [License](#license)
- [Contact](#contact)
- [Frequently Asked Questions (FAQ)](#frequently-asked-questions-faq)

## Requirements

- iOS 13.0+ / macOS 10.15+ / tvOS 13.0+ / watchOS 6.0+ / visionOS 1.0+
- Swift 5.0+
- Foxentry.com API credentials

## Installation

#### Swift Package Manager

- File > Swift Packages > Add Package Dependency
- Add `FoxentrySdk repository URL`

## Usage

In case that you successfully installed our FoxentrySdk please execute this code:

```swift
import FoxentrySdk

let config = Config(token: "YOUR_API_KEY")
let sdk = FoxentrySdk(config: config)

do {
let response = try await sdk.companyService.validateCompanyData(/* query parameters */)
// Use response data
} catch {
// Handle errors
}
```

## Features

Kindly note that every URI is relative to _https://api.foxentry.com_.

The table displays all features categorized based on their specific purposes.

| Class | Method | HTTP request | Description |
| -------------------------- | ------------------------ | --------------------------- | ---------------------- |
| _FoxentrySdk.Sdk.Company_ | **ValidateCompanyData** | **POST** /company/validate | Validate company data |
| _FoxentrySdk.Sdk.Company_ | **CompanySearch** | **POST** /company/search | Search company |
| _FoxentrySdk.Sdk.Company_ | **GetCompanyData** | **POST** /company/get | Get company data |
| _FoxentrySdk.Sdk.Email_ | **ValidateEmail** | **POST** /email/validate | Validate email |
| _FoxentrySdk.Sdk.Email_ | **EmailSearch** | **POST** /email/search | Search email |
| _FoxentrySdk.Sdk.Location_ | **LocationValidation** | **POST** /location/validate | Validate location data |
| _FoxentrySdk.Sdk.Location_ | **LocationSearch** | **POST** /location/search | Search location |
| _FoxentrySdk.Sdk.Location_ | **LocationGet** | **POST** /location/get | Get location data |
| _FoxentrySdk.Sdk.Location_ | **LocationLocalization** | **POST** /location/localize | Localization |
| _FoxentrySdk.Sdk.Name_ | **NameValidation** | **POST** /name/validate | Validate name data |
| _FoxentrySdk.Sdk.Phone_ | **ValidatePhoneNumber** | **POST** /phone/validate | Validate phone number |

## Contributing

To learn more about the possibility of contributing to the subsequent development of this SDK, please visit our [contributing page](./CONTRIBUTING.md). Kindly note that contributions are limited by a unique set of rules in order to ensure clarity.

## License

Please refer to the [license page](./LICENSE) for more information about the license type and the corresponding terms of use.

## Contact

We kindly request that you direct all questions to our support email:

- [[email protected]](mailto:[email protected])

## Frequently Asked Questions (FAQ)
Binary file added assets/logo.webp
Binary file not shown.
Loading

0 comments on commit 613e1f1

Please sign in to comment.