Skip to content

Commit

Permalink
docs: move to litestar (#2)
Browse files Browse the repository at this point in the history
* docs: move to litestar

* docs: add pages

* docs: update changelog

* docs: notate stability policy

* ci:  apply pre-commit

* docs:  fix version

* docs: fix config
  • Loading branch information
JacobCoffee authored Apr 26, 2024
1 parent 982c27c commit 25eb15b
Show file tree
Hide file tree
Showing 24 changed files with 1,093 additions and 666 deletions.
2 changes: 1 addition & 1 deletion .all-contributorsrc
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"contributorsPerLine": 7,
"projectName": "dtos",
"projectOwner": "jolt-org",
"projectOwner": "litestar-org",
"repoType": "github",
"repoHost": "https://github.com",
"commitConvention": "angular",
Expand Down
4 changes: 2 additions & 2 deletions .github/CODEOWNERS
Validating CODEOWNERS rules …
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Code owner settings for `jolt-org`
# Code owner settings for `litestar-org`
# @maintainers should be assigned to all reviews.
# Most specific assignment takes precedence though, so if you add a more specific thing than the `*` glob, you must also add @maintainers
# For more info about code owners see https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners#codeowners-file-example

# Global Assignment
* @jolt-org/maintainers @jolt-org/members
* @litestar-org/maintainers @litestar-org/members
File renamed without changes.
File renamed without changes.
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ jobs:

token: ${{ secrets.DOCS_PREVIEW_DEPLOY_TOKEN }}

repository-name: jolt-org/dtos-docs-preview
repository-name: litestar-org/dtos-docs-preview
clean: false

target-folder: ${{ env.PR_NUMBER }}
Expand All @@ -54,7 +54,7 @@ jobs:
with:
script: |
const issue_number = process.env.PR_NUMBER
const body = "Documentation preview will be available shortly at https://jolt-org.github.io/dtos-docs-preview/" + issue_number
const body = "Documentation preview will be available shortly at https://litestar-org.github.io/dtos-docs-preview/" + issue_number
const opts = github.rest.issues.listComments.endpoint.merge({
owner: context.repo.owner,
Expand Down
File renamed without changes.
File renamed without changes.
File renamed without changes.
8 changes: 4 additions & 4 deletions CONTRIBUTING.rst
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Code contributions
Workflow
++++++++

1. `Fork <https://github.com/jolt-org/dtos/fork>`_ the `dtos repository <https://github.com/jolt-org/dtos>`_
1. `Fork <https://github.com/litestar-org/dtos/fork>`_ the `dtos repository <https://github.com/litestar-org/dtos>`_
2. Clone your fork locally with git
3. `Set up the environment <#setting-up-the-environment>`_
4. Make your changes
Expand Down Expand Up @@ -66,13 +66,13 @@ Then you can serve the documentation with ``make docs-serve``, or build them wit
Creating a new release
----------------------

1. Increment the version in `pyproject.toml <https://github.com/jolt-org/dtos/blob/main/pyproject.toml>`_.
1. Increment the version in `pyproject.toml <https://github.com/litestar-org/dtos/blob/main/pyproject.toml>`_.
.. note:: The version should follow `semantic versioning <https://semver.org/>`_ and `PEP 440 <https://www.python.org/dev/peps/pep-0440/>`_.
2. `Draft a new release <https://github.com/jolt-org/dtos/releases/new>`_ on GitHub
2. `Draft a new release <https://github.com/litestar-org/dtos/releases/new>`_ on GitHub

* Use ``vMAJOR.MINOR.PATCH`` (e.g. ``v1.2.3``) as both the tag and release title
* Fill in the release description. You can use the "Generate release notes" function to get a draft for this
3. Commit your changes and push to ``main``
4. Publish the release
5. Go to `Actions <https://github.com/jolt-org/dtos/actions>`_ and approve the release workflow
5. Go to `Actions <https://github.com/litestar-org/dtos/actions>`_ and approve the release workflow
6. Check that the workflow runs successfully
2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
The MIT License (MIT)

Copyright (c) 2023 Jolt Org.
Copyright (c) 2024 Litestar Organization.

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
Expand Down
49 changes: 28 additions & 21 deletions README.md

Large diffs are not rendered by default.

69 changes: 8 additions & 61 deletions docs/PYPI_README.md
Original file line number Diff line number Diff line change
@@ -1,65 +1,12 @@
# dtos

Model your domain at the edge.

<div align="center">

| Project | | Status |
| --------- | :-- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| CI/CD | | [![Latest Release](https://github.com/jolt-org/dtos/actions/workflows/publish.yaml/badge.svg)](https://github.com/jolt-org/dtos/actions/workflows/publish.yaml) [![Tests And Linting](https://github.com/jolt-org/dtos/actions/workflows/ci.yaml/badge.svg)](https://github.com/jolt-org/dtos/actions/workflows/ci.yaml) [![Documentation Building](https://github.com/jolt-org/dtos/actions/workflows/docs.yaml/badge.svg)](https://github.com/jolt-org/dtos/actions/workflows/docs.yaml) |
| Quality | | [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=jolt-org_dtos&metric=coverage)](https://sonarcloud.io/summary/new_code?id=jolt-org_dtos) [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=jolt-org_dtos&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=jolt-org_dtos) [![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=jolt-org_dtos&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=jolt-org_dtos) [![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=jolt-org_dtos&metric=reliability_rating)](https://sonarcloud.io/summary/new_code?id=jolt-org_dtos) [![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=jolt-org_dtos&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=jolt-org_dtos) |
| Community | | [![Discord](https://img.shields.io/discord/1149784127659319356?labelColor=F50057&color=202020&label=chat%20on%20discord&logo=discord&logoColor=202020)](https://discord.gg/XpFNTjjtTK) |
| Meta | | [![Jolt Project](https://img.shields.io/badge/Jolt%20Org-%E2%AD%90-F50057.svg?logo=python&labelColor=F50057&color=202020&logoColor=202020)](https://github.com/jolt-org/) [![types - Mypy](https://img.shields.io/badge/types-Mypy-F50057.svg?logo=python&labelColor=F50057&color=202020&logoColor=202020)](https://github.com/python/mypy) [![License - MIT](https://img.shields.io/badge/license-MIT-F50057.svg?logo=python&labelColor=F50057&color=202020&logoColor=202020)](https://spdx.org/licenses/) [![Jolt Sponsors](https://img.shields.io/badge/Sponsor-%E2%9D%A4-%23202020.svg?&logo=github&logoColor=202020&labelColor=F50057)](https://github.com/sponsors/jolt-org) [![linting - Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json&labelColor=F50057)](https://github.com/astral-sh/ruff) [![code style - Black](https://img.shields.io/badge/code%20style-black-000000.svg?logo=python&labelColor=F50057&logoColor=202020)](https://github.com/psf/black) |

</div>

> **Warning**: Pre-Release Alpha Stage
>
> Please note that DTOS is currently in a pre-release alpha stage of development. This means the library is still under
> active development, and its API is subject to change. We encourage developers to experiment with DTOS and provide
> feedback, but we recommend against using it in production environments until a stable release is available.`
## About

The `dtos` library bridges the gap between complex domain models and their practical usage across network boundaries.
It is designed for Python developers seeking to streamline the process of configuring different representations of
domain models, such as dataclasses and SQLAlchemy models, for network edge parsing and validation. Whether you're
looking to accept a subset, superset, or a completely customized set of fields defined on your model at the network
edge, `dtos` offers a flexible and powerful solution.

## Purpose

``dtos`` is built with the vision of enhancing domain modeling at the network edge, offering developers unparalleled control
over their data's shape and structure during transfer. The library facilitates:

- **Customizable Data Representations**: Tailor your data to meet the exact needs of your network interactions, enabling
a more efficient and precise data exchange.
- **Edge Parsing and Validation**: Ensure your data integrity by defining explicit parsing and validation rules that
match your application's requirements.
- **Seamless Integration**: Designed to work effortlessly with popular Python data modeling and ORM tools, ``dtos``
integrates into your existing workflow with minimal overhead.

## Contributing

All [Jolt][jolt-org] projects will always be a community-centered, available for contributions of any size.

Before contributing, please review the [contribution guide][contributing].

If you have any questions, reach out to us on [Discord][discord], our org-wide [GitHub discussions][jolt-discussions] page,
or the [project-specific GitHub discussions page][project-discussions].

<hr>

<!-- markdownlint-disable -->
<p align="center">
<img src="https://raw.githubusercontent.com/jolt-org/branding/473f54621e55cde9acbb6fcab7fc03036173eb3d/assets/Branding%20-%20PNG%20-%20Transparent/Logo%20-%20Banner%20-%20Inline%20-%20Light.png" alt="Litestar Logo - Light" width="100%" height="auto" />
<img src="https://raw.githubusercontent.com/litestar-org/branding/473f54621e55cde9acbb6fcab7fc03036173eb3d/assets/Branding%20-%20PNG%20-%20Transparent/Logo%20-%20Banner%20-%20Inline%20-%20Light.png" alt="Litestar Logo - Light" width="100%" height="auto" />
</p>

[jolt-org]: https://github.com/jolt-org
[contributing]: https://docs.dtos.jolt.rs/latest/contribution-guide.html
[discord]: https://discord.gg/XpFNTjjtTK
[jolt-discussions]: https://github.com/orgs/jolt-org/discussions
[project-discussions]: https://github.com/jolt-org/dtos/discussions
[project-docs]: https://docs.dtos.jolt.rs
[install-guide]: https://docs.dtos.jolt.rs/latest/#installation
[newrepo]: https://github.com/organizations/jolt-org/repositories/new?template=dtos
[litestar-org]: https://github.com/litestar-org
[contributing]: https://docs.dtos.litestar.dev/latest/contribution-guide.html
[discord]: https://discord.gg/litestar
[litestar-discussions]: https://github.com/orgs/litestar-org/discussions
[project-discussions]: https://github.com/litestar-org/dtos/discussions
[project-docs]: https://docs.dtos.litestar.dev
[install-guide]: https://docs.dtos.litestar.dev/latest/#installation
29 changes: 29 additions & 0 deletions docs/changelog.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
=========
Changelog
=========

All commits to this project will be documented in this file.

`Release [v0.1.0] - 2024-04-26 <https://github.com/litestar-org/dtos/releases/tag/v0.1.0>`_
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
* `See All commits in v0.1.0 <https://github.com/litestar-org/dtos/commits/v0.1.0>`_

Documentation
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

* (`e34f8f6 <https://github.com/litestar-org/dtos/commit/e34f8f6724d21cfd02e54380e47a14d5abb9f0ca>`_) - Move to litestar (Jacob Coffee)
* (`d019741 <https://github.com/litestar-org/dtos/commit/d01974125292d1afbdd36c07728f22bbf210a31f>`_) - Add pages (Jacob Coffee)

Miscellaneous Tasks
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

* (`88e2026 <https://github.com/litestar-org/dtos/commit/88e20261d8ab08d224072fc01fe3b4a5f077af49>`_) - Fix linting errors (Peter Schutt)
* (`90f21ec <https://github.com/litestar-org/dtos/commit/90f21ecc9b90f79435ca4f43edd41dc3762ba187>`_) - Updated type-lens dep to pre-release (Peter Schutt)
* (`6e16eeb <https://github.com/litestar-org/dtos/commit/6e16eeb877644a80c6b2db67868dc5202faadc2b>`_) - Use github readme admonition (Jacob Coffee)

Ci
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

* (`6f03cf1 <https://github.com/litestar-org/dtos/commit/6f03cf15893e39a06637f85d49173031cb51d8a8>`_) - Update py versions (Peter Schutt)

DTOs Changelog
Loading

0 comments on commit 25eb15b

Please sign in to comment.