Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We鈥檒l occasionally send you account related emails.

Already on GitHub? Sign in to your account

python311Packages.sphinxcontrib-ditaa: init at 1.0.2 #309426

Merged
merged 2 commits into from
May 23, 2024

Conversation

Rconybea
Copy link
Contributor

@Rconybea Rconybea commented May 6, 2024

Description of changes

Add sphinx plugin to invoke ditaa.

  1. ditaa (nixpkgs.ditaa) renders ascii art block diagrams to image formats like .svg
  2. sphinx (nixpkgs.python3xxPackages.sphinx) generates documentation from .rst text files
  3. sphinxcontrib-ditaa (https://pypi.org/project/sphinxcontrib-ditaa) adds sphinx markup to send a block of text to ditaa for rendering. Analogous to existing packages such as nixpkgs.python3xxPackages.sphinxcontrib-plantuml.

Executable content comprises about 200 lines of python.
nix package adapted from sphinxcontrib-blockdiag

Things done

Using successfully for sphinx-generated documentation in xo-unit (https://github.com/rconybea/xo-unit),
and user environment in xo-nix2 (https://github.com/rconybea/xo-nix2/flake.nix)

  • Built on platform(s)
    • x86_64-linux
    • aarch64-linux
    • x86_64-darwin
    • aarch64-darwin
  • For non-Linux: Is sandboxing enabled in nix.conf? (See Nix manual)
    • sandbox = relaxed
    • sandbox = true
  • Tested, as applicable:
  • Tested compilation of all packages that depend on this change using nix-shell -p nixpkgs-review --run "nixpkgs-review rev HEAD". Note: all changes have to be committed, also see nixpkgs-review usage
  • Tested basic functionality of all binary files (usually in ./result/bin/)
  • 24.05 Release Notes (or backporting 23.05 and 23.11 Release notes)
    • (Package updates) Added a release notes entry if the change is major or breaking
    • (Module updates) Added a release notes entry if the change is significant
    • (Module addition) Added a release notes entry if adding a new NixOS module
  • Fits CONTRIBUTING.md.

Add a 馃憤 reaction to pull requests you find important.

@natsukium
Copy link
Member

Could you please rewrite your commit message and PR title as python311Packages.sphinxcontrib-ditaa: init at 1.0.2?
https://github.com/NixOS/nixpkgs/blob/master/doc/languages-frameworks/python.section.md#contributing-guidelines-contributing-guidelines

@Rconybea Rconybea changed the title sphinxcontrib-ditaa: init at 1.0.2 python311Packages.sphinxcontrib-ditaa: init at 1.0.2 May 6, 2024
@Rconybea Rconybea force-pushed the add-sphinxcontrib-ditaa branch 2 times, most recently from 173571c to ba59da8 Compare May 7, 2024 04:32
@Rconybea Rconybea requested a review from natsukium May 7, 2024 14:10
@Rconybea Rconybea requested a review from natsukium May 22, 2024 15:58
@Rconybea Rconybea force-pushed the add-sphinxcontrib-ditaa branch 2 times, most recently from 60a37e3 to 7be01b1 Compare May 22, 2024 23:56
Copy link
Member

@natsukium natsukium left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM.
Could you reformat with nixfmt-rfc-style? ref. #313628

Co-authored-by: OTABI Tomoya <tomoya.otabi@gmail.com>
@Rconybea
Copy link
Contributor Author

format regularized with nixfmt from pkgs.nixfmt-rfc-style

@Rconybea
Copy link
Contributor Author

@NixOS/nixpkgs-merge-bot merge

@nixpkgs-merge-bot
Copy link
Contributor

@Rconybea merge not permitted (#305350):
maintainers/maintainer-list.nix is not in pkgs/by-name/
pkgs/development/python-modules/sphinxcontrib-ditaa/default.nix is not in pkgs/by-name/
pkgs/top-level/python-packages.nix is not in pkgs/by-name/

@Rconybea
Copy link
Contributor Author

looks like need help to trigger the merge here.

@natsukium natsukium merged commit a36fa54 into NixOS:master May 23, 2024
24 of 25 checks passed
@natsukium
Copy link
Member

Thank you!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants