Skip to content

Commit

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

* docs: fix discord link

* docs: add pages

* docs: update changelog, add filler content

* ci:  apply pre-commit

* docs:  fix version

* docs: fix config and changelog
  • Loading branch information
JacobCoffee authored Apr 26, 2024
1 parent 2076afe commit cd923d5
Show file tree
Hide file tree
Showing 20 changed files with 1,233 additions and 718 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": "type-lens",
"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
4 changes: 2 additions & 2 deletions .github/workflows/docs-preview.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ jobs:

ssh-key: ${{ secrets.DOCS_PREVIEW_DEPLOY_KEY }}

repository-name: jolt-org/type-lens-docs-preview
repository-name: litestar-org/type-lens-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/type-lens-docs-preview/" + issue_number
const body = "Documentation preview will be available shortly at https://litestar-org.github.io/type-lens-docs-preview/" + issue_number
const opts = github.rest.issues.listComments.endpoint.merge({
owner: context.repo.owner,
Expand Down
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/type-lens/fork>`_ the `type-lens repository <https://github.com/jolt-org/type-lens>`_
1. `Fork <https://github.com/litestar-org/type-lens/fork>`_ the `type-lens repository <https://github.com/litestar-org/type-lens>`_
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/type-lens/blob/main/pyproject.toml>`_.
1. Increment the version in `pyproject.toml <https://github.com/litestar-org/type-lens/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/type-lens/releases/new>`_ on GitHub
2. `Draft a new release <https://github.com/litestar-org/type-lens/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/type-lens/actions>`_ and approve the release workflow
5. Go to `Actions <https://github.com/litestar-org/type-lens/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
2 changes: 1 addition & 1 deletion Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -146,7 +146,7 @@ docs-clean: ## Dump the existing built docs

docs-serve: docs-clean ## Serve the docs locally
@echo "=> Serving documentation"
$(PDM) run sphinx-autobuild docs docs/_build/ -j auto --watch polyfactory --watch docs --watch tests --watch CONTRIBUTING.rst --port 8002
$(PDM) run sphinx-autobuild docs docs/_build/ -j auto --watch type_lens --watch docs --watch tests --watch CONTRIBUTING.rst --port 8002

docs: docs-clean ## Dump the existing built docs and rebuild them
@echo "=> Building documentation"
Expand Down
44 changes: 25 additions & 19 deletions README.md

Large diffs are not rendered by default.

59 changes: 7 additions & 52 deletions docs/PYPI_README.md
Original file line number Diff line number Diff line change
@@ -1,56 +1,11 @@
# type-lens

<div align="center">

| Project | | Status |
| --------- | :-- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| CI/CD | | [![Latest Release](https://github.com/jolt-org/type-lens/actions/workflows/publish.yaml/badge.svg)](https://github.com/jolt-org/type-lens/actions/workflows/publish.yaml) [![Tests And Linting](https://github.com/jolt-org/type-lens/actions/workflows/ci.yaml/badge.svg)](https://github.com/jolt-org/type-lens/actions/workflows/ci.yaml) [![Documentation Building](https://github.com/jolt-org/type-lens/actions/workflows/docs.yaml/badge.svg)](https://github.com/jolt-org/type-lens/actions/workflows/docs.yaml) |
| Quality | | [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=jolt-org_type-lens&metric=coverage)](https://sonarcloud.io/summary/new_code?id=jolt-org_type-lens) [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=jolt-org_type-lens&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=jolt-org_type-lens) [![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=jolt-org_type-lens&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=jolt-org_type-lens) [![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=jolt-org_type-lens&metric=reliability_rating)](https://sonarcloud.io/summary/new_code?id=jolt-org_type-lens) [![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=jolt-org_type-lens&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=jolt-org_type-lens) |
| 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 `type-lens` 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 `type-lens` and
> provide feedback, but we recommend against using it in production environments until a stable release is available.
## About

`type-lens` is a library that allows for utilizing Python types at runtime.

## Usage

- Install `type-lens` with `pip` or check out [our installation guide][install-guide]

```shell
pip install type-lens
```

## 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.type-lens.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/type-lens/discussions
[project-docs]: https://docs.type-lens.jolt.rs
[install-guide]: https://docs.type-lens.jolt.rs/latest/#installation
[newrepo]: https://github.com/organizations/jolt-org/repositories/new?template=type-lens
[litestar-org]: https://github.com/litestar-org
[contributing]: https://docs.type-lens.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/type-lens/discussions
[project-docs]: https://docs.type-lens.litestar.dev
38 changes: 38 additions & 0 deletions docs/changelog.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
=========
Changelog
=========

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

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

`0e209be <https://github.com/litestar-org/type-lens/commit/0e209be1dc0bf99a0163ec4cdc15e36e4d21eb2b>`_ ... `567f49a <https://github.com/litestar-org/type-lens/commit/567f49ae117ff5d3619f857cbf986d454ef7e9fa>`_ | `See diff for 0.1.0a1 <https://github.com/litestar-org/type-lens/compare/0e209be1dc0bf99a0163ec4cdc15e36e4d21eb2b...567f49ae117ff5d3619f857cbf986d454ef7e9fa>`_

Bug Fixes
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

* (`6405898 <https://github.com/litestar-org/type-lens/commit/64058981550b0ca41538fe8a706cd782a885dc4d>`_) - Add ParameterView to pkg ns (Peter Schutt)

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

* (`3d80638 <https://github.com/litestar-org/type-lens/commit/3d806380f3e9b6b6d2a02c0bfbca866701f7df8a>`_) - Move to litestar (Jacob Coffee)
* (`bea1211 <https://github.com/litestar-org/type-lens/commit/bea12110642f52e7df44ab0a088cdc63a618915c>`_) - Fix discord link (Jacob Coffee)
* (`55ef5f6 <https://github.com/litestar-org/type-lens/commit/55ef5f6b161ec20c7691e656ea525fc61d71c8a5>`_) - Add pages (Jacob Coffee)
* (`14b0898 <https://github.com/litestar-org/type-lens/commit/14b08987f33a88f56a1a6e4084695cb74c5e2ae8>`_) - Update changelog, add filler content (Jacob Coffee)
* (`567f49a <https://github.com/litestar-org/type-lens/commit/567f49ae117ff5d3619f857cbf986d454ef7e9fa>`_) - Fix version (Jacob Coffee)

Refactor
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

* (`105043a <https://github.com/litestar-org/type-lens/commit/105043af379af5c8f8670f276767e9c0ac830b1c>`_) - Better Empty type (Peter Schutt)
* (`2076afe <https://github.com/litestar-org/type-lens/commit/2076afe75f4a1a0c23d50e245a27bdd388cfaa1e>`_) - Use plain old python classes (Peter Schutt)

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

* (`0da8b24 <https://github.com/litestar-org/type-lens/commit/0da8b245d3bea78b3caad01a1c319f79bbb13f36>`_) - Apply pre-commit (Jacob Coffee)

Type Lens Changelog
Loading

0 comments on commit cd923d5

Please sign in to comment.