Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/practicalli/clojure
Practicalli Clojure REPL Driven Development
https://github.com/practicalli/clojure
clojure clojure-cli repl
Last synced: 9 days ago
JSON representation
Practicalli Clojure REPL Driven Development
- Host: GitHub
- URL: https://github.com/practicalli/clojure
- Owner: practicalli
- License: cc-by-sa-4.0
- Created: 2016-04-28T02:09:05.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2024-10-21T23:21:57.000Z (23 days ago)
- Last Synced: 2024-10-22T04:45:37.768Z (23 days ago)
- Topics: clojure, clojure-cli, repl
- Language: Markdown
- Homepage: https://practical.li/clojure/
- Size: 220 MB
- Stars: 89
- Watchers: 4
- Forks: 36
- Open Issues: 374
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Practicalli Clojure
```none
██████╗ ██████╗ █████╗ ██████╗████████╗██╗ ██████╗ █████╗ ██╗ ██╗ ██╗
██╔══██╗██╔══██╗██╔══██╗██╔════╝╚══██╔══╝██║██╔════╝██╔══██╗██║ ██║ ██║
██████╔╝██████╔╝███████║██║ ██║ ██║██║ ███████║██║ ██║ ██║
██╔═══╝ ██╔══██╗██╔══██║██║ ██║ ██║██║ ██╔══██║██║ ██║ ██║
██║ ██║ ██║██║ ██║╚██████╗ ██║ ██║╚██████╗██║ ██║███████╗███████╗██║
╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝ ╚═════╝╚═╝ ╚═╝╚══════╝╚══════╝╚═╝
██████╗██╗ ██████╗ ██╗██╗ ██╗██████╗ ███████╗
██╔════╝██║ ██╔═══██╗ ██║██║ ██║██╔══██╗██╔════╝
██║ ██║ ██║ ██║ ██║██║ ██║██████╔╝█████╗
██║ ██║ ██║ ██║██ ██║██║ ██║██╔══██╗██╔══╝
╚██████╗███████╗╚██████╔╝╚█████╔╝╚██████╔╝██║ ██║███████╗
╚═════╝╚══════╝ ╚═════╝ ╚════╝ ╚═════╝ ╚═╝ ╚═╝╚══════╝
```
## Book Overview
A guide to software development with the Clojure programming language, using Clojure CLI and a wide range of community tools for a REPL focused workflow.
The guide uses Practicalli Clojure CLI Config to provide aliases to run over 30 community tools that complement the workflow, including a REPL Reloaded workflow for a highly interactive and effective development experience.
Learning Clojure syntax and how to think in a functional design is also covered with code examples and challenge that help embed these concepts.
## Book status
[](https://github.com/practicalli/clojure/actions/workflows/megalinter.yaml)[](https://github.com/practicalli/clojure/actions/workflows/publish-book.yaml)
[](https://github.com/practicalli/clojure/actions/workflows/publish-book.yaml)
[](https://github.com/practicalli/clojure/actions/workflows/pages/pages-build-deployment)
[](https://github.com/practicalli/clojure/issues)
[](https://github.com/practicalli/clojure/pulls)
## Creative commons license
This work is licensed under a Creative Commons Attribution 4.0 ShareAlike License (including images & stylesheets).
## Contributing
Issues and pull requests are most welcome although it is the maintainers discression as to if they are applicable. Please detail issues as much as you can. Pull requests are simpler to work with when they are specific to a page or at most a section. The smaller the change the quicker it is to review and merge.
Please read the [detailed Practicalli contributing page](https://practical.li/contributing/) before raising an issue or pull request to avoid disapointment.
* [Current Issues](https://github.com/practicalli/clojure/issues)
* [Current pull requests](https://github.com/practicalli/clojure/pulls)
[Practicalli Clojure CLI Config](clojure/clojure-cli/practicalli-config.md) provides a user level configuration providing aliases for community tools used throughout this guide. Issues and pull requests can also be made via its GitHub repository.
By submitting content ideas and corrections you are agreeing they can be used in any work by Practicalli under the [Creative Commons Attribution ShareAlike 4.0 International license](https://creativecommons.org/licenses/by-sa/4.0/). Attribution will be detailed via [GitHub contributors](https://github.com/practicalli/clojure/graphs/contributors).
## Sponsor Practicalli
[](https://github.com/sponsors/practicalli-johnny/)
All sponsorship funds are used to support the continued development of [Practicalli series of books and videos](https://practical.li/), although most work is done at personal cost and time.
Thanks to [Cognitect](https://www.cognitect.com/), [Nubank](https://nubank.com.br/) and a wide range of other [sponsors](https://github.com/sponsors/practicalli-johnny#sponsors) for your continued support
## Star History
[](https://star-history.com/#practicalli/clojure&Date)
## GitHub Actions
The megalinter GitHub actions will run when a pull request is created,checking basic markdown syntax.
A review of the change will be carried out by the Practicalli team and the PR merged if the change is acceptable.
The Publish Book GitHub action will run when PR's are merged into main (or the Practicalli team pushes changes to the default branch).
Publish book workflow installs Material for MkDocs version 9
## Local development
Install mkdocs version 9 using the Python pip package manager
```shell
pip install mkdocs-material=="9.5"
```
Install the plugins used by the Practicalli site using Pip (these are also installed in the GitHub Action workflow)
```shell
pip3 install mkdocs-material mkdocs-callouts mkdocs-glightbox mkdocs-git-revision-date-localized-plugin mkdocs-redirects pillow cairosvg
```
> pillow and cairosvg python packages are required for [Social Cards](https://squidfunk.github.io/mkdocs-material/setup/setting-up-social-cards/)
Fork the GitHub repository and clone that fork to your computer,
```shell
git clone https://github.com//.git
```
Run a local server from the root of the cloned project
```shell
make docs
```
The website will open at
If making smaller changes, then only rebuild the content that changes, speeding up the local development process
```shell
make docs-changed
```
> NOTE: navigation changes may not be correctly reflected without reloading the page in the web browser or carrying out a full `make docs` build