From df0ee3d26770a6cbde012b68718f89c9ef2217d2 Mon Sep 17 00:00:00 2001
From: JoshuaBrest <36625023+JoshuaBrest@users.noreply.github.com>
Date: Thu, 6 Jul 2023 01:32:48 -0700
Subject: [PATCH] First commit
---
.github/workflows/rust-publish.yml | 23 +++
.github/workflows/rust-test.yml | 63 +++++++
LICENSE | 157 +++++++++++++++++
README.md | 12 ++
icns-rs/.gitignore | 4 +
icns-rs/Cargo.toml | 20 +++
icns-rs/README.md | 74 ++++++++
icns-rs/example.icns | Bin 0 -> 192911 bytes
icns-rs/example.png | Bin 0 -> 59948 bytes
icns-rs/examples/encode.rs | 36 ++++
icns-rs/rustfmt.toml | 3 +
icns-rs/src/icns_format.rs | 129 ++++++++++++++
icns-rs/src/image_encoder.rs | 215 +++++++++++++++++++++++
icns-rs/src/image_types.rs | 226 ++++++++++++++++++++++++
icns-rs/src/lib.rs | 105 +++++++++++
icns-rs/src/packbits.rs | 268 +++++++++++++++++++++++++++++
16 files changed, 1335 insertions(+)
create mode 100644 .github/workflows/rust-publish.yml
create mode 100644 .github/workflows/rust-test.yml
create mode 100644 LICENSE
create mode 100644 README.md
create mode 100644 icns-rs/.gitignore
create mode 100644 icns-rs/Cargo.toml
create mode 100644 icns-rs/README.md
create mode 100644 icns-rs/example.icns
create mode 100644 icns-rs/example.png
create mode 100644 icns-rs/examples/encode.rs
create mode 100644 icns-rs/rustfmt.toml
create mode 100644 icns-rs/src/icns_format.rs
create mode 100644 icns-rs/src/image_encoder.rs
create mode 100644 icns-rs/src/image_types.rs
create mode 100644 icns-rs/src/lib.rs
create mode 100644 icns-rs/src/packbits.rs
diff --git a/.github/workflows/rust-publish.yml b/.github/workflows/rust-publish.yml
new file mode 100644
index 0000000..861f9b7
--- /dev/null
+++ b/.github/workflows/rust-publish.yml
@@ -0,0 +1,23 @@
+name: Cargo Publish
+on:
+ push:
+ tags:
+ - "rust-*"
+ workflow_dispatch:
+jobs:
+ publish:
+ name: Publish
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v3
+ - name: Setup Rust
+ uses: actions-rs/toolchain@v1
+ with:
+ toolchain: stable
+ override: true
+ - name: Change Working Directory
+ run: cd icns-rs
+ - name: Publish
+ run: cargo publish --token ${CRATES_TOKEN}
+ env:
+ CRATES_IO_TOKEN: ${{ secrets.CRATES_TOKEN }}
diff --git a/.github/workflows/rust-test.yml b/.github/workflows/rust-test.yml
new file mode 100644
index 0000000..ea5fc55
--- /dev/null
+++ b/.github/workflows/rust-test.yml
@@ -0,0 +1,63 @@
+name: Rust CI
+concurrency:
+ group: ${{ github.workflow }}-${{ github.ref }}
+ cancel-in-progress: true
+on:
+ pull_request:
+ paths:
+ - icns-rs/**
+ push: null
+ workflow_dispatch: null
+jobs:
+ tests:
+ name: Tests
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v3
+ - name: Setup Rust
+ uses: actions-rs/toolchain@v1
+ with:
+ toolchain: stable
+ override: true
+ - name: Change Working Directory
+ run: cd icns-rs
+ - name: Run tests
+ uses: actions-rs/cargo@v1]
+ with:
+ command: test
+ rustfmt:
+ name: Rustfmt
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v3
+ - name: Setup Rust
+ uses: actions-rs/toolchain@v1
+ with:
+ toolchain: stable
+ override: true
+ components: rustfmt
+ - name: Change Working Directory
+ run: cd icns-rs
+ - name: Run rustfmt
+ uses: actions-rs/cargo@v1
+ with:
+ command: fmt
+ args: "-- --check"
+ clippy:
+ name: Clippy
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v3
+ - name: Setup Rust
+ uses: actions-rs/toolchain@v1
+ with:
+ toolchain: stable
+ override: true
+ components: clippy
+ - name: Change Working Directory
+ run: cd icns-rs
+ - name: Run clippy
+ uses: actions-rs/cargo@v1
+ with:
+ command: clippy
+ args: "-- -D warnings"
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..144f824
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,157 @@
+# GNU LESSER GENERAL PUBLIC LICENSE
+
+Version 3, 29 June 2007
+
+Copyright (C) 2007 Free Software Foundation, Inc.
+
+
+Everyone is permitted to copy and distribute verbatim copies of this
+license document, but changing it is not allowed.
+
+This version of the GNU Lesser General Public License incorporates the
+terms and conditions of version 3 of the GNU General Public License,
+supplemented by the additional permissions listed below.
+
+## 0. Additional Definitions.
+
+As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the
+GNU General Public License.
+
+"The Library" refers to a covered work governed by this License, other
+than an Application or a Combined Work as defined below.
+
+An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+A "Combined Work" is a work produced by combining or linking an
+Application with the Library. The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+## 1. Exception to Section 3 of the GNU GPL.
+
+You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+## 2. Conveying Modified Versions.
+
+If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+- a) under this License, provided that you make a good faith effort
+ to ensure that, in the event an Application does not supply the
+ function or data, the facility still operates, and performs
+ whatever part of its purpose remains meaningful, or
+- b) under the GNU GPL, with none of the additional permissions of
+ this License applicable to that copy.
+
+## 3. Object Code Incorporating Material from Library Header Files.
+
+The object code form of an Application may incorporate material from a
+header file that is part of the Library. You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+- a) Give prominent notice with each copy of the object code that
+ the Library is used in it and that the Library and its use are
+ covered by this License.
+- b) Accompany the object code with a copy of the GNU GPL and this
+ license document.
+
+## 4. Combined Works.
+
+You may convey a Combined Work under terms of your choice that, taken
+together, effectively do not restrict modification of the portions of
+the Library contained in the Combined Work and reverse engineering for
+debugging such modifications, if you also do each of the following:
+
+- a) Give prominent notice with each copy of the Combined Work that
+ the Library is used in it and that the Library and its use are
+ covered by this License.
+- b) Accompany the Combined Work with a copy of the GNU GPL and this
+ license document.
+- c) For a Combined Work that displays copyright notices during
+ execution, include the copyright notice for the Library among
+ these notices, as well as a reference directing the user to the
+ copies of the GNU GPL and this license document.
+- d) Do one of the following:
+ - 0) Convey the Minimal Corresponding Source under the terms of
+ this License, and the Corresponding Application Code in a form
+ suitable for, and under terms that permit, the user to
+ recombine or relink the Application with a modified version of
+ the Linked Version to produce a modified Combined Work, in the
+ manner specified by section 6 of the GNU GPL for conveying
+ Corresponding Source.
+ - 1) Use a suitable shared library mechanism for linking with
+ the Library. A suitable mechanism is one that (a) uses at run
+ time a copy of the Library already present on the user's
+ computer system, and (b) will operate properly with a modified
+ version of the Library that is interface-compatible with the
+ Linked Version.
+- e) Provide Installation Information, but only if you would
+ otherwise be required to provide such information under section 6
+ of the GNU GPL, and only to the extent that such information is
+ necessary to install and execute a modified version of the
+ Combined Work produced by recombining or relinking the Application
+ with a modified version of the Linked Version. (If you use option
+ 4d0, the Installation Information must accompany the Minimal
+ Corresponding Source and Corresponding Application Code. If you
+ use option 4d1, you must provide the Installation Information in
+ the manner specified by section 6 of the GNU GPL for conveying
+ Corresponding Source.)
+
+## 5. Combined Libraries.
+
+You may place library facilities that are a work based on the Library
+side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+- a) Accompany the combined library with a copy of the same work
+ based on the Library, uncombined with any other library
+ facilities, conveyed under the terms of this License.
+- b) Give prominent notice with the combined library that part of it
+ is a work based on the Library, and explaining where to find the
+ accompanying uncombined form of the same work.
+
+## 6. Revised Versions of the GNU Lesser General Public License.
+
+The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number. If the Library
+as you received it specifies that a certain numbered version of the
+GNU Lesser General Public License "or any later version" applies to
+it, you have the option of following the terms and conditions either
+of that published version or of any later version published by the
+Free Software Foundation. If the Library as you received it does not
+specify a version number of the GNU Lesser General Public License, you
+may choose any version of the GNU Lesser General Public License ever
+published by the Free Software Foundation.
+
+If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.
\ No newline at end of file
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..213606e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,12 @@
+# ICNS
+
+This repository contains a multiple libraries for reading and writing ICNS files.
+ - Rust: [icns-rs](icns-rs/README.md)
+
+## Contributing
+
+Contributions are welcome! Feel free to open an issue or submit a pull request.
+
+## License
+
+This project is licensed under the LGPLv3 license. See the [LICENSE](/LICENSE) file for more details.
\ No newline at end of file
diff --git a/icns-rs/.gitignore b/icns-rs/.gitignore
new file mode 100644
index 0000000..a73dbda
--- /dev/null
+++ b/icns-rs/.gitignore
@@ -0,0 +1,4 @@
+# Cargo
+/target/
+Cargo.lock
+# ^^^^^^^^ Lock files aren't allowed in libraries
\ No newline at end of file
diff --git a/icns-rs/Cargo.toml b/icns-rs/Cargo.toml
new file mode 100644
index 0000000..073d294
--- /dev/null
+++ b/icns-rs/Cargo.toml
@@ -0,0 +1,20 @@
+[package]
+name = "icns-rs"
+version = "0.1.0"
+edition = "2021"
+description = "A library for reading and writing Apple Icon Image (.icns) files."
+license = "LGPL-3.0-or-later"
+homepage = "https://github.com/JoshuaBrest/icns/tree/master/icns-rs"
+documentation = "https://docs.rs/icns-rs"
+repository = "https://github.com/JoshuaBrest/icns"
+catagories = ["image"]
+keywords = ["icns", "image", "apple", "icon"]
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+
+[dependencies]
+image = "0.24.6"
+
+[[example]]
+name = "encode"
+path = "examples/encode.rs"
diff --git a/icns-rs/README.md b/icns-rs/README.md
new file mode 100644
index 0000000..99916c5
--- /dev/null
+++ b/icns-rs/README.md
@@ -0,0 +1,74 @@
+# ICNS-RS
+
+ICNS is a file format used by Apple to store icons for macOS applications. This crate provides a simple API for reading and (and soon)writing ICNS files.
+
+## Roadmap
+
+- [x] Write ICNS files
+- [ ] Read ICNS files
+
+## Usage
+
+Here's a simple example of how to read an ICNS file:
+
+> You can find this example in `examples/encode.rs` or run it with:
+> ```sh
+> cargo run --example encode
+> ```
+
+```rust
+use std::fs::File;
+use std::io::prelude::*;
+use image::open;
+use icns_rs::{IcnsEncoder, IconFormats};
+
+fn main() -> std::io::Result<()> {
+ // Open the image
+ let image = match open("example.png") {
+ Ok(image) => image,
+ Err(e) => {
+ println!("Error opening file: {}", e);
+ return Ok(());
+ }
+ };
+
+ // Create the encoder
+ let mut encoder = IcnsEncoder::new();
+
+ encoder.data(image);
+ encoder.formats(IconFormats::recommended());
+
+ // Encode the image
+ let data = match encoder.build() {
+ Ok(data) => data,
+ Err(e) => {
+ println!("Error encoding image: {}", e);
+ return Ok(());
+ }
+ };
+
+ // Write data to file
+ let mut file = File::create("example.icns")?;
+ file.write_all(&data)?;
+
+ Ok(())
+}
+```
+
+## License
+
+This project is licensed under the GPLv3 license. See the [LICENSE](/LICENSE) file for more details.
+
+## Contributing
+
+Contributions are welcome! Feel free to open an issue or submit a pull request.
+
+## Acknowledgements
+
+This project is heavily inspired by:
+ - The Python package: [icnsutil](https://github.com/relikd/icnsutil/)
+ - The JavaScript package: [@fiahfy/icns](https://github.com/fiahfy/icns/)
+ - The JavaScript PackBits implementation: [@fiahfy/packbits](https://github.com/fiahfy/packbits/)
+ - The Wikipedia page: [Wikipedia: Apple Icon Image Format](https://en.wikipedia.org/wiki/Apple_Icon_Image_format#Icon_types)
+
+When I started building this, I didn't know there already was a ICNS lib for rust, but, after looking at it, it was not up to my standards because of the lack of ARGB, RGB, and, Mask support. I wanted to create a modern package that was easy to use and had a simple API. I also wanted to make sure that it was well documented and had a good test suite. I hope you enjoy using this package as much as I enjoyed making it!.
\ No newline at end of file
diff --git a/icns-rs/example.icns b/icns-rs/example.icns
new file mode 100644
index 0000000000000000000000000000000000000000..232f2c6c36956a31248a7e0fda0785bb0f835b36
GIT binary patch
literal 192911
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