Skip to content

Commit

Permalink
Update README
Browse files Browse the repository at this point in the history
  • Loading branch information
dbarrous committed Apr 6, 2023
1 parent 2a1a52b commit abd8ee5
Show file tree
Hide file tree
Showing 4 changed files with 40 additions and 36 deletions.
4 changes: 2 additions & 2 deletions CONTRIBUTING.rst
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Types of Contributions
Report Bugs
~~~~~~~~~~~

Report bugs at https://github.com/dbarrous/sdc-aws-utils/issues
Report bugs at https://github.com/HERMES-SOC/sdc_aws_utils/issues

If you are reporting a bug, please include:

Expand Down Expand Up @@ -44,7 +44,7 @@ Submit Feedback
~~~~~~~~~~~~~~~

The best way to send feedback is to file an issue at
https://github.com/dbarrous/sdc-aws-utils/issues.
https://github.com/HERMES-SOC/sdc_aws_utils/issues.

If you are proposing a new feature:

Expand Down
66 changes: 35 additions & 31 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,48 +1,52 @@
# sdc-aws-utils
# sdc_aws_utils Python Package Library

[![Release](https://img.shields.io/github/v/release/dbarrous/sdc-aws-utils)](https://img.shields.io/github/v/release/dbarrous/sdc-aws-utils)
[![Build status](https://img.shields.io/github/actions/workflow/status/dbarrous/sdc-aws-utils/main.yml?branch=main)](https://github.com/dbarrous/sdc-aws-utils/actions/workflows/main.yml?query=branch%3Amain)
[![codecov](https://codecov.io/gh/dbarrous/sdc-aws-utils/branch/main/graph/badge.svg)](https://codecov.io/gh/dbarrous/sdc-aws-utils)
[![Commit activity](https://img.shields.io/github/commit-activity/m/dbarrous/sdc-aws-utils)](https://img.shields.io/github/commit-activity/m/dbarrous/sdc-aws-utils)
[![License](https://img.shields.io/github/license/dbarrous/sdc-aws-utils)](https://img.shields.io/github/license/dbarrous/sdc-aws-utils)
[![Release](https://img.shields.io/github/v/release/HERMES-SOC/sdc_aws_utils)](https://img.shields.io/github/v/release/HERMES-SOC/sdc_aws_utils)
[![Build status](https://img.shields.io/github/actions/workflow/status/HERMES-SOC/sdc_aws_utils/main.yml?branch=main)](https://github.com/HERMES-SOC/sdc_aws_utils/actions/workflows/main.yml?query=branch%3Amain)
[![codecov](https://codecov.io/gh/HERMES-SOC/sdc_aws_utils/branch/main/graph/badge.svg)](https://codecov.io/gh/HERMES-SOC/sdc_aws_utils)
[![Commit activity](https://img.shields.io/github/commit-activity/m/HERMES-SOC/sdc_aws_utils)](https://img.shields.io/github/commit-activity/m/HERMES-SOC/sdc_aws_utils)
[![License](https://img.shields.io/github/license/HERMES-SOC/sdc_aws_utils)](https://img.shields.io/github/license/HERMES-SOC/sdc_aws_utils)

This is a Python package that includes utility functions used throughout the different pipeline repos.
This is a Python package library that includes utility functions used throughout the different pipeline repos.

- **Github repository**: <https://github.com/dbarrous/sdc-aws-utils/>
- **Documentation** <https://dbarrous.github.io/sdc-aws-utils/>
- **Github repository**: <https://github.com/HERMES-SOC/sdc_aws_utils/>

## Getting started with your project
## Table of Contents

First, create a repository on GitHub with the same name as this project, and then run the following commands:
- [Introduction](#introduction)
- [Installation](#installation)
- [Structure](#structure)
- [Contributing](#contributing)
- [License](#license)

``` bash
git init -b main
git add .
git commit -m "init commit"
git remote add origin [email protected]:dbarrous/sdc-aws-utils.git
git push -u origin main
```
## Introduction

The `sdc_aws_utils` library provides utility functions for working with AWS services like S3 and Timestream, Slack notifications, logging, and pipeline repository configurations. It is designed to be a simple-to-use and efficient library to enhance your projects that rely on AWS services and improve the overall project management experience.

## Installation

Finally, install the environment and the pre-commit hooks with
To install the `sdc_aws_utils` library directly from the GitHub repository, run the following command:

```bash
make install
pip install git+https://github.com/HERMES-SOC/sdc_aws_utils.git
```

You are now ready to start development on your project! The CI/CD
pipeline will be triggered when you open a pull request, merge to main,
or when you create a new release.
## Structure

To finalize the set-up for publishing to PyPi or Artifactory, see
[here](https://fpgmaas.github.io/cookiecutter-poetry/features/publishing/#set-up-for-pypi).
For activating the automatic documentation with MkDocs, see
[here](https://fpgmaas.github.io/cookiecutter-poetry/features/mkdocs/#enabling-the-documentation-on-github).
To enable the code coverage reports, see [here](https://fpgmaas.github.io/cookiecutter-poetry/features/codecov/).
The `sdc_aws_utils` library is organized as follows:

## Releasing a new version
```
sdc_aws_utils/
├── aws.py # Functions for working with AWS services (S3, Timestream)
├── config.py # Configuration handling
├── __init__.py # Initialization
├── logging.py # Logging setup and utilities
└── slack.py # Functions for working with Slack notifications
```

## Contributing

We welcome contributions to the `sdc_aws_utils` library. Please read the [contributing guidelines](CONTRIBUTING.rst) for more information on how to get involved.

---
## License

Repository initiated with [fpgmaas/cookiecutter-poetry](https://github.com/fpgmaas/cookiecutter-poetry).
This project is licensed under the [MIT License](LICENSE). For more information, please see the [license file](LICENSE).
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ name = "sdc_aws_utils"
version = "0.1.0"
description = "This is a Python package that includes utility functions used throughout the different pipeline repos."
authors = ["Damian Barrous-Dume <[email protected]>"]
repository = "https://github.com/dbarrous/sdc-aws-utils"
repository = "https://github.com/HERMES-SOC/sdc_aws_utils"
documentation = "https://dbarrous.github.io/sdc-aws-utils/"
readme = "README.md"
packages = [
Expand Down
4 changes: 2 additions & 2 deletions sdc_aws_utils/aws.py
Original file line number Diff line number Diff line change
Expand Up @@ -169,7 +169,7 @@ def upload_file_to_s3(s3_client: str, filename: str, destination_bucket: str, fi


def log_to_timestream(
timesteam_client: type,
timestream_client: type,
action_type: str,
file_key: str,
new_file_key: str = None,
Expand Down Expand Up @@ -200,7 +200,7 @@ def log_to_timestream(
raise ValueError("A Source or Destination Buckets is required")

# Write to Timestream
timesteam_client.write_records(
timestream_client.write_records(
DatabaseName="sdc_aws_logs",
TableName="sdc_aws_s3_bucket_log_table",
Records=[
Expand Down

0 comments on commit abd8ee5

Please sign in to comment.