# Everysk Library
The **Everysk Library** is a one-stop solution designed to help our teams and partners streamline workflows and maximize productivity.
Many projects at Everysk rely on multiple **endpoints**, **engines**, and **utilities** to automate workflows, handle entities such as portfolios, datastores, reports, and files, and perform complex calculations. Adopting and maintaining each of these components individually can be both time-consuming and expensive.
To address this challenge, Everysk developed the Everysk Library: a unified Python library that bundles these capabilities into a single, convenient package.
By consolidating essential functionalities — ranging from portfolio creation to workflow automation — Everysk Lib greatly simplifies implementation and ongoing maintenance. This all-in-one toolkit ensures you have everything you need to build powerful, scalable solutions across a variety of Everysk projects.
<br>
## Table of Contents
- [Directory Structure](#directory-structure)
- [Installation](#installation)
- [Running Tests](#running-tests)
- [Running Tests with coverage](#running-tests-with-coverage)
- [Contributing](#contributing)
- [License](#license)
## Directory Structure
Below we have the main directories that you will be working with.
```mermaid
flowchart TB
EveryskLibrary(["Everysk Library"])
SDKDir(["sdk"])
CoreDir(["core"])
ServerDir(["server"])
ApiDir(["api"])
EntitiesDir(["entities"])
EnginesDir(["engines"])
DatetimeDir(["datetime"])
EveryskLibrary --> SDKDir
EveryskLibrary --> CoreDir
EveryskLibrary --> ServerDir
EveryskLibrary --> ApiDir
SDKDir --> EntitiesDir
SDKDir --> EnginesDir
CoreDir --> DatetimeDir
```
<br>
## Installation
To install the **Everysk library**, you will need to use pip's `install` command:
```bash
pip install everysk-lib
```
### Verifying the Installation
After installing the library, it's a good practice to verify if the installation was successful. Here is how to achieve this:
#### 1. Open a terminal
#### 2. Start the Python interpreter by typing `python` and pressing `Enter`
#### 3. In the Python interpreter, type the following command then press `Enter`:
```python
import everysk
```
If the library has been installed correctly, this command should complete without any errors. If the library is not installed or there's a problem with the installation, Python will raise a `ModuleNotFoundError`
<br>
## Documentation
The main documentation of the Everysk Library can be founded here: [Everysk Library Documentation](docs/README.md)
<br>
## Running Tests
This section provides instructions on how to run tests for the project. There are two scenarios, the first one is running tests in a development environment and the second one is running tests after the library has been installed from PyPI.
### Running Tests in Development Environment
In a development environment you can use the provided shell script to run the tests. The script sets up the necessary environment and then run the tests. To execute the tests, open a bash terminal and run the following command.
```bash
./run.sh tests
```
### Running Tests After the Library is Installed
After the library has been installed in your project from PyPI, you can start running tests using Python's built-in unittest module. To run tests use the following command:
```bash
python3 -m unittest everysk.core.tests
```
The command uses Python's unittest module as mentioned above as a script, which then runs the test in the `everysk.core.tests` package.
<br>
## Running Tests with coverage
Code coverage us a way of measuring how many lines of code are executed while the automated tests are running.
To run tests along with a coverage report, you can use the provided shell script. The script will not only run the tests but also generate a coverage report that shows the percentage of code that was executed during the tests.
This is useful to identify sections of your code that are not being tested and may need additional tests.
#### 1. Open a terminal in your Visual Studio Code environment.
#### 2. Run the following command.
```bash
./run.sh coverage
```
This command executes the `run.sh` script with the `coverage` argument. The report will be displayed in the terminal after the script completed the tests.
**Remember:** a high coverage percentage is generally good, but 100% coverage does not ensures that your code is free from bugs or any other problem that might occur in your code. The full coverage just means that all the lines in your code were executed during the tests.
<br>
## Contributing
Contributions are always welcome and greatly appreciated!
Go to the repository [link](https://github.com/Everysk/everysk-lib) and click on the `Fork` button to create your own copy of the everysk library.
Then clone the project in your own local machine by running the command below or using the **GitHub Desktop**.
```bash
git clone https://github.com/<your-username>/everysk-lib.git everysk-yourusername
```
This section creates a directory called `everysk-yourusername` to center all your code.
After that you can change the directory by:
```bash
cd everysk-yourusername
```
Create the **upstream** repository which will refer to the main repository that you just forked.
```bash
git remote add upstream https://github.com/Everysk/everysk-lib.git
```
Now run the following commands to make sure that your clone is up-to-date with main everysk repository
```bash
git checkout main
git pull upstream main
```
Shortly after, create a new branch to add your code
```bash
git checkout -b brand-new-feature
```
The command above will automatically switch to this newly created branch. At this moment your are able to make your modifications to the code and commit locally as you progress.
After all the code changes, you can submit your contribution by pushing the changes to your fork on GitHub:
```bash
git push origin brand-new-feature
```
The command above ensures that all the modifications that you've made are up-to-date with your current branch.
At the end of this process you will need to make a **Pull Request** to the main branch.
To achieve this, go to the GitHub page of the project and click on the `Pull requests` tab, then click on `New pull request` button.
This will open a new section used to compare branches, now choose your branch for merging into the main branch and hit the `Create pull request` button.
<br>
## License
(C) Copyright 2025 EVERYSK TECHNOLOGIES
This is an unpublished work containing confidential and proprietary
information of EVERYSK TECHNOLOGIES. Disclosure, use, or reproduction
without authorization of EVERYSK TECHNOLOGIES is prohibited.
Date: Jan 2025
Contact: contact@everysk.com
URL: https://everysk.com/
<br>
<hr>
<br>
[Back to the top](#everysk-library)
Raw data
{
"_id": null,
"home_page": null,
"name": "everysk-beta",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "python, setuptools, development, lib",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/6d/2d/e714015c3d959b4bd3addbb28a1e9898ea3f09a9e088fa0e334eb9143884/everysk_beta-1.6.1502.tar.gz",
"platform": null,
"description": "\n# Everysk Library\n\nThe **Everysk Library** is a one-stop solution designed to help our teams and partners streamline workflows and maximize productivity.\n\nMany projects at Everysk rely on multiple **endpoints**, **engines**, and **utilities** to automate workflows, handle entities such as portfolios, datastores, reports, and files, and perform complex calculations. Adopting and maintaining each of these components individually can be both time-consuming and expensive.\n\nTo address this challenge, Everysk developed the Everysk Library: a unified Python library that bundles these capabilities into a single, convenient package.\n\nBy consolidating essential functionalities \u2014 ranging from portfolio creation to workflow automation \u2014 Everysk Lib greatly simplifies implementation and ongoing maintenance. This all-in-one toolkit ensures you have everything you need to build powerful, scalable solutions across a variety of Everysk projects.\n\n<br>\n\n## Table of Contents\n\n- [Directory Structure](#directory-structure)\n- [Installation](#installation)\n- [Running Tests](#running-tests)\n- [Running Tests with coverage](#running-tests-with-coverage)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Directory Structure\n\nBelow we have the main directories that you will be working with.\n\n```mermaid\nflowchart TB\n EveryskLibrary([\"Everysk Library\"])\n SDKDir([\"sdk\"])\n CoreDir([\"core\"])\n ServerDir([\"server\"])\n ApiDir([\"api\"])\n EntitiesDir([\"entities\"])\n EnginesDir([\"engines\"])\n DatetimeDir([\"datetime\"])\n EveryskLibrary --> SDKDir\n EveryskLibrary --> CoreDir\n EveryskLibrary --> ServerDir\n EveryskLibrary --> ApiDir\n SDKDir --> EntitiesDir\n SDKDir --> EnginesDir\n CoreDir --> DatetimeDir\n```\n\n<br>\n\n## Installation\n\nTo install the **Everysk library**, you will need to use pip's `install` command:\n\n```bash\n pip install everysk-lib\n```\n\n### Verifying the Installation\n\nAfter installing the library, it's a good practice to verify if the installation was successful. Here is how to achieve this:\n\n#### 1. Open a terminal\n\n#### 2. Start the Python interpreter by typing `python` and pressing `Enter`\n\n#### 3. In the Python interpreter, type the following command then press `Enter`:\n\n```python\n import everysk\n```\n\nIf the library has been installed correctly, this command should complete without any errors. If the library is not installed or there's a problem with the installation, Python will raise a `ModuleNotFoundError`\n\n<br>\n\n## Documentation\n\nThe main documentation of the Everysk Library can be founded here: [Everysk Library Documentation](docs/README.md)\n\n<br>\n\n## Running Tests\n\nThis section provides instructions on how to run tests for the project. There are two scenarios, the first one is running tests in a development environment and the second one is running tests after the library has been installed from PyPI.\n\n### Running Tests in Development Environment\n\nIn a development environment you can use the provided shell script to run the tests. The script sets up the necessary environment and then run the tests. To execute the tests, open a bash terminal and run the following command.\n\n```bash\n ./run.sh tests\n```\n\n### Running Tests After the Library is Installed\n\nAfter the library has been installed in your project from PyPI, you can start running tests using Python's built-in unittest module. To run tests use the following command:\n\n\n```bash\n python3 -m unittest everysk.core.tests\n```\n\nThe command uses Python's unittest module as mentioned above as a script, which then runs the test in the `everysk.core.tests` package.\n\n<br>\n\n## Running Tests with coverage\n\nCode coverage us a way of measuring how many lines of code are executed while the automated tests are running.\n\nTo run tests along with a coverage report, you can use the provided shell script. The script will not only run the tests but also generate a coverage report that shows the percentage of code that was executed during the tests.\n\nThis is useful to identify sections of your code that are not being tested and may need additional tests.\n\n#### 1. Open a terminal in your Visual Studio Code environment.\n\n#### 2. Run the following command.\n\n```bash\n ./run.sh coverage\n```\n\nThis command executes the `run.sh` script with the `coverage` argument. The report will be displayed in the terminal after the script completed the tests.\n\n**Remember:** a high coverage percentage is generally good, but 100% coverage does not ensures that your code is free from bugs or any other problem that might occur in your code. The full coverage just means that all the lines in your code were executed during the tests.\n\n<br>\n\n## Contributing\n\nContributions are always welcome and greatly appreciated!\n\nGo to the repository [link](https://github.com/Everysk/everysk-lib) and click on the `Fork` button to create your own copy of the everysk library.\n\nThen clone the project in your own local machine by running the command below or using the **GitHub Desktop**.\n\n```bash\n git clone https://github.com/<your-username>/everysk-lib.git everysk-yourusername\n```\n\nThis section creates a directory called `everysk-yourusername` to center all your code.\n\nAfter that you can change the directory by:\n\n```bash\n cd everysk-yourusername\n```\n\nCreate the **upstream** repository which will refer to the main repository that you just forked.\n\n```bash\n git remote add upstream https://github.com/Everysk/everysk-lib.git\n```\n\nNow run the following commands to make sure that your clone is up-to-date with main everysk repository\n\n```bash\n git checkout main\n git pull upstream main\n```\n\nShortly after, create a new branch to add your code\n\n```bash\n git checkout -b brand-new-feature\n```\n\nThe command above will automatically switch to this newly created branch. At this moment your are able to make your modifications to the code and commit locally as you progress.\n\nAfter all the code changes, you can submit your contribution by pushing the changes to your fork on GitHub:\n\n```bash\n git push origin brand-new-feature\n```\n\nThe command above ensures that all the modifications that you've made are up-to-date with your current branch.\n\nAt the end of this process you will need to make a **Pull Request** to the main branch.\n\nTo achieve this, go to the GitHub page of the project and click on the `Pull requests` tab, then click on `New pull request` button.\n\nThis will open a new section used to compare branches, now choose your branch for merging into the main branch and hit the `Create pull request` button.\n\n<br>\n\n## License\n\n(C) Copyright 2025 EVERYSK TECHNOLOGIES\n\nThis is an unpublished work containing confidential and proprietary\ninformation of EVERYSK TECHNOLOGIES. Disclosure, use, or reproduction\nwithout authorization of EVERYSK TECHNOLOGIES is prohibited.\n\nDate: Jan 2025\n\nContact: contact@everysk.com\n\nURL: https://everysk.com/\n\n\n<br>\n<hr>\n<br>\n\n[Back to the top](#everysk-library)\n",
"bugtrack_url": null,
"license": "(C) Copyright 2025 EVERYSK TECHNOLOGIES This is an unpublished work containing confidential and proprietary information of EVERYSK TECHNOLOGIES. Disclosure, use, or reproduction without authorization of EVERYSK TECHNOLOGIES is prohibited. Date: Jan 2025 Contact: contact@everysk.com URL: https://everysk.com/ ",
"summary": "Generic lib to share python code on Everysk.",
"version": "1.6.1502",
"project_urls": {
"Homepage": "https://everysk.com/"
},
"split_keywords": [
"python",
" setuptools",
" development",
" lib"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "865c0931d4a76be1fa79fa05dc0e751292156c604d1533c7a5229b6dfeb5cbc1",
"md5": "4794eb732512664a79be8fedec9546e0",
"sha256": "fb75a82baa5005f9d8ebc96673fd964e6dac1c63058dec30e35c709fa4096557"
},
"downloads": -1,
"filename": "everysk_beta-1.6.1502-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4794eb732512664a79be8fedec9546e0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 359305,
"upload_time": "2025-02-11T20:42:47",
"upload_time_iso_8601": "2025-02-11T20:42:47.606770Z",
"url": "https://files.pythonhosted.org/packages/86/5c/0931d4a76be1fa79fa05dc0e751292156c604d1533c7a5229b6dfeb5cbc1/everysk_beta-1.6.1502-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6d2de714015c3d959b4bd3addbb28a1e9898ea3f09a9e088fa0e334eb9143884",
"md5": "321f15663e9b4e57c07494d156c429a8",
"sha256": "c3732bd9eea75a3ec503223e374c6ec2ce9569fd9925b2b9c6f2898e219272e0"
},
"downloads": -1,
"filename": "everysk_beta-1.6.1502.tar.gz",
"has_sig": false,
"md5_digest": "321f15663e9b4e57c07494d156c429a8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 268136,
"upload_time": "2025-02-11T20:42:50",
"upload_time_iso_8601": "2025-02-11T20:42:50.187055Z",
"url": "https://files.pythonhosted.org/packages/6d/2d/e714015c3d959b4bd3addbb28a1e9898ea3f09a9e088fa0e334eb9143884/everysk_beta-1.6.1502.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-11 20:42:50",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "everysk-beta"
}
JSON