| Name | ancv JSON |
| Version |
1.4.1
JSON |
| download |
| home_page | https://ancv.io |
| Summary | Renders your (JSON) resume/CV for online & pretty terminal display |
| upload_time | 2024-05-01 15:15:09 |
| maintainer | None |
| docs_url | None |
| author | Alex Povel |
| requires_python | <4.0,>=3.10 |
| license | MIT |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# [ancv](https://github.com/alexpovel/ancv)
Getting your resume aka [an CV](https://youtu.be/mJUtMEJdvqM?t=16) (*[ANSI](https://en.wikipedia.org/wiki/ANSI_escape_code)-v* 🤡) straight to your and anyone else's terminals:
---
Be warned though, for this is kinda useless and just for fun:
<p align="center">
<img src="docs/images/users-venn.svg" alt="users venn diagram">
</p>
## Getting started
1. Create your resume according to the [JSON Resume Schema](https://jsonresume.org/schema/) (see also the [schema specification](https://github.com/jsonresume/resume-schema/blob/master/schema.json)) either:
- use ChatGPT (or another LLM) with the following prompt (you need to fill in the spaces for `[resume]` and `[json_schema]`):
```
Resume:[resume]
JSON Resume Schema:[json_schema]
Provide JSON data structure of the resume, formatted according to the JSON Resume Schema
Output json, no yapping
```
Note: for `json_schema` you can just use the example [from here](https://jsonresume.org/schema/)
- manually (see [the `heyho` sample](./ancv/data/showcase.resume.json) for a possible starting point),
- exporting from [LinkedIn](https://www.linkedin.com/) using [Joshua Tzucker's LinkedIn exporter](https://joshuatz.com/projects/web-stuff/linkedin-profile-to-json-resume-exporter/) ([repo](https://github.com/joshuatz/linkedin-to-jsonresume))[^1], or
- exporting from one of the platforms advertised as offering [JSON resume integration](https://jsonresume.org/schema/).
2. [Create a **public** gist](https://gist.github.com/) named `resume.json` with your resume contents.
3. You're now the proud owner of an ancv.
Time to try it out.
The following examples work out-of-the-box.
**Replace `heyho` with your GitHub username** once you're all set up.
- curl:
```bash
curl -L ancv.io/heyho
```
with `-L` being shorthand for [`--location`](https://curl.se/docs/manpage.html), allowing you to follow the redirect from `http://ancv.io` through to `https://ancv.io`.
It's shorter than its also perfectly viable alternative:
```bash
curl https://ancv.io/heyho
```
Lastly, you might want to page the output for easiest reading, top-to-bottom:
```bash
curl -sL ancv.io/heyho | less
```
If that garbles the rendered output, try `less -r` aka [`--raw-control-chars`](https://man7.org/linux/man-pages/man1/less.1.html).
- wget:
```bash
wget -O - --quiet ancv.io/heyho
```
where `-O` is short for [`--output-document`](https://linux.die.net/man/1/wget), used here to redirect to stdout.
- PowerShell 7:
```powershell
(iwr ancv.io/heyho).Content
```
where `iwr` is an alias for [`Invoke-Webrequest`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/invoke-webrequest?view=powershell-7.2), returning an object whose `Content` we access.
- PowerShell 5:
```powershell
(iwr -UseBasicParsing ancv.io/heyho).Content
```
where `-UseBasicParsing` is *only* required if you haven't set up Internet Explorer yet ([yes, really](https://stackoverflow.com/q/38005341/11477374)).
If you have, then it works as PowerShell 7 (where that flag is deprecated and the default anyway).
## Configuration
*All configuration is optional.*
The CV is constructed as follows:
In summary:
- you control:
- the **template**.
Essentially the order of items, indentations, text alignment, position of dates and more.
Templates are like layouts/skeletons.
- the **theme**.
This controls colors, italics, boldface, underlining, blinking (yes, really) and more.
A couple themes exist but you can easily add your own one.
- the **language** to use.
Pre-set strings like section titles (*Education*, ...), names of months etc. are governed by *translations*, of which there are a couple available already.
All other text is free-form.
- text content like emojis and newlines to control paragraph breaks.
Emojis are user-controlled: if you want them, use them in your `resume.json`; in the future, there might be *templates* with emojis baked in, but you'd have to actively opt into using one.
- date formatting, in a limited fashion through a special `dec31_as_year` toggle.
If that toggle is `true`, dates in the format `YYYY-12-31` will be displayed as `YYYY` only.
- lastly, there's a toggle for ASCII-only output.
It only concerns the *template* and controls the drawing of boxes and such (e.g., [`-`](https://unicode-table.com/en/002D/) versus [`─`](https://unicode-table.com/en/2500/) : only the latter will produce gapless rules).
If you yourself use non-ASCII characters in your texts, use a *language* containing non-ASCII characters (Spanish, French, ...) or a *theme* with non-ASCII characters (e.g., a theme might use the `•` character to print bullet points), non-ASCII Unicode will still occur.
As such, this toggle currently isn't very powerful, but with some care it *does* ultimately allow you to be ASCII-only.
If you come up with new templates, themes or translations, a PR would be highly appreciated.
- you *do not* control:
- anything about a viewer's terminal!
Any recent terminal will support a baseline of features (e.g., colors), but large parts of the functionalities depend on the *font* used: proper Unicode support is needed for pretty output (see `ascii_only`), and ideally emojis if you're into that (although it's easy to pick an emoji-free template).
Many themes leverage Unicode characters as well.
- access to your CV: like the gist itself, it will be publicly available on GitHub.
### How to configure
Configuring `ancv` requires going beyond the vanilla JSON Resume schema.
You will need to add an (entirely optional) `$.meta.ancv` field to your `resume.json`.
The [provided schema](schema.json) will be of help here:
an editor capable of providing auto-completion based on it, like [Visual Studio Code](https://code.visualstudio.com/docs/languages/json#_json-schemas-and-settings), will make filling out the additional configuration a breeze.
The schema will further inform you of the default values (used for unspecified fields).
Since everything is optional, a [valid JSON resume](https://github.com/jsonresume/resume-schema/blob/master/schema.json) (without an `ancv` section) is valid for `ancv` use as well.
## Installation
### As a library
Install the package as usual:
```bash
pip install ancv
```
This also allows you to import whatever you could want or need from the package, if anything.
Note that it's pretty heavy on the dependencies.
### As a container
See also the available [packages aka images](https://github.com/alexpovel/ancv/pkgs/container/ancv):
```bash
docker pull ghcr.io/alexpovel/ancv
```
Versioned tags (so you can pin a major) are available.
### Local usage
Once installed, you could for example check whether your `resume.json` is valid at all (`validate`) or get a glimpse at the final product (`render`):
```bash
# pip route:
$ ancv render resume.json
# container route:
$ docker run -v $(pwd)/resume.json:/app/resume.json ghcr.io/alexpovel/ancv render
```
## Self-hosting
Self-hosting is a first-class citizen here.
### Context: Cloud Hosting
The <https://ancv.io> site is hosted on [Google Cloud Run](https://cloud.google.com/run) (serverless) and deployed there [automatically](https://github.com/alexpovel/ancv/runs/8172131447), such that the latest release you see here is also the code executing in that cloud environment.
That's convenient to get started: simply create a `resume.json` gist and you're good to go within minutes.
It can also be used for debugging and playing around; it's a playground of sorts.
You're invited to use this service for as much and as long as you'd like.
However, obviously, as an individual I cannot guarantee its availability in perpetuity.
You might also feel uncomfortable uploading your CV onto GitHub, since it *has* to be public for this whole exercise to work.
Lastly, you might also be suspicious of me inserting funny business into your CV before serving it out.
If this is you, self-hosting is for you.
### Setup
For simplicity, using Docker Compose (with Docker's recent [Compose CLI plugin](https://docs.docker.com/compose/install/compose-plugin/)):
1. Clone this repository onto your server (or fork it, make your edits and clone that)
2. `cd self-hosting`
3. Edit [Caddy's config file](./self-hosting/Caddyfile) ([more info](https://caddyserver.com/docs/caddyfile)) to contain your own domain name
4. Place your `resume.json` into the directory
5. Run `docker compose up`
Caddy (chosen here for simplicity) will handle HTTPS automatically for you, but will of course require domain names to be set up correctly to answer ACME challenges.
Handling DNS is up to you; for dynamic DNS, I can recommend [`qmcgaw/ddns-updater`](https://github.com/qdm12/ddns-updater).
If you self-host in the cloud, the server infrastructure might be taken care of for you by your provider already (as is the case for Google Cloud Run).
In these cases, a dedicated proxy is unnecessary and a single [Dockerfile](./Dockerfile) might suffice (adjusted to your needs).
True [serverless](https://www.serverless.com/) is also a possibility and an excellent fit here.
For example, one could use [Digital Ocean's *Functions*](https://docs.digitalocean.com/products/functions/).
If you go that route and succeed, please let me know! (I had given up with how depressingly hard dependency management was, as opposed to tried-and-tested container images.)
---
<p align="center">
<a href="https://github.com/alexpovel/ancv">
<img src="https://github.githubassets.com/images/modules/site/icons/footer/github-mark.svg" alt="github logo">
</a>
</p>
[^1]: The exporter has a couple caveats.
You will probably not be able to paste its result into a gist and have it work out of the box.
It is recommended to paste the export into an editor capable of helping you find errors against the contained `$schema`, like VS Code.
Alternatively, a local `ancv render your-file.json` will print `pydantic` validation errors, which might be helpful in debugging.
For example, the exporter might leave `$.basics.url` an empty string, which isn't a valid URI and therefore fails the schema and, by extension, `ancv`.
Similarly, `endDate` keys might get empty string values.
**Remove these entries** entirely to stay conformant to the JSON Resume Schema (to which `ancv` stays conformant).
Raw data
{
"_id": null,
"home_page": "https://ancv.io",
"name": "ancv",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Alex Povel",
"author_email": "python@alexpovel.de",
"download_url": "https://files.pythonhosted.org/packages/c5/96/79711dd9e682af665455e33c6898b5caebc97b9addaa18e99e738f433bbd/ancv-1.4.1.tar.gz",
"platform": null,
"description": "# [ancv](https://github.com/alexpovel/ancv)\n\nGetting your resume aka [an CV](https://youtu.be/mJUtMEJdvqM?t=16) (*[ANSI](https://en.wikipedia.org/wiki/ANSI_escape_code)-v* \ud83e\udd21) straight to your and anyone else's terminals:\n\n\n\n---\n\nBe warned though, for this is kinda useless and just for fun:\n\n<p align=\"center\">\n <img src=\"docs/images/users-venn.svg\" alt=\"users venn diagram\">\n</p>\n\n## Getting started\n\n1. Create your resume according to the [JSON Resume Schema](https://jsonresume.org/schema/) (see also the [schema specification](https://github.com/jsonresume/resume-schema/blob/master/schema.json)) either:\n\n - use ChatGPT (or another LLM) with the following prompt (you need to fill in the spaces for `[resume]` and `[json_schema]`):\n ```\n Resume:[resume]\n\n JSON Resume Schema:[json_schema]\n\n Provide JSON data structure of the resume, formatted according to the JSON Resume Schema\n \n Output json, no yapping\n ```\n Note: for `json_schema` you can just use the example [from here](https://jsonresume.org/schema/)\n - manually (see [the `heyho` sample](./ancv/data/showcase.resume.json) for a possible starting point),\n - exporting from [LinkedIn](https://www.linkedin.com/) using [Joshua Tzucker's LinkedIn exporter](https://joshuatz.com/projects/web-stuff/linkedin-profile-to-json-resume-exporter/) ([repo](https://github.com/joshuatz/linkedin-to-jsonresume))[^1], or\n - exporting from one of the platforms advertised as offering [JSON resume integration](https://jsonresume.org/schema/).\n2. [Create a **public** gist](https://gist.github.com/) named `resume.json` with your resume contents.\n3. You're now the proud owner of an ancv.\n Time to try it out.\n\n The following examples work out-of-the-box.\n **Replace `heyho` with your GitHub username** once you're all set up.\n\n - curl:\n\n ```bash\n curl -L ancv.io/heyho\n ```\n\n with `-L` being shorthand for [`--location`](https://curl.se/docs/manpage.html), allowing you to follow the redirect from `http://ancv.io` through to `https://ancv.io`.\n It's shorter than its also perfectly viable alternative:\n\n ```bash\n curl https://ancv.io/heyho\n ```\n\n Lastly, you might want to page the output for easiest reading, top-to-bottom:\n\n ```bash\n curl -sL ancv.io/heyho | less\n ```\n\n If that garbles the rendered output, try `less -r` aka [`--raw-control-chars`](https://man7.org/linux/man-pages/man1/less.1.html).\n\n - wget:\n\n ```bash\n wget -O - --quiet ancv.io/heyho\n ```\n\n where `-O` is short for [`--output-document`](https://linux.die.net/man/1/wget), used here to redirect to stdout.\n\n - PowerShell 7:\n\n ```powershell\n (iwr ancv.io/heyho).Content\n ```\n\n where `iwr` is an alias for [`Invoke-Webrequest`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/invoke-webrequest?view=powershell-7.2), returning an object whose `Content` we access.\n - PowerShell 5:\n\n ```powershell\n (iwr -UseBasicParsing ancv.io/heyho).Content\n ```\n\n where `-UseBasicParsing` is *only* required if you haven't set up Internet Explorer yet ([yes, really](https://stackoverflow.com/q/38005341/11477374)).\n If you have, then it works as PowerShell 7 (where that flag is deprecated and the default anyway).\n\n## Configuration\n\n*All configuration is optional.*\n\nThe CV is constructed as follows:\n\n\n\nIn summary:\n\n- you control:\n - the **template**.\n\n Essentially the order of items, indentations, text alignment, position of dates and more.\n Templates are like layouts/skeletons.\n - the **theme**.\n\n This controls colors, italics, boldface, underlining, blinking (yes, really) and more.\n A couple themes exist but you can easily add your own one.\n - the **language** to use.\n\n Pre-set strings like section titles (*Education*, ...), names of months etc. are governed by *translations*, of which there are a couple available already.\n All other text is free-form.\n - text content like emojis and newlines to control paragraph breaks.\n\n Emojis are user-controlled: if you want them, use them in your `resume.json`; in the future, there might be *templates* with emojis baked in, but you'd have to actively opt into using one.\n - date formatting, in a limited fashion through a special `dec31_as_year` toggle.\n If that toggle is `true`, dates in the format `YYYY-12-31` will be displayed as `YYYY` only.\n - lastly, there's a toggle for ASCII-only output.\n\n It only concerns the *template* and controls the drawing of boxes and such (e.g., [`-`](https://unicode-table.com/en/002D/) versus [`\u2500`](https://unicode-table.com/en/2500/) : only the latter will produce gapless rules).\n If you yourself use non-ASCII characters in your texts, use a *language* containing non-ASCII characters (Spanish, French, ...) or a *theme* with non-ASCII characters (e.g., a theme might use the `\u2022` character to print bullet points), non-ASCII Unicode will still occur.\n As such, this toggle currently isn't very powerful, but with some care it *does* ultimately allow you to be ASCII-only.\n\n If you come up with new templates, themes or translations, a PR would be highly appreciated.\n- you *do not* control:\n - anything about a viewer's terminal!\n\n Any recent terminal will support a baseline of features (e.g., colors), but large parts of the functionalities depend on the *font* used: proper Unicode support is needed for pretty output (see `ascii_only`), and ideally emojis if you're into that (although it's easy to pick an emoji-free template).\n Many themes leverage Unicode characters as well.\n - access to your CV: like the gist itself, it will be publicly available on GitHub.\n\n### How to configure\n\nConfiguring `ancv` requires going beyond the vanilla JSON Resume schema.\nYou will need to add an (entirely optional) `$.meta.ancv` field to your `resume.json`.\nThe [provided schema](schema.json) will be of help here:\nan editor capable of providing auto-completion based on it, like [Visual Studio Code](https://code.visualstudio.com/docs/languages/json#_json-schemas-and-settings), will make filling out the additional configuration a breeze.\n\nThe schema will further inform you of the default values (used for unspecified fields).\nSince everything is optional, a [valid JSON resume](https://github.com/jsonresume/resume-schema/blob/master/schema.json) (without an `ancv` section) is valid for `ancv` use as well.\n\n## Installation\n\n### As a library\n\nInstall the package as usual:\n\n```bash\npip install ancv\n```\n\nThis also allows you to import whatever you could want or need from the package, if anything.\nNote that it's pretty heavy on the dependencies.\n\n### As a container\n\nSee also the available [packages aka images](https://github.com/alexpovel/ancv/pkgs/container/ancv):\n\n```bash\ndocker pull ghcr.io/alexpovel/ancv\n```\n\nVersioned tags (so you can pin a major) are available.\n\n### Local usage\n\nOnce installed, you could for example check whether your `resume.json` is valid at all (`validate`) or get a glimpse at the final product (`render`):\n\n```bash\n# pip route:\n$ ancv render resume.json\n# container route:\n$ docker run -v $(pwd)/resume.json:/app/resume.json ghcr.io/alexpovel/ancv render\n```\n\n## Self-hosting\n\nSelf-hosting is a first-class citizen here.\n\n### Context: Cloud Hosting\n\nThe <https://ancv.io> site is hosted on [Google Cloud Run](https://cloud.google.com/run) (serverless) and deployed there [automatically](https://github.com/alexpovel/ancv/runs/8172131447), such that the latest release you see here is also the code executing in that cloud environment.\nThat's convenient to get started: simply create a `resume.json` gist and you're good to go within minutes.\nIt can also be used for debugging and playing around; it's a playground of sorts.\n\nYou're invited to use this service for as much and as long as you'd like.\nHowever, obviously, as an individual I cannot guarantee its availability in perpetuity.\nYou might also feel uncomfortable uploading your CV onto GitHub, since it *has* to be public for this whole exercise to work.\nLastly, you might also be suspicious of me inserting funny business into your CV before serving it out.\nIf this is you, self-hosting is for you.\n\n### Setup\n\nFor simplicity, using Docker Compose (with Docker's recent [Compose CLI plugin](https://docs.docker.com/compose/install/compose-plugin/)):\n\n1. Clone this repository onto your server (or fork it, make your edits and clone that)\n2. `cd self-hosting`\n3. Edit [Caddy's config file](./self-hosting/Caddyfile) ([more info](https://caddyserver.com/docs/caddyfile)) to contain your own domain name\n4. Place your `resume.json` into the directory\n5. Run `docker compose up`\n\nCaddy (chosen here for simplicity) will handle HTTPS automatically for you, but will of course require domain names to be set up correctly to answer ACME challenges.\nHandling DNS is up to you; for dynamic DNS, I can recommend [`qmcgaw/ddns-updater`](https://github.com/qdm12/ddns-updater).\n\nIf you self-host in the cloud, the server infrastructure might be taken care of for you by your provider already (as is the case for Google Cloud Run).\nIn these cases, a dedicated proxy is unnecessary and a single [Dockerfile](./Dockerfile) might suffice (adjusted to your needs).\nTrue [serverless](https://www.serverless.com/) is also a possibility and an excellent fit here.\nFor example, one could use [Digital Ocean's *Functions*](https://docs.digitalocean.com/products/functions/).\nIf you go that route and succeed, please let me know! (I had given up with how depressingly hard dependency management was, as opposed to tried-and-tested container images.)\n\n---\n\n<p align=\"center\">\n <a href=\"https://github.com/alexpovel/ancv\">\n <img src=\"https://github.githubassets.com/images/modules/site/icons/footer/github-mark.svg\" alt=\"github logo\">\n </a>\n</p>\n\n[^1]: The exporter has a couple caveats.\n You will probably not be able to paste its result into a gist and have it work out of the box.\n It is recommended to paste the export into an editor capable of helping you find errors against the contained `$schema`, like VS Code.\n Alternatively, a local `ancv render your-file.json` will print `pydantic` validation errors, which might be helpful in debugging.\n For example, the exporter might leave `$.basics.url` an empty string, which isn't a valid URI and therefore fails the schema and, by extension, `ancv`.\n Similarly, `endDate` keys might get empty string values.\n **Remove these entries** entirely to stay conformant to the JSON Resume Schema (to which `ancv` stays conformant).\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Renders your (JSON) resume/CV for online & pretty terminal display",
"version": "1.4.1",
"project_urls": {
"Bug Tracker": "https://github.com/alexpovel/ancv/issues/",
"Changelog": "https://github.com/alexpovel/ancv/blob/main/CHANGELOG.md",
"Homepage": "https://ancv.io",
"Pull Requests": "https://github.com/alexpovel/ancv/pulls",
"Repository": "https://github.com/alexpovel/ancv/"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f24e58e6478cca71c34425d7db7d8dfd76b4be28b3889666a03e4dc659d36f75",
"md5": "8c92300d821cda73eb757319c41b064f",
"sha256": "5cd9bb760209456562cf207e3c6446719a6757dc5729f9fab87fafdd3737e884"
},
"downloads": -1,
"filename": "ancv-1.4.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8c92300d821cda73eb757319c41b064f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 35802,
"upload_time": "2024-05-01T15:15:06",
"upload_time_iso_8601": "2024-05-01T15:15:06.624351Z",
"url": "https://files.pythonhosted.org/packages/f2/4e/58e6478cca71c34425d7db7d8dfd76b4be28b3889666a03e4dc659d36f75/ancv-1.4.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c59679711dd9e682af665455e33c6898b5caebc97b9addaa18e99e738f433bbd",
"md5": "27ac44547fd5a8a9bcb240216fa77234",
"sha256": "42ce01e30607c16e8c7b95ed41a2b1523fc482df211d18a1a42cb30c628afd4f"
},
"downloads": -1,
"filename": "ancv-1.4.1.tar.gz",
"has_sig": false,
"md5_digest": "27ac44547fd5a8a9bcb240216fa77234",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 35704,
"upload_time": "2024-05-01T15:15:09",
"upload_time_iso_8601": "2024-05-01T15:15:09.119693Z",
"url": "https://files.pythonhosted.org/packages/c5/96/79711dd9e682af665455e33c6898b5caebc97b9addaa18e99e738f433bbd/ancv-1.4.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-01 15:15:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "alexpovel",
"github_project": "ancv",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ancv"
}
