Debian 包是否有标准/推荐的目录结构？

Question

My next project will be a Debian daemon written in Python and I want to package it as a Debian native package. The project is versioned using Git and the code is hosted in GitHub.

How can I organize directories and branches in the repository? Is there a standard/common/recommended way?

The project is basically composed by some python scripts and systemd unit files. By looking around I came up with this directory structure but I don't know if it is reasonable:

my-app/
├── debian/
│   ├── control
│   ├── copyright
│   ├── changelog
│   ├── rules
│   └── ...
├── my_module/
│   ├── __init__.py
│   ├── my_script.py
│   └── ...
├── systemd/
│   ├── my-service.service
│   └── ...
├── README.md
├── LICENSE
└── ...

Answer 1

it seems you are asking about the directory structure (which files should be where), not the repository structure (which would be about branches).

the structure is as follows:

• the upstream project (eg the content of a source release tarball)
• PLUS a debian/ folder in the root of this directory

that's it. this structure was designed to allow packaging of arbitrary projects - with the only constraint that there is no debian/ folder.

now, this structure is very tightly coupled to the concept of having upstream-development separate from Debian-packaging. (something which might not apply to your use case, as you seem to be both upstream developer and the one creating the Debian package).

in order to make life easier for an eventual adaption into Debian proper (eg adaption of the package into a real Debian release), you should make sure that the /debian directory is not included in the release tarballs.

You should also exclude repository configuration files from your release tarballs ( .gitignore files, CI-configuration,...)

if using git, you might add a .gitattributes file that contains (among other things):

/debian/    export-ignore
.git*       export-ignore

There's also a more elaborate online guide on how to be a nice upstream for Debian: https://wiki.debian.org/UpstreamGuide